@apexhub/apex-ui-react 0.0.0-stage → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (185) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/en_US.d.ts +191 -0
  4. package/dist/index.cjs +40692 -0
  5. package/dist/index.d.ts +6869 -0
  6. package/dist/index.mjs +40676 -0
  7. package/dist/llm/alert.tokens.txt +44 -0
  8. package/dist/llm/alert.txt +167 -0
  9. package/dist/llm/apex-provider.txt +368 -0
  10. package/dist/llm/auto-complete.tokens.txt +77 -0
  11. package/dist/llm/auto-complete.txt +373 -0
  12. package/dist/llm/avatar.tokens.txt +38 -0
  13. package/dist/llm/avatar.txt +199 -0
  14. package/dist/llm/breadcrumb.tokens.txt +193 -0
  15. package/dist/llm/breadcrumb.txt +251 -0
  16. package/dist/llm/button.tokens.txt +470 -0
  17. package/dist/llm/button.txt +262 -0
  18. package/dist/llm/card.tokens.txt +27 -0
  19. package/dist/llm/card.txt +95 -0
  20. package/dist/llm/cascader.tokens.txt +253 -0
  21. package/dist/llm/cascader.txt +898 -0
  22. package/dist/llm/checkbox.tokens.txt +28 -0
  23. package/dist/llm/checkbox.txt +332 -0
  24. package/dist/llm/collapse.tokens.txt +84 -0
  25. package/dist/llm/collapse.txt +330 -0
  26. package/dist/llm/date-picker.tokens.txt +171 -0
  27. package/dist/llm/date-picker.txt +424 -0
  28. package/dist/llm/divider.tokens.txt +22 -0
  29. package/dist/llm/divider.txt +161 -0
  30. package/dist/llm/drawer.tokens.txt +71 -0
  31. package/dist/llm/drawer.txt +369 -0
  32. package/dist/llm/dropdown.tokens.txt +59 -0
  33. package/dist/llm/dropdown.txt +420 -0
  34. package/dist/llm/form.tokens.txt +26 -0
  35. package/dist/llm/form.txt +341 -0
  36. package/dist/llm/grid.txt +419 -0
  37. package/dist/llm/image.tokens.txt +28 -0
  38. package/dist/llm/image.txt +428 -0
  39. package/dist/llm/input-number.tokens.txt +159 -0
  40. package/dist/llm/input-number.txt +486 -0
  41. package/dist/llm/input.tokens.txt +136 -0
  42. package/dist/llm/input.txt +422 -0
  43. package/dist/llm/layout.tokens.txt +29 -0
  44. package/dist/llm/layout.txt +298 -0
  45. package/dist/llm/menu.tokens.txt +87 -0
  46. package/dist/llm/menu.txt +680 -0
  47. package/dist/llm/message.tokens.txt +25 -0
  48. package/dist/llm/message.txt +301 -0
  49. package/dist/llm/modal.tokens.txt +96 -0
  50. package/dist/llm/modal.txt +584 -0
  51. package/dist/llm/notification.tokens.txt +79 -0
  52. package/dist/llm/notification.txt +383 -0
  53. package/dist/llm/pagination.tokens.txt +33 -0
  54. package/dist/llm/pagination.txt +208 -0
  55. package/dist/llm/popover.tokens.txt +28 -0
  56. package/dist/llm/popover.txt +233 -0
  57. package/dist/llm/progress.tokens.txt +83 -0
  58. package/dist/llm/progress.txt +279 -0
  59. package/dist/llm/radio.tokens.txt +21 -0
  60. package/dist/llm/radio.txt +348 -0
  61. package/dist/llm/rate.tokens.txt +20 -0
  62. package/dist/llm/rate.txt +241 -0
  63. package/dist/llm/select.tokens.txt +160 -0
  64. package/dist/llm/select.txt +830 -0
  65. package/dist/llm/skeleton.tokens.txt +15 -0
  66. package/dist/llm/skeleton.txt +275 -0
  67. package/dist/llm/spin.tokens.txt +21 -0
  68. package/dist/llm/spin.txt +294 -0
  69. package/dist/llm/steps.tokens.txt +30 -0
  70. package/dist/llm/steps.txt +300 -0
  71. package/dist/llm/switch.tokens.txt +38 -0
  72. package/dist/llm/switch.txt +216 -0
  73. package/dist/llm/table.tokens.txt +94 -0
  74. package/dist/llm/table.txt +1046 -0
  75. package/dist/llm/tabs.tokens.txt +78 -0
  76. package/dist/llm/tabs.txt +306 -0
  77. package/dist/llm/tag.tokens.txt +76 -0
  78. package/dist/llm/tag.txt +305 -0
  79. package/dist/llm/tooltip.tokens.txt +22 -0
  80. package/dist/llm/tooltip.txt +304 -0
  81. package/dist/llm/tree-select.tokens.txt +174 -0
  82. package/dist/llm/tree-select.txt +762 -0
  83. package/dist/llm/tree.tokens.txt +36 -0
  84. package/dist/llm/tree.txt +505 -0
  85. package/dist/llm/typography.tokens.txt +60 -0
  86. package/dist/llm/typography.txt +413 -0
  87. package/dist/llm/upload.tokens.txt +201 -0
  88. package/dist/llm/upload.txt +706 -0
  89. package/dist/llms-full.txt +16689 -0
  90. package/dist/llms-theme.txt +32 -0
  91. package/dist/llms.txt +59 -0
  92. package/dist/locale/en_US.cjs +160 -0
  93. package/dist/locale/en_US.d.ts +4 -0
  94. package/dist/locale/en_US.mjs +161 -0
  95. package/dist/locale/zh_CN.cjs +160 -0
  96. package/dist/locale/zh_CN.d.ts +4 -0
  97. package/dist/locale/zh_CN.mjs +161 -0
  98. package/dist/style.css +19619 -0
  99. package/dist/zh_CN.d.ts +191 -0
  100. package/llms-full.txt +16689 -0
  101. package/llms-theme.txt +32 -0
  102. package/llms.txt +59 -0
  103. package/package.json +118 -3
  104. package/src/alert/llm.txt +167 -0
  105. package/src/alert/tokens.txt +44 -0
  106. package/src/apex-provider/llm.txt +368 -0
  107. package/src/auto-complete/llm.txt +373 -0
  108. package/src/auto-complete/tokens.txt +77 -0
  109. package/src/avatar/llm.txt +199 -0
  110. package/src/avatar/tokens.txt +38 -0
  111. package/src/breadcrumb/llm.txt +251 -0
  112. package/src/breadcrumb/tokens.txt +193 -0
  113. package/src/button/llm.txt +262 -0
  114. package/src/button/tokens.txt +470 -0
  115. package/src/card/llm.txt +95 -0
  116. package/src/card/tokens.txt +27 -0
  117. package/src/cascader/llm.txt +898 -0
  118. package/src/cascader/tokens.txt +253 -0
  119. package/src/checkbox/llm.txt +332 -0
  120. package/src/checkbox/tokens.txt +28 -0
  121. package/src/collapse/llm.txt +330 -0
  122. package/src/collapse/tokens.txt +84 -0
  123. package/src/date-picker/llm.txt +424 -0
  124. package/src/date-picker/tokens.txt +171 -0
  125. package/src/divider/llm.txt +161 -0
  126. package/src/divider/tokens.txt +22 -0
  127. package/src/drawer/llm.txt +369 -0
  128. package/src/drawer/tokens.txt +71 -0
  129. package/src/dropdown/llm.txt +420 -0
  130. package/src/dropdown/tokens.txt +59 -0
  131. package/src/form/llm.txt +341 -0
  132. package/src/form/tokens.txt +26 -0
  133. package/src/grid/llm.txt +419 -0
  134. package/src/image/llm.txt +428 -0
  135. package/src/image/tokens.txt +28 -0
  136. package/src/input/llm.txt +422 -0
  137. package/src/input/tokens.txt +136 -0
  138. package/src/input-number/llm.txt +486 -0
  139. package/src/input-number/tokens.txt +159 -0
  140. package/src/layout/llm.txt +298 -0
  141. package/src/layout/tokens.txt +29 -0
  142. package/src/menu/llm.txt +680 -0
  143. package/src/menu/tokens.txt +87 -0
  144. package/src/message/llm.txt +301 -0
  145. package/src/message/tokens.txt +25 -0
  146. package/src/modal/llm.txt +584 -0
  147. package/src/modal/tokens.txt +96 -0
  148. package/src/notification/llm.txt +383 -0
  149. package/src/notification/tokens.txt +79 -0
  150. package/src/pagination/llm.txt +208 -0
  151. package/src/pagination/tokens.txt +33 -0
  152. package/src/popover/llm.txt +233 -0
  153. package/src/popover/tokens.txt +28 -0
  154. package/src/progress/llm.txt +279 -0
  155. package/src/progress/tokens.txt +83 -0
  156. package/src/radio/llm.txt +348 -0
  157. package/src/radio/tokens.txt +21 -0
  158. package/src/rate/llm.txt +241 -0
  159. package/src/rate/tokens.txt +20 -0
  160. package/src/select/llm.txt +830 -0
  161. package/src/select/tokens.txt +160 -0
  162. package/src/skeleton/llm.txt +275 -0
  163. package/src/skeleton/tokens.txt +15 -0
  164. package/src/spin/llm.txt +294 -0
  165. package/src/spin/tokens.txt +21 -0
  166. package/src/steps/llm.txt +300 -0
  167. package/src/steps/tokens.txt +30 -0
  168. package/src/switch/llm.txt +216 -0
  169. package/src/switch/tokens.txt +38 -0
  170. package/src/table/llm.txt +1046 -0
  171. package/src/table/tokens.txt +94 -0
  172. package/src/tabs/llm.txt +306 -0
  173. package/src/tabs/tokens.txt +78 -0
  174. package/src/tag/llm.txt +305 -0
  175. package/src/tag/tokens.txt +76 -0
  176. package/src/tooltip/llm.txt +304 -0
  177. package/src/tooltip/tokens.txt +22 -0
  178. package/src/tree/llm.txt +505 -0
  179. package/src/tree/tokens.txt +36 -0
  180. package/src/tree-select/llm.txt +762 -0
  181. package/src/tree-select/tokens.txt +174 -0
  182. package/src/typography/llm.txt +413 -0
  183. package/src/typography/tokens.txt +60 -0
  184. package/src/upload/llm.txt +706 -0
  185. package/src/upload/tokens.txt +201 -0
@@ -0,0 +1,253 @@
1
+ # Cascader Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--checkbox-fill-checked` | `fill`、`outline` | `var(--apex-fill-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
14
+ | `--checkbox-fill-indeterminate` | `fill` | `var(--apex-fill-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
15
+ | `--checkbox-group-spacing-gap-x` | `column-gap` | `var(--apex-spacing-12)` | `.apex-checkbox-group.apex-default-checkbox-group` |
16
+ | `--checkbox-group-spacing-gap-y` | `row-gap` | `var(--apex-spacing-8)` | `.apex-checkbox-group.apex-default-checkbox-group` |
17
+ | `--checkbox-icon-checked` | `color` | `var(--apex-icon-neutral-quaternary-stable)` | `.apex-checkbox.apex-default-checkbox` |
18
+ | `--checkbox-icon-icon-md` | `height`、`width` | `var(--apex-size-20)` | `.apex-checkbox.apex-default-checkbox` |
19
+ | `--checkbox-icon-indeterminate` | `color` | `var(--apex-icon-neutral-quaternary-stable)` | `.apex-checkbox.apex-default-checkbox` |
20
+ | `--checkbox-radius-radius` | `border-radius` | `var(--apex-radius-4)` | `.apex-checkbox.apex-default-checkbox` |
21
+ | `--checkbox-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-checkbox.apex-default-checkbox` |
22
+ | `--checkbox-stroke-checked` | `color` | `var(--apex-stroke-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
23
+ | `--checkbox-stroke-default` | `color` | `var(--apex-stroke-neutral-denary)` | `.apex-checkbox.apex-default-checkbox` |
24
+ | `--checkbox-stroke-disabled` | `color`、`fill` | `var(--apex-stroke-neutral-quinary)` | `.apex-checkbox.apex-default-checkbox` |
25
+ | `--checkbox-stroke-hover` | `color` | `var(--apex-stroke-neutral-octonary)` | `.apex-checkbox.apex-default-checkbox` |
26
+ | `--checkbox-stroke-indeterminate` | `color` | `var(--apex-stroke-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
27
+ | `--checkbox-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-checkbox.apex-default-checkbox` |
28
+ | `--checkbox-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-checkbox.apex-default-checkbox` |
29
+ | `--dropdown-fill-active` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-dropdown.apex-default-dropdown` |
30
+ | `--dropdown-fill-container-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-dropdown.apex-default-dropdown` |
31
+ | `--dropdown-fill-default` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
32
+ | `--dropdown-fill-disabled` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
33
+ | `--dropdown-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-dropdown.apex-default-dropdown` |
34
+ | `--dropdown-fill-loading` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-dropdown.apex-default-dropdown` |
35
+ | `--dropdown-fill-selected` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
36
+ | `--dropdown-icon-active` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
37
+ | `--dropdown-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
38
+ | `--dropdown-icon-disabled` | `color` | `var(--apex-icon-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
39
+ | `--dropdown-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
40
+ | `--dropdown-icon-item` | `height`、`width` | `var(--apex-icon-16)` | `.apex-dropdown.apex-lg-dropdown` |
41
+ | `--dropdown-icon-item` | `height`、`width` | `var(--apex-icon-16)` | `.apex-dropdown.apex-sm-dropdown` |
42
+ | `--dropdown-icon-loading` | `color` | `var(--apex-icon-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
43
+ | `--dropdown-icon-selected` | `color` | `var(--apex-icon-brand-primary)` | `.apex-dropdown.apex-default-dropdown` |
44
+ | `--dropdown-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-lg-dropdown` |
45
+ | `--dropdown-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-sm-dropdown` |
46
+ | `--dropdown-radius-item` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-lg-dropdown` |
47
+ | `--dropdown-radius-item` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-sm-dropdown` |
48
+ | `--dropdown-size-container-gap` | `gap` | `var(--apex-spacing-2)` | `.apex-dropdown.apex-lg-dropdown` |
49
+ | `--dropdown-size-container-gap` | `gap` | `var(--apex-spacing-2)` | `.apex-dropdown.apex-sm-dropdown` |
50
+ | `--dropdown-size-container-height-max` | `max-height` | `var(--apex-size-320)` | `.apex-dropdown.apex-lg-dropdown` |
51
+ | `--dropdown-size-container-height-max` | `max-height` | `var(--apex-size-320)` | `.apex-dropdown.apex-sm-dropdown` |
52
+ | `--dropdown-size-item-gap-check-min-item` | `padding-left` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-lg-dropdown` |
53
+ | `--dropdown-size-item-gap-check-min-item` | `padding-left` | `var(--apex-spacing-8)` | `.apex-dropdown.apex-sm-dropdown` |
54
+ | `--dropdown-size-item-gap-item` | `gap` | `var(--apex-spacing-4)` | `.apex-dropdown.apex-lg-dropdown` |
55
+ | `--dropdown-size-item-gap-item` | `gap` | `var(--apex-spacing-4)` | `.apex-dropdown.apex-sm-dropdown` |
56
+ | `--dropdown-size-item-height-item` | `min-height` | `var(--apex-size-32)` | `.apex-dropdown.apex-lg-dropdown` |
57
+ | `--dropdown-size-item-height-item` | `min-height` | `var(--apex-size-24)` | `.apex-dropdown.apex-sm-dropdown` |
58
+ | `--dropdown-size-item-width-min-item` | `min-width` | `var(--apex-size-80)` | `.apex-dropdown.apex-lg-dropdown` |
59
+ | `--dropdown-size-item-width-min-item` | `min-width` | `var(--apex-size-80)` | `.apex-dropdown.apex-sm-dropdown` |
60
+ | `--dropdown-spacing-container-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-lg-dropdown` |
61
+ | `--dropdown-spacing-container-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-sm-dropdown` |
62
+ | `--dropdown-spacing-container-padding-y` | `max-height`、`padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-lg-dropdown` |
63
+ | `--dropdown-spacing-container-padding-y` | `max-height`、`padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-sm-dropdown` |
64
+ | `--dropdown-spacing-item-padding-x-item` | `padding`、`padding-inline` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-lg-dropdown` |
65
+ | `--dropdown-spacing-item-padding-x-item` | `padding`、`padding-inline` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-sm-dropdown` |
66
+ | `--dropdown-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-dropdown.apex-lg-dropdown` |
67
+ | `--dropdown-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-dropdown.apex-sm-dropdown` |
68
+ | `--dropdown-stroke-container-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-dropdown.apex-default-dropdown` |
69
+ | `--dropdown-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
70
+ | `--dropdown-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
71
+ | `--dropdown-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
72
+ | `--dropdown-text-hover` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
73
+ | `--dropdown-text-loading` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
74
+ | `--dropdown-text-selected` | `color` | `var(--apex-text-brand-primary)` | `.apex-dropdown.apex-default-dropdown` |
75
+ | `--dropdown-text-subtitle-default` | `color` | `var(--apex-text-neutral-alpha-primary)` | `.apex-dropdown.apex-default-dropdown` |
76
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-cn-body-font` |
77
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-cn-caption-font` |
78
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-cn-heading-1-font` |
79
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-cn-heading-2-font` |
80
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-3-font` |
81
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-4-font` |
82
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-en-body-font` |
83
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-en-caption-font` |
84
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-en-heading-1-font` |
85
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-en-heading-2-font` |
86
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-3-font` |
87
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-4-font` |
88
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-cn-body-font` |
89
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-cn-caption-font` |
90
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-cn-heading-1-font` |
91
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-cn-heading-2-font` |
92
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-3-font` |
93
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-4-font` |
94
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-en-body-font` |
95
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-en-caption-font` |
96
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-en-heading-1-font` |
97
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-en-heading-2-font` |
98
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-3-font` |
99
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-4-font` |
100
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-body-font` |
101
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-caption-font` |
102
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-1-font` |
103
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-2-font` |
104
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-8)` | `.apex-font.apex-text-cn-heading-3-font` |
105
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-4-font` |
106
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-body-font` |
107
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-caption-font` |
108
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-1-font` |
109
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-2-font` |
110
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-3-font` |
111
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-4-font` |
112
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-body-font` |
113
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-caption-font` |
114
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-1-font` |
115
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-2-font` |
116
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-3-font` |
117
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-heading-4-font` |
118
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-body-font` |
119
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-caption-font` |
120
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-1-font` |
121
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-2-font` |
122
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-3-font` |
123
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-heading-4-font` |
124
+ | `--input-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
125
+ | `--input-fill-default` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
126
+ | `--input-fill-disabled` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
127
+ | `--input-fill-disabled` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
128
+ | `--input-fill-error` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
129
+ | `--input-fill-error` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
130
+ | `--input-fill-focused` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-input.apex-default-input` |
131
+ | `--input-fill-focused` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
132
+ | `--input-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-default-input` |
133
+ | `--input-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
134
+ | `--input-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
135
+ | `--input-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
136
+ | `--input-icon-disabled` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-input.apex-default-input` |
137
+ | `--input-icon-disabled` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
138
+ | `--input-icon-error` | `color` | `var(--apex-icon-error-primary)` | `.apex-input.apex-default-input` |
139
+ | `--input-icon-error` | `color` | `var(--apex-icon-error-primary)` | `.apex-input.apex-elevated-input` |
140
+ | `--input-icon-focused` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
141
+ | `--input-icon-focused` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
142
+ | `--input-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
143
+ | `--input-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
144
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-16)` | `.apex-input.apex-lg-input` |
145
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-16)` | `.apex-input.apex-md-input` |
146
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-14)` | `.apex-input.apex-sm-input` |
147
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-lg-input` |
148
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-md-input` |
149
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-sm-input` |
150
+ | `--input-spacing-char-counter-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-input.apex-textarea-input` |
151
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-lg-input` |
152
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-md-input` |
153
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-sm-input` |
154
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-44)` | `.apex-input.apex-lg-input` |
155
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-32)` | `.apex-input.apex-md-input` |
156
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-24)` | `.apex-input.apex-sm-input` |
157
+ | `--input-spacing-height-max` | `max-height` | `var(--apex-size-130)` | `.apex-input.apex-textarea-input` |
158
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-lg-input` |
159
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-md-input` |
160
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-8)` | `.apex-input.apex-sm-input` |
161
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-textarea-input` |
162
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-12)` | `.apex-input.apex-lg-input` |
163
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-6)` | `.apex-input.apex-md-input` |
164
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-4)` | `.apex-input.apex-sm-input` |
165
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-6)` | `.apex-input.apex-textarea-input` |
166
+ | `--input-spacing-width-min` | `min-width` | `var(--apex-size-120)` | `.apex-input.apex-lg-input` |
167
+ | `--input-spacing-width-min` | `min-width` | `var(--apex-size-120)` | `.apex-input.apex-md-input` |
168
+ | `--input-spacing-width-min` | `min-width` | `var(--apex-size-120)` | `.apex-input.apex-sm-input` |
169
+ | `--input-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-default-input` |
170
+ | `--input-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-elevated-input` |
171
+ | `--input-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-default-input` |
172
+ | `--input-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-elevated-input` |
173
+ | `--input-stroke-error` | `border-color` | `var(--apex-stroke-error-primary)` | `.apex-input.apex-default-input` |
174
+ | `--input-stroke-error` | `border-color` | `var(--apex-stroke-error-primary)` | `.apex-input.apex-elevated-input` |
175
+ | `--input-stroke-focused` | `border-color` | `var(--apex-stroke-brand-primary)` | `.apex-input.apex-default-input` |
176
+ | `--input-stroke-focused` | `border-color` | `var(--apex-stroke-brand-primary)` | `.apex-input.apex-elevated-input` |
177
+ | `--input-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-input.apex-default-input` |
178
+ | `--input-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-input.apex-elevated-input` |
179
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-lg-input` |
180
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-md-input` |
181
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-sm-input` |
182
+ | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
183
+ | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
184
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-secondary)` | `.apex-input.apex-default-input` |
185
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
186
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
187
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
188
+ | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
189
+ | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
190
+ | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
191
+ | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
192
+ | `--input-text-placeholder-default` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
193
+ | `--input-text-placeholder-default` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
194
+ | `--input-text-placeholder-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-default-input` |
195
+ | `--input-text-placeholder-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
196
+ | `--input-text-placeholder-error` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
197
+ | `--input-text-placeholder-error` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
198
+ | `--input-text-placeholder-focused` | `color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
199
+ | `--input-text-placeholder-focused` | `color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
200
+ | `--input-text-placeholder-hover` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
201
+ | `--input-text-placeholder-hover` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
202
+ | `--tag-active` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-tag.apex-close-tag` |
203
+ | `--tag-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-close-tag` |
204
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-brand-alpha-secondary)` | `.apex-tag.apex-filled-default-brand-tag` |
205
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-tag.apex-filled-default-default-tag` |
206
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-error-alpha-secondary)` | `.apex-tag.apex-filled-default-error-tag` |
207
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-tag.apex-filled-default-grey-tag` |
208
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-success-alpha-secondary)` | `.apex-tag.apex-filled-default-success-tag` |
209
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-warning-alpha-secondary)` | `.apex-tag.apex-filled-default-warning-tag` |
210
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-tag.apex-outlined-default-tag` |
211
+ | `--tag-hover` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-tag.apex-close-tag` |
212
+ | `--tag-icon-default` | `color` | `var(--apex-icon-brand-primary)` | `.apex-tag.apex-filled-default-brand-tag` |
213
+ | `--tag-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-filled-default-default-tag` |
214
+ | `--tag-icon-default` | `color` | `var(--apex-icon-error-primary)` | `.apex-tag.apex-filled-default-error-tag` |
215
+ | `--tag-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-filled-default-grey-tag` |
216
+ | `--tag-icon-default` | `color` | `var(--apex-icon-success-primary)` | `.apex-tag.apex-filled-default-success-tag` |
217
+ | `--tag-icon-default` | `color` | `var(--apex-icon-warning-primary)` | `.apex-tag.apex-filled-default-warning-tag` |
218
+ | `--tag-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-outlined-default-tag` |
219
+ | `--tag-icon-icon` | `font-size`、`height`、`width` | `var(--apex-icon-20)` | `.apex-tag.apex-lg-tag` |
220
+ | `--tag-icon-icon` | `font-size`、`height`、`width` | `var(--apex-icon-16)` | `.apex-tag.apex-md-tag` |
221
+ | `--tag-icon-icon` | `font-size`、`height`、`width` | `var(--apex-icon-16)` | `.apex-tag.apex-sm-tag` |
222
+ | `--tag-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tag.apex-lg-tag` |
223
+ | `--tag-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tag.apex-md-tag` |
224
+ | `--tag-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tag.apex-sm-tag` |
225
+ | `--tag-size-height` | `height` | `var(--apex-size-28)` | `.apex-tag.apex-lg-tag` |
226
+ | `--tag-size-height` | `height` | `var(--apex-size-24)` | `.apex-tag.apex-md-tag` |
227
+ | `--tag-size-height` | `height` | `var(--apex-size-20)` | `.apex-tag.apex-sm-tag` |
228
+ | `--tag-size-width-max` | `max-width` | `var(--apex-size-180)` | `.apex-tag.apex-lg-tag` |
229
+ | `--tag-size-width-max` | `max-width` | `var(--apex-size-180)` | `.apex-tag.apex-md-tag` |
230
+ | `--tag-size-width-max` | `max-width` | `var(--apex-size-180)` | `.apex-tag.apex-sm-tag` |
231
+ | `--tag-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tag.apex-lg-tag` |
232
+ | `--tag-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tag.apex-md-tag` |
233
+ | `--tag-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tag.apex-sm-tag` |
234
+ | `--tag-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-tag.apex-lg-tag` |
235
+ | `--tag-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-tag.apex-md-tag` |
236
+ | `--tag-spacing-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-tag.apex-sm-tag` |
237
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-brand-transparent)` | `.apex-tag.apex-filled-default-brand-tag` |
238
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tag.apex-filled-default-default-tag` |
239
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-error-transparent)` | `.apex-tag.apex-filled-default-error-tag` |
240
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tag.apex-filled-default-grey-tag` |
241
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-success-transparent)` | `.apex-tag.apex-filled-default-success-tag` |
242
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-warning-transparent)` | `.apex-tag.apex-filled-default-warning-tag` |
243
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-tag.apex-outlined-default-tag` |
244
+ | `--tag-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tag.apex-lg-tag` |
245
+ | `--tag-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tag.apex-md-tag` |
246
+ | `--tag-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tag.apex-sm-tag` |
247
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-brand-tag` |
248
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-default-tag` |
249
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-error-tag` |
250
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-grey-tag` |
251
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-success-tag` |
252
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-warning-tag` |
253
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tag.apex-outlined-default-tag` |
@@ -0,0 +1,332 @@
1
+ # Checkbox
2
+
3
+ > Checkbox:用户可从多个选项中任选零个、一个或多个时(与 Radio 互斥单选相对)。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Checkbox`、`CheckboxGroup`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Checkbox } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => <Checkbox>Apex UI</Checkbox>
19
+ ```
20
+
21
+ ## 何时使用
22
+
23
+ - 用户可从多个选项中任选零个、一个或多个时(与 Radio 互斥单选相对)。
24
+ - 需要「全选 / 半选 / 全不选」父子联动时,父级使用 `indeterminate`。
25
+ - 若只能选一个,请使用 Radio 或 Radio.Group。
26
+
27
+ ## API
28
+
29
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
30
+
31
+ ### Checkbox
32
+
33
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
34
+ | --- | --- | --- | --- | --- |
35
+ | value | 在 `Checkbox.Group` 内作为子项时,标识该项对应取值(与组 `value` 数组比较) | `string \| number \| boolean` | 否 | — |
36
+ | checked | 是否选中(受控) | `boolean` | 否 | `false` |
37
+ | defaultChecked | 初始是否选中(非受控) | `boolean` | 否 | `false` |
38
+ | indeterminate | 半选(不确定)态,常用于全选父级;与 `checked` 并列,由实现合成 indeterminate 视觉态 | `boolean` | 否 | `false` |
39
+ | onChange | 状态变化时的回调 | `(event: CheckboxChangeEvent) => void` | 否 | — |
40
+ | classNames | 为各语义子结构自定义 `className`,支持对象或函数 | `Partial<Record<CheckboxSemanticDOM, string>> \| ((info: { props: Readonly<CheckboxProps> }) => Partial<Record<CheckboxSemanticDOM, string>>)` | 否 | — |
41
+ | styles | 为各语义子结构自定义内联样式(仅允许 CSS Token 等变量赋值,禁止业务硬编码色值) | `Partial<Record<CheckboxSemanticDOM, React.CSSProperties>> \| ((info: { props: Readonly<CheckboxProps> }) => Partial<Record<CheckboxSemanticDOM, React.CSSProperties>>)` | 否 | — |
42
+ | children | 主文案或与勾选框并排展示的内容 | `React.ReactNode` | 否 | — |
43
+
44
+ ### RadixCheckboxRootProps
45
+
46
+ ```typescript
47
+ type RadixCheckboxRootProps = React.ComponentProps<typeof Checkbox.Root>
48
+ ```
49
+
50
+ ### CheckboxSemanticDOM
51
+
52
+ Checkbox 子结构语义,用于 `classNames` / `styles` 分段定制
53
+
54
+ ```typescript
55
+ type CheckboxSemanticDOM = 'root' | 'indicator'
56
+ ```
57
+
58
+ ### CheckboxOption
59
+
60
+ `Checkbox.Group` 的 `options` 项描述(`title` / `className` / `style` 作用于单个选项)
61
+
62
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
63
+ | --- | --- | --- | --- | --- |
64
+ | value | 选项值,出现在组的 `value` 与 `onChange` 回调数组中 | `string \| number \| boolean` | 是 | — |
65
+ | label | 展示文案;省略时可对 `value` 做字符串化 | `React.ReactNode` | 否 | — |
66
+ | title | 选项原生 `title`(悬停提示) | `string` | 否 | — |
67
+ | className | 选项根节点 `className` | `string` | 否 | — |
68
+ | style | 选项根节点样式(仅允许 CSS Token 等变量赋值,禁止业务硬编码色值) | `React.CSSProperties` | 否 | — |
69
+ | disabled | 是否禁用该选项 | `boolean` | 否 | — |
70
+
71
+ ### CheckboxChangeTarget
72
+
73
+ 继承:`EventTarget`;本节列出新增或重声明字段。
74
+
75
+ 变更事件目标:通过 `target.checked` 读取是否选中;
76
+
77
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
78
+ | --- | --- | --- | --- | --- |
79
+ | checked | 是否选中(确定态) | `boolean` | 是 | — |
80
+ | indeterminate | 是否为半选(不确定)态 | `boolean` | 否 | — |
81
+
82
+ ### CheckboxChangeEvent
83
+
84
+ 继承:`React.SyntheticEvent<HTMLButtonElement, Event>`;本节列出新增或重声明字段。
85
+
86
+ 选中状态变更时的回调事件对象
87
+
88
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
89
+ | --- | --- | --- | --- | --- |
90
+ | target | — | `CheckboxChangeTarget` | 是 | — |
91
+
92
+ ### CheckboxGroupProps
93
+
94
+ 继承:`Pick<
95
+ React.HTMLAttributes<HTMLDivElement>,
96
+ 'className' | 'style' | 'id' | 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'role'
97
+ >`;本节列出新增或重声明字段。
98
+
99
+ Checkbox.Group Props
100
+
101
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
102
+ | --- | --- | --- | --- | --- |
103
+ | ref | 组容器 ref | `React.Ref<HTMLDivElement>` | 否 | — |
104
+ | defaultValue | 默认已选值(非受控) | `(string \| number \| boolean)[]` | 否 | `[]` |
105
+ | disabled | 整组是否禁用 | `boolean` | 否 | `false` |
106
+ | name | 子项共享的 `name`,对应原生复选框组;缺省可由实现生成 | `string` | 否 | — |
107
+ | options | 快捷生成选项;与 `children` 同时存在时优先 `options`,`children` 被忽略(dev 模式 warn) | `string[] \| number[] \| CheckboxOption[]` | 否 | `[]` |
108
+ | value | 当前已选值(受控) | `(string \| number \| boolean)[]` | 否 | `[]` |
109
+ | onChange | 已选值变化回调 | `(checkedValue: Array<string \| number \| boolean>) => void` | 否 | — |
110
+ | children | 自定义子节点(与 `options` 互斥;同时存在时 `options` 胜出) | `React.ReactNode` | 否 | — |
111
+
112
+ ### 导出类型
113
+
114
+ 另可从 `@apexhub/apex-ui-react` 导入:`CheckboxChangeEvent`、`CheckboxChangeTarget`、`CheckboxGroupProps`、`CheckboxOption`、`CheckboxProps`、`CheckboxSemanticDOM`(与上文子类型配合使用)。
115
+
116
+ ## 代码演示
117
+
118
+ ### 禁用状态
119
+
120
+ `disabled` 可用于单个复选框或整组复选框,禁用后不可切换。
121
+
122
+ ```tsx
123
+ import { Checkbox } from '@apexhub/apex-ui-react'
124
+
125
+ export default () => (
126
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
127
+ <Checkbox disabled>禁用</Checkbox>
128
+ <Checkbox disabled defaultChecked>
129
+ 禁用且已选
130
+ </Checkbox>
131
+ <Checkbox.Group disabled defaultValue={['apple']}>
132
+ <Checkbox value="apple">苹果</Checkbox>
133
+ <Checkbox value="banana">香蕉</Checkbox>
134
+ </Checkbox.Group>
135
+ </div>
136
+ )
137
+ ```
138
+
139
+ ### 多种状态
140
+
141
+ 并排展示未选、选中、半选及禁用等常见状态,便于对照视觉与交互差异。
142
+
143
+ ```tsx
144
+ import { Checkbox } from '@apexhub/apex-ui-react'
145
+
146
+ export default () => (
147
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
148
+ <Checkbox>未选中</Checkbox>
149
+ <Checkbox defaultChecked>已选中</Checkbox>
150
+ <Checkbox indeterminate>半选</Checkbox>
151
+ <Checkbox disabled>禁用 - 未选</Checkbox>
152
+ <Checkbox disabled defaultChecked>
153
+ 禁用 - 选中
154
+ </Checkbox>
155
+ <Checkbox disabled indeterminate>
156
+ 禁用 - 半选
157
+ </Checkbox>
158
+ </div>
159
+ )
160
+ ```
161
+
162
+ ### 受控用法
163
+
164
+ 通过 `checked` 与 变更事件 控制选中;变更事件 通过 `e.target.checked` 读取是否选中。
165
+
166
+ ```tsx
167
+ import { Checkbox } from '@apexhub/apex-ui-react'
168
+
169
+ import { useState } from 'react'
170
+
171
+ export default () => {
172
+ const [checked, setChecked] = useState(false)
173
+ return (
174
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
175
+ <Checkbox checked={checked} onChange={(e) => setChecked(e.target.checked)}>
176
+ 受控复选框
177
+ </Checkbox>
178
+ <span style={{ fontSize: 12 }}>状态:{checked ? '已选中' : '未选中'}</span>
179
+ </div>
180
+ )
181
+ }
182
+ ```
183
+
184
+ ### 复选框组
185
+
186
+ 用 `Checkbox.Group` 包裹多个 `Checkbox`,由组的 `value` / 变更事件 统一管理已选值。
187
+
188
+ ```tsx
189
+ import { Checkbox } from '@apexhub/apex-ui-react'
190
+
191
+ export default () => (
192
+ <Checkbox.Group defaultValue={['apple']}>
193
+ <Checkbox value="apple">苹果</Checkbox>
194
+ <Checkbox value="banana">香蕉</Checkbox>
195
+ <Checkbox value="cherry">樱桃</Checkbox>
196
+ </Checkbox.Group>
197
+ )
198
+ ```
199
+
200
+ ### 快捷选项
201
+
202
+ `options` 与 子内容 同时存在时,以 `options` 为准。
203
+
204
+ ```tsx
205
+ import type { CheckboxOption } from '@apexhub/apex-ui-react'
206
+
207
+ import { Checkbox } from '@apexhub/apex-ui-react'
208
+
209
+ import { useState } from 'react'
210
+
211
+ const options: CheckboxOption[] = [
212
+ { label: '苹果', value: 'apple' },
213
+ { label: '香蕉', value: 'banana' },
214
+ { label: '樱桃', value: 'cherry' },
215
+ ]
216
+
217
+ export default () => {
218
+ const [value, setValue] = useState<Array<string | number | boolean>>(['banana'])
219
+ return (
220
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
221
+ <Checkbox.Group options={options} value={value} onChange={setValue} />
222
+ <span style={{ fontSize: 12 }}>
223
+ 已选:{value.length === 0 ? '(空)' : value.map(String).join(', ')}
224
+ </span>
225
+ </div>
226
+ )
227
+ }
228
+ ```
229
+
230
+ ### 全选
231
+
232
+ `indeterminate` 常用于「全选」父级:子项只选中一部分时父级为半选,点击父级可在全选与全不选间切换。
233
+
234
+ ```tsx
235
+ import type { CheckboxOption } from '@apexhub/apex-ui-react'
236
+
237
+ import { Checkbox } from '@apexhub/apex-ui-react'
238
+
239
+ import { useState } from 'react'
240
+
241
+ const options: CheckboxOption[] = [
242
+ { label: '苹果', value: 'apple' },
243
+ { label: '香蕉', value: 'banana' },
244
+ { label: '樱桃', value: 'cherry' },
245
+ ]
246
+
247
+ export default () => {
248
+ const [list, setList] = useState<string[]>(['apple'])
249
+ const all = options.map((o) => String(o.value))
250
+ const checkedAll = all.every((v) => list.includes(v))
251
+ const indeterminate = list.length > 0 && !checkedAll
252
+
253
+ return (
254
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
255
+ <Checkbox
256
+ checked={checkedAll}
257
+ indeterminate={indeterminate}
258
+ onChange={(e) => setList(e.target.checked ? all : [])}
259
+ >
260
+ 全选 / 取消
261
+ </Checkbox>
262
+ <Checkbox.Group
263
+ options={options}
264
+ value={list}
265
+ onChange={(next) => setList(next as string[])}
266
+ />
267
+ </div>
268
+ )
269
+ }
270
+ ```
271
+
272
+ ### 自定义语义结构
273
+
274
+ 通过 `classNames` 和 `styles` 为复选框的语义子结构(`root` / `indicator`)添加类名或样式。
275
+
276
+ ```tsx
277
+ import type { CheckboxProps } from '@apexhub/apex-ui-react'
278
+
279
+ import { Checkbox } from '@apexhub/apex-ui-react'
280
+
281
+ import type * as React from 'react'
282
+
283
+ const styles: CheckboxProps['styles'] = {
284
+ root: {
285
+ '--checkbox-gap': 'var(--apex-spacing-3)',
286
+ } as React.CSSProperties,
287
+ indicator: {
288
+ opacity: 0.9,
289
+ },
290
+ }
291
+
292
+ export default () => (
293
+ <Checkbox
294
+ defaultChecked
295
+ classNames={{
296
+ root: 'custom-checkbox-root',
297
+ indicator: 'custom-checkbox-indicator',
298
+ }}
299
+ styles={styles}
300
+ >
301
+ 自定义语义结构
302
+ </Checkbox>
303
+ )
304
+ ```
305
+
306
+ ## DOM 结构
307
+
308
+ 源码声明的静态 `data-slot`:`checkbox-root`、`checkbox`、`checkbox-indicator`、`checkbox-label`、`checkbox-standalone-scope`、`checkbox-group`。具体节点随模式和状态出现,不表示固定嵌套顺序。
309
+
310
+ ## 样式定制
311
+
312
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
313
+
314
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
315
+
316
+ ## FAQ
317
+
318
+ ### `options` 和 `children` 同时传了会怎样?
319
+
320
+ 以 `options` 为准,`children` 会被忽略;开发模式下会输出警告。请只选一种渲染方式。
321
+
322
+
323
+
324
+ ### `indeterminate` 和 `checked` 有什么区别?
325
+
326
+ `checked` 表示确定选中;`indeterminate` 表示半选(子项部分选中)。全选父级通常在子项未全选时设 `indeterminate={true}` 且 `checked={false}`。
327
+
328
+
329
+
330
+ ### Group 的 `onChange` 和单个 Checkbox 的 `onChange` 一样吗?
331
+
332
+ 不同。Group 的 `onChange` 直接收到当前已选值数组;单个 Checkbox 的 `onChange` 是事件对象,通过 `e.target.checked` 读取。
@@ -0,0 +1,28 @@
1
+ # Checkbox Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--checkbox-fill-checked` | `fill`、`outline` | `var(--apex-fill-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
14
+ | `--checkbox-fill-indeterminate` | `fill` | `var(--apex-fill-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
15
+ | `--checkbox-group-spacing-gap-x` | `column-gap` | `var(--apex-spacing-12)` | `.apex-checkbox-group.apex-default-checkbox-group` |
16
+ | `--checkbox-group-spacing-gap-y` | `row-gap` | `var(--apex-spacing-8)` | `.apex-checkbox-group.apex-default-checkbox-group` |
17
+ | `--checkbox-icon-checked` | `color` | `var(--apex-icon-neutral-quaternary-stable)` | `.apex-checkbox.apex-default-checkbox` |
18
+ | `--checkbox-icon-icon-md` | `height`、`width` | `var(--apex-size-20)` | `.apex-checkbox.apex-default-checkbox` |
19
+ | `--checkbox-icon-indeterminate` | `color` | `var(--apex-icon-neutral-quaternary-stable)` | `.apex-checkbox.apex-default-checkbox` |
20
+ | `--checkbox-radius-radius` | `border-radius` | `var(--apex-radius-4)` | `.apex-checkbox.apex-default-checkbox` |
21
+ | `--checkbox-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-checkbox.apex-default-checkbox` |
22
+ | `--checkbox-stroke-checked` | `color` | `var(--apex-stroke-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
23
+ | `--checkbox-stroke-default` | `color` | `var(--apex-stroke-neutral-denary)` | `.apex-checkbox.apex-default-checkbox` |
24
+ | `--checkbox-stroke-disabled` | `color`、`fill` | `var(--apex-stroke-neutral-quinary)` | `.apex-checkbox.apex-default-checkbox` |
25
+ | `--checkbox-stroke-hover` | `color` | `var(--apex-stroke-neutral-octonary)` | `.apex-checkbox.apex-default-checkbox` |
26
+ | `--checkbox-stroke-indeterminate` | `color` | `var(--apex-stroke-brand-primary)` | `.apex-checkbox.apex-default-checkbox` |
27
+ | `--checkbox-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-checkbox.apex-default-checkbox` |
28
+ | `--checkbox-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-checkbox.apex-default-checkbox` |