For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/v0.4.0/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/v0.4.0/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/v0.4.0/components/setting-row.md.

设置行

设置行在稳定网格中对齐设置名称、直接说明、控件和可选验证信息。多个设置行放在设置列表中,再组合进设置布局。

实时预览
语言

选择界面显示语言。

跟随系统主题

使用操作系统的外观设置。

用法

<div class="setting-list">
  <div class="setting-row">
    <div data-setting-identity>
      <strong>语言</strong>
      <p>选择界面显示语言。</p>
    </div>
    <div data-setting-control>
      <select class="select">
        ...
      </select>
    </div>
    <p data-setting-message>...</p>
  </div>
</div>

参数

API用途
class="setting-list"组合相邻设置行和共享边界
class="setting-row"稳定的名称与控件网格
data-setting-identity设置名称和直接说明
data-setting-control原生或复合控件
data-setting-message可选验证或恢复信息
data-state="invalid"无效设置行样式

状态和变体

焦点、禁用、加载、选中和只读状态由子控件承担。设置行负责建立名称、控件和错误恢复之间的关系。低于 640 像素时按 DOM 顺序堆叠。

无障碍

用原生标签或明确的 ARIA 名称关联控件。说明和错误信息通过 aria-describedby 关联,无效控件同时设置 aria-invalid="true"。