feat: added v-is to API reference

vuejs · NataliaTepluhina · Jul 15, 2020 · Jul 14, 2020 · Jul 14, 2020 · Jul 14, 2020
commit a7a43649435a37be4706666ab0f0809aba0e87d6
diff --git a/src/api/directives.md b/src/api/directives.md
@@ -453,3 +453,30 @@

 - **See also:**
  - [Data Binding Syntax - interpolations](../guide/template-syntax.html#text)
+
+## v-is
+
+- **Expects:** string literal
+
+- **Limited to:** native HTML elements
+
+- **Usage:** When using in-DOM templates, the template is subject to native HTML parsing rules. Some HTML elements, such as `<ul>`, `<ol>`, `<table>` and `<select>` have restrictions on what elements can appear inside them, and some elements such as `<li>`, `<tr>`, and `<option>` can only appear inside certain other elements. As a workaround, we can use `v-is` directive on these elements:
+
+```html
+<table>
+  <tr v-is="'blog-post-row'"></tr>
+</table>
+```
+
+:::warning
+`v-is` functions like a dynamic 2.x `:is` binding - so to render a component by its registered name, its value should be a JavaScript string literal:
+
+```html
+<!-- Incorrect, nothing will be rendered -->
+<tr v-is="blog-post-row"></tr>
+
+<!-- Correct -->
+<tr v-is="'blog-post-row'"></tr>
+```
+
+:::