Button 按钮

基础操作按钮。触发即时操作，支持类型、尺寸、加载、禁用、图标与国风花纹底。

契约源：lh-ui-core/specs/button.json · 黄金用例：cases/button.json（8 条，已翻译为 JVM 单测 + Compose UI Test）

类型

六种类型决定底色与文字色。

9:41Button 类型

HTML 模拟预览（Android / Compose 外观），非真机渲染

LhButton(type = LhButtonType.Primary, onClick = {}) { Text("主要按钮") }

尺寸

三档尺寸映射到 button.height / paddingHorizontal / fontSize / iconSize 令牌。

9:41Button 尺寸

HTML 模拟预览（Android / Compose 外观），非真机渲染

状态

禁用与加载中都不触发 onClick；两者共存时按禁用优先处理（黄金用例 disabled-precedes-loading）。

9:41Button 状态

HTML 模拟预览（Android / Compose 外观），非真机渲染

图标与花纹底

图标名按本地图标体系解析（LhButtonIcons，当前支持 search / refresh / check / close，未登记名不绘制）。 花纹底消费 color.decoration 令牌，叠在底色之上、文字之下，不影响对比度。

9:41图标与花纹

HTML 模拟预览（Android / Compose 外观），非真机渲染

明暗主题

切换站点右上角主题，模拟器手机框内的按钮颜色即变；真机通过 LhTheme(isDark = true) 切换。

9:41暗色按钮

HTML 模拟预览（Android / Compose 外观），非真机渲染；明/暗值全部取自 core 令牌快照

API

Props

属性	说明	类型	默认值
onClick	点击回调；disabled 或 loading 为 true 时不触发	() -> Unit	—
modifier	修饰符	Modifier	Modifier
type	按钮类型，决定底色与文字色	LhButtonType	Default
size	按钮尺寸，映射到尺寸令牌	LhButtonSize	Medium
disabled	是否禁用	Boolean	false
loading	是否加载中（显示指示器，不触发 onClick）	Boolean	false
icon	图标名（本地图标体系解析）	String?	null
bgPattern	是否绘制国风花纹底纹	Boolean	false
content	按钮文字内容（spec 的 default 插槽）	@Composable () -> Unit	—

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（32dp）	button.paddingHorizontal.small（16dp）	button.fontSize.small（13sp）	button.iconSize.small（16dp）
Medium	button.height.medium（40dp）	button.paddingHorizontal.medium（20dp）	button.fontSize.medium（14sp）	button.iconSize.medium（18dp）
Large	button.height.large（48dp）	button.paddingHorizontal.large（24dp）	button.fontSize.large（16sp）	button.iconSize.large（20dp）

禁用态覆盖：底色 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）
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
motion.duration.fast / motion.easing.easeInOut	按压反馈动效

黄金用例对照

cases/button.json 的 8 条断言与本地测试的对应关系：

case id	断言	本地测试
click-emits-onclick	点击触发 onClick ×1	LhButtonTest.click_emits_onClick（Compose UI Test）
disabled-blocks-click	禁用态不触发	LhButtonTest.disabled_blocks_click
loading-blocks-click	加载态不触发	LhButtonTest.loading_blocks_click
disabled-precedes-loading	禁用优先	LhButtonTest.disabled_precedes_loading_blocks_click + LhButtonDefaultsTest.disabled_precedes_loading
default-type-renders-text	默认类型渲染文字	LhButtonDefaultsTest.default_type_uses_neutral_tokens
primary-type-uses-primary-tokens	主色类型消费主色令牌	LhButtonDefaultsTest.primary_type_uses_primary_tokens
small-size-uses-small-tokens	小号消费 small 尺寸令牌	LhButtonDefaultsTest.small_size_uses_small_tokens
bgpattern-uses-decoration-token	花纹底消费装饰色	LhButtonDefaultsTest.bgPattern_uses_decoration_token
icon-renders-icon-command	已登记图标名渲染矢量；未登记名不绘制	LhButtonDefaultsTest.icon_renders_registered_vector + unknown_icon_name_resolves_to_null

./gradlew :components:button:test                        # JVM 部分
./gradlew :components:button:connectedAndroidTest        # 交互部分（需设备）