StatusBar 状态栏

底部静默信息条：左右分段单元格 + 可点项 + 后台活动旋转指示 + 告警/进度语义色。与 oas-footer（内容页脚）的分工——statusbar 承载状态词汇（聚合计数、当前选中、同步态），footer 是语义化内容页脚。

基础用法

默认插槽放左段单元格（与整个工作区相关的聚合状态），slot="end" 放右段（次要/上下文项，自动推到远端，RTL 镜像）。数值单元格建议 value + label 组合（value 走表格数字体对齐）。全空单元格（label / value / icon / spinning 全缺）整体不渲染（宿主打 data-empty 并退场，无布局足迹，不留间隔位）。

场景计数 + 选中 + 同步态

示例代码

可点单元格（button）

button 布尔属性把单元格渲染为原生 button（键盘可达），点击派发 oas-item-click（detail { value, label }，可在容器或宿主上监听）。

点击单元格触发命令

点左段可点项，观察 oas-item-click 事件反馈。

示例代码

语义色与后台活动（status / spinning）

status 语义档：default / info / warning / error / progress——warning/error 用底色醒目（仅特殊且必要场景慎用，状态栏惯例），info/progress 只着文字色；spinning 显示后台活动旋转指示（prefers-reduced-motion 停转）。

状态语义档

示例代码

图标（icon）

icon 属性从内置图标注册表取图（@oas-ui/icons；未知名不渲染）。

图标单元格

示例代码

RTL

容器 dir="rtl" 下组件自动镜像：data-rtl 钩子 + 全逻辑属性布局，end 段推到书写方向远端。

RTL 镜像

示例代码

API

oas-statusbar

属性

属性	说明	类型	默认值
label	可访问名称（缺省走 i18n「状态栏」）	string	—

插槽

名称	说明
默认	左段状态单元格（与整个工作区相关的聚合状态）
end	右段状态单元格（次要/上下文项，自动推到书写方向远端）

CSS 变量

CSS 变量	默认值
--oas-statusbar-bg	var(--oas-color-bg-elevated)
--oas-statusbar-height	24px

oas-statusbar-item

属性

属性	说明	类型	默认值
button	渲染为原生 button（可点、键盘可达）；缺省为只读 div 语义	boolean	—
icon	内置图标名（@oas-ui/icons 内置图标；未知名不渲染）	string	—
label	文本标签	string	—
spinning	后台活动旋转指示（prefers-reduced-motion 停转）	boolean	—
status	语义色档：default（默认）/ info / warning / error / progress——warning/error 用底色醒目（仅特殊且必要场景慎用），info/progress 只着文字色；非法值回落 default 并告警一次	string	default
value	数值/状态值（表格数字体呈现）	string	—

事件

事件	说明
oas-item-click	button 模式点击时派发；detail { value, label }；bubbles + composed（容器与宿主均可监听）

CSS 变量

CSS 变量	默认值
--oas-statusbar-error-bg	var(--oas-color-danger)
--oas-statusbar-info-color	color-mix(in srgb, var(--oas-color-info-text) 88%, var(--oas-color-text-primary))
--oas-statusbar-item-height	22px
--oas-statusbar-item-hover-bg	var(--oas-color-bg-hover)
--oas-statusbar-progress-color	var(--oas-color-primary-text)
--oas-statusbar-warning-bg	var(--oas-color-warning)