跳转正文

YFormGrid ​

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

定位 / Owner ​

YFormGrid 是无状态字段布局 primitive:移动端保持单列,桌面按 columns 使用一列或两列。

什么时候使用 ​

用于 EditorPanel/Dialog 内需要稳定响应式排列的 YFormField 集合。

不什么时候使用 ​

数据表格、dashboard grid 或任意 masonry layout 不属于 FormGrid。

Public API ​

prop:columns: 1 | 2(默认 2);default slot。

Composition ​

通常放在 YFormSection 内;字段状态仍由 Form owner / YFormField / control 管理。

Anti-pattern ​

不要用 DOM 顺序以外的 CSS 重排改变键盘阅读顺序,也不要在组件内推断字段宽度。

Production Example ​

Edition Editor 与 Role Data Workbench Editor 直接消费它。

Live Workbench ​

/frontend-module-demo/component-workbench/form-grid

Verification / Source ​

  • packages/yoyo-admin/admin-kit/src/ui/components/form/YFormGrid.vue
  • form-feedback-grammar.spec.ts 与 Edition/Role consumers

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