跳到正文
小小东 UI

组件 · 操作 · 原生 HTML 与 React

按钮 Button

按钮文字描述下一次点击会做什么。一处只放一个实心按钮。

演示

尺寸

图标按钮

纯图标按钮必须有 aria-label;悬停时 tooltip 连续出现。圆形图标按钮跟随圆角开关。

纯平 / 质感(D1 对比)

右上角「主色」里把按钮质感切到「质感」:实心按钮多一条顶部 1px 内高光、深一点的边,按下时下沉 0.5px。

进行中与完成

点一下:宽度不跳,转圈居中;完成后图标变勾 1 秒。

状态

同一个元素的各种状态并排。悬停、聚焦、按下用的是组件 CSS 里真实的规则(构建时复制成强制状态),不是手画的。

默认
悬停
键盘聚焦
按下
禁用
进行中

属性与类名

属性 / 类名说明
data-variantprimary | secondary(缺省)| ghost | outline | danger | danger-outline
data-sizexs | sm | md | lg
data-icon-only纯图标(必须有 aria-label)
aria-pressed切换态
aria-busy进行中:宽度不跳,转圈居中;Xxd.runBusy(btn, task) 完成后图标变勾
data-block撑满一行
data-shaperound:圆形图标按钮(跟随圆角开关)
类名xxd-btn xxd-label-text

JS

await Xxd.runBusy(button, () => save())

键盘与读屏

规则