@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,160 @@
1
+ # Select 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
+ | `--dropdown-fill-active` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-dropdown.apex-default-dropdown` |
14
+ | `--dropdown-fill-container-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-dropdown.apex-default-dropdown` |
15
+ | `--dropdown-fill-disabled` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
16
+ | `--dropdown-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-lg-dropdown` |
17
+ | `--dropdown-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-sm-dropdown` |
18
+ | `--dropdown-size-container-gap` | `gap`、`padding-bottom` | `var(--apex-spacing-2)` | `.apex-dropdown.apex-lg-dropdown` |
19
+ | `--dropdown-size-container-gap` | `gap`、`padding-bottom` | `var(--apex-spacing-2)` | `.apex-dropdown.apex-sm-dropdown` |
20
+ | `--dropdown-size-container-height-max` | `max-height` | `var(--apex-size-320)` | `.apex-dropdown.apex-lg-dropdown` |
21
+ | `--dropdown-size-container-height-max` | `max-height` | `var(--apex-size-320)` | `.apex-dropdown.apex-sm-dropdown` |
22
+ | `--dropdown-size-item-height-item` | `min-height` | `var(--apex-size-32)` | `.apex-dropdown.apex-lg-dropdown` |
23
+ | `--dropdown-size-item-height-item` | `min-height` | `var(--apex-size-24)` | `.apex-dropdown.apex-sm-dropdown` |
24
+ | `--dropdown-spacing-container-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-lg-dropdown` |
25
+ | `--dropdown-spacing-container-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-sm-dropdown` |
26
+ | `--dropdown-spacing-container-padding-y` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-lg-dropdown` |
27
+ | `--dropdown-spacing-container-padding-y` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-sm-dropdown` |
28
+ | `--dropdown-spacing-item-padding-x-item` | `padding`、`padding-inline` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-lg-dropdown` |
29
+ | `--dropdown-spacing-item-padding-x-item` | `padding`、`padding-inline` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-sm-dropdown` |
30
+ | `--dropdown-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-dropdown.apex-lg-dropdown` |
31
+ | `--dropdown-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-dropdown.apex-sm-dropdown` |
32
+ | `--dropdown-stroke-container-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-dropdown.apex-default-dropdown` |
33
+ | `--dropdown-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
34
+ | `--dropdown-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
35
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-cn-body-font` |
36
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-cn-caption-font` |
37
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-cn-heading-1-font` |
38
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-cn-heading-2-font` |
39
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-3-font` |
40
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-4-font` |
41
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-en-body-font` |
42
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-en-caption-font` |
43
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-en-heading-1-font` |
44
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-en-heading-2-font` |
45
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-3-font` |
46
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-4-font` |
47
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-cn-body-font` |
48
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-cn-caption-font` |
49
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-cn-heading-1-font` |
50
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-cn-heading-2-font` |
51
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-3-font` |
52
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-4-font` |
53
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-en-body-font` |
54
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-en-caption-font` |
55
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-en-heading-1-font` |
56
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-en-heading-2-font` |
57
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-3-font` |
58
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-4-font` |
59
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-body-font` |
60
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-caption-font` |
61
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-1-font` |
62
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-2-font` |
63
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-8)` | `.apex-font.apex-text-cn-heading-3-font` |
64
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-4-font` |
65
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-body-font` |
66
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-caption-font` |
67
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-1-font` |
68
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-2-font` |
69
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-3-font` |
70
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-4-font` |
71
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-body-font` |
72
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-caption-font` |
73
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-1-font` |
74
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-2-font` |
75
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-3-font` |
76
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-heading-4-font` |
77
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-body-font` |
78
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-caption-font` |
79
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-1-font` |
80
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-2-font` |
81
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-3-font` |
82
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-heading-4-font` |
83
+ | `--input-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
84
+ | `--input-fill-default` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
85
+ | `--input-fill-disabled` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
86
+ | `--input-fill-disabled` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
87
+ | `--input-fill-error` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
88
+ | `--input-fill-error` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
89
+ | `--input-fill-focused` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-input.apex-default-input` |
90
+ | `--input-fill-focused` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
91
+ | `--input-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-default-input` |
92
+ | `--input-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
93
+ | `--input-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
94
+ | `--input-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
95
+ | `--input-icon-disabled` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-input.apex-default-input` |
96
+ | `--input-icon-disabled` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
97
+ | `--input-icon-error` | `color` | `var(--apex-icon-error-primary)` | `.apex-input.apex-default-input` |
98
+ | `--input-icon-error` | `color` | `var(--apex-icon-error-primary)` | `.apex-input.apex-elevated-input` |
99
+ | `--input-icon-focused` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
100
+ | `--input-icon-focused` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
101
+ | `--input-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
102
+ | `--input-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
103
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-16)` | `.apex-input.apex-lg-input` |
104
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-16)` | `.apex-input.apex-md-input` |
105
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-14)` | `.apex-input.apex-sm-input` |
106
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-lg-input` |
107
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-md-input` |
108
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-sm-input` |
109
+ | `--input-spacing-char-counter-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-input.apex-textarea-input` |
110
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-lg-input` |
111
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-md-input` |
112
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-sm-input` |
113
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-44)` | `.apex-input.apex-lg-input` |
114
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-32)` | `.apex-input.apex-md-input` |
115
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-24)` | `.apex-input.apex-sm-input` |
116
+ | `--input-spacing-height-max` | `max-height` | `var(--apex-size-130)` | `.apex-input.apex-textarea-input` |
117
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-lg-input` |
118
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-md-input` |
119
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-8)` | `.apex-input.apex-sm-input` |
120
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-textarea-input` |
121
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-12)` | `.apex-input.apex-lg-input` |
122
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-6)` | `.apex-input.apex-md-input` |
123
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-4)` | `.apex-input.apex-sm-input` |
124
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-6)` | `.apex-input.apex-textarea-input` |
125
+ | `--input-spacing-width-min` | `min-width` | `var(--apex-size-120)` | `.apex-input.apex-lg-input` |
126
+ | `--input-spacing-width-min` | `min-width` | `var(--apex-size-120)` | `.apex-input.apex-md-input` |
127
+ | `--input-spacing-width-min` | `min-width` | `var(--apex-size-120)` | `.apex-input.apex-sm-input` |
128
+ | `--input-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-default-input` |
129
+ | `--input-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-elevated-input` |
130
+ | `--input-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-default-input` |
131
+ | `--input-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-elevated-input` |
132
+ | `--input-stroke-error` | `border-color` | `var(--apex-stroke-error-primary)` | `.apex-input.apex-default-input` |
133
+ | `--input-stroke-error` | `border-color` | `var(--apex-stroke-error-primary)` | `.apex-input.apex-elevated-input` |
134
+ | `--input-stroke-focused` | `border-color` | `var(--apex-stroke-brand-primary)` | `.apex-input.apex-default-input` |
135
+ | `--input-stroke-focused` | `border-color` | `var(--apex-stroke-brand-primary)` | `.apex-input.apex-elevated-input` |
136
+ | `--input-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-input.apex-default-input` |
137
+ | `--input-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-input.apex-elevated-input` |
138
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-lg-input` |
139
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-md-input` |
140
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-sm-input` |
141
+ | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
142
+ | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
143
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-secondary)` | `.apex-input.apex-default-input` |
144
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
145
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
146
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
147
+ | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
148
+ | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
149
+ | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
150
+ | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
151
+ | `--input-text-placeholder-default` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
152
+ | `--input-text-placeholder-default` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
153
+ | `--input-text-placeholder-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-default-input` |
154
+ | `--input-text-placeholder-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
155
+ | `--input-text-placeholder-error` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
156
+ | `--input-text-placeholder-error` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
157
+ | `--input-text-placeholder-focused` | `color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
158
+ | `--input-text-placeholder-focused` | `color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
159
+ | `--input-text-placeholder-hover` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
160
+ | `--input-text-placeholder-hover` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
@@ -0,0 +1,275 @@
1
+ # Skeleton
2
+
3
+ > Skeleton:页面、卡片或表格数据仍在加载,需要先稳定布局并降低等待感时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Skeleton`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Skeleton } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => (
19
+ <Skeleton title={{ width: '32%' }} paragraph={{ rows: 3, width: ['100%', '86%', '58%'] }} />
20
+ )
21
+ ```
22
+
23
+ ## 何时使用
24
+
25
+ - 页面、卡片或表格数据仍在加载,需要先稳定布局并降低等待感时。
26
+ - 已知内容的大致结构,希望用标题、段落、头像或自定义占位块组合加载态时。
27
+ - 加载时间极短或只需表达后台处理中时,优先使用 Spin,避免骨架屏闪烁。
28
+
29
+ ## API
30
+
31
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
32
+
33
+ ### Skeleton
34
+
35
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
36
+ | --- | --- | --- | --- | --- |
37
+ | active | 是否显示加载动画。 | `boolean` | 否 | `false` |
38
+ | loading | `false` 时直接返回 children;未传或 `true` 时显示骨架。 | `boolean` | 否 | — |
39
+ | avatar | 是否显示头像占位,或传入头像配置。 | `boolean \| SkeletonAvatarConfig` | 否 | `false` |
40
+ | title | 是否显示标题占位,或传入标题配置。 | `boolean \| SkeletonTitleProps` | 否 | `true` |
41
+ | paragraph | 是否显示段落占位,或传入段落配置。 | `boolean \| SkeletonParagraphProps` | 否 | `true` |
42
+ | round | 标题和段落是否使用胶囊圆角。 | `boolean` | 否 | `false` |
43
+ | classNames | 语义化节点类名。 | `SkeletonClassNames` | 否 | — |
44
+ | styles | 语义化节点样式。 | `SkeletonStyles` | 否 | — |
45
+ | children | `loading={false}` 时展示的真实内容。 | `React.ReactNode` | 否 | — |
46
+ | ref | React 19 根 DOM ref。 | `React.Ref<HTMLDivElement>` | 否 | — |
47
+
48
+ ### SkeletonSize
49
+
50
+ ```typescript
51
+ type SkeletonSize = 'small' | 'medium' | 'large'
52
+ ```
53
+
54
+ ### SkeletonElementShape
55
+
56
+ ```typescript
57
+ type SkeletonElementShape = 'circle' | 'square' | 'round' | 'default'
58
+ ```
59
+
60
+ ### SkeletonSemanticDOM
61
+
62
+ ```typescript
63
+ type SkeletonSemanticDOM = 'root' | 'header' | 'section' | 'avatar' | 'title' | 'paragraph'
64
+ ```
65
+
66
+ ### SkeletonClassNames
67
+
68
+ ```typescript
69
+ type SkeletonClassNames = Partial<Record<SkeletonSemanticDOM, string>>
70
+ ```
71
+
72
+ ### SkeletonStyles
73
+
74
+ ```typescript
75
+ type SkeletonStyles = Partial<Record<SkeletonSemanticDOM, React.CSSProperties>>
76
+ ```
77
+
78
+ ### SkeletonTitleProps
79
+
80
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
81
+ | --- | --- | --- | --- | --- |
82
+ | width | 标题占位宽度;数字按 px 处理。 | `number \| string` | 否 | — |
83
+
84
+ ### SkeletonParagraphProps
85
+
86
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
87
+ | --- | --- | --- | --- | --- |
88
+ | rows | 段落占位行数。 | `number` | 否 | — |
89
+ | width | 数组逐行设置宽度;单值仅设置最后一行宽度。数字按 px 处理。 | `number \| string \| Array<number \| string>` | 否 | — |
90
+
91
+ ### SkeletonElementClassNames
92
+
93
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
94
+ | --- | --- | --- | --- | --- |
95
+ | root | — | `string` | 否 | — |
96
+ | content | — | `string` | 否 | — |
97
+
98
+ ### SkeletonElementStyles
99
+
100
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
101
+ | --- | --- | --- | --- | --- |
102
+ | root | — | `React.CSSProperties` | 否 | — |
103
+ | content | — | `React.CSSProperties` | 否 | — |
104
+
105
+ ### SkeletonElementBaseProps
106
+
107
+ 继承:`Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>`;本节列出新增或重声明字段。
108
+
109
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
110
+ | --- | --- | --- | --- | --- |
111
+ | active | 是否显示加载动画。 | `boolean` | 否 | — |
112
+ | classNames | 根与内容节点的语义化类名。 | `SkeletonElementClassNames` | 否 | — |
113
+ | styles | 根与内容节点的语义化样式。 | `SkeletonElementStyles` | 否 | — |
114
+ | ref | React 19 根 DOM ref。 | `React.Ref<HTMLSpanElement>` | 否 | — |
115
+
116
+ ### SkeletonAvatarProps
117
+
118
+ 继承:`SkeletonElementBaseProps`;本节列出新增或重声明字段。
119
+
120
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
121
+ | --- | --- | --- | --- | --- |
122
+ | shape | — | `"circle" \| "square"` | 否 | `'circle'` |
123
+ | size | — | `SkeletonSize \| number` | 否 | `'medium'` |
124
+
125
+ ### SkeletonButtonProps
126
+
127
+ 继承:`SkeletonElementBaseProps`;本节列出新增或重声明字段。
128
+
129
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
130
+ | --- | --- | --- | --- | --- |
131
+ | shape | — | `"circle" \| "square" \| "round" \| "default"` | 否 | `'default'` |
132
+ | size | — | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
133
+ | block | 是否撑满父容器宽度。 | `boolean` | 否 | `false` |
134
+
135
+ ### SkeletonInputProps
136
+
137
+ 继承:`SkeletonElementBaseProps`;本节列出新增或重声明字段。
138
+
139
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
140
+ | --- | --- | --- | --- | --- |
141
+ | size | — | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
142
+ | block | 是否撑满父容器宽度。 | `boolean` | 否 | `false` |
143
+
144
+ ### SkeletonAvatarConfig
145
+
146
+ 主 Skeleton 内部头像配置;动画统一由主组件控制。
147
+
148
+ ```typescript
149
+ type SkeletonAvatarConfig = Omit<SkeletonAvatarProps, 'active'>
150
+ ```
151
+
152
+ ### SkeletonNodeProps
153
+
154
+ 继承:`SkeletonElementBaseProps`;本节列出新增或重声明字段。
155
+
156
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
157
+ | --- | --- | --- | --- | --- |
158
+ | children | 自定义占位内容。 | `React.ReactNode` | 否 | — |
159
+
160
+ ### 导出类型
161
+
162
+ 另可从 `@apexhub/apex-ui-react` 导入:`SkeletonAvatarConfig`、`SkeletonAvatarProps`、`SkeletonButtonProps`、`SkeletonClassNames`、`SkeletonElementClassNames`、`SkeletonElementShape`、`SkeletonElementStyles`、`SkeletonImageProps`、`SkeletonInputProps`、`SkeletonNodeProps`、`SkeletonParagraphProps`、`SkeletonProps`、`SkeletonSemanticDOM`、`SkeletonSize`、`SkeletonStyles`、`SkeletonTitleProps`(与上文子类型配合使用)。
163
+
164
+ ## 代码演示
165
+
166
+ ### 加载动画
167
+
168
+ 设置 `active` 开启渐变动画;设置 `round` 后标题和段落使用胶囊圆角。
169
+
170
+ ```tsx
171
+ import { Skeleton } from '@apexhub/apex-ui-react'
172
+
173
+ export default () => <Skeleton active round avatar={{ size: 48 }} />
174
+ ```
175
+
176
+ ### 独立占位元素
177
+
178
+ 使用 `Skeleton.Avatar`、`Button`、`Input`、`Image` 和 `Node` 组合与真实内容结构匹配的占位布局。
179
+
180
+ ```tsx
181
+ import { Skeleton } from '@apexhub/apex-ui-react'
182
+
183
+ export default () => (
184
+ <div style={{ display: 'flex', flexWrap: 'wrap', alignItems: 'center', gap: 16 }}>
185
+ <Skeleton.Avatar active size="large" />
186
+ <Skeleton.Button active />
187
+ <Skeleton.Input active />
188
+ <Skeleton.Image active />
189
+ <Skeleton.Node active styles={{ content: { width: 120, height: 40 } }} />
190
+ </div>
191
+ )
192
+ ```
193
+
194
+ ### 加载状态切换
195
+
196
+ 通过 `loading` 在骨架屏与 子内容 之间切换;`loading` 为 `false` 时不会增加额外包装节点。
197
+
198
+ ```tsx
199
+ import { Button, Skeleton } from '@apexhub/apex-ui-react'
200
+
201
+ import { useState } from 'react'
202
+
203
+ export default () => {
204
+ const [loading, setLoading] = useState(true)
205
+
206
+ return (
207
+ <div style={{ display: 'grid', gap: 16 }}>
208
+ <Button onClick={() => setLoading((value) => !value)}>
209
+ {loading ? '显示内容' : '显示骨架'}
210
+ </Button>
211
+ <Skeleton loading={loading} active>
212
+ <article>内容已加载,Skeleton 不会增加额外包装节点。</article>
213
+ </Skeleton>
214
+ </div>
215
+ )
216
+ }
217
+ ```
218
+
219
+ ### 页面级组合
220
+
221
+ 在统计卡片中组合多个 `Skeleton.Node`,用细条占位分别表达标题、指标和说明文字。
222
+
223
+ ```tsx
224
+ import { Card, Skeleton } from '@apexhub/apex-ui-react'
225
+
226
+ function MetricCardSkeleton() {
227
+ return (
228
+ <Card>
229
+ <div style={{ display: 'grid', gap: 12, minHeight: 76 }}>
230
+ <Skeleton.Node
231
+ active
232
+ styles={{ root: { display: 'block' }, content: { width: '34%', height: 11 } }}
233
+ />
234
+ <Skeleton.Node
235
+ active
236
+ styles={{ root: { display: 'block' }, content: { width: '42%', height: 26 } }}
237
+ />
238
+ <Skeleton.Node
239
+ active
240
+ styles={{ root: { display: 'block' }, content: { width: '60%', height: 10 } }}
241
+ />
242
+ </div>
243
+ </Card>
244
+ )
245
+ }
246
+
247
+ export default () => (
248
+ <div style={{ display: 'grid', gridTemplateColumns: 'repeat(4, minmax(0, 1fr))', gap: 12 }}>
249
+ {Array.from({ length: 4 }, (_, index) => (
250
+ <MetricCardSkeleton key={index} />
251
+ ))}
252
+ </div>
253
+ )
254
+ ```
255
+
256
+ ## DOM 结构
257
+
258
+ 源码声明的静态 `data-slot`:`skeleton`、`skeleton-header`、`skeleton-section`、`skeleton-title`、`skeleton-paragraph`、`skeleton-paragraph-row`。具体节点随模式和状态出现,不表示固定嵌套顺序。
259
+
260
+ ## 样式定制
261
+
262
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
263
+
264
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
265
+
266
+ ## FAQ
267
+
268
+ ### `loading` 不传时为什么仍然显示骨架?
269
+
270
+ Skeleton 默认就是占位内容,因此不传 `loading` 与 `loading={true}` 等价。数据加载完成后传入 `loading={false}`,组件会直接返回 `children`。
271
+
272
+
273
+ ### Skeleton 和 Spin 怎么选择?
274
+
275
+ 能预估内容结构时使用 Skeleton,保持页面布局稳定;无法预估结构、操作正在提交或等待时间较短时使用 Spin。
@@ -0,0 +1,15 @@
1
+ # Skeleton 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
+ | `--skeleton-fill-default` | `background`、`color` | `var(--apex-fill-neutral-tertiary)` | `.apex-skeleton.apex-default-skeleton` |
14
+ | `--skeleton-radius-radius` | `border-radius` | `var(--apex-radius-4)` | `.apex-skeleton.apex-default-skeleton` |
15
+ | `--skeleton-spacing-height` | `border-radius`、`gap`、`height`、`margin`、`margin-inline-end`、`width` | `var(--apex-size-24)` | `.apex-skeleton.apex-default-skeleton` |