跳转正文

YSettingRow ​

适用范围:Legacy Admin Kit / Schema 与旧 admin-vue。新 admin-nuxtui 的开发入口见管理端 Nuxt UI 指南。

定位 / Owner ​

YSettingRow 统一设置项的 label、description、error、disabled 语义,并把 ARIA wiring 通过 scoped slot 交给真实 control。

什么时候使用 ​

用于 Preference Drawer、Tenant Editor 等“说明在左、control 在右”的设置列表。

不什么时候使用 ​

普通数据录入字段使用 YFormField;复杂子表单不应塞进单个 SettingRow。

Public API ​

props:label、description、error、disabled;default slot 暴露 labelId、describedBy、disabled、invalid。

Composition ​

control 必须消费 slot 暴露的 ARIA/disabled 值;SettingRow 不读取或拥有 control model。

Anti-pattern ​

不要仅靠视觉邻接建立标签关系,也不要忽略 scoped disabled 后仍允许操作。

Production Example ​

Tenant Editor 与 Preference Drawer 直接消费它。

Live Workbench ​

/frontend-module-demo/component-workbench/setting-row

Verification / Source ​

  • packages/yoyo-admin/admin-kit/src/ui/components/settings/YSettingRow.vue
  • setting-row.spec.ts 与 Tenant/Preference consumers

YoyoBoot · 从真实项目走向可复用能力