Button 按钮
基础操作按钮。触发即时操作，支持类型、尺寸、加载、禁用、图标与国风花纹底。
契约源：
lh-ui-core/specs/button.json· 黄金用例：lh-ui-core/cases/button.json（8 条，已翻译为 hypium 测试）
类型
六种类型决定底色与文字色。
HTML 模拟预览（鸿蒙 / ArkUI 外观），非真机渲染
LhButton({ onClick: () => {}, type: LhButtonType.Primary, text: '主要按钮' })尺寸
三档尺寸映射到 button.height / paddingHorizontal / fontSize / iconSize 令牌。
HTML 模拟预览（鸿蒙 / ArkUI 外观），非真机渲染
状态
禁用与加载中都不触发 onClick；两者共存时按禁用优先处理（黄金用例 disabled-precedes-loading）。
HTML 模拟预览（鸿蒙 / ArkUI 外观），非真机渲染
图标与花纹底
图标名按本地图标体系解析（LhButtonTokens.iconFor，当前支持 search / refresh / check / close， 未登记名不绘制）。花纹底消费 color.decoration 令牌，Canvas 绘制 45° 斜纹。
HTML 模拟预览（鸿蒙 / ArkUI 外观），非真机渲染
明暗主题
切换站点右上角主题，模拟器手机框内的按钮颜色即变；真机通过 LhTheme.apply(true) 切换。
HTML 模拟预览（鸿蒙 / ArkUI 外观），非真机渲染；明/暗值全部取自 core 令牌快照
API
Props
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
onClick | 点击回调；disabled 或 loading 为 true 时不触发 | () => void | 空函数 |
type | 按钮类型，决定底色与文字色 | LhButtonType | Default |
size | 按钮尺寸，映射到尺寸令牌 | LhButtonSize | Medium |
disabled | 是否禁用 | boolean | false |
loading | 是否加载中（显示指示器，不触发 onClick） | boolean | false |
icon | 图标名（本地图标体系解析） | string? | undefined |
bgPattern | 是否绘制国风花纹底纹 | boolean | false |
text | 按钮文字内容（spec 的 default 插槽） | string | '' |
LhButtonType
| 值 | 底色 | 文字色 |
|---|---|---|
Default | color.background.default | color.text.primary |
Primary | color.primary.default | color.onPrimary |
Success | color.success.default | color.onPrimary |
Warning | color.warning.default | color.onPrimary |
Danger | color.danger.default | color.onPrimary |
Info | color.info.default | color.onPrimary |
LhButtonSize
| 值 | height | paddingHorizontal | fontSize | iconSize |
|---|---|---|---|---|
Small | button.height.small（32vp） | button.paddingHorizontal.small（16vp） | button.fontSize.small（13） | button.iconSize.small（16） |
Medium | button.height.medium（40vp） | button.paddingHorizontal.medium（20vp） | button.fontSize.medium（14） | button.iconSize.medium（18） |
Large | button.height.large（48vp） | button.paddingHorizontal.large（24vp） | button.fontSize.large（16） | button.iconSize.large（20） |
禁用态覆盖：底色 color.disabled.bg、文字 color.disabled.text、描边 color.disabled.border。
令牌对照
按钮消费的令牌（与 specs/button.json 的 tokenRefs 逐条对齐）：
| 令牌 | 用途 |
|---|---|
button.height.{small,medium,large} | 三档高度 |
button.paddingHorizontal.{small,medium,large} | 三档横向内边距 |
button.fontSize.{small,medium,large} | 三档字号 |
button.iconSize.{small,medium,large} | 三档图标尺寸 |
button.borderRadius / button.borderWidth | 圆角（跟随 radius.base）与描边宽度 |
button.fontWeight | 字重（跟随 typography.fontWeight.primary，端侧映射 FontWeight） |
color.primary.default / color.onPrimary | 主色类型底/文字 |
color.{success,warning,danger,info}.default | 语义类型底色 |
color.background.default / color.text.primary / color.border.base | 默认类型底/文字/描边 |
color.disabled.{bg,text,border} | 禁用态三色 |
color.decoration | 花纹底纹色 |
shadow.lighter | 默认 elevation（LhTokens.Shadow.lighter） |
黄金用例对照
cases/button.json 的 8 条断言与 hypium 测试的对应关系（entry/src/test/Button.test.ets）：
| case id | 断言 | 本地测试 |
|---|---|---|
click-emits-onclick | gate 放行（可交互） | enabled_button_is_interactive |
disabled-blocks-click | 禁用态不可交互 | disabled_is_not_interactive |
loading-blocks-click | 加载态不可交互 | loading_is_not_interactive |
disabled-precedes-loading | 禁用优先 + 禁用样式 | disabled_precedes_loading |
default-type-renders-text | 默认类型中性底/文字 | default_type_uses_neutral_tokens |
primary-type-uses-primary-tokens | 主色类型消费主色令牌 | primary_type_uses_primary_tokens |
small-size-uses-small-tokens | 小号消费 small 尺寸令牌 | small_size_uses_small_tokens |
bgpattern-uses-decoration-token | 花纹底消费装饰色 | bgpattern_uses_decoration_token |
另有暗色专项：dark_colors_come_from_dark_tokens / dimensions_are_identical_in_dark_mode。 运行：DevEco Studio 右键 entry/src/test → Run Tests。