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

Setting Row

Setting Row aligns a setting label, direct description, control, and optional validation message on a stable grid. Group rows in Setting List inside Settings Layout.

Live preview
Language

Choose the interface language.

Follow system theme

Use the operating system appearance setting.

Usage

<div class="setting-list">
  <div class="setting-row">
    <div data-setting-identity>
      <strong>Language</strong>
      <p>Choose the interface language.</p>
    </div>
    <div data-setting-control>
      <select class="select">
        ...
      </select>
    </div>
    <p data-setting-message>...</p>
  </div>
</div>

Parameters

APIPurpose
class="setting-list"Groups adjacent rows and shared boundaries
class="setting-row"Stable label-control grid
data-setting-identityName and direct description
data-setting-controlNative or composite control
data-setting-messageOptional validation or recovery message
data-state="invalid"Invalid row styling

States and variants

Child controls own focus, disabled, loading, checked, and read-only state. The row owns the relationship between identity, control, and error recovery. It stacks without changing DOM order below 640px.

Accessibility

Associate the control with a native label or explicit ARIA labeling. Descriptions and error messages use aria-describedby; invalid controls also use aria-invalid="true".