PatternsSemantic
SettingsFieldRow
@mox-hub/patterns 模式 · Semantic · canonical
settings-field-row@mox-hub/patternsSemanticcanonicalsrc/components/settings-field-row.tsx变体演示settings-field-row
自动更新
启动后检查新版本并在后台下载
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| title* | ReactNode | — | — |
| description* | ReactNode | — | — |
| control* | ReactNode | — | — |
源码
/**
* SettingsFieldRow - 设置字段行(左说明右控件,2026-10-01 设置页语义组件批二)
*
* 设置页「左 label + helper 说明、右 Switch/Select 控件」的三段行骨架,
* 收编 settings 域 10+ 处同构散写(flex justify-between + rounded-lg border p-3 基准,
* 形态逐字沿袭 dock-section 等既有写法)。控件不传时整行退化为说明行。
* 与 DefinitionRow 的分工:本件是表单控件行(无点击导航语义),DefinitionRow 是
* 定义类管理行的行卡(点击编辑/拖拽);勿混用。
* props 面封闭(G8):不接 className、不透传样式。
*/
import type { ReactNode } from 'react';
export interface SettingsFieldRowProps {
/** 字段名(左列首行,text-sm) */
title: ReactNode;
/** helper 说明(左列第二行,text-xs 次级色;约束说明也放这里) */
description?: ReactNode;
/** 右侧控件(Switch / Select / Input 等);不传则不渲染控件槽 */
control?: ReactNode;
}
export function SettingsFieldRow({ title, description, control }: SettingsFieldRowProps) {
return (
<div
data-slot="settings-field-row"
className="flex items-center justify-between gap-4 rounded-lg border border-border p-3"
>
<div className="min-w-0">
<p className="m-0 text-sm text-foreground">{title}</p>
{description ? <p className="mt-0.5 text-xs text-muted-foreground">{description}</p> : null}
</div>
{control ? <div className="shrink-0">{control}</div> : null}
</div>
);
}
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
设置字段行:左 label/helper、右控件;不传控件退化为说明行;与 definition-row 的分工是表单控件行 vs 管理行卡。