@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,78 @@
1
+ # Tabs Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./tabs.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--tab-button-capsule-icon-icon` | `height`、`width` | `var(--apex-icon-16)` | `.apex-tab-button.apex-tab-button-tab-button` |
14
+ | `--tab-button-capsule-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tab-button.apex-tab-button-tab-button` |
15
+ | `--tab-button-capsule-size-height` | `height` | `var(--apex-size-28)` | `.apex-tab-button.apex-tab-button-tab-button` |
16
+ | `--tab-button-capsule-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tab-button.apex-tab-button-tab-button` |
17
+ | `--tab-button-capsule-spacing-padding-x` | `padding` | `var(--apex-spacing-12)` | `.apex-tab-button.apex-tab-button-tab-button` |
18
+ | `--tab-button-capsule-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tab-button.apex-tab-button-tab-button` |
19
+ | `--tab-button-fill-active` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-tab-button.apex-capsule-tab-button` |
20
+ | `--tab-button-fill-default` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
21
+ | `--tab-button-fill-disabled` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
22
+ | `--tab-button-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-tab-button.apex-capsule-tab-button` |
23
+ | `--tab-button-fill-selected` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-tab-button.apex-capsule-tab-button` |
24
+ | `--tab-button-icon-active` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
25
+ | `--tab-button-icon-active` | `color` | `var(--apex-icon-brand-secondary)` | `.apex-tab-button.apex-line-tab-button` |
26
+ | `--tab-button-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
27
+ | `--tab-button-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tab-button.apex-line-tab-button` |
28
+ | `--tab-button-icon-disabled` | `color` | `var(--apex-icon-neutral-disabled)` | `.apex-tab-button.apex-capsule-tab-button` |
29
+ | `--tab-button-icon-disabled` | `color` | `var(--apex-icon-neutral-disabled)` | `.apex-tab-button.apex-line-tab-button` |
30
+ | `--tab-button-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
31
+ | `--tab-button-icon-hover` | `color` | `var(--apex-icon-neutral-secondary)` | `.apex-tab-button.apex-line-tab-button` |
32
+ | `--tab-button-icon-selected` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
33
+ | `--tab-button-icon-selected` | `color` | `var(--apex-icon-brand-primary)` | `.apex-tab-button.apex-line-tab-button` |
34
+ | `--tab-button-line-icon-icon` | `height`、`width` | `var(--apex-icon-16)` | `.apex-tab-button.apex-tab-button-tab-button` |
35
+ | `--tab-button-line-size-height` | `height` | `var(--apex-size-32)` | `.apex-tab-button.apex-tab-button-tab-button` |
36
+ | `--tab-button-line-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tab-button.apex-tab-button-tab-button` |
37
+ | `--tab-button-line-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-tab-button.apex-tab-button-tab-button` |
38
+ | `--tab-button-stroke-active` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
39
+ | `--tab-button-stroke-default` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
40
+ | `--tab-button-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
41
+ | `--tab-button-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
42
+ | `--tab-button-stroke-selected` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tab-button.apex-capsule-tab-button` |
43
+ | `--tab-button-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
44
+ | `--tab-button-text-active` | `color` | `var(--apex-text-brand-secondary)` | `.apex-tab-button.apex-line-tab-button` |
45
+ | `--tab-button-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
46
+ | `--tab-button-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tab-button.apex-line-tab-button` |
47
+ | `--tab-button-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-tab-button.apex-capsule-tab-button` |
48
+ | `--tab-button-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-tab-button.apex-line-tab-button` |
49
+ | `--tab-button-text-hover` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
50
+ | `--tab-button-text-hover` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tab-button.apex-line-tab-button` |
51
+ | `--tab-button-text-selected` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tab-button.apex-capsule-tab-button` |
52
+ | `--tab-button-text-selected` | `color` | `var(--apex-text-brand-primary)` | `.apex-tab-button.apex-line-tab-button` |
53
+ | `--tab-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-tab.apex-capsule-tab` |
54
+ | `--tab-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tab.apex-capsule-horizontal-tab` |
55
+ | `--tab-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tab.apex-capsule-vertical-tab` |
56
+ | `--tab-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tab.apex-capsule-horizontal-tab` |
57
+ | `--tab-spacing-gap` | `gap` | `var(--apex-spacing-8)` | `.apex-tab.apex-capsule-vertical-tab` |
58
+ | `--tab-spacing-gap-button` | `gap` | `var(--apex-spacing-12)` | `.apex-tab.apex-line-horizontal-tab` |
59
+ | `--tab-spacing-gap-button` | `gap` | `var(--apex-spacing-12)` | `.apex-tab.apex-line-vertical-tab` |
60
+ | `--tab-spacing-gap-button-line` | `bottom`、`right` | `var(--apex-spacing-2)` | `.apex-tab.apex-line-horizontal-tab` |
61
+ | `--tab-spacing-gap-button-line` | `bottom`、`right` | `var(--apex-spacing-8)` | `.apex-tab.apex-line-vertical-tab` |
62
+ | `--tab-spacing-margin` | `gap` | `var(--apex-spacing-12)` | `.apex-tab.apex-capsule-horizontal-tab` |
63
+ | `--tab-spacing-margin` | `gap` | `var(--apex-spacing-12)` | `.apex-tab.apex-capsule-vertical-tab` |
64
+ | `--tab-spacing-margin` | `gap` | `var(--apex-spacing-12)` | `.apex-tab.apex-line-horizontal-tab` |
65
+ | `--tab-spacing-margin` | `gap` | `var(--apex-spacing-12)` | `.apex-tab.apex-line-vertical-tab` |
66
+ | `--tab-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-tab.apex-capsule-horizontal-tab` |
67
+ | `--tab-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-tab.apex-capsule-vertical-tab` |
68
+ | `--tab-spacing-padding-y` | `padding` | `var(--apex-spacing-4)` | `.apex-tab.apex-capsule-horizontal-tab` |
69
+ | `--tab-spacing-padding-y` | `padding` | `var(--apex-spacing-4)` | `.apex-tab.apex-capsule-vertical-tab` |
70
+ | `--tab-stroke-default` | `bottom`、`box-shadow`、`height`、`right`、`width` | `var(--apex-stroke-neutral-quaternary)` | `.apex-tab.apex-capsule-tab` |
71
+ | `--tab-stroke-default` | `bottom`、`box-shadow`、`height`、`right`、`width` | `var(--apex-border-1)` | `.apex-tab.apex-line-horizontal-tab` |
72
+ | `--tab-stroke-default` | `bottom`、`box-shadow`、`height`、`right`、`width` | `var(--apex-stroke-neutral-tertiary)` | `.apex-tab.apex-line-tab` |
73
+ | `--tab-stroke-default` | `bottom`、`box-shadow`、`height`、`right`、`width` | `var(--apex-border-1)` | `.apex-tab.apex-line-vertical-tab` |
74
+ | `--tab-stroke-selected` | `bottom`、`height`、`right`、`width` | `var(--apex-border-2)` | `.apex-tab.apex-line-horizontal-tab` |
75
+ | `--tab-stroke-selected` | `bottom`、`height`、`right`、`width` | `var(--apex-stroke-brand-primary)` | `.apex-tab.apex-line-tab` |
76
+ | `--tab-stroke-selected` | `bottom`、`height`、`right`、`width` | `var(--apex-border-2)` | `.apex-tab.apex-line-vertical-tab` |
77
+ | `--tab-stroke-stroke` | `box-shadow` | `var(--apex-border-1)` | `.apex-tab.apex-capsule-horizontal-tab` |
78
+ | `--tab-stroke-stroke` | `box-shadow` | `var(--apex-border-1)` | `.apex-tab.apex-capsule-vertical-tab` |
@@ -0,0 +1,306 @@
1
+ # Tabs
2
+
3
+ > Tabs:需要在同一页面区域内切换多组相关内容,且各面板互斥展示时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Tabs`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Tabs } from '@apexhub/apex-ui-react'
15
+
16
+ import type { TabsItem } from '@apexhub/apex-ui-react'
17
+
18
+ import { Typography } from '@apexhub/apex-ui-react'
19
+
20
+ import '@apexhub/apex-ui-react/style.css'
21
+
22
+ const TABS_ITEMS: TabsItem[] = [
23
+ {
24
+ key: 'tab1',
25
+ label: 'Tab 1',
26
+ children: <Typography.Text variant="caption">面板一的内容</Typography.Text>,
27
+ },
28
+ {
29
+ key: 'tab2',
30
+ label: 'Tab 2',
31
+ children: <Typography.Text variant="caption">面板二的内容</Typography.Text>,
32
+ },
33
+ {
34
+ key: 'tab3',
35
+ label: 'Tab 3',
36
+ children: <Typography.Text variant="caption">面板三的内容</Typography.Text>,
37
+ },
38
+ ]
39
+
40
+ export default () => <Tabs items={TABS_ITEMS} defaultActiveKey="tab1" />
41
+ ```
42
+
43
+ ## 何时使用
44
+
45
+ - 需要在同一页面区域内切换多组相关内容,且各面板互斥展示时。
46
+ - 内容分组清晰、标签数量适中(标签过多时需消费方自行滚动或拆页)。
47
+ - 若仅需锚点跳转或页面级路由切换,请使用 Menu 或路由导航,而不是 Tabs。
48
+
49
+ ## API
50
+
51
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
52
+
53
+ ### Tabs
54
+
55
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
56
+ | --- | --- | --- | --- | --- |
57
+ | items | 选项卡列表。 | `TabsItem[]` | 否 | `[]` |
58
+ | activeKey | 受控当前激活面板的 key。 | `TabsKey` | 否 | — |
59
+ | defaultActiveKey | 非受控初始激活面板的 key;未设置时使用 `items[0].key`。 | `TabsKey` | 否 | — |
60
+ | onChange | 切换面板的回调。 | `(activeKey: TabsKey) => void` | 否 | — |
61
+ | destroyOnHidden | 隐藏面板后是否卸载其子树。<br>关闭时仅隐藏非激活面板,保留其 DOM、ref 与内部状态。 | `boolean` | 否 | `false` |
62
+ | type | 页签外观类型。<br>- `line`:下划线指示条<br>- `capsule`:胶囊轨道 + 选中高亮<br>- `capsule-number`:同 capsule,标题右侧展示 `item.count`<br>- `text`:纯文字标签 + 分隔线(触发器复用 `<Button type="text">`) | `"line" \| "text" \| "capsule" \| "capsule-number"` | 否 | `'line'` |
63
+ | tabPosition | 页签位置。<br>- `top`:横向页签在内容区上方(`apex-line-horizontal-tab`)<br>- `left`:纵向页签在内容区左侧(`apex-line-vertical-tab`)<br>v1 仅开放 `top` / `left`;right / bottom 下版规划。 | `"top" \| "left"` | 否 | `'top'` |
64
+ | className | 根节点类名。 | `string` | 否 | — |
65
+ | style | 根节点样式;禁止硬编码色值。 | `React.CSSProperties` | 否 | — |
66
+ | ref | 根节点 ref。 | `React.Ref<HTMLDivElement>` | 否 | — |
67
+
68
+ ### TabsKey
69
+
70
+ ```typescript
71
+ type TabsKey = string
72
+ ```
73
+
74
+ ### TabsType
75
+
76
+ ```typescript
77
+ type TabsType = 'line' | 'capsule' | 'capsule-number' | 'text'
78
+ ```
79
+
80
+ ### TabsItem
81
+
82
+ Tabs 面板项。
83
+
84
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
85
+ | --- | --- | --- | --- | --- |
86
+ | key | 选项卡唯一标识;仅支持字符串,直接映射到 Radix Tabs value。 | `TabsKey` | 是 | — |
87
+ | label | 选项卡标题。 | `React.ReactNode` | 是 | — |
88
+ | children | 选项卡面板内容。 | `React.ReactNode` | 否 | — |
89
+ | disabled | 是否禁用该选项卡。 | `boolean` | 否 | `false` |
90
+ | icon | 选项卡标题前的图标。 | `React.ReactNode` | 否 | — |
91
+ | count | 标题右侧数字(仅 `type="capsule-number"` 时渲染)。<br>与 capsule 视觉一致,数字紧跟 label 右侧。 | `React.ReactNode` | 否 | — |
92
+
93
+ ### 导出类型
94
+
95
+ 另可从 `@apexhub/apex-ui-react` 导入:`TabsItem`、`TabsKey`、`TabsProps`、`TabsType`(与上文子类型配合使用)。
96
+
97
+ ## 代码演示
98
+
99
+ ### 外观类型
100
+
101
+ 通过 `type` 切换线型下划线、胶囊轨道、带计数胶囊与纯文字分隔四种页签外观。胶囊页签使用 32px 轨道和 24px 触发器,适合紧凑筛选场景。
102
+
103
+ ```tsx
104
+ import { Tabs } from '@apexhub/apex-ui-react'
105
+
106
+ import type { TabsItem } from '@apexhub/apex-ui-react'
107
+
108
+ import { Typography } from '@apexhub/apex-ui-react'
109
+
110
+ const TABS_ITEMS: TabsItem[] = [
111
+ {
112
+ key: 'tab1',
113
+ label: 'Tab 1',
114
+ children: <Typography.Text variant="caption">面板一的内容</Typography.Text>,
115
+ },
116
+ {
117
+ key: 'tab2',
118
+ label: 'Tab 2',
119
+ children: <Typography.Text variant="caption">面板二的内容</Typography.Text>,
120
+ },
121
+ {
122
+ key: 'tab3',
123
+ label: 'Tab 3',
124
+ children: <Typography.Text variant="caption">面板三的内容</Typography.Text>,
125
+ },
126
+ ]
127
+
128
+ export default () => (
129
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 24 }}>
130
+ <Tabs items={TABS_ITEMS} type="line" />
131
+ <Tabs items={TABS_ITEMS} type="capsule" />
132
+ <Tabs
133
+ type="capsule-number"
134
+ items={TABS_ITEMS.map((item, index) => ({ ...item, count: [128, 12, 3][index] }))}
135
+ />
136
+ <Tabs items={TABS_ITEMS} type="text" />
137
+ </div>
138
+ )
139
+ ```
140
+
141
+ ### 页签位置
142
+
143
+ `tabPosition` 支持 `top`(横向,默认)与 `left`(纵向);right / bottom 下版规划。
144
+
145
+ ```tsx
146
+ import { Tabs } from '@apexhub/apex-ui-react'
147
+
148
+ import type { TabsItem } from '@apexhub/apex-ui-react'
149
+
150
+ import { Typography } from '@apexhub/apex-ui-react'
151
+
152
+ const TABS_ITEMS: TabsItem[] = [
153
+ {
154
+ key: 'tab1',
155
+ label: 'Tab 1',
156
+ children: <Typography.Text variant="caption">面板一的内容</Typography.Text>,
157
+ },
158
+ {
159
+ key: 'tab2',
160
+ label: 'Tab 2',
161
+ children: <Typography.Text variant="caption">面板二的内容</Typography.Text>,
162
+ },
163
+ {
164
+ key: 'tab3',
165
+ label: 'Tab 3',
166
+ children: <Typography.Text variant="caption">面板三的内容</Typography.Text>,
167
+ },
168
+ ]
169
+
170
+ export default () => (
171
+ <div style={{ display: 'flex', gap: 48 }}>
172
+ <Tabs items={TABS_ITEMS} tabPosition="top" />
173
+ <Tabs items={TABS_ITEMS} tabPosition="left" />
174
+ </div>
175
+ )
176
+ ```
177
+
178
+ ### 受控用法
179
+
180
+ 传入 `activeKey` 与 变更事件 由外部控制当前激活面板。
181
+
182
+ ```tsx
183
+ import { Tabs } from '@apexhub/apex-ui-react'
184
+
185
+ import { useState } from 'react'
186
+
187
+ import type { TabsItem } from '@apexhub/apex-ui-react'
188
+
189
+ import { Typography } from '@apexhub/apex-ui-react'
190
+
191
+ const TABS_ITEMS: TabsItem[] = [
192
+ {
193
+ key: 'tab1',
194
+ label: 'Tab 1',
195
+ children: <Typography.Text variant="caption">面板一的内容</Typography.Text>,
196
+ },
197
+ {
198
+ key: 'tab2',
199
+ label: 'Tab 2',
200
+ children: <Typography.Text variant="caption">面板二的内容</Typography.Text>,
201
+ },
202
+ {
203
+ key: 'tab3',
204
+ label: 'Tab 3',
205
+ children: <Typography.Text variant="caption">面板三的内容</Typography.Text>,
206
+ },
207
+ ]
208
+
209
+ export default () => {
210
+ const [activeKey, setActiveKey] = useState('tab2')
211
+ return <Tabs items={TABS_ITEMS} activeKey={activeKey} onChange={setActiveKey} />
212
+ }
213
+ ```
214
+
215
+ ### 禁用选项卡
216
+
217
+ 通过 `items[].disabled` 禁用单个选项卡,禁用项不可被激活。
218
+
219
+ ```tsx
220
+ import type { TabsItem } from '@apexhub/apex-ui-react'
221
+
222
+ import { Tabs, Typography } from '@apexhub/apex-ui-react'
223
+
224
+ const disabledItems: TabsItem[] = [
225
+ {
226
+ key: 'tab1',
227
+ label: 'Tab 1',
228
+ children: <Typography.Text variant="caption">面板一</Typography.Text>,
229
+ },
230
+ {
231
+ key: 'tab2',
232
+ label: 'Tab 2',
233
+ children: <Typography.Text variant="caption">面板二</Typography.Text>,
234
+ disabled: true,
235
+ },
236
+ {
237
+ key: 'tab3',
238
+ label: 'Tab 3',
239
+ children: <Typography.Text variant="caption">面板三</Typography.Text>,
240
+ disabled: true,
241
+ },
242
+ ]
243
+
244
+ export default () => (
245
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 24 }}>
246
+ <Tabs items={disabledItems} type="line" defaultActiveKey="tab1" />
247
+ <Tabs items={disabledItems} type="capsule" defaultActiveKey="tab1" />
248
+ <Tabs items={disabledItems} type="text" defaultActiveKey="tab1" />
249
+ </div>
250
+ )
251
+ ```
252
+
253
+ ### 带图标
254
+
255
+ 通过 `items[].icon` 在页签标题前插入图标。
256
+
257
+ ```tsx
258
+ import type { TabsItem } from '@apexhub/apex-ui-react'
259
+
260
+ import { Tabs, Typography } from '@apexhub/apex-ui-react'
261
+
262
+ const SearchIcon = () => (
263
+ <svg viewBox="0 0 16 16" width="16" height="16" fill="none" aria-hidden="true">
264
+ <circle cx="7" cy="7" r="4.5" stroke="currentColor" strokeWidth="1.5" />
265
+ <path d="m11 11 3 3" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
266
+ </svg>
267
+ )
268
+
269
+ const items: TabsItem[] = [
270
+ {
271
+ key: 'tab1',
272
+ label: 'Tab 1',
273
+ icon: <SearchIcon />,
274
+ children: <Typography.Text variant="caption">面板一</Typography.Text>,
275
+ },
276
+ {
277
+ key: 'tab2',
278
+ label: 'Tab 2',
279
+ icon: <SearchIcon />,
280
+ children: <Typography.Text variant="caption">面板二</Typography.Text>,
281
+ },
282
+ ]
283
+
284
+ export default () => <Tabs items={items} defaultActiveKey="tab1" />
285
+ ```
286
+
287
+ ## DOM 结构
288
+
289
+ 源码声明的静态 `data-slot`:`tabs`、`tabs-list`、`tabs-trigger`、`tabs-icon`、`tabs-label`、`tabs-count`、`tabs-content`、`tabs-body`。具体节点随模式和状态出现,不表示固定嵌套顺序。
290
+
291
+ ## 样式定制
292
+
293
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../llms-theme.txt)。
294
+
295
+ 需要定制具体样式时再读取 [Token 明细](./tabs.tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
296
+
297
+ ## FAQ
298
+
299
+ ### 切换面板后,未激活的内容会被销毁吗?
300
+
301
+ 默认不会。`destroyOnHidden` 默认为 `false`,隐藏面板仍保留在 DOM 中,因此 ref 与内部状态不会因切换丢失。性能敏感场景可设为 `true`,在切换后卸载非激活面板子树。
302
+
303
+
304
+ ### 从 antd `Tabs.TabPane` 写法迁移怎么做?
305
+
306
+ Apex Tabs 仅支持 `items` 配置式,不支持 `Tabs.TabPane` 复合写法。将每个 `TabPane` 的 `key`、`tab`、`children` 映射为 `items` 数组元素即可。
@@ -0,0 +1,76 @@
1
+ # Tag Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./tag.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-cn-body-font` |
14
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-cn-caption-font` |
15
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-cn-heading-1-font` |
16
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-cn-heading-2-font` |
17
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-3-font` |
18
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-4-font` |
19
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-en-body-font` |
20
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-en-caption-font` |
21
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-en-heading-1-font` |
22
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-en-heading-2-font` |
23
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-3-font` |
24
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-4-font` |
25
+ | `--tag-active` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-tag.apex-close-tag` |
26
+ | `--tag-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-close-tag` |
27
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-brand-alpha-secondary)` | `.apex-tag.apex-filled-default-brand-tag` |
28
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-tag.apex-filled-default-default-tag` |
29
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-error-alpha-secondary)` | `.apex-tag.apex-filled-default-error-tag` |
30
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-tag.apex-filled-default-grey-tag` |
31
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-success-alpha-secondary)` | `.apex-tag.apex-filled-default-success-tag` |
32
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-warning-alpha-secondary)` | `.apex-tag.apex-filled-default-warning-tag` |
33
+ | `--tag-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-tag.apex-outlined-default-tag` |
34
+ | `--tag-hover` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-tag.apex-close-tag` |
35
+ | `--tag-icon-default` | `color` | `var(--apex-icon-brand-primary)` | `.apex-tag.apex-filled-default-brand-tag` |
36
+ | `--tag-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-filled-default-default-tag` |
37
+ | `--tag-icon-default` | `color` | `var(--apex-icon-error-primary)` | `.apex-tag.apex-filled-default-error-tag` |
38
+ | `--tag-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-filled-default-grey-tag` |
39
+ | `--tag-icon-default` | `color` | `var(--apex-icon-success-primary)` | `.apex-tag.apex-filled-default-success-tag` |
40
+ | `--tag-icon-default` | `color` | `var(--apex-icon-warning-primary)` | `.apex-tag.apex-filled-default-warning-tag` |
41
+ | `--tag-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-tag.apex-outlined-default-tag` |
42
+ | `--tag-icon-icon` | `font-size`、`height`、`width` | `var(--apex-icon-20)` | `.apex-tag.apex-lg-tag` |
43
+ | `--tag-icon-icon` | `font-size`、`height`、`width` | `var(--apex-icon-16)` | `.apex-tag.apex-md-tag` |
44
+ | `--tag-icon-icon` | `font-size`、`height`、`width` | `var(--apex-icon-16)` | `.apex-tag.apex-sm-tag` |
45
+ | `--tag-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tag.apex-lg-tag` |
46
+ | `--tag-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tag.apex-md-tag` |
47
+ | `--tag-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-tag.apex-sm-tag` |
48
+ | `--tag-size-height` | `height` | `var(--apex-size-28)` | `.apex-tag.apex-lg-tag` |
49
+ | `--tag-size-height` | `height` | `var(--apex-size-24)` | `.apex-tag.apex-md-tag` |
50
+ | `--tag-size-height` | `height` | `var(--apex-size-20)` | `.apex-tag.apex-sm-tag` |
51
+ | `--tag-size-width-max` | `max-width` | `var(--apex-size-180)` | `.apex-tag.apex-lg-tag` |
52
+ | `--tag-size-width-max` | `max-width` | `var(--apex-size-180)` | `.apex-tag.apex-md-tag` |
53
+ | `--tag-size-width-max` | `max-width` | `var(--apex-size-180)` | `.apex-tag.apex-sm-tag` |
54
+ | `--tag-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tag.apex-lg-tag` |
55
+ | `--tag-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tag.apex-md-tag` |
56
+ | `--tag-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-tag.apex-sm-tag` |
57
+ | `--tag-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-tag.apex-lg-tag` |
58
+ | `--tag-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-tag.apex-md-tag` |
59
+ | `--tag-spacing-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-tag.apex-sm-tag` |
60
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-brand-transparent)` | `.apex-tag.apex-filled-default-brand-tag` |
61
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tag.apex-filled-default-default-tag` |
62
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-error-transparent)` | `.apex-tag.apex-filled-default-error-tag` |
63
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-tag.apex-filled-default-grey-tag` |
64
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-success-transparent)` | `.apex-tag.apex-filled-default-success-tag` |
65
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-warning-transparent)` | `.apex-tag.apex-filled-default-warning-tag` |
66
+ | `--tag-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-tag.apex-outlined-default-tag` |
67
+ | `--tag-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tag.apex-lg-tag` |
68
+ | `--tag-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tag.apex-md-tag` |
69
+ | `--tag-stroke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-tag.apex-sm-tag` |
70
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-brand-tag` |
71
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-default-tag` |
72
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-error-tag` |
73
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-grey-tag` |
74
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-success-tag` |
75
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-tag.apex-filled-default-warning-tag` |
76
+ | `--tag-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-tag.apex-outlined-default-tag` |