Button 按钮
基础操作按钮。触发即时操作，支持类型、尺寸、加载、禁用、图标与国风花纹底。
契约源：
lh-ui-core/specs/button.json· 黄金用例：lh-ui-core/cases/button.json（8 条，已翻译为 XCTest，macOS 宿主即可运行）
类型
六种类型决定底色与文字色。
HTML 模拟预览（iOS / SwiftUI 外观），非真机渲染
LhButton(onClick: {}, type: .primary, text: "主要按钮")尺寸
三档尺寸映射到 button.height / paddingHorizontal / fontSize / iconSize 令牌。 iOS 形态为胶囊圆角（radius.round 令牌）。
HTML 模拟预览（iOS / SwiftUI 外观），非真机渲染
状态
禁用与加载中都不触发 onClick；两者共存时按禁用优先处理（黄金用例 disabled-precedes-loading）。
HTML 模拟预览（iOS / SwiftUI 外观），非真机渲染
图标与花纹底
图标名按本地图标体系解析（LhButtonStyle.icon(for:) 映射 SF Symbol：search → magnifyingglass、 refresh → arrow.clockwise、check → checkmark、close → xmark，未登记名不绘制）。 花纹底消费 color.decoration 令牌，Canvas 绘制 45° 斜纹，叠在底色之下、文字之上但不影响对比度。
HTML 模拟预览（iOS / SwiftUI 外观），非真机渲染
明暗主题
切换站点右上角主题，模拟器手机框内的按钮颜色即变；真机通过 LhTheme(isDark: true) 切换。
HTML 模拟预览（iOS / SwiftUI 外观），非真机渲染；明/暗值全部取自 core 令牌快照
API
Props
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
onClick | 点击回调；disabled 或 loading 为 true 时不触发 | () -> Void | — |
type | 按钮类型，决定底色与文字色 | LhButtonType | .default |
size | 按钮尺寸，映射到尺寸令牌 | LhButtonSize | .medium |
disabled | 是否禁用 | Bool | false |
loading | 是否加载中（显示指示器，不触发 onClick） | Bool | false |
icon | 图标名（SF Symbol 映射解析） | String? | nil |
bgPattern | 是否绘制国风花纹底纹 | Bool | false |
label / text | 按钮文字内容（spec 的 default 插槽） | Text / 字符串 | — |
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（32pt） | button.paddingHorizontal.small（16pt） | button.fontSize.small（13pt） | button.iconSize.small（16pt） |
.medium | button.height.medium（40pt） | button.paddingHorizontal.medium（20pt） | button.fontSize.medium（14pt） | button.iconSize.medium（18pt） |
.large | button.height.large（48pt） | button.paddingHorizontal.large（24pt） | button.fontSize.large（16pt） | button.iconSize.large（20pt） |
禁用态覆盖：底色 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，端侧映射 Font.Weight） |
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（LhShadow 载体） |
spacing.xs | 图标与文字间距 |
黄金用例对照
cases/button.json 的 8 条断言与 XCTest 的对应关系：
| case id | 断言 | 本地测试 |
|---|---|---|
click-emits-onclick | gate 放行（可交互） | LhButtonTests.testEnabledButtonIsInteractive |
disabled-blocks-click | 禁用态不可交互 | testDisabledIsNotInteractive |
loading-blocks-click | 加载态不可交互 | testLoadingIsNotInteractive |
disabled-precedes-loading | 禁用优先 + 禁用样式 | testDisabledPrecedesLoading |
default-type-renders-text | 默认类型中性底/文字 | testDefaultTypeUsesNeutralTokens |
primary-type-uses-primary-tokens | 主色类型消费主色令牌 | testPrimaryTypeUsesPrimaryTokens |
small-size-uses-small-tokens | 小号消费 small 尺寸令牌 | testSmallSizeUsesSmallTokens |
bgpattern-uses-decoration-token | 花纹底消费装饰色 | testBgPatternUsesDecorationToken |
另有暗色专项：testDarkColorsComeFromDarkTokens / testDisabledInDarkUsesDarkDisabledTokens / testDimensionsAreIdenticalInDarkMode。
swift test # macOS 宿主即可跑，无需模拟器