@apexhub/apex-ui-react 0.0.0-stage → 1.2.2
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.
- package/LICENSE +21 -0
- package/README.md +37 -2
- package/dist/en_US.d.ts +191 -0
- package/dist/index.cjs +40727 -0
- package/dist/index.d.ts +6873 -0
- package/dist/index.mjs +40711 -0
- package/dist/llm/alert.tokens.txt +44 -0
- package/dist/llm/alert.txt +167 -0
- package/dist/llm/apex-provider.txt +369 -0
- package/dist/llm/auto-complete.tokens.txt +77 -0
- package/dist/llm/auto-complete.txt +373 -0
- package/dist/llm/avatar.tokens.txt +38 -0
- package/dist/llm/avatar.txt +199 -0
- package/dist/llm/breadcrumb.tokens.txt +143 -0
- package/dist/llm/breadcrumb.txt +251 -0
- package/dist/llm/button.tokens.txt +470 -0
- package/dist/llm/button.txt +270 -0
- package/dist/llm/card.tokens.txt +29 -0
- package/dist/llm/card.txt +118 -0
- package/dist/llm/cascader.tokens.txt +261 -0
- package/dist/llm/cascader.txt +917 -0
- package/dist/llm/checkbox.tokens.txt +36 -0
- package/dist/llm/checkbox.txt +343 -0
- package/dist/llm/collapse.tokens.txt +84 -0
- package/dist/llm/collapse.txt +330 -0
- package/dist/llm/date-picker.tokens.txt +171 -0
- package/dist/llm/date-picker.txt +428 -0
- package/dist/llm/divider.tokens.txt +22 -0
- package/dist/llm/divider.txt +161 -0
- package/dist/llm/drawer.tokens.txt +71 -0
- package/dist/llm/drawer.txt +369 -0
- package/dist/llm/dropdown.tokens.txt +59 -0
- package/dist/llm/dropdown.txt +420 -0
- package/dist/llm/form.tokens.txt +28 -0
- package/dist/llm/form.txt +341 -0
- package/dist/llm/grid.txt +419 -0
- package/dist/llm/image.tokens.txt +28 -0
- package/dist/llm/image.txt +428 -0
- package/dist/llm/input-number.tokens.txt +159 -0
- package/dist/llm/input-number.txt +491 -0
- package/dist/llm/input.tokens.txt +136 -0
- package/dist/llm/input.txt +424 -0
- package/dist/llm/layout.tokens.txt +29 -0
- package/dist/llm/layout.txt +298 -0
- package/dist/llm/menu.tokens.txt +100 -0
- package/dist/llm/menu.txt +687 -0
- package/dist/llm/message.tokens.txt +25 -0
- package/dist/llm/message.txt +301 -0
- package/dist/llm/modal.tokens.txt +96 -0
- package/dist/llm/modal.txt +584 -0
- package/dist/llm/notification.tokens.txt +79 -0
- package/dist/llm/notification.txt +383 -0
- package/dist/llm/pagination.tokens.txt +35 -0
- package/dist/llm/pagination.txt +217 -0
- package/dist/llm/popover.tokens.txt +18 -0
- package/dist/llm/popover.txt +233 -0
- package/dist/llm/progress.tokens.txt +83 -0
- package/dist/llm/progress.txt +279 -0
- package/dist/llm/radio.tokens.txt +26 -0
- package/dist/llm/radio.txt +385 -0
- package/dist/llm/rate.tokens.txt +20 -0
- package/dist/llm/rate.txt +241 -0
- package/dist/llm/select.tokens.txt +160 -0
- package/dist/llm/select.txt +831 -0
- package/dist/llm/skeleton.tokens.txt +15 -0
- package/dist/llm/skeleton.txt +275 -0
- package/dist/llm/spin.tokens.txt +21 -0
- package/dist/llm/spin.txt +294 -0
- package/dist/llm/steps.tokens.txt +30 -0
- package/dist/llm/steps.txt +300 -0
- package/dist/llm/switch.tokens.txt +38 -0
- package/dist/llm/switch.txt +216 -0
- package/dist/llm/table.tokens.txt +94 -0
- package/dist/llm/table.txt +1049 -0
- package/dist/llm/tabs.tokens.txt +78 -0
- package/dist/llm/tabs.txt +306 -0
- package/dist/llm/tag.tokens.txt +75 -0
- package/dist/llm/tag.txt +304 -0
- package/dist/llm/tooltip.tokens.txt +22 -0
- package/dist/llm/tooltip.txt +304 -0
- package/dist/llm/tree-select.tokens.txt +175 -0
- package/dist/llm/tree-select.txt +772 -0
- package/dist/llm/tree.tokens.txt +34 -0
- package/dist/llm/tree.txt +501 -0
- package/dist/llm/typography.tokens.txt +60 -0
- package/dist/llm/typography.txt +413 -0
- package/dist/llm/upload.tokens.txt +205 -0
- package/dist/llm/upload.txt +708 -0
- package/dist/llms-full.txt +16826 -0
- package/dist/llms-theme.txt +32 -0
- package/dist/llms.txt +59 -0
- package/dist/locale/en_US.cjs +160 -0
- package/dist/locale/en_US.d.ts +4 -0
- package/dist/locale/en_US.mjs +161 -0
- package/dist/locale/zh_CN.cjs +160 -0
- package/dist/locale/zh_CN.d.ts +4 -0
- package/dist/locale/zh_CN.mjs +161 -0
- package/dist/style.css +20095 -0
- package/dist/zh_CN.d.ts +191 -0
- package/llms-full.txt +16826 -0
- package/llms-theme.txt +32 -0
- package/llms.txt +59 -0
- package/package.json +118 -3
- package/src/alert/llm.txt +167 -0
- package/src/alert/tokens.txt +44 -0
- package/src/apex-provider/llm.txt +369 -0
- package/src/auto-complete/llm.txt +373 -0
- package/src/auto-complete/tokens.txt +77 -0
- package/src/avatar/llm.txt +199 -0
- package/src/avatar/tokens.txt +38 -0
- package/src/breadcrumb/llm.txt +251 -0
- package/src/breadcrumb/tokens.txt +143 -0
- package/src/button/llm.txt +270 -0
- package/src/button/tokens.txt +470 -0
- package/src/card/llm.txt +118 -0
- package/src/card/tokens.txt +29 -0
- package/src/cascader/llm.txt +917 -0
- package/src/cascader/tokens.txt +261 -0
- package/src/checkbox/llm.txt +343 -0
- package/src/checkbox/tokens.txt +36 -0
- package/src/collapse/llm.txt +330 -0
- package/src/collapse/tokens.txt +84 -0
- package/src/date-picker/llm.txt +428 -0
- package/src/date-picker/tokens.txt +171 -0
- package/src/divider/llm.txt +161 -0
- package/src/divider/tokens.txt +22 -0
- package/src/drawer/llm.txt +369 -0
- package/src/drawer/tokens.txt +71 -0
- package/src/dropdown/llm.txt +420 -0
- package/src/dropdown/tokens.txt +59 -0
- package/src/form/llm.txt +341 -0
- package/src/form/tokens.txt +28 -0
- package/src/grid/llm.txt +419 -0
- package/src/image/llm.txt +428 -0
- package/src/image/tokens.txt +28 -0
- package/src/input/llm.txt +424 -0
- package/src/input/tokens.txt +136 -0
- package/src/input-number/llm.txt +491 -0
- package/src/input-number/tokens.txt +159 -0
- package/src/layout/llm.txt +298 -0
- package/src/layout/tokens.txt +29 -0
- package/src/menu/llm.txt +687 -0
- package/src/menu/tokens.txt +100 -0
- package/src/message/llm.txt +301 -0
- package/src/message/tokens.txt +25 -0
- package/src/modal/llm.txt +584 -0
- package/src/modal/tokens.txt +96 -0
- package/src/notification/llm.txt +383 -0
- package/src/notification/tokens.txt +79 -0
- package/src/pagination/llm.txt +217 -0
- package/src/pagination/tokens.txt +35 -0
- package/src/popover/llm.txt +233 -0
- package/src/popover/tokens.txt +18 -0
- package/src/progress/llm.txt +279 -0
- package/src/progress/tokens.txt +83 -0
- package/src/radio/llm.txt +385 -0
- package/src/radio/tokens.txt +26 -0
- package/src/rate/llm.txt +241 -0
- package/src/rate/tokens.txt +20 -0
- package/src/select/llm.txt +831 -0
- package/src/select/tokens.txt +160 -0
- package/src/skeleton/llm.txt +275 -0
- package/src/skeleton/tokens.txt +15 -0
- package/src/spin/llm.txt +294 -0
- package/src/spin/tokens.txt +21 -0
- package/src/steps/llm.txt +300 -0
- package/src/steps/tokens.txt +30 -0
- package/src/switch/llm.txt +216 -0
- package/src/switch/tokens.txt +38 -0
- package/src/table/llm.txt +1049 -0
- package/src/table/tokens.txt +94 -0
- package/src/tabs/llm.txt +306 -0
- package/src/tabs/tokens.txt +78 -0
- package/src/tag/llm.txt +304 -0
- package/src/tag/tokens.txt +75 -0
- package/src/tooltip/llm.txt +304 -0
- package/src/tooltip/tokens.txt +22 -0
- package/src/tree/llm.txt +501 -0
- package/src/tree/tokens.txt +34 -0
- package/src/tree-select/llm.txt +772 -0
- package/src/tree-select/tokens.txt +175 -0
- package/src/typography/llm.txt +413 -0
- package/src/typography/tokens.txt +60 -0
- package/src/upload/llm.txt +708 -0
- package/src/upload/tokens.txt +205 -0
|
@@ -0,0 +1,385 @@
|
|
|
1
|
+
# Radio
|
|
2
|
+
|
|
3
|
+
> Radio:用户必须从多个互斥选项中选择一个时(如性别、配送方式)。
|
|
4
|
+
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
|
+
|
|
7
|
+
公开导出:`Radio`、`RadioGroup`、`RadioIndicator`。
|
|
8
|
+
|
|
9
|
+
以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
|
|
10
|
+
|
|
11
|
+
## 快速开始
|
|
12
|
+
|
|
13
|
+
```tsx
|
|
14
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
15
|
+
|
|
16
|
+
import '@apexhub/apex-ui-react/style.css'
|
|
17
|
+
|
|
18
|
+
export default () => (
|
|
19
|
+
<Radio.Group defaultValue="apple">
|
|
20
|
+
<Radio value="apple">苹果</Radio>
|
|
21
|
+
<Radio value="banana">香蕉</Radio>
|
|
22
|
+
<Radio value="orange">橙子</Radio>
|
|
23
|
+
</Radio.Group>
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## 何时使用
|
|
28
|
+
|
|
29
|
+
- 用户必须从多个互斥选项中选择一个时(如性别、配送方式)。
|
|
30
|
+
- 选项数量较少、需要并排或纵向展示全部选项时。
|
|
31
|
+
- 若允许选择多个,请使用 Checkbox 或 Checkbox.Group,而不是 Radio。
|
|
32
|
+
|
|
33
|
+
## API
|
|
34
|
+
|
|
35
|
+
仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
|
|
36
|
+
|
|
37
|
+
### Radio
|
|
38
|
+
|
|
39
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
40
|
+
| --- | --- | --- | --- | --- |
|
|
41
|
+
| value | 选项值,与组当前值比较以判断是否选中 | `string \| number \| boolean` | 是 | — |
|
|
42
|
+
| checked | 是否选中(受控) | `boolean` | 否 | `false` |
|
|
43
|
+
| defaultChecked | 初始是否选中(非受控) | `boolean` | 否 | `false` |
|
|
44
|
+
| disabled | 是否禁用 | `boolean` | 否 | `false` |
|
|
45
|
+
| name | 单独使用时子项共享的表单 `name`(组内由 `Radio.Group` 的 `name` 控制) | `string` | 否 | — |
|
|
46
|
+
| onChange | 状态变化回调(单独使用时使用;`e.target.checked`) | `(event: RadioChangeEvent) => void` | 否 | — |
|
|
47
|
+
| classNames | 为各语义子结构自定义 `className`,支持对象或函数 | `Partial<Record<RadioSemanticDOM, string>> \| ((info: { props: Readonly<RadioProps> }) => Partial<Record<RadioSemanticDOM, string>>)` | 否 | — |
|
|
48
|
+
| styles | 为各语义子结构自定义内联样式(仅允许 CSS Token 等变量赋值,禁止业务硬编码色值) | `Partial<Record<RadioSemanticDOM, React.CSSProperties>> \| ((info: { props: Readonly<RadioProps> }) => Partial<Record<RadioSemanticDOM, React.CSSProperties>>)` | 否 | — |
|
|
49
|
+
| children | 选项标签内容 | `React.ReactNode` | 否 | — |
|
|
50
|
+
|
|
51
|
+
### RadixRadioGroupRootProps
|
|
52
|
+
|
|
53
|
+
```typescript
|
|
54
|
+
type RadixRadioGroupRootProps = React.ComponentProps<typeof RadioGroup.Root>
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### RadixRadioItemProps
|
|
58
|
+
|
|
59
|
+
```typescript
|
|
60
|
+
type RadixRadioItemProps = React.ComponentProps<typeof RadioGroup.Item>
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### RadioSemanticDOM
|
|
64
|
+
|
|
65
|
+
Radio(单选项,`RadioGroup.Item`)子结构语义,用于 `classNames` / `styles` 分段定制
|
|
66
|
+
|
|
67
|
+
```typescript
|
|
68
|
+
type RadioSemanticDOM = 'root' | 'indicator'
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### RadioGroupSemanticDOM
|
|
72
|
+
|
|
73
|
+
Radio.Group(`RadioGroup.Root`)子结构语义,用于 `classNames` / `styles` 分段定制
|
|
74
|
+
|
|
75
|
+
```typescript
|
|
76
|
+
type RadioGroupSemanticDOM = 'root'
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### RadioGroupChangeTarget
|
|
80
|
+
|
|
81
|
+
继承:`EventTarget`;本节列出新增或重声明字段。
|
|
82
|
+
|
|
83
|
+
组值变更时回调中 `target.value`(实现层可与 Radix 字符串互转)
|
|
84
|
+
|
|
85
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
86
|
+
| --- | --- | --- | --- | --- |
|
|
87
|
+
| value | — | `string \| number \| boolean` | 是 | — |
|
|
88
|
+
|
|
89
|
+
### RadioGroupChangeEvent
|
|
90
|
+
|
|
91
|
+
继承:`React.SyntheticEvent<HTMLDivElement, Event>`;本节列出新增或重声明字段。
|
|
92
|
+
|
|
93
|
+
Radio.Group `onChange` 事件对象(实现层负责提供 `target.value`)
|
|
94
|
+
|
|
95
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
96
|
+
| --- | --- | --- | --- | --- |
|
|
97
|
+
| target | — | `RadioGroupChangeTarget` | 是 | — |
|
|
98
|
+
|
|
99
|
+
### RadioChangeTarget
|
|
100
|
+
|
|
101
|
+
继承:`EventTarget`;本节列出新增或重声明字段。
|
|
102
|
+
|
|
103
|
+
单独使用 Radio 时,`onChange` `target.checked`
|
|
104
|
+
|
|
105
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
106
|
+
| --- | --- | --- | --- | --- |
|
|
107
|
+
| checked | — | `boolean` | 是 | — |
|
|
108
|
+
|
|
109
|
+
### RadioChangeEvent
|
|
110
|
+
|
|
111
|
+
继承:`React.SyntheticEvent<HTMLButtonElement, Event>`;本节列出新增或重声明字段。
|
|
112
|
+
|
|
113
|
+
Radio `onChange` 事件对象(实现层负责提供 `target.checked`)
|
|
114
|
+
|
|
115
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
116
|
+
| --- | --- | --- | --- | --- |
|
|
117
|
+
| target | — | `RadioChangeTarget` | 是 | — |
|
|
118
|
+
|
|
119
|
+
### RadioOptionType
|
|
120
|
+
|
|
121
|
+
`Radio.Group` 的 `options` 项描述
|
|
122
|
+
|
|
123
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
124
|
+
| --- | --- | --- | --- | --- |
|
|
125
|
+
| label | 展示文案 | `string` | 否 | — |
|
|
126
|
+
| value | 选项值,参与组内比较 | `string \| number \| boolean` | 是 | — |
|
|
127
|
+
| style | 应用到该选项根节点的样式;仅允许 CSS Token 等变量赋值,禁止业务硬编码色值 | `React.CSSProperties` | 否 | — |
|
|
128
|
+
| className | 选项根节点 `className` | `string` | 否 | — |
|
|
129
|
+
| disabled | 是否禁用该选项 | `boolean` | 否 | `false` |
|
|
130
|
+
| title | 原生 `title` | `string` | 否 | — |
|
|
131
|
+
| id | 原生 `id` | `string` | 否 | — |
|
|
132
|
+
| onChange | 组选中值变化时触发(`options` 项上;与组级 `onChange` 并存时由实现约定优先级) | `(event: RadioGroupChangeEvent) => void` | 否 | — |
|
|
133
|
+
| required | 是否必选 | `boolean` | 否 | `false` |
|
|
134
|
+
|
|
135
|
+
### RadioGroupProps
|
|
136
|
+
|
|
137
|
+
继承:`Omit<RadixRadioGroupRootProps, 'value' | 'defaultValue' | 'onValueChange' | 'onChange'>`;本节列出新增或重声明字段。
|
|
138
|
+
|
|
139
|
+
Radio.Group Props(底层对应 Radix `RadioGroup.Root`)
|
|
140
|
+
|
|
141
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
142
|
+
| --- | --- | --- | --- | --- |
|
|
143
|
+
| value | 当前选中值(受控) | `string \| number \| boolean \| null` | 否 | — |
|
|
144
|
+
| defaultValue | 默认选中值(非受控) | `string \| number \| boolean` | 否 | — |
|
|
145
|
+
| onChange | 值变化回调 | `(event: RadioGroupChangeEvent) => void` | 否 | — |
|
|
146
|
+
| disabled | 整组是否禁用 | `boolean` | 否 | `false` |
|
|
147
|
+
| name | 子项共享的 `name`,对应原生单选组;不传时可由实现生成 | `string` | 否 | — |
|
|
148
|
+
| block | 占满父级宽度 | `boolean` | 否 | `false` |
|
|
149
|
+
| orientation | 排布方向(不使用 `vertical` boolean,仅以本属性为准) | `"horizontal" \| "vertical"` | 否 | `'horizontal'` |
|
|
150
|
+
| options | 快捷生成子选项;与 `children` 二选一或按实现约定合并 | `string[] \| number[] \| RadioOptionType[]` | 否 | — |
|
|
151
|
+
| classNames | 为组根节点自定义 `className`,支持对象或函数 | `Partial<Record<RadioGroupSemanticDOM, string>> \| ((info: { props: Readonly<RadioGroupProps> }) => Partial<Record<RadioGroupSemanticDOM, string>>)` | 否 | — |
|
|
152
|
+
| styles | 为组根节点自定义内联样式(仅允许 CSS Token 等变量赋值,禁止业务硬编码色值) | `Partial<Record<RadioGroupSemanticDOM, React.CSSProperties>> \| ((info: { props: Readonly<RadioGroupProps> }) => Partial<Record<RadioGroupSemanticDOM, React.CSSProperties>>)` | 否 | — |
|
|
153
|
+
| children | 自定义子节点(与 `options` 相对) | `React.ReactNode` | 否 | — |
|
|
154
|
+
|
|
155
|
+
### RadioIndicatorProps
|
|
156
|
+
|
|
157
|
+
继承:`React.HTMLAttributes<HTMLSpanElement>`;本节列出新增或重声明字段。
|
|
158
|
+
|
|
159
|
+
Radio 圆环指示器 Props(自定义 span,非 Radix Indicator)
|
|
160
|
+
|
|
161
|
+
(暂无属性)
|
|
162
|
+
|
|
163
|
+
### 导出类型
|
|
164
|
+
|
|
165
|
+
另可从 `@apexhub/apex-ui-react` 导入:`RadioChangeEvent`、`RadioGroupChangeEvent`、`RadioGroupProps`、`RadioIndicatorProps`、`RadioOptionType`、`RadioProps`(与上文子类型配合使用)。
|
|
166
|
+
|
|
167
|
+
## 代码演示
|
|
168
|
+
|
|
169
|
+
### 单独使用
|
|
170
|
+
|
|
171
|
+
组外可以通过 `checked` 与 变更事件 自行维护选中状态。
|
|
172
|
+
|
|
173
|
+
```tsx
|
|
174
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
175
|
+
|
|
176
|
+
import { useState } from 'react'
|
|
177
|
+
|
|
178
|
+
export default () => {
|
|
179
|
+
const [checked, setChecked] = useState(false)
|
|
180
|
+
|
|
181
|
+
return (
|
|
182
|
+
<Radio value="solo" checked={checked} onChange={(event) => setChecked(event.target.checked)}>
|
|
183
|
+
单独选项
|
|
184
|
+
</Radio>
|
|
185
|
+
)
|
|
186
|
+
}
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
### 禁用状态
|
|
190
|
+
|
|
191
|
+
可禁用单个 Radio,也可以通过 `Radio.Group` 禁用整组。
|
|
192
|
+
|
|
193
|
+
```tsx
|
|
194
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
195
|
+
|
|
196
|
+
export default () => (
|
|
197
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
|
|
198
|
+
<Radio.Group defaultValue="a">
|
|
199
|
+
<Radio value="a">可选 A</Radio>
|
|
200
|
+
<Radio value="b" disabled>
|
|
201
|
+
禁用 B
|
|
202
|
+
</Radio>
|
|
203
|
+
</Radio.Group>
|
|
204
|
+
<Radio.Group defaultValue="c" disabled>
|
|
205
|
+
<Radio value="c">整组禁用 C</Radio>
|
|
206
|
+
<Radio value="d">整组禁用 D</Radio>
|
|
207
|
+
</Radio.Group>
|
|
208
|
+
</div>
|
|
209
|
+
)
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### 状态对照
|
|
213
|
+
|
|
214
|
+
并排展示默认与禁用状态下的未选中、已选中 Radio,便于对照控件图形与文字间距。
|
|
215
|
+
|
|
216
|
+
```tsx
|
|
217
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
218
|
+
|
|
219
|
+
export default () => (
|
|
220
|
+
<div
|
|
221
|
+
style={{
|
|
222
|
+
display: 'grid',
|
|
223
|
+
gridTemplateColumns: 'auto repeat(2, minmax(88px, 1fr))',
|
|
224
|
+
alignItems: 'center',
|
|
225
|
+
columnGap: 16,
|
|
226
|
+
rowGap: 12,
|
|
227
|
+
width: 'min(100%, 280px)',
|
|
228
|
+
}}
|
|
229
|
+
>
|
|
230
|
+
<span />
|
|
231
|
+
<span>未选中</span>
|
|
232
|
+
<span>已选中</span>
|
|
233
|
+
<span>默认</span>
|
|
234
|
+
<Radio value="default-unchecked">默认-未选中</Radio>
|
|
235
|
+
<Radio value="default-checked" defaultChecked>
|
|
236
|
+
默认-已选中
|
|
237
|
+
</Radio>
|
|
238
|
+
<span>禁用</span>
|
|
239
|
+
<Radio value="disabled-unchecked" disabled>
|
|
240
|
+
禁用-未选中
|
|
241
|
+
</Radio>
|
|
242
|
+
<Radio value="disabled-checked" disabled defaultChecked>
|
|
243
|
+
禁用-已选中
|
|
244
|
+
</Radio>
|
|
245
|
+
</div>
|
|
246
|
+
)
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
### 受控用法
|
|
250
|
+
|
|
251
|
+
通过 `value` 和 变更事件 控制选中项。
|
|
252
|
+
|
|
253
|
+
```tsx
|
|
254
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
255
|
+
|
|
256
|
+
import { useState } from 'react'
|
|
257
|
+
|
|
258
|
+
export default () => {
|
|
259
|
+
const [value, setValue] = useState<string | number | boolean>('a')
|
|
260
|
+
|
|
261
|
+
return (
|
|
262
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
|
|
263
|
+
<Radio.Group value={value} onChange={(event) => setValue(event.target.value)}>
|
|
264
|
+
<Radio value="a">选项 A</Radio>
|
|
265
|
+
<Radio value="b">选项 B</Radio>
|
|
266
|
+
</Radio.Group>
|
|
267
|
+
<span>当前值:{String(value)}</span>
|
|
268
|
+
</div>
|
|
269
|
+
)
|
|
270
|
+
}
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
### 垂直排列
|
|
274
|
+
|
|
275
|
+
通过 `orientation="vertical"` 垂直排列,不提供 `vertical` boolean。
|
|
276
|
+
|
|
277
|
+
```tsx
|
|
278
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
279
|
+
|
|
280
|
+
export default () => (
|
|
281
|
+
<Radio.Group defaultValue="email" orientation="vertical">
|
|
282
|
+
<Radio value="email">邮件通知</Radio>
|
|
283
|
+
<Radio value="sms">短信通知</Radio>
|
|
284
|
+
<Radio value="none">不通知</Radio>
|
|
285
|
+
</Radio.Group>
|
|
286
|
+
)
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
### 快捷选项
|
|
290
|
+
|
|
291
|
+
通过 `options` 快速生成选项,适合选项结构简单的场景。
|
|
292
|
+
|
|
293
|
+
```tsx
|
|
294
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
295
|
+
|
|
296
|
+
export default () => (
|
|
297
|
+
<Radio.Group
|
|
298
|
+
defaultValue="banana"
|
|
299
|
+
options={[
|
|
300
|
+
{ label: 'Apple', value: 'apple' },
|
|
301
|
+
{ label: 'Banana', value: 'banana' },
|
|
302
|
+
{ label: 'Cherry', value: 'cherry', disabled: true },
|
|
303
|
+
]}
|
|
304
|
+
/>
|
|
305
|
+
)
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
### 等宽排列
|
|
309
|
+
|
|
310
|
+
通过 `block` 让 Radio.Group 占满父级宽度。
|
|
311
|
+
|
|
312
|
+
```tsx
|
|
313
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
314
|
+
|
|
315
|
+
export default () => (
|
|
316
|
+
<div style={{ width: 360 }}>
|
|
317
|
+
<Radio.Group defaultValue="left" block>
|
|
318
|
+
<Radio value="left">左侧</Radio>
|
|
319
|
+
<Radio value="center">居中</Radio>
|
|
320
|
+
<Radio value="right">右侧</Radio>
|
|
321
|
+
</Radio.Group>
|
|
322
|
+
</div>
|
|
323
|
+
)
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
### 自定义语义结构
|
|
327
|
+
|
|
328
|
+
通过 `classNames` 和 `styles` 定制 Radio 或 Radio.Group 的语义节点样式。
|
|
329
|
+
|
|
330
|
+
```tsx
|
|
331
|
+
import type { RadioGroupProps, RadioProps } from '@apexhub/apex-ui-react'
|
|
332
|
+
|
|
333
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
334
|
+
|
|
335
|
+
const groupStyles: RadioGroupProps['styles'] = {
|
|
336
|
+
root: {
|
|
337
|
+
gap: 'var(--apex-spacing-16)',
|
|
338
|
+
},
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
const radioStyles: RadioProps['styles'] = {
|
|
342
|
+
indicator: {
|
|
343
|
+
opacity: 0.9,
|
|
344
|
+
},
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
export default () => (
|
|
348
|
+
<Radio.Group
|
|
349
|
+
defaultValue="basic"
|
|
350
|
+
classNames={{ root: 'custom-radio-group' }}
|
|
351
|
+
styles={groupStyles}
|
|
352
|
+
>
|
|
353
|
+
<Radio
|
|
354
|
+
value="basic"
|
|
355
|
+
classNames={{ root: 'custom-radio-root', indicator: 'custom-radio-indicator' }}
|
|
356
|
+
styles={radioStyles}
|
|
357
|
+
>
|
|
358
|
+
基础版
|
|
359
|
+
</Radio>
|
|
360
|
+
<Radio value="pro">专业版</Radio>
|
|
361
|
+
</Radio.Group>
|
|
362
|
+
)
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
## DOM 结构
|
|
366
|
+
|
|
367
|
+
源码声明的静态 `data-slot`:`radio-indicator`、`radio`、`radio-group`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
368
|
+
|
|
369
|
+
## 样式定制
|
|
370
|
+
|
|
371
|
+
优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
|
|
372
|
+
|
|
373
|
+
需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
|
|
374
|
+
|
|
375
|
+
## FAQ
|
|
376
|
+
|
|
377
|
+
### `options` 和 `children` 能同时用吗?
|
|
378
|
+
|
|
379
|
+
不建议。同时传入时仅渲染 `options`,`children` 会被忽略。
|
|
380
|
+
|
|
381
|
+
|
|
382
|
+
|
|
383
|
+
### 为什么没有 Radio.Button?
|
|
384
|
+
|
|
385
|
+
当前不提供 antd 的按钮化单选(`Radio.Button` / `buttonStyle` / `optionType`);需要按钮形态时请使用 Button 组或 Segmented(规划中)。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Radio Token 明细
|
|
2
|
+
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
|
+
|
|
5
|
+
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
|
+
|
|
7
|
+
以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
|
|
8
|
+
|
|
9
|
+
定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
|
|
10
|
+
|
|
11
|
+
| Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
|
|
12
|
+
| --- | --- | --- | --- |
|
|
13
|
+
| `--radio-icon-icon` | `height`、`width` | `var(--apex-size-20)` | `.apex-radio.apex-default-radio` |
|
|
14
|
+
| `--radio-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-radio.apex-default-radio` |
|
|
15
|
+
| `--radio-stoke-stroke` | `border`、`height`、`width` | `var(--apex-border-1)` | `.apex-radio.apex-default-radio` |
|
|
16
|
+
| `--radio-stroke-active` | `border-color` | `var(--apex-stroke-neutral-septenary)` | `.apex-radio.apex-default-radio` |
|
|
17
|
+
| `--radio-stroke-check-active` | `background-color`、`border-color` | `var(--apex-stroke-brand-tertiary)` | `.apex-radio.apex-default-radio` |
|
|
18
|
+
| `--radio-stroke-check-hover` | `background-color`、`border-color` | `var(--apex-stroke-brand-secondary)` | `.apex-radio.apex-default-radio` |
|
|
19
|
+
| `--radio-stroke-default` | `border` | `var(--apex-stroke-neutral-denary)` | `.apex-radio.apex-default-radio` |
|
|
20
|
+
| `--radio-stroke-disabled` | `background-color`、`border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-radio.apex-default-radio` |
|
|
21
|
+
| `--radio-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-octonary)` | `.apex-radio.apex-default-radio` |
|
|
22
|
+
| `--radio-stroke-selected` | `background-color`、`border-color` | `var(--apex-stroke-brand-primary)` | `.apex-radio.apex-default-radio` |
|
|
23
|
+
| `--radio-text-active` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-radio.apex-default-radio` |
|
|
24
|
+
| `--radio-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-radio.apex-default-radio` |
|
|
25
|
+
| `--radio-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-radio.apex-default-radio` |
|
|
26
|
+
| `--radio-text-hover` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-radio.apex-default-radio` |
|
package/src/rate/llm.txt
ADDED
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
# Rate
|
|
2
|
+
|
|
3
|
+
> Rate:需要对服务、内容或商品进行星级评价时。
|
|
4
|
+
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
|
+
|
|
7
|
+
公开导出:`Rate`、`StarFilled`。
|
|
8
|
+
|
|
9
|
+
以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
|
|
10
|
+
|
|
11
|
+
## 快速开始
|
|
12
|
+
|
|
13
|
+
```tsx
|
|
14
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
15
|
+
|
|
16
|
+
import '@apexhub/apex-ui-react/style.css'
|
|
17
|
+
|
|
18
|
+
export default () => <Rate defaultValue={3} aria-label="评分" />
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## 何时使用
|
|
22
|
+
|
|
23
|
+
- 需要对服务、内容或商品进行星级评价时。
|
|
24
|
+
- 需要半星精度或悬停预览分值时。
|
|
25
|
+
- 纯展示型进度或百分比请使用 Progress;二元开关请使用 Switch。
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
|
|
30
|
+
|
|
31
|
+
### Rate
|
|
32
|
+
|
|
33
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
34
|
+
| --- | --- | --- | --- | --- |
|
|
35
|
+
| allowClear | 是否允许再次点击后清除 | `boolean` | 否 | `true` |
|
|
36
|
+
| allowHalf | 是否允许半选 | `boolean` | 否 | `false` |
|
|
37
|
+
| character | — | `React.ReactNode \| ((props: RateCharacterInfo) => React.ReactNode)` | 否 | — |
|
|
38
|
+
| count | star 总数 | `number` | 否 | `5` |
|
|
39
|
+
| defaultValue | 默认值 | `number` | 否 | `0` |
|
|
40
|
+
| disabled | 只读,无法进行交互 | `boolean` | 否 | `false` |
|
|
41
|
+
| keyboard | 支持使用键盘操作 | `boolean` | 否 | `true` |
|
|
42
|
+
| size | 星星尺寸 | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
|
|
43
|
+
| tooltips | 自定义每项的提示信息 | `RateTooltipItem[]` | 否 | — |
|
|
44
|
+
| value | 当前数,受控值 | `number` | 否 | — |
|
|
45
|
+
| onBlur | 失去焦点时的回调 | `() => void` | 否 | — |
|
|
46
|
+
| onChange | 选择时的回调 | `(value: number) => void` | 否 | — |
|
|
47
|
+
| onFocus | 获取焦点时的回调 | `() => void` | 否 | — |
|
|
48
|
+
| onHoverChange | 鼠标经过时数值变化的回调 | `(value: number \| undefined) => void` | 否 | — |
|
|
49
|
+
| onKeyDown | 按键回调 | `React.KeyboardEventHandler<HTMLUListElement>` | 否 | — |
|
|
50
|
+
| ref | — | `React.Ref<RateRef>` | 否 | — |
|
|
51
|
+
|
|
52
|
+
### RateSize
|
|
53
|
+
|
|
54
|
+
```typescript
|
|
55
|
+
type RateSize = 'small' | 'medium' | 'large'
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### RateItemVisualState
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
type RateItemVisualState = 'full' | 'half' | 'empty'
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### RateCharacterInfo
|
|
65
|
+
|
|
66
|
+
单个星标渲染时传入 `character` 函数的上下文
|
|
67
|
+
|
|
68
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
69
|
+
| --- | --- | --- | --- | --- |
|
|
70
|
+
| index | — | `number` | 是 | — |
|
|
71
|
+
| value | — | `number` | 否 | — |
|
|
72
|
+
| count | — | `number` | 否 | — |
|
|
73
|
+
| disabled | — | `boolean` | 否 | — |
|
|
74
|
+
| allowHalf | — | `boolean` | 否 | — |
|
|
75
|
+
|
|
76
|
+
### RateTooltipItem
|
|
77
|
+
|
|
78
|
+
```typescript
|
|
79
|
+
type RateTooltipItem = string | TooltipProps
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### RateRef
|
|
83
|
+
|
|
84
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
85
|
+
| --- | --- | --- | --- | --- |
|
|
86
|
+
| focus | — | `() => void` | 是 | — |
|
|
87
|
+
| blur | — | `() => void` | 是 | — |
|
|
88
|
+
|
|
89
|
+
### RateItemProps
|
|
90
|
+
|
|
91
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
92
|
+
| --- | --- | --- | --- | --- |
|
|
93
|
+
| index | — | `number` | 是 | — |
|
|
94
|
+
| count | — | `number` | 是 | — |
|
|
95
|
+
| value | — | `number` | 是 | — |
|
|
96
|
+
| hoverValue | — | `number \| null` | 是 | — |
|
|
97
|
+
| allowHalf | — | `boolean` | 是 | — |
|
|
98
|
+
| disabled | — | `boolean` | 是 | — |
|
|
99
|
+
| focused | — | `boolean` | 是 | — |
|
|
100
|
+
| character | — | `React.ReactNode \| ((props: RateCharacterInfo) => React.ReactNode) \| undefined` | 是 | — |
|
|
101
|
+
| itemRef | — | `(node: HTMLLIElement \| null) => void` | 否 | — |
|
|
102
|
+
| onHover | — | `(event: React.MouseEvent<HTMLLIElement>, index: number) => void` | 是 | — |
|
|
103
|
+
| onClick | — | `( event: React.MouseEvent<HTMLLIElement> \| React.KeyboardEvent<HTMLLIElement>, index: number, ) => void` | 是 | — |
|
|
104
|
+
|
|
105
|
+
其他组件的类型不在此展开:`TooltipProps` 见 `../tooltip/llm.txt`。
|
|
106
|
+
|
|
107
|
+
### 导出类型
|
|
108
|
+
|
|
109
|
+
另可从 `@apexhub/apex-ui-react` 导入:`RateCharacterInfo`、`RateProps`、`RateRef`、`RateSize`、`RateTooltipItem`(与上文子类型配合使用)。
|
|
110
|
+
|
|
111
|
+
## 代码演示
|
|
112
|
+
|
|
113
|
+
### 半星
|
|
114
|
+
|
|
115
|
+
开启 `allowHalf` 后支持半星选择,点击星标左半区与右半区分别对应半星与整星。
|
|
116
|
+
|
|
117
|
+
```tsx
|
|
118
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
119
|
+
|
|
120
|
+
export default () => <Rate allowHalf defaultValue={2.5} aria-label="半星评分" />
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### 尺寸
|
|
124
|
+
|
|
125
|
+
提供 `small`、`medium`(默认)和 `large` 三种尺寸。
|
|
126
|
+
|
|
127
|
+
```tsx
|
|
128
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
129
|
+
|
|
130
|
+
export default () => (
|
|
131
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: 24 }}>
|
|
132
|
+
<Rate size="small" defaultValue={3} aria-label="小号评分" />
|
|
133
|
+
<Rate size="medium" defaultValue={3} aria-label="中号评分" />
|
|
134
|
+
<Rate size="large" defaultValue={3} aria-label="大号评分" />
|
|
135
|
+
</div>
|
|
136
|
+
)
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### 禁用状态
|
|
140
|
+
|
|
141
|
+
`disabled` 后评分只读,无法通过鼠标或键盘修改。
|
|
142
|
+
|
|
143
|
+
```tsx
|
|
144
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
145
|
+
|
|
146
|
+
export default () => <Rate defaultValue={3} disabled aria-label="禁用评分" />
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### 清除
|
|
150
|
+
|
|
151
|
+
`allowClear` 为 `true`(默认)时,再次点击当前分值可清除为 `0`。
|
|
152
|
+
|
|
153
|
+
```tsx
|
|
154
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
155
|
+
|
|
156
|
+
import { useState } from 'react'
|
|
157
|
+
|
|
158
|
+
export default () => {
|
|
159
|
+
const [value, setValue] = useState(2)
|
|
160
|
+
|
|
161
|
+
return (
|
|
162
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
|
|
163
|
+
<Rate value={value} onChange={setValue} allowClear aria-label="可清除评分" />
|
|
164
|
+
<span>当前值:{value}</span>
|
|
165
|
+
</div>
|
|
166
|
+
)
|
|
167
|
+
}
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
### 提示信息
|
|
171
|
+
|
|
172
|
+
通过 `tooltips` 为每个星标配置悬停提示,支持字符串或 Tooltip 配置对象。
|
|
173
|
+
|
|
174
|
+
```tsx
|
|
175
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
176
|
+
|
|
177
|
+
export default () => (
|
|
178
|
+
<Rate
|
|
179
|
+
defaultValue={2}
|
|
180
|
+
tooltips={['很差', '较差', '一般', '不错', '很棒']}
|
|
181
|
+
aria-label="带提示评分"
|
|
182
|
+
/>
|
|
183
|
+
)
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
### 自定义字符
|
|
187
|
+
|
|
188
|
+
通过 `character` 替换默认星标,可传入 自定义节点 或按索引返回内容的函数。
|
|
189
|
+
|
|
190
|
+
```tsx
|
|
191
|
+
import { Rate, StarFilled } from '@apexhub/apex-ui-react'
|
|
192
|
+
|
|
193
|
+
export default () => (
|
|
194
|
+
<Rate defaultValue={4} character={<StarFilled />} aria-label="自定义字符评分" />
|
|
195
|
+
)
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
### 受控用法
|
|
199
|
+
|
|
200
|
+
通过 `value` 与 变更事件 控制分值,可配合 悬停变化事件 监听悬停预览。
|
|
201
|
+
|
|
202
|
+
```tsx
|
|
203
|
+
import { Rate } from '@apexhub/apex-ui-react'
|
|
204
|
+
|
|
205
|
+
import { useState } from 'react'
|
|
206
|
+
|
|
207
|
+
export default () => {
|
|
208
|
+
const [value, setValue] = useState(3)
|
|
209
|
+
const [hoverValue, setHoverValue] = useState<number | undefined>()
|
|
210
|
+
|
|
211
|
+
return (
|
|
212
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
|
|
213
|
+
<Rate value={value} onChange={setValue} onHoverChange={setHoverValue} aria-label="受控评分" />
|
|
214
|
+
<span>选中:{value}</span>
|
|
215
|
+
<span>悬停预览:{hoverValue ?? '—'}</span>
|
|
216
|
+
</div>
|
|
217
|
+
)
|
|
218
|
+
}
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
## DOM 结构
|
|
222
|
+
|
|
223
|
+
源码声明的静态 `data-slot`:`rate`、`rate-item`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
224
|
+
|
|
225
|
+
## 样式定制
|
|
226
|
+
|
|
227
|
+
优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
|
|
228
|
+
|
|
229
|
+
需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
|
|
230
|
+
|
|
231
|
+
## FAQ
|
|
232
|
+
|
|
233
|
+
### 自定义 `character` 时半星怎么显示?
|
|
234
|
+
|
|
235
|
+
传入固定 ReactNode 时不会自动切换描边/半星样式;若需要半星效果,请使用 `character` 函数,根据 `index` 与 `value` 自行分支渲染。
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
### `onHoverChange` 为什么有时是 `undefined`?
|
|
240
|
+
|
|
241
|
+
鼠标离开评分区域时会清除悬停预览,此时回调参数为 `undefined`,而非 `0`。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Rate Token 明细
|
|
2
|
+
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
|
+
|
|
5
|
+
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
|
+
|
|
7
|
+
以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
|
|
8
|
+
|
|
9
|
+
定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
|
|
10
|
+
|
|
11
|
+
| Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
|
|
12
|
+
| --- | --- | --- | --- |
|
|
13
|
+
| `--rating-fill-active` | `color` | `var(--apex-fill-warning-primary)` | `.apex-rating.apex-default-rating` |
|
|
14
|
+
| `--rating-fill-default` | `color` | `var(--apex-fill-neutral-senary)` | `.apex-rating.apex-default-rating` |
|
|
15
|
+
| `--rating-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-rating.apex-lg-rating` |
|
|
16
|
+
| `--rating-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-rating.apex-md-rating` |
|
|
17
|
+
| `--rating-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-rating.apex-sm-rating` |
|
|
18
|
+
| `--rating-spacing-height` | `font-size`、`height`、`width` | `var(--apex-size-32)` | `.apex-rating.apex-lg-rating` |
|
|
19
|
+
| `--rating-spacing-height` | `font-size`、`height`、`width` | `var(--apex-size-24)` | `.apex-rating.apex-md-rating` |
|
|
20
|
+
| `--rating-spacing-height` | `font-size`、`height`、`width` | `var(--apex-size-16)` | `.apex-rating.apex-sm-rating` |
|