@apexhub/apex-ui-react 1.2.0 → 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/dist/index.cjs +3363 -3328
- package/dist/index.d.ts +26 -22
- package/dist/index.mjs +3363 -3328
- package/dist/llm/alert.tokens.txt +1 -1
- package/dist/llm/alert.txt +3 -3
- package/dist/llm/apex-provider.txt +3 -2
- package/dist/llm/auto-complete.tokens.txt +1 -1
- package/dist/llm/auto-complete.txt +1 -1
- package/dist/llm/avatar.tokens.txt +1 -1
- package/dist/llm/avatar.txt +1 -1
- package/dist/llm/breadcrumb.tokens.txt +46 -96
- package/dist/llm/breadcrumb.txt +8 -8
- package/dist/llm/button.tokens.txt +1 -1
- package/dist/llm/button.txt +16 -8
- package/dist/llm/card.tokens.txt +3 -1
- package/dist/llm/card.txt +24 -1
- package/dist/llm/cascader.tokens.txt +15 -7
- package/dist/llm/cascader.txt +25 -6
- package/dist/llm/checkbox.tokens.txt +10 -2
- package/dist/llm/checkbox.txt +24 -13
- package/dist/llm/collapse.tokens.txt +1 -1
- package/dist/llm/collapse.txt +1 -1
- package/dist/llm/date-picker.tokens.txt +10 -10
- package/dist/llm/date-picker.txt +7 -3
- package/dist/llm/divider.tokens.txt +1 -1
- package/dist/llm/divider.txt +1 -1
- package/dist/llm/drawer.tokens.txt +2 -2
- package/dist/llm/drawer.txt +2 -2
- package/dist/llm/dropdown.tokens.txt +1 -1
- package/dist/llm/dropdown.txt +1 -1
- package/dist/llm/form.tokens.txt +3 -1
- package/dist/llm/form.txt +1 -1
- package/dist/llm/grid.txt +9 -9
- package/dist/llm/image.tokens.txt +1 -1
- package/dist/llm/image.txt +2 -2
- package/dist/llm/input-number.tokens.txt +4 -4
- package/dist/llm/input-number.txt +8 -3
- package/dist/llm/input.tokens.txt +4 -4
- package/dist/llm/input.txt +4 -2
- package/dist/llm/layout.tokens.txt +1 -1
- package/dist/llm/layout.txt +1 -1
- package/dist/llm/menu.tokens.txt +21 -8
- package/dist/llm/menu.txt +19 -12
- package/dist/llm/message.tokens.txt +1 -1
- package/dist/llm/message.txt +1 -1
- package/dist/llm/modal.tokens.txt +1 -1
- package/dist/llm/modal.txt +9 -9
- package/dist/llm/notification.tokens.txt +1 -1
- package/dist/llm/notification.txt +1 -1
- package/dist/llm/pagination.tokens.txt +6 -4
- package/dist/llm/pagination.txt +18 -9
- package/dist/llm/popover.tokens.txt +4 -14
- package/dist/llm/popover.txt +3 -3
- package/dist/llm/progress.tokens.txt +1 -1
- package/dist/llm/progress.txt +4 -4
- package/dist/llm/radio.tokens.txt +11 -6
- package/dist/llm/radio.txt +38 -1
- package/dist/llm/rate.tokens.txt +1 -1
- package/dist/llm/rate.txt +1 -1
- package/dist/llm/select.tokens.txt +4 -4
- package/dist/llm/select.txt +8 -7
- package/dist/llm/skeleton.tokens.txt +1 -1
- package/dist/llm/skeleton.txt +1 -1
- package/dist/llm/spin.tokens.txt +1 -1
- package/dist/llm/spin.txt +1 -1
- package/dist/llm/steps.tokens.txt +1 -1
- package/dist/llm/steps.txt +1 -1
- package/dist/llm/switch.tokens.txt +1 -1
- package/dist/llm/switch.txt +1 -1
- package/dist/llm/table.tokens.txt +2 -2
- package/dist/llm/table.txt +16 -13
- package/dist/llm/tabs.tokens.txt +1 -1
- package/dist/llm/tabs.txt +1 -1
- package/dist/llm/tag.tokens.txt +1 -2
- package/dist/llm/tag.txt +7 -8
- package/dist/llm/tooltip.tokens.txt +1 -1
- package/dist/llm/tooltip.txt +1 -1
- package/dist/llm/tree-select.tokens.txt +7 -6
- package/dist/llm/tree-select.txt +32 -22
- package/dist/llm/tree.tokens.txt +1 -3
- package/dist/llm/tree.txt +11 -15
- package/dist/llm/typography.tokens.txt +1 -1
- package/dist/llm/typography.txt +1 -1
- package/dist/llm/upload.tokens.txt +5 -1
- package/dist/llm/upload.txt +4 -2
- package/dist/llms-full.txt +321 -184
- package/dist/llms.txt +1 -1
- package/dist/style.css +1716 -1240
- package/llms-full.txt +321 -184
- package/llms.txt +1 -1
- package/package.json +1 -1
- package/src/alert/llm.txt +3 -3
- package/src/alert/tokens.txt +1 -1
- package/src/apex-provider/llm.txt +3 -2
- package/src/auto-complete/llm.txt +1 -1
- package/src/auto-complete/tokens.txt +1 -1
- package/src/avatar/llm.txt +1 -1
- package/src/avatar/tokens.txt +1 -1
- package/src/breadcrumb/llm.txt +8 -8
- package/src/breadcrumb/tokens.txt +46 -96
- package/src/button/llm.txt +16 -8
- package/src/button/tokens.txt +1 -1
- package/src/card/llm.txt +24 -1
- package/src/card/tokens.txt +3 -1
- package/src/cascader/llm.txt +25 -6
- package/src/cascader/tokens.txt +15 -7
- package/src/checkbox/llm.txt +24 -13
- package/src/checkbox/tokens.txt +10 -2
- package/src/collapse/llm.txt +1 -1
- package/src/collapse/tokens.txt +1 -1
- package/src/date-picker/llm.txt +7 -3
- package/src/date-picker/tokens.txt +10 -10
- package/src/divider/llm.txt +1 -1
- package/src/divider/tokens.txt +1 -1
- package/src/drawer/llm.txt +2 -2
- package/src/drawer/tokens.txt +2 -2
- package/src/dropdown/llm.txt +1 -1
- package/src/dropdown/tokens.txt +1 -1
- package/src/form/llm.txt +1 -1
- package/src/form/tokens.txt +3 -1
- package/src/grid/llm.txt +9 -9
- package/src/image/llm.txt +2 -2
- package/src/image/tokens.txt +1 -1
- package/src/input/llm.txt +4 -2
- package/src/input/tokens.txt +4 -4
- package/src/input-number/llm.txt +8 -3
- package/src/input-number/tokens.txt +4 -4
- package/src/layout/llm.txt +1 -1
- package/src/layout/tokens.txt +1 -1
- package/src/menu/llm.txt +19 -12
- package/src/menu/tokens.txt +21 -8
- package/src/message/llm.txt +1 -1
- package/src/message/tokens.txt +1 -1
- package/src/modal/llm.txt +9 -9
- package/src/modal/tokens.txt +1 -1
- package/src/notification/llm.txt +1 -1
- package/src/notification/tokens.txt +1 -1
- package/src/pagination/llm.txt +18 -9
- package/src/pagination/tokens.txt +6 -4
- package/src/popover/llm.txt +3 -3
- package/src/popover/tokens.txt +4 -14
- package/src/progress/llm.txt +4 -4
- package/src/progress/tokens.txt +1 -1
- package/src/radio/llm.txt +38 -1
- package/src/radio/tokens.txt +11 -6
- package/src/rate/llm.txt +1 -1
- package/src/rate/tokens.txt +1 -1
- package/src/select/llm.txt +8 -7
- package/src/select/tokens.txt +4 -4
- package/src/skeleton/llm.txt +1 -1
- package/src/skeleton/tokens.txt +1 -1
- package/src/spin/llm.txt +1 -1
- package/src/spin/tokens.txt +1 -1
- package/src/steps/llm.txt +1 -1
- package/src/steps/tokens.txt +1 -1
- package/src/switch/llm.txt +1 -1
- package/src/switch/tokens.txt +1 -1
- package/src/table/llm.txt +16 -13
- package/src/table/tokens.txt +2 -2
- package/src/tabs/llm.txt +1 -1
- package/src/tabs/tokens.txt +1 -1
- package/src/tag/llm.txt +7 -8
- package/src/tag/tokens.txt +1 -2
- package/src/tooltip/llm.txt +1 -1
- package/src/tooltip/tokens.txt +1 -1
- package/src/tree/llm.txt +11 -15
- package/src/tree/tokens.txt +1 -3
- package/src/tree-select/llm.txt +32 -22
- package/src/tree-select/tokens.txt +7 -6
- package/src/typography/llm.txt +1 -1
- package/src/typography/tokens.txt +1 -1
- package/src/upload/llm.txt +4 -2
- package/src/upload/tokens.txt +5 -1
package/src/menu/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Menu:侧栏持久导航,需要在图标 rail 与展开列表之间切换时。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`isKeySelected`、`Menu`。
|
|
8
8
|
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
## 快速开始
|
|
12
12
|
|
|
13
13
|
```tsx
|
|
14
|
-
import { Button, Menu, MenuItemType } from '@apexhub/apex-ui-react'
|
|
14
|
+
import { Button, Menu, type MenuItemType } from '@apexhub/apex-ui-react'
|
|
15
15
|
|
|
16
16
|
import { useState } from 'react'
|
|
17
17
|
|
|
@@ -33,13 +33,20 @@ const items: MenuItemType[] = [
|
|
|
33
33
|
|
|
34
34
|
export default () => {
|
|
35
35
|
const [collapsed, setCollapsed] = useState(false)
|
|
36
|
+
|
|
36
37
|
return (
|
|
37
|
-
<
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
38
|
+
<Menu
|
|
39
|
+
items={items}
|
|
40
|
+
collapsed={collapsed}
|
|
41
|
+
onCollapse={setCollapsed}
|
|
42
|
+
defaultOpenKeys={['workspace']}
|
|
43
|
+
defaultSelectedKeys={['projects']}
|
|
44
|
+
footer={
|
|
45
|
+
<Button type="text" onClick={() => setCollapsed((current) => !current)}>
|
|
46
|
+
{collapsed ? '展开菜单' : '收起菜单'}
|
|
47
|
+
</Button>
|
|
48
|
+
}
|
|
49
|
+
/>
|
|
43
50
|
)
|
|
44
51
|
}
|
|
45
52
|
```
|
|
@@ -265,8 +272,8 @@ const railStyle = {
|
|
|
265
272
|
flexDirection: 'column' as const,
|
|
266
273
|
width: 'fit-content',
|
|
267
274
|
height: '100%',
|
|
268
|
-
backgroundColor: '
|
|
269
|
-
borderRight: '
|
|
275
|
+
backgroundColor: 'var(--apex-fill-neutral-secondary)',
|
|
276
|
+
borderRight: 'var(--apex-border-1) solid var(--apex-stroke-neutral-tertiary)',
|
|
270
277
|
padding: 8,
|
|
271
278
|
boxSizing: 'border-box' as const,
|
|
272
279
|
justifyContent: 'space-between' as const,
|
|
@@ -475,7 +482,7 @@ export default () => {
|
|
|
475
482
|
|
|
476
483
|
### 自定义顶栏
|
|
477
484
|
|
|
478
|
-
通过 `header` 与 `footer`
|
|
485
|
+
通过 `header` 与 `footer` 插槽自定义收窄与展开态的顶栏、底栏内容;展开态的顶栏沿用菜单 Token 表面样式。
|
|
479
486
|
|
|
480
487
|
```tsx
|
|
481
488
|
import { Avatar, Button, Card, Dropdown, Menu, Typography } from '@apexhub/apex-ui-react'
|
|
@@ -593,7 +600,7 @@ export default () => {
|
|
|
593
600
|
height: '100%',
|
|
594
601
|
cursor: 'pointer',
|
|
595
602
|
backgroundColor: profileHovered
|
|
596
|
-
? '
|
|
603
|
+
? 'var(--apex-fill-neutral-tertiary)'
|
|
597
604
|
: undefined,
|
|
598
605
|
transition: 'background-color 0.15s ease',
|
|
599
606
|
}}
|
package/src/menu/tokens.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Menu Token 明细
|
|
2
2
|
|
|
3
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
4
|
|
|
5
5
|
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
6
|
|
|
@@ -48,6 +48,19 @@
|
|
|
48
48
|
| `--menu-button-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu-button.apex-icon-menu-button` |
|
|
49
49
|
| `--menu-button-spacing-padding-x` | `padding` | `var(--apex-spacing-12)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
50
50
|
| `--menu-button-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
51
|
+
| `--menu-button-stroke-active` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
52
|
+
| `--menu-button-stroke-active` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
53
|
+
| `--menu-button-stroke-default` | `border` | `var(--apex-stroke-neutral-secondary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
54
|
+
| `--menu-button-stroke-default` | `border` | `var(--apex-stroke-neutral-secondary)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
55
|
+
| `--menu-button-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-primary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
56
|
+
| `--menu-button-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-primary)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
57
|
+
| `--menu-button-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-tertiary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
58
|
+
| `--menu-button-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-tertiary)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
59
|
+
| `--menu-button-stroke-selected` | `border-color` | `var(--apex-stroke-neutral-secondary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
60
|
+
| `--menu-button-stroke-selected` | `border-color` | `var(--apex-stroke-brand-transparent)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
61
|
+
| `--menu-button-stroke-stroke` | `border` | `var(--apex-border-1)` | `.apex-menu-button.apex-icon-menu-button` |
|
|
62
|
+
| `--menu-button-stroke-stroke` | `border` | `var(--apex-border-1)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
63
|
+
| `--menu-button-stroke-stroke` | `border` | `var(--apex-border-1)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
51
64
|
| `--menu-button-text-active` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
52
65
|
| `--menu-button-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-menu-button.apex-secondary-menu-button` |
|
|
53
66
|
| `--menu-button-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-menu-button.apex-primary-menu-button` |
|
|
@@ -62,13 +75,13 @@
|
|
|
62
75
|
| `--menu-fill-container-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-menu.apex-default-menu` |
|
|
63
76
|
| `--menu-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-menu.apex-container-md-menu` |
|
|
64
77
|
| `--menu-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-menu.apex-container-sm-menu` |
|
|
65
|
-
| `--menu-spacing-gap-md` | `gap`、`margin-
|
|
66
|
-
| `--menu-spacing-gap-md` | `gap`、`margin-
|
|
67
|
-
| `--menu-spacing-gap-sm` | `gap`、`
|
|
68
|
-
| `--menu-spacing-gap-sm` | `gap`、`
|
|
69
|
-
| `--menu-spacing-gap-sm` | `gap`、`
|
|
70
|
-
| `--menu-spacing-gap-sublist` | `padding-inline-start` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
|
|
71
|
-
| `--menu-spacing-gap-sublist` | `padding-inline-start` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-sm-menu` |
|
|
78
|
+
| `--menu-spacing-gap-md` | `gap`、`margin-block-start`、`padding`、`padding-bottom` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
|
|
79
|
+
| `--menu-spacing-gap-md` | `gap`、`margin-block-start`、`padding`、`padding-bottom` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-sm-menu` |
|
|
80
|
+
| `--menu-spacing-gap-sm` | `gap`、`margin-block`、`margin-block-end`、`margin-inline-start`、`max-width`、`padding`、`width` | `var(--apex-spacing-4)` | `.apex-menu-sliding-panel` |
|
|
81
|
+
| `--menu-spacing-gap-sm` | `gap`、`margin-block`、`margin-block-end`、`margin-inline-start`、`max-width`、`padding`、`width` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-md-menu` |
|
|
82
|
+
| `--menu-spacing-gap-sm` | `gap`、`margin-block`、`margin-block-end`、`margin-inline-start`、`max-width`、`padding`、`width` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
|
|
83
|
+
| `--menu-spacing-gap-sublist` | `margin-inline-start`、`max-width`、`padding-inline-start`、`width` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
|
|
84
|
+
| `--menu-spacing-gap-sublist` | `margin-inline-start`、`max-width`、`padding-inline-start`、`width` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-sm-menu` |
|
|
72
85
|
| `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu-sliding-panel` |
|
|
73
86
|
| `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-md-menu` |
|
|
74
87
|
| `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
|
package/src/message/llm.txt
CHANGED
package/src/message/tokens.txt
CHANGED
package/src/modal/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Modal:需要用户阅读并确认、取消或提交,且应暂时阻断当前页面操作时。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`Modal`。
|
|
8
8
|
|
|
@@ -73,7 +73,7 @@ export default () => {
|
|
|
73
73
|
| styles | 各语义节点的内联样式,支持对象或函数 | `Partial<Record<SemanticDOM, React.CSSProperties>> \| ((info: { props: ModalProps }) => Partial<Record<SemanticDOM, React.CSSProperties>>)` | 否 | — |
|
|
74
74
|
| title | 标题。`undefined`(缺省)且无关闭钮时自动补 sr-only 标题以满足无障碍;<br>`null` 时消费方在 `children` 中自行提供标题(如 `Modal.confirm`),不渲染标题区且不兜底 sr-only,须配合 `titleId` 关联无障碍名称。 | `React.ReactNode` | 否 | — |
|
|
75
75
|
| open | 是否显示弹窗(受控;必填) | `boolean` | 是 | — |
|
|
76
|
-
| width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 /
|
|
76
|
+
| width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 / 720 / 1000 断点匹配尺寸样式。<br>兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。 | `string \| number` | 否 | — |
|
|
77
77
|
| wrapClassName | 含蒙层的容器 className | `string` | 否 | — |
|
|
78
78
|
| onCancel | 点击蒙层、右上角关闭或 Cancel 时触发 | `(e: React.MouseEvent<HTMLElement> \| React.KeyboardEvent<HTMLElement>) => void` | 否 | — |
|
|
79
79
|
| onOk | 点击 OK 时触发 | `(e: React.MouseEvent<HTMLElement>) => void` | 否 | — |
|
|
@@ -262,7 +262,7 @@ export default () => {
|
|
|
262
262
|
|
|
263
263
|
### 尺寸与宽度
|
|
264
264
|
|
|
265
|
-
`size`
|
|
265
|
+
`size` 对应三档宽度:`sm` 420px、`md` 720px(默认)、`xl` 1000px;`lg` 为 720px 的兼容别名。传入 `width`(数字或 CSS 长度)时会覆盖预设宽度。
|
|
266
266
|
|
|
267
267
|
```tsx
|
|
268
268
|
import { Button, Modal } from '@apexhub/apex-ui-react'
|
|
@@ -270,14 +270,14 @@ import { Button, Modal } from '@apexhub/apex-ui-react'
|
|
|
270
270
|
import { useState } from 'react'
|
|
271
271
|
|
|
272
272
|
export default () => {
|
|
273
|
-
const [kind, setKind] = useState<'sm' | 'md' | '
|
|
273
|
+
const [kind, setKind] = useState<'sm' | 'md' | 'xl' | 'custom' | null>(null)
|
|
274
274
|
|
|
275
275
|
return (
|
|
276
276
|
<>
|
|
277
277
|
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
|
|
278
278
|
<Button onClick={() => setKind('sm')}>sm(420px)</Button>
|
|
279
|
-
<Button onClick={() => setKind('md')}>md(
|
|
280
|
-
<Button onClick={() => setKind('
|
|
279
|
+
<Button onClick={() => setKind('md')}>md(720px)</Button>
|
|
280
|
+
<Button onClick={() => setKind('xl')}>xl(1000px)</Button>
|
|
281
281
|
<Button onClick={() => setKind('custom')}>自定义 width</Button>
|
|
282
282
|
</div>
|
|
283
283
|
<Modal
|
|
@@ -299,13 +299,13 @@ export default () => {
|
|
|
299
299
|
使用 size="md"。
|
|
300
300
|
</Modal>
|
|
301
301
|
<Modal
|
|
302
|
-
open={kind === '
|
|
303
|
-
size="
|
|
302
|
+
open={kind === 'xl'}
|
|
303
|
+
size="xl"
|
|
304
304
|
title="大尺寸"
|
|
305
305
|
onCancel={() => setKind(null)}
|
|
306
306
|
onOk={() => setKind(null)}
|
|
307
307
|
>
|
|
308
|
-
使用 size="
|
|
308
|
+
使用 size="xl"。
|
|
309
309
|
</Modal>
|
|
310
310
|
<Modal
|
|
311
311
|
open={kind === 'custom'}
|
package/src/modal/tokens.txt
CHANGED
package/src/notification/llm.txt
CHANGED
package/src/pagination/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Pagination:数据量较大、需要分批次浏览列表或表格时。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`Pagination`。
|
|
8
8
|
|
|
@@ -21,7 +21,7 @@ export default () => <Pagination total={85} defaultCurrent={1} />
|
|
|
21
21
|
## 何时使用
|
|
22
22
|
|
|
23
23
|
- 数据量较大、需要分批次浏览列表或表格时。
|
|
24
|
-
-
|
|
24
|
+
- 需要让用户切换每页条数时;Vue 版也支持快速跳转到指定页。
|
|
25
25
|
- 纯滚动加载场景不必使用 Pagination;仅一页时可配合 `hideOnSinglePage` 隐藏分页器。
|
|
26
26
|
|
|
27
27
|
## API
|
|
@@ -42,8 +42,8 @@ export default () => <Pagination total={85} defaultCurrent={1} />
|
|
|
42
42
|
| pageSizeOptions | pageSize 切换器的可选档位。 | `number[]` | 否 | `[10, 20, 50, 100]` |
|
|
43
43
|
| disabled | 整体禁用 | `boolean` | 否 | `false` |
|
|
44
44
|
| showSizeChanger | 显示 pageSize 切换器。<br>未传 → total > 50 时自动 true;显式 false → 永远关;显式 true → 永远开 | `boolean` | 否 | — |
|
|
45
|
-
| showQuickJumper |
|
|
46
|
-
| showTotal |
|
|
45
|
+
| showQuickJumper | 兼容旧调用方;当前 React 设计不渲染快速跳转输入 | `boolean` | 否 | — |
|
|
46
|
+
| showTotal | 兼容旧调用方;当前 React 设计不渲染总数区域 | `ShowTotalFn` | 否 | — |
|
|
47
47
|
| hideOnSinglePage | 总页数 ≤ 1 时不渲染整个组件 | `boolean` | 否 | `false` |
|
|
48
48
|
| itemRender | 自定义每项渲染。<br>所有可点项(prev/next/jump-prev/jump-next/page)都调用此函数。<br>业务方应用 React.cloneElement(originalElement, ...) 保留 a11y props。 | `ItemRender` | 否 | — |
|
|
49
49
|
| responsive | 开启容器宽度自适应(ResizeObserver 四档)。 | `boolean` | 否 | `false` |
|
|
@@ -89,7 +89,7 @@ type PageItemType = 'page' | 'prev' | 'next' | 'jump-prev' | 'jump-next'
|
|
|
89
89
|
|
|
90
90
|
### 每页条数切换
|
|
91
91
|
|
|
92
|
-
数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger`
|
|
92
|
+
数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger` 强制开启或关闭。
|
|
93
93
|
|
|
94
94
|
```tsx
|
|
95
95
|
import { Pagination } from '@apexhub/apex-ui-react'
|
|
@@ -134,7 +134,9 @@ export default () => {
|
|
|
134
134
|
}
|
|
135
135
|
```
|
|
136
136
|
|
|
137
|
-
###
|
|
137
|
+
### 受控用法 (quick-jumper)
|
|
138
|
+
|
|
139
|
+
**快速跳转**
|
|
138
140
|
|
|
139
141
|
`showQuickJumper` 展示跳转输入框,输入页码后按 Enter 跳转。
|
|
140
142
|
|
|
@@ -157,14 +159,21 @@ export default () => {
|
|
|
157
159
|
}
|
|
158
160
|
```
|
|
159
161
|
|
|
160
|
-
###
|
|
162
|
+
### 受控用法 (show-total)
|
|
163
|
+
|
|
164
|
+
**显示总数**
|
|
161
165
|
|
|
162
166
|
`showTotal` 自定义总数展示文案,接收 `(total, range) => 自定义节点`。
|
|
163
167
|
|
|
164
168
|
```tsx
|
|
165
169
|
import { Pagination } from '@apexhub/apex-ui-react'
|
|
166
170
|
|
|
167
|
-
export default () =>
|
|
171
|
+
export default () => (
|
|
172
|
+
<Pagination
|
|
173
|
+
total={128}
|
|
174
|
+
showTotal={(total, range) => `共 ${total} 条,当前 ${range[0]}-${range[1]}`}
|
|
175
|
+
/>
|
|
176
|
+
)
|
|
168
177
|
```
|
|
169
178
|
|
|
170
179
|
### 禁用
|
|
@@ -201,7 +210,7 @@ export default () => <Pagination total={50} disabled />
|
|
|
201
210
|
|
|
202
211
|
### `responsive` 如何工作?
|
|
203
212
|
|
|
204
|
-
开启后组件通过 ResizeObserver
|
|
213
|
+
开启后组件通过 ResizeObserver 监听容器宽度,按阈值自动调整布局;Vue 版会逐步隐藏总数与条数切换器,React 版只调整当前实际渲染的控件。默认 `false`,须显式传入 `responsive`。
|
|
205
214
|
|
|
206
215
|
### `pageSizeOptions` 可以自定义吗?
|
|
207
216
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Pagination Token 明细
|
|
2
2
|
|
|
3
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
4
|
|
|
5
5
|
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
6
|
|
|
@@ -22,12 +22,14 @@
|
|
|
22
22
|
| `--pagination-button-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-pagination-button.apex-default-pagination-button` |
|
|
23
23
|
| `--pagination-button-spacing-height` | `height` | `var(--apex-size-28)` | `.apex-pagination-button.apex-default-pagination-button` |
|
|
24
24
|
| `--pagination-button-spacing-height` | `height` | `var(--pagination-height)` | `.apex-pagination.apex-default-pagination` |
|
|
25
|
-
| `--pagination-button-spacing-
|
|
26
|
-
| `--pagination-button-spacing-width` | `min-width` | `var(--apex-size-28)` | `.apex-pagination-button.apex-default-pagination-button` |
|
|
25
|
+
| `--pagination-button-spacing-width` | `min-width`、`width` | `var(--apex-size-28)` | `.apex-pagination-button.apex-default-pagination-button` |
|
|
27
26
|
| `--pagination-button-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-pagination-button.apex-default-pagination-button` |
|
|
28
27
|
| `--pagination-button-text-hover` | `color` | `var(--apex-text-neutral-primary)` | `.apex-pagination-button.apex-default-pagination-button` |
|
|
29
28
|
| `--pagination-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-pagination.apex-default-pagination` |
|
|
30
29
|
| `--pagination-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-pagination.apex-default-pagination` |
|
|
31
30
|
| `--pagination-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
|
|
31
|
+
| `--pagination-spacing-gap-text` | `gap` | `var(--apex-spacing-16)` | `.apex-pagination.apex-default-pagination` |
|
|
32
32
|
| `--pagination-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
|
|
33
|
-
| `--pagination-spacing-padding-y` | `height`、`padding` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
|
|
33
|
+
| `--pagination-spacing-padding-y` | `min-height`、`padding` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
|
|
34
|
+
| `--pagination-stroke-default` | `border` | `var(--apex-stroke-neutral-tertiary)` | `.apex-pagination.apex-default-pagination` |
|
|
35
|
+
| `--pagination-text-default` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-pagination.apex-default-pagination` |
|
package/src/popover/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Popover:需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`Popover`。
|
|
8
8
|
|
|
@@ -28,7 +28,7 @@ export default () => (
|
|
|
28
28
|
|
|
29
29
|
- 需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
|
|
30
30
|
- 点击或悬停展开补充说明、快捷操作面板时。
|
|
31
|
-
-
|
|
31
|
+
- 默认内容适合简短的补充信息;宽面板可通过 `className` 调整宽度,并在接近可用边界时自动收缩。
|
|
32
32
|
- 若只需单行文字提示、无交互内容,请使用 Tooltip,而不是 Popover。
|
|
33
33
|
|
|
34
34
|
## API
|
|
@@ -230,4 +230,4 @@ v1 仅支持单值触发方式,避免组合触发带来的状态复杂度;
|
|
|
230
230
|
|
|
231
231
|
### Popover 内容有固定最大宽度吗?
|
|
232
232
|
|
|
233
|
-
|
|
233
|
+
React Popover 默认最小宽度为 80px、最大宽度为 420px,并受浮层可用空间限制。需要更宽的业务面板时,可通过 `className` 覆盖最大宽度,并确保内容在可用空间内布局。
|
package/src/popover/tokens.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Popover Token 明细
|
|
2
2
|
|
|
3
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
4
|
|
|
5
5
|
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
6
|
|
|
@@ -10,19 +10,9 @@
|
|
|
10
10
|
|
|
11
11
|
| Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
|
|
12
12
|
| --- | --- | --- | --- |
|
|
13
|
-
| `--popover-fill-default` | `background-color`、`fill` | `var(--apex-fill-neutral-tertiary)` | `.apex-popover.apex-default-popover` |
|
|
14
|
-
| `--popover-fill-default` | `background-color`、`fill` | `var(--apex-fill-neutral-tertiary)` | `.apex-popover.apex-error-popover` |
|
|
15
|
-
| `--popover-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-popover.apex-default-popover` |
|
|
16
|
-
| `--popover-spacing-gap` | `gap` | `var(--apex-spacing-8)` | `.apex-popover.apex-default-popover` |
|
|
17
13
|
| `--popover-spacing-height-max` | `max-height` | `var(--apex-size-560)` | `.apex-popover.apex-default-popover` |
|
|
18
|
-
| `--popover-spacing-height-min` | `min-height` | `var(--apex-size-64)` | `.apex-popover.apex-default-popover` |
|
|
19
|
-
| `--popover-spacing-padding-x` | `padding` | `var(--apex-spacing-12)` | `.apex-popover.apex-default-popover` |
|
|
20
|
-
| `--popover-spacing-padding-y` | `padding` | `var(--apex-spacing-12)` | `.apex-popover.apex-default-popover` |
|
|
21
|
-
| `--popover-spacing-width-min` | `min-width` | `var(--apex-size-240)` | `.apex-popover.apex-default-popover` |
|
|
22
|
-
| `--popover-stroke-default` | `border`、`stroke` | `var(--apex-stroke-neutral-quinary)` | `.apex-popover.apex-default-popover` |
|
|
23
|
-
| `--popover-stroke-default` | `border`、`stroke` | `var(--apex-stroke-error-primary)` | `.apex-popover.apex-error-popover` |
|
|
24
|
-
| `--popover-stroke-stroke` | `border`、`margin-bottom`、`margin-top`、`stroke-width` | `var(--apex-border-08)` | `.apex-popover.apex-default-popover` |
|
|
25
|
-
| `--popover-text-body` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-popover.apex-default-popover` |
|
|
26
|
-
| `--popover-text-body` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-popover.apex-error-popover` |
|
|
27
14
|
| `--popover-text-title` | `color` | `var(--apex-text-neutral-primary)` | `.apex-popover.apex-default-popover` |
|
|
28
15
|
| `--popover-text-title` | `color` | `var(--apex-text-neutral-primary)` | `.apex-popover.apex-error-popover` |
|
|
16
|
+
| `--tooltip-fill-default` | `background-color`、`fill` | `var(--apex-fill-neutral-quaternary)` | `.apex-tooltip.apex-default-tooltip` |
|
|
17
|
+
| `--tooltip-stroke-default` | `border`、`stroke` | `var(--apex-stroke-neutral-transparent)` | `.apex-tooltip.apex-default-tooltip` |
|
|
18
|
+
| `--tooltip-stroke-stroke` | `border`、`margin-bottom`、`margin-top`、`stroke-width` | `var(--apex-border-08)` | `.apex-tooltip.apex-default-tooltip` |
|
package/src/progress/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Progress:需要向用户展示任务、上传、加载等操作的完成百分比时。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`Progress`。
|
|
8
8
|
|
|
@@ -119,7 +119,7 @@ export default () => (
|
|
|
119
119
|
|
|
120
120
|
通过 `success.percent` 在轨道内叠加已成功部分;`format` 第二个参数为成功段百分比,可用于自定义文案。
|
|
121
121
|
|
|
122
|
-
以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-
|
|
122
|
+
以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-bar-brand` / `--progress-bar-success` 对调(仅演示)。
|
|
123
123
|
|
|
124
124
|
```tsx
|
|
125
125
|
import { Progress, Tooltip } from '@apexhub/apex-ui-react'
|
|
@@ -245,8 +245,8 @@ const SuccessSegmentHoverMark = () => {
|
|
|
245
245
|
format={(_percent, success) => `${success ?? 0}%`}
|
|
246
246
|
style={
|
|
247
247
|
{
|
|
248
|
-
'--progress-
|
|
249
|
-
'--progress-
|
|
248
|
+
'--progress-bar-brand': percentStripColor,
|
|
249
|
+
'--progress-bar-success': successStripColor,
|
|
250
250
|
} as React.CSSProperties
|
|
251
251
|
}
|
|
252
252
|
/>
|
package/src/progress/tokens.txt
CHANGED
package/src/radio/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Radio:用户必须从多个互斥选项中选择一个时(如性别、配送方式)。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`Radio`、`RadioGroup`、`RadioIndicator`。
|
|
8
8
|
|
|
@@ -209,6 +209,43 @@ export default () => (
|
|
|
209
209
|
)
|
|
210
210
|
```
|
|
211
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
|
+
|
|
212
249
|
### 受控用法
|
|
213
250
|
|
|
214
251
|
通过 `value` 和 变更事件 控制选中项。
|
package/src/radio/tokens.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Radio Token 明细
|
|
2
2
|
|
|
3
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
4
|
|
|
5
5
|
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
6
|
|
|
@@ -10,12 +10,17 @@
|
|
|
10
10
|
|
|
11
11
|
| Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
|
|
12
12
|
| --- | --- | --- | --- |
|
|
13
|
-
| `--radio-icon-icon` | `
|
|
13
|
+
| `--radio-icon-icon` | `height`、`width` | `var(--apex-size-20)` | `.apex-radio.apex-default-radio` |
|
|
14
14
|
| `--radio-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-radio.apex-default-radio` |
|
|
15
|
-
| `--radio-stoke-stroke` | `border
|
|
16
|
-
| `--radio-stroke-
|
|
17
|
-
| `--radio-stroke-
|
|
18
|
-
| `--radio-stroke-hover` | `border-color` | `var(--apex-stroke-
|
|
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` |
|
|
19
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` |
|
|
20
24
|
| `--radio-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-radio.apex-default-radio` |
|
|
21
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
CHANGED
package/src/rate/tokens.txt
CHANGED
package/src/select/llm.txt
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Select:选项来自预设列表,需要从其中选择一个或多个值时。
|
|
4
4
|
|
|
5
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
6
|
|
|
7
7
|
公开导出:`Select`。
|
|
8
8
|
|
|
@@ -388,7 +388,7 @@ type MaxTagCount = number | 'responsive'
|
|
|
388
388
|
|
|
389
389
|
### 尺寸
|
|
390
390
|
|
|
391
|
-
支持 `large
|
|
391
|
+
支持 `large`、`medium`(默认)、`small` 三种尺寸。示例选中值并开启清除:large/medium 的下拉箭头为 16px,small 为 14px,清除按钮均为 14px。
|
|
392
392
|
|
|
393
393
|
```tsx
|
|
394
394
|
import { Select } from '@apexhub/apex-ui-react'
|
|
@@ -400,9 +400,9 @@ const options = [
|
|
|
400
400
|
|
|
401
401
|
export default () => (
|
|
402
402
|
<div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
|
|
403
|
-
<Select size="large"
|
|
404
|
-
<Select size="medium"
|
|
405
|
-
<Select size="small"
|
|
403
|
+
<Select size="large" defaultValue="react" allowClear options={options} />
|
|
404
|
+
<Select size="medium" defaultValue="react" allowClear options={options} />
|
|
405
|
+
<Select size="small" defaultValue="react" allowClear options={options} />
|
|
406
406
|
</div>
|
|
407
407
|
)
|
|
408
408
|
```
|
|
@@ -429,7 +429,7 @@ export default () => (
|
|
|
429
429
|
|
|
430
430
|
### 只读
|
|
431
431
|
|
|
432
|
-
`readOnly`
|
|
432
|
+
`readOnly` 不可打开下拉、不可改值;视觉使用禁用配色,但仍可聚焦。示例包含空值、单选和多选。
|
|
433
433
|
|
|
434
434
|
```tsx
|
|
435
435
|
import { Select } from '@apexhub/apex-ui-react'
|
|
@@ -442,6 +442,7 @@ const options = [
|
|
|
442
442
|
|
|
443
443
|
export default () => (
|
|
444
444
|
<div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
|
|
445
|
+
<Select readOnly placeholder="只读空值" options={options} style={{ minWidth: 160 }} />
|
|
445
446
|
<Select readOnly defaultValue="a" options={options} />
|
|
446
447
|
<Select
|
|
447
448
|
mode="multiple"
|
|
@@ -827,4 +828,4 @@ export default () => (
|
|
|
827
828
|
|
|
828
829
|
### `readOnly` 和 `disabled` 有什么区别?
|
|
829
830
|
|
|
830
|
-
`disabled`
|
|
831
|
+
`disabled` 不可交互;`readOnly` 同样使用禁用配色且不可打开下拉或改值,但保留可聚焦语义,适合表单只读场景。
|
package/src/select/tokens.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Select Token 明细
|
|
2
2
|
|
|
3
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
4
|
|
|
5
5
|
按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
|
|
6
6
|
|
|
@@ -140,10 +140,10 @@
|
|
|
140
140
|
| `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-sm-input` |
|
|
141
141
|
| `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
|
|
142
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-
|
|
143
|
+
| `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-default-input` |
|
|
144
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-
|
|
146
|
-
| `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-
|
|
145
|
+
| `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
|
|
146
|
+
| `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
|
|
147
147
|
| `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
|
|
148
148
|
| `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
|
|
149
149
|
| `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
|