跳至内容

原生组件

将 Radix 的功能组合到替代元素类型或您自己的 Vue 组件中。

在构建组件时,在某些情况下,您可能希望允许用户将某些功能组合到基础元素或替代元素上。 这就是 Primitive 派上用场的地方,因为它向用户公开这种能力。

API 参考

属性默认值类型
as
div
string | Component
当前元素应渲染成的元素或组件。
asChild
false
boolean
更改作为子元素传递的默认渲染元素,合并其属性和行为。

阅读我们的 组合 指南以了解更多详细信息。

用法

更改 as

如果要更改正在渲染的默认元素或组件,可以在定义属性时设置默认 as

vue
<script setup lang="ts">
import { Primitive, type PrimitiveProps } from 'radix-vue'

const props = withDefaults(defineProps<PrimitiveProps>(), {
  as: 'span'
})
</script>

<template>
  <!-- Now this element will be rendered as `span` by default -->
  <Primitive v-bind="props">
    ...
  </Primitive>
</template>

渲染 asChild

更改作为子元素传递的默认渲染元素,合并其属性和行为。

阅读我们的 组合 指南以了解更多详细信息。