组合式 API：辅助函数 {#composition-api-helpers}

useAttrs() {#useattrs}

从 Setup 上下文中返回 attrs 对象，其中包含当前组件的透传 attributes。此函数专为 `

• 参考
  • 指南 - 模板引用
  • 指南 - 为模板引用标注类型
  • 指南 - 为组件模板引用标注类型

useId() ^{#useid}

用于为无障碍属性或表单元素生成每个应用内唯一的 ID。

• 类型

  ts 复制代码

  function useId(): string

• 示例

  vue 复制代码

  <template>
    <form>
      <label :for="id">Name:</label>
      <input :id="id" type="text" />
    </form>
  </template>

• 详细信息

  useId() 生成的每个 ID 在每个应用内都是唯一的。它可以用于为表单元素和无障碍属性生成 ID。在同一个组件中多次调用会生成不同的 ID；同一个组件的多个实例调用 useId() 也会生成不同的 ID。

  useId() 生成的 ID 在服务器端和客户端渲染之间是稳定的，因此可以安全地在 SSR 应用中使用，不会导致激活不匹配。

  如果同一页面上有多个 Vue 应用实例，可以通过 app.config.idPrefix 为每个应用提供一个 ID 前缀，以避免 ID 冲突。

  :::warning 警告
  useId() 不应在 computed() 属性内部调用，因为这可能导致实例冲突。相反，应在 computed() 外部声明 ID，并在计算属性函数内部引用该 ID。
  :::