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

Settings Layout

Settings Layout provides navigable configuration sections with real form controls. It is intended for operational configuration, preferences, policy, providers, routing, and other structured settings.

Live preview

General

Identity and network defaults for this gateway.

Usage

<div class="settings-layout">
  <aside><nav aria-label="Settings sections">...</nav></aside>
  <main><section id="general">...</section></main>
</div>

Parameters

ParameterDefaultPurpose
--settings-navigation-size14remNavigation column width
--settings-sticky-offset1remSticky navigation top offset
--settings-section-gap1.5remGap between configuration sections
aria-current="page"—Marks the active settings destination

Variants and states

The layout becomes a horizontally scrollable section list below 768px. Form state belongs to child primitives: required, disabled, aria-invalid, validation messages, dirty-state badges, and save feedback.

Accessibility

Use real form controls and field labels; do not replace configuration with an unstructured source editor. Keep advanced raw configuration as an optional escape hatch. Each section needs a unique heading and ID so navigation can deep-link to it.