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/foundations/shape-and-elevation.md.

形状与层级

A3S UI 使用 4、6、8 与 12px 四级圆角。静态表面保持平坦;只有真正浮在内容上方或内容会从其下方经过的表面才获得阴影。

实时预览

微型


4px

控件


6px

表面


8px

浮层


12px

圆角

令牌默认值用途
--radius-sm / --a3s-radius-xs4pxBadge 内部、微型控件
--radius-md / --a3s-radius-sm6pxButton、Input 与导航项
--radius-lg / --a3s-radius-md8px卡片、工具栏与稳定表面
--radius-xl / --a3s-radius-lg12pxDialog、Drawer、Popover 与预览框

药丸形只用于状态、紧凑筛选器、开关轨道和圆形操作,不能成为普通按钮或卡片的默认形状。

阴影

令牌值用途
--a3s-shadow-control0 1px 2px rgb(0 0 0 / 4%), 0 1px 6px rgb(0 0 0 / 3%)选中控件与轻量预览边界
--a3s-shadow-soft0 8px 16px -4px rgb(0 0 0 / 20%)菜单、Popover 与浮动面板
--a3s-shadow0 20px 20px -8px rgb(0 0 0 / 24%)模态 Dialog

深色主题增加不透明度,不添加发亮边框。静态卡片、外壳、目录、任务记录和设置行不使用阴影。同一条边默认只使用清晰边界或浮动阴影,不重复强调。