Ordo UI
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——

源码

packages/patterns/src/components/settings-field-row.tsx
/**
 * 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 /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

设置字段行:左 label/helper、右控件;不传控件退化为说明行;与 definition-row 的分工是表单控件行 vs 管理行卡。