一个用于渲染动态组件或元素的“元组件”。
Props
interface DynamicComponentProps {is: string | Component
}
详细信息:
要渲染的实际组件由 is prop 决定。
- 当 is 是字符串,它既可以是 HTML 标签名也可以是组件的注册名。
- 或者,is 也可以直接绑定到组件的定义。
示例:
按注册名渲染组件 (选项式 API):
<script>
import Foo from './Foo.vue'
import Bar from './Bar.vue'export default {components: { Foo, Bar },data() {return {view: 'Foo'}}
}
</script><template><component :is="view" />
</template>
按定义渲染组件 (
<script setup>
import Foo from './Foo.vue'
import Bar from './Bar.vue'
</script><template><component :is="Math.random() > 0.5 ? Foo : Bar" />
</template>
渲染 HTML 元素:
<component :is="href ? 'a' : 'span'"></component>
内置组件都可以传递给 is,但是如果想通过名称传递则必须先对其进行注册。举例来说:
<script>
import { Transition, TransitionGroup } from 'vue'export default {components: {Transition,TransitionGroup}
}
</script><template><component :is="isGroup ? 'TransitionGroup' : 'Transition'">...</component>
</template>
如果将组件本身传递给 is 而不是其名称,则不需要注册,例如在
如果在 标签上使用 v-model,模板编译器会将其扩展为 modelValue prop 和 update:modelValue 事件监听器,就像对任何其他组件一样。但是,这与原生 HTML 元素不兼容,例如 或 。因此,在动态创建的原生元素上使用 v-model 将不起作用:
<script setup>
import { ref } from 'vue'const tag = ref('input')
const username = ref('')
</script><template><!-- 由于 'input' 是原生 HTML 元素,因此这个 v-model 不起作用 --><component :is="tag" v-model="username" />
</template>
在实践中,这种极端情况并不常见,因为原生表单字段通常包裹在实际应用的组件中。如果确实需要直接使用原生元素,那么你可以手动将 v-model 拆分为 attribute 和事件。
动态组件
有些场景会需要在两个组件间来回切换,比如 Tab 界面:
<!-- currentTab 改变时组件也改变 -->
<component :is="tabs[currentTab]"></component>
在上面的例子中,被传给 :is 的值可以是以下几种:
- 被注册的组件名
- 导入的组件对象
你也可以使用 is attribute 来创建一般的 HTML 元素。
当使用 来在多个组件间作切换时,被切换掉的组件会被卸载。我们可以通过 组件强制被切换掉的组件仍然保持“存活”的状态。