@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/llms-full.txt
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
> Alert:需要在当前页面内展示操作结果、风险提示或补充说明,且信息应持续可见时。
|
|
8
8
|
|
|
9
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
9
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
10
10
|
|
|
11
11
|
公开导出:`Alert`。
|
|
12
12
|
|
|
@@ -108,7 +108,7 @@ export default () => <Alert type="warning" title="可关闭的警告" closable s
|
|
|
108
108
|
|
|
109
109
|
### 操作区
|
|
110
110
|
|
|
111
|
-
通过 `action`
|
|
111
|
+
通过 `action` 在右侧放置操作按钮或链接。示例使用 `text-secondary` 的 medium 按钮;关闭控件使用 medium 图标按钮。
|
|
112
112
|
|
|
113
113
|
```tsx
|
|
114
114
|
import { Alert, Button } from '@apexhub/apex-ui-react'
|
|
@@ -119,7 +119,7 @@ export default () => (
|
|
|
119
119
|
title="提交失败"
|
|
120
120
|
description="网络异常,请稍后重试。"
|
|
121
121
|
action={
|
|
122
|
-
<Button
|
|
122
|
+
<Button variant="text-secondary" size="medium">
|
|
123
123
|
重试
|
|
124
124
|
</Button>
|
|
125
125
|
}
|
|
@@ -176,7 +176,7 @@ Apex Alert 使用 `title` 作为主标题字段,语义更清晰,也与 Messa
|
|
|
176
176
|
|
|
177
177
|
> ApexProvider:在应用或微前端子应用最外层包裹,确保组件库 Token、主题、滚动条样式在整个组件树生效。
|
|
178
178
|
|
|
179
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
179
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
180
180
|
|
|
181
181
|
公开导出:`ApexProvider`、`useConfig`。
|
|
182
182
|
|
|
@@ -443,7 +443,7 @@ export default () => {
|
|
|
443
443
|
</Form.Item>
|
|
444
444
|
</Form>
|
|
445
445
|
|
|
446
|
-
<Pagination total={60} defaultCurrent={1}
|
|
446
|
+
<Pagination total={60} defaultCurrent={1} showSizeChanger />
|
|
447
447
|
|
|
448
448
|
<DatePicker />
|
|
449
449
|
</div>
|
|
@@ -468,6 +468,7 @@ const canvasStyle: CSSProperties = {
|
|
|
468
468
|
gap: 16,
|
|
469
469
|
maxWidth: 480,
|
|
470
470
|
background: 'var(--apex-fill-neutral-secondary)',
|
|
471
|
+
color: 'var(--apex-text-neutral-primary)',
|
|
471
472
|
borderRadius: 8,
|
|
472
473
|
}
|
|
473
474
|
|
|
@@ -547,7 +548,7 @@ export default () => {
|
|
|
547
548
|
|
|
548
549
|
> AutoComplete:为自由文本输入提供历史记录、关键词或搜索建议。没有匹配建议时,输入内容仍会保留。
|
|
549
550
|
|
|
550
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
551
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
551
552
|
|
|
552
553
|
公开导出:`AutoComplete`。
|
|
553
554
|
|
|
@@ -923,7 +924,7 @@ export default function Demo() {
|
|
|
923
924
|
|
|
924
925
|
> Avatar:需要展示用户、团队或业务实体的缩略标识,且空间有限时。
|
|
925
926
|
|
|
926
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
927
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
927
928
|
|
|
928
929
|
公开导出:`Avatar`、`AvatarGroup`。
|
|
929
930
|
|
|
@@ -1125,7 +1126,7 @@ export default () => (
|
|
|
1125
1126
|
|
|
1126
1127
|
> Breadcrumb:页面层级较深,用户需要知道「当前在哪」并快速返回上级时。
|
|
1127
1128
|
|
|
1128
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
1129
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
1129
1130
|
|
|
1130
1131
|
公开导出:`Breadcrumb`、`BreadcrumbLink`、`BreadcrumbSeparatorIcon`、`isBreadcrumbSeparatorItem`。
|
|
1131
1132
|
|
|
@@ -1141,9 +1142,9 @@ import { Breadcrumb, BreadcrumbSeparatorIcon } from '@apexhub/apex-ui-react'
|
|
|
1141
1142
|
import '@apexhub/apex-ui-react/style.css'
|
|
1142
1143
|
|
|
1143
1144
|
const items: BreadcrumbItemType[] = [
|
|
1144
|
-
{ type: 'section', title: '
|
|
1145
|
-
{ title: '
|
|
1146
|
-
{ title: '
|
|
1145
|
+
{ type: 'section', title: '首页', href: '/' },
|
|
1146
|
+
{ title: 'Button', href: '/components/button' },
|
|
1147
|
+
{ title: 'Breadcrumb' },
|
|
1147
1148
|
]
|
|
1148
1149
|
|
|
1149
1150
|
export default () => <Breadcrumb items={items} separator={<BreadcrumbSeparatorIcon />} />
|
|
@@ -1178,10 +1179,10 @@ export default () => <Breadcrumb items={items} separator={<BreadcrumbSeparatorIc
|
|
|
1178
1179
|
| --- | --- | --- | --- | --- |
|
|
1179
1180
|
| type | 栏目标题项;使用 heading-3 字阶与默认字色,其后自动渲染竖向 Divider | `"section"` | 否 | — |
|
|
1180
1181
|
| title | 展示名称(可内嵌图标) | `React.ReactNode` | 否 | — |
|
|
1181
|
-
| href |
|
|
1182
|
+
| href | 上级项链接;末项作为当前页始终不可点击。与 `path` 共存时优先 `href` | `string` | 否 | — |
|
|
1182
1183
|
| path | 相对路径段;累加并支持 `:key` + `Breadcrumb.params` | `string` | 否 | — |
|
|
1183
1184
|
| className | 该项最外层 DOM 的类名(`li` 或链接/文案壳层,非 `Breadcrumb` 根) | `string` | 否 | — |
|
|
1184
|
-
| onClick |
|
|
1185
|
+
| onClick | 上级链接单击事件;末项不会绑定 | `React.MouseEventHandler<HTMLAnchorElement \| HTMLElement>` | 否 | — |
|
|
1185
1186
|
|
|
1186
1187
|
### BreadcrumbSeparatorItem
|
|
1187
1188
|
|
|
@@ -1202,7 +1203,7 @@ type BreadcrumbItemType = BreadcrumbRouteItem | BreadcrumbSeparatorItem
|
|
|
1202
1203
|
|
|
1203
1204
|
### BreadcrumbItemRender
|
|
1204
1205
|
|
|
1205
|
-
|
|
1206
|
+
自定义上级项渲染(当前页始终使用 `title`,避免生成可点击节点)
|
|
1206
1207
|
|
|
1207
1208
|
```typescript
|
|
1208
1209
|
type BreadcrumbItemRender = (
|
|
@@ -1279,7 +1280,7 @@ export default () => <Breadcrumb separator={<BreadcrumbSeparatorIcon />} items={
|
|
|
1279
1280
|
|
|
1280
1281
|
### 路径参数与自定义渲染
|
|
1281
1282
|
|
|
1282
|
-
通过 `path` 与 `params` 拼接路径,也可以用 `itemRender`
|
|
1283
|
+
通过 `path` 与 `params` 拼接路径,也可以用 `itemRender` 自定义上级项展示。未解析的路径参数不会生成链接;当前项始终使用 `title`,避免自定义渲染产生可点击节点。
|
|
1283
1284
|
|
|
1284
1285
|
```tsx
|
|
1285
1286
|
import type { BreadcrumbItemRender, BreadcrumbItemType } from '@apexhub/apex-ui-react'
|
|
@@ -1379,7 +1380,7 @@ export default () => <Breadcrumb items={items} />
|
|
|
1379
1380
|
|
|
1380
1381
|
> Button:标记一个或多个操作(提交、确认、跳转等)时。
|
|
1381
1382
|
|
|
1382
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
1383
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
1383
1384
|
|
|
1384
1385
|
公开导出:`Button`。
|
|
1385
1386
|
|
|
@@ -1410,8 +1411,8 @@ export default () => <Button type="primary">主要按钮</Button>
|
|
|
1410
1411
|
| 属性 | 说明 | 类型 | 必填 | 默认值 | 版本 |
|
|
1411
1412
|
| --- | --- | --- | --- | --- | --- |
|
|
1412
1413
|
| type | 按钮类型,控制外观样式<br>- `default`:默认边框按钮(白底)<br>- `primary`:主色实心按钮<br>- `danger`:危险操作(边框红色)<br>- `text`:纯文字,无边框无背景<br>- `link`:链接样式,无边框无背景<br>注:`tabCapsule` 为 Tabs capsule 内部变体,不在对外 API 中暴露。 | `"default" \| "primary" \| "danger" \| "text" \| "link"` | 否 | `'default'` | `0.1.0` |
|
|
1413
|
-
| variant | Figma visual style. When provided, it overrides the style implied by `type`.<br>- `main`: solid emphasis<br>- `outline`: bordered emphasis<br>- `secondary`: neutral filled action<br>- `text` / `link`: low-emphasis actions<br>- `icon`: icon-only
|
|
1414
|
-
| tone | Visual intent. `main`, `outline`, and `icon` support every tone;<br>`icon-transparent`, `secondary`, `text
|
|
1414
|
+
| variant | Figma visual style. When provided, it overrides the style implied by `type`.<br>- `main`: solid emphasis<br>- `outline`: bordered emphasis<br>- `secondary`: neutral filled action<br>- `text` / `text-secondary` / `link`: low-emphasis actions<br>- `icon` / `icon-primary`: icon-only actions with hover fill<br>- `icon-transparent`: icon-only action, fully transparent background | `"text" \| "link" \| "main" \| "outline" \| "secondary" \| "text-secondary" \| "icon" \| "icon-primary" \| "icon-transparent" \| null` | 否 | — | `0.1.0` |
|
|
1415
|
+
| tone | Visual intent. `main`, `outline`, and `icon` support every tone;<br>`icon-primary`, `icon-transparent`, `secondary`, `text`,<br>`text-secondary`, and `link` use `default`.<br>When omitted, the legacy `danger` type resolves to `error`; other types<br>resolve to `default`. | `"default" \| "error" \| "success" \| "warning" \| null` | 否 | — | `0.1.0` |
|
|
1415
1416
|
| size | 按钮尺寸(`medium` 32px / `small` 24px;水平内边距共用 `--button-spacing-padding-x`) | `"small" \| "medium" \| null` | 否 | `'medium'` | `0.1.0` |
|
|
1416
1417
|
| disabled | 是否禁用。禁用时不可点击,视觉降级 | `boolean` | 否 | `false` | — |
|
|
1417
1418
|
| loading | 是否显示加载状态。<br>loading 为 true 时:不可点击,icon 位置替换为 loading 指示器 | `boolean` | 否 | `false` | `0.1.0` |
|
|
@@ -1421,6 +1422,7 @@ export default () => <Button type="primary">主要按钮</Button>
|
|
|
1421
1422
|
| target | 链接 target。依赖 `href`,仅在 `href` 存在时生效。 | `string` | 否 | — | — |
|
|
1422
1423
|
| asChild | 将按钮的样式与 props 合并到直接子元素上,而非渲染内置 `<button>` / `<a>`。<br>用于多态组合——让任意元素(如 `<a>`、路由 `Link`)拥有按钮外观。<br>优先级高于 `href` / `htmlType`。 | `boolean` | 否 | `false` | `0.1.0` |
|
|
1423
1424
|
| icon | 前置图标。loading 为 true 时此 prop 被 loading 指示器替换 | `React.ReactNode` | 否 | — | — |
|
|
1425
|
+
| suffixIcon | 尾部图标;loading 时仍保留在文案后方。 | `React.ReactNode` | 否 | — | — |
|
|
1424
1426
|
| block | 是否撑满父容器宽度(`display: flex; width: 100%`) | `boolean \| null` | 否 | `false` | `0.1.0` |
|
|
1425
1427
|
| className | 根节点类名 | `string` | 否 | — | — |
|
|
1426
1428
|
| style | 根节点内联样式(禁止硬编码色值,优先 CSS Token) | `React.CSSProperties` | 否 | — | — |
|
|
@@ -1451,7 +1453,7 @@ type ButtonVariants = VariantProps<typeof buttonVariants>
|
|
|
1451
1453
|
|
|
1452
1454
|
### 外观类型
|
|
1453
1455
|
|
|
1454
|
-
通过 `type` 控制外观:`default`、`primary`、`danger`、`text`、`link`。`main` / `outline` / `icon` 等 Figma 样式可通过 `variant` + `tone`
|
|
1456
|
+
通过 `type` 控制外观:`default`、`primary`、`danger`、`text`、`link`。`main` / `outline` / `icon` 等 Figma 样式可通过 `variant` + `tone` 组合;`text-secondary` 对应设计稿的透明文字样式,`icon-primary` 对应主色图标按钮。显式传入 `variant` 时优先于 `type`。
|
|
1455
1457
|
|
|
1456
1458
|
```tsx
|
|
1457
1459
|
import { Button } from '@apexhub/apex-ui-react'
|
|
@@ -1469,7 +1471,7 @@ export default () => (
|
|
|
1469
1471
|
|
|
1470
1472
|
### 尺寸
|
|
1471
1473
|
|
|
1472
|
-
提供 `medium`(默认)与 `small`
|
|
1474
|
+
提供 `medium`(默认)与 `small` 两种尺寸。对应文字为 14px / 20px 与 12px / 16px;前后图标占位分别为 20px 与 16px。
|
|
1473
1475
|
|
|
1474
1476
|
```tsx
|
|
1475
1477
|
import { Button } from '@apexhub/apex-ui-react'
|
|
@@ -1527,9 +1529,9 @@ export default () => (
|
|
|
1527
1529
|
)
|
|
1528
1530
|
```
|
|
1529
1531
|
|
|
1530
|
-
###
|
|
1532
|
+
### 图标
|
|
1531
1533
|
|
|
1532
|
-
通过 `icon`
|
|
1534
|
+
通过 `icon` 在文案前插入图标,`suffixIcon` 在文案后插入图标;`loading` 时前置 icon 会被 loading 指示器替换。
|
|
1533
1535
|
|
|
1534
1536
|
```tsx
|
|
1535
1537
|
import { Button } from '@apexhub/apex-ui-react'
|
|
@@ -1546,7 +1548,14 @@ export default () => (
|
|
|
1546
1548
|
<Button type="primary" icon={<StarIcon />}>
|
|
1547
1549
|
主要带图标
|
|
1548
1550
|
</Button>
|
|
1551
|
+
<Button type="primary" icon={<StarIcon />} suffixIcon={<StarIcon />}>
|
|
1552
|
+
前后图标
|
|
1553
|
+
</Button>
|
|
1554
|
+
<Button variant="text-secondary" suffixIcon={<StarIcon />}>
|
|
1555
|
+
透明文字
|
|
1556
|
+
</Button>
|
|
1549
1557
|
<Button type="primary" icon={<StarIcon />} aria-label="收藏" />
|
|
1558
|
+
<Button variant="icon-primary" icon={<StarIcon />} aria-label="收藏(主色图标)" />
|
|
1550
1559
|
</div>
|
|
1551
1560
|
)
|
|
1552
1561
|
```
|
|
@@ -1599,7 +1608,7 @@ export default () => (
|
|
|
1599
1608
|
|
|
1600
1609
|
## DOM 结构
|
|
1601
1610
|
|
|
1602
|
-
|
|
1611
|
+
源码声明的静态 `data-slot`:`button-loading-icon`、`button-icon`、`button-suffix-icon`、`button-content`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
1603
1612
|
|
|
1604
1613
|
## 样式定制
|
|
1605
1614
|
|
|
@@ -1644,7 +1653,7 @@ export default () => (
|
|
|
1644
1653
|
|
|
1645
1654
|
> Card:需要将一组相关信息收纳在带边框的容器内,与页面背景区分时。
|
|
1646
1655
|
|
|
1647
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
1656
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
1648
1657
|
|
|
1649
1658
|
公开导出:`Card`。
|
|
1650
1659
|
|
|
@@ -1678,6 +1687,7 @@ export default () => (
|
|
|
1678
1687
|
|
|
1679
1688
|
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
1680
1689
|
| --- | --- | --- | --- | --- |
|
|
1690
|
+
| variant | 卡片表面层级;primary 用于页面主容器,secondary 用于嵌套区域 | `"primary" \| "secondary"` | 否 | — |
|
|
1681
1691
|
| title | 卡片标题,存在时渲染头部区域 | `React.ReactNode` | 否 | — |
|
|
1682
1692
|
| extra | 卡片右上角操作区域;与 title 任一存在即渲染 header | `React.ReactNode` | 否 | — |
|
|
1683
1693
|
| children | 卡片内容区 | `React.ReactNode` | 否 | — |
|
|
@@ -1715,6 +1725,28 @@ export default () => (
|
|
|
1715
1725
|
)
|
|
1716
1726
|
```
|
|
1717
1727
|
|
|
1728
|
+
### 表面层级
|
|
1729
|
+
|
|
1730
|
+
React Card 可用 `variant` 切换 `primary`(默认)和 `secondary` 表面。悬停、按下以及通过 `data-selected` 标记选中时,边框会显示对应状态。
|
|
1731
|
+
|
|
1732
|
+
```tsx
|
|
1733
|
+
import { Card } from '@apexhub/apex-ui-react'
|
|
1734
|
+
|
|
1735
|
+
export default () => (
|
|
1736
|
+
<div style={{ display: 'flex', flexWrap: 'wrap', gap: 16 }}>
|
|
1737
|
+
<Card title="主表面" variant="primary" style={{ width: 240 }}>
|
|
1738
|
+
页面中的主要内容区域
|
|
1739
|
+
</Card>
|
|
1740
|
+
<Card title="次级表面" variant="secondary" style={{ width: 240 }}>
|
|
1741
|
+
需要区分层级的内容区域
|
|
1742
|
+
</Card>
|
|
1743
|
+
<Card title="已选中" variant="secondary" data-selected="" style={{ width: 240 }}>
|
|
1744
|
+
通过 data-selected 标记选中状态
|
|
1745
|
+
</Card>
|
|
1746
|
+
</div>
|
|
1747
|
+
)
|
|
1748
|
+
```
|
|
1749
|
+
|
|
1718
1750
|
## DOM 结构
|
|
1719
1751
|
|
|
1720
1752
|
源码声明的静态 `data-slot`:`card`、`card-header`、`card-title`、`card-extra`、`card-body`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
@@ -1742,7 +1774,7 @@ export default () => (
|
|
|
1742
1774
|
|
|
1743
1775
|
> Cascader:选项具有清晰的层级关系(省市区、分类目录等),需要从根到叶逐级选择时。
|
|
1744
1776
|
|
|
1745
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
1777
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
1746
1778
|
|
|
1747
1779
|
公开导出:`Cascader`。
|
|
1748
1780
|
|
|
@@ -2008,7 +2040,7 @@ type MaxTagCount = number | 'responsive'
|
|
|
2008
2040
|
|
|
2009
2041
|
### 默认值
|
|
2010
2042
|
|
|
2011
|
-
通过 `defaultValue`
|
|
2043
|
+
通过 `defaultValue` 设置非受控初始选中路径。示例可悬停查看清除按钮:medium/large 的下拉箭头为 16px、small 为 14px;清除按钮保持 14px。
|
|
2012
2044
|
|
|
2013
2045
|
```tsx
|
|
2014
2046
|
import { Cascader } from '@apexhub/apex-ui-react'
|
|
@@ -2419,7 +2451,7 @@ export default () => (
|
|
|
2419
2451
|
|
|
2420
2452
|
### 禁用选项
|
|
2421
2453
|
|
|
2422
|
-
在 `options` 中为单项设置 `disabled: true`
|
|
2454
|
+
在 `options` 中为单项设置 `disabled: true` 禁止选中。多选时预选一个可用子项,父级显示半选;点击父级只勾选可用子项,不会勾选禁用子项。
|
|
2423
2455
|
|
|
2424
2456
|
```tsx
|
|
2425
2457
|
import type { CascaderOption } from '@apexhub/apex-ui-react'
|
|
@@ -2465,9 +2497,27 @@ const options: CascaderOption[] = [
|
|
|
2465
2497
|
},
|
|
2466
2498
|
]
|
|
2467
2499
|
|
|
2500
|
+
const multipleOptions: CascaderOption[] = [
|
|
2501
|
+
{
|
|
2502
|
+
value: 'team',
|
|
2503
|
+
label: '项目组',
|
|
2504
|
+
children: [
|
|
2505
|
+
{ value: 'design', label: '设计', isLeaf: true },
|
|
2506
|
+
{ value: 'engineering', label: '研发', isLeaf: true },
|
|
2507
|
+
{ value: 'archived', label: '已归档', disabled: true, isLeaf: true },
|
|
2508
|
+
],
|
|
2509
|
+
},
|
|
2510
|
+
]
|
|
2511
|
+
|
|
2468
2512
|
export default () => (
|
|
2469
|
-
<div style={cascaderWrapStyle}>
|
|
2470
|
-
<Cascader options={options} placeholder="
|
|
2513
|
+
<div style={{ ...cascaderWrapStyle, display: 'flex', flexDirection: 'column', gap: 12 }}>
|
|
2514
|
+
<Cascader options={options} placeholder="禁用父级" />
|
|
2515
|
+
<Cascader
|
|
2516
|
+
multiple
|
|
2517
|
+
options={multipleOptions}
|
|
2518
|
+
defaultValue={[['team', 'design']]}
|
|
2519
|
+
placeholder="多选与禁用子项"
|
|
2520
|
+
/>
|
|
2471
2521
|
</div>
|
|
2472
2522
|
)
|
|
2473
2523
|
```
|
|
@@ -2563,7 +2613,7 @@ export default () => (
|
|
|
2563
2613
|
|
|
2564
2614
|
### 只读
|
|
2565
2615
|
|
|
2566
|
-
`readOnly` 为 true
|
|
2616
|
+
`readOnly` 为 true 时不可打开下拉、不可清除或修改;视觉使用禁用配色,但仍可聚焦。示例对照空值与已选路径。
|
|
2567
2617
|
|
|
2568
2618
|
```tsx
|
|
2569
2619
|
import { Cascader } from '@apexhub/apex-ui-react'
|
|
@@ -2603,6 +2653,7 @@ export default () => (
|
|
|
2603
2653
|
placeholder="可编辑"
|
|
2604
2654
|
allowClear
|
|
2605
2655
|
/>
|
|
2656
|
+
<Cascader options={CASCADER_OPTIONS} readOnly placeholder="只读空值" />
|
|
2606
2657
|
<Cascader
|
|
2607
2658
|
options={CASCADER_OPTIONS}
|
|
2608
2659
|
defaultValue={['zhejiang', 'hangzhou', 'xihu']}
|
|
@@ -2643,7 +2694,7 @@ export default () => (
|
|
|
2643
2694
|
|
|
2644
2695
|
> Checkbox:用户可从多个选项中任选零个、一个或多个时(与 Radio 互斥单选相对)。
|
|
2645
2696
|
|
|
2646
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
2697
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
2647
2698
|
|
|
2648
2699
|
公开导出:`Checkbox`、`CheckboxGroup`。
|
|
2649
2700
|
|
|
@@ -2785,17 +2836,28 @@ export default () => (
|
|
|
2785
2836
|
import { Checkbox } from '@apexhub/apex-ui-react'
|
|
2786
2837
|
|
|
2787
2838
|
export default () => (
|
|
2788
|
-
<div
|
|
2789
|
-
|
|
2790
|
-
|
|
2791
|
-
|
|
2792
|
-
|
|
2793
|
-
|
|
2794
|
-
|
|
2795
|
-
|
|
2796
|
-
|
|
2797
|
-
|
|
2798
|
-
|
|
2839
|
+
<div
|
|
2840
|
+
style={{
|
|
2841
|
+
display: 'grid',
|
|
2842
|
+
gridTemplateColumns: 'auto repeat(3, minmax(72px, 1fr))',
|
|
2843
|
+
alignItems: 'center',
|
|
2844
|
+
columnGap: 16,
|
|
2845
|
+
rowGap: 12,
|
|
2846
|
+
width: 'min(100%, 360px)',
|
|
2847
|
+
}}
|
|
2848
|
+
>
|
|
2849
|
+
<span />
|
|
2850
|
+
<span>未选中</span>
|
|
2851
|
+
<span>已选中</span>
|
|
2852
|
+
<span>半选</span>
|
|
2853
|
+
<span>默认</span>
|
|
2854
|
+
<Checkbox aria-label="默认-未选中" />
|
|
2855
|
+
<Checkbox defaultChecked aria-label="默认-已选中" />
|
|
2856
|
+
<Checkbox indeterminate aria-label="默认-半选" />
|
|
2857
|
+
<span>禁用</span>
|
|
2858
|
+
<Checkbox disabled aria-label="禁用-未选中" />
|
|
2859
|
+
<Checkbox disabled defaultChecked aria-label="禁用-已选中" />
|
|
2860
|
+
<Checkbox disabled indeterminate aria-label="禁用-半选" />
|
|
2799
2861
|
</div>
|
|
2800
2862
|
)
|
|
2801
2863
|
```
|
|
@@ -2923,7 +2985,7 @@ import type * as React from 'react'
|
|
|
2923
2985
|
|
|
2924
2986
|
const styles: CheckboxProps['styles'] = {
|
|
2925
2987
|
root: {
|
|
2926
|
-
'--checkbox-gap': 'var(--apex-spacing-
|
|
2988
|
+
'--checkbox-spacing-gap': 'var(--apex-spacing-8)',
|
|
2927
2989
|
} as React.CSSProperties,
|
|
2928
2990
|
indicator: {
|
|
2929
2991
|
opacity: 0.9,
|
|
@@ -2978,7 +3040,7 @@ export default () => (
|
|
|
2978
3040
|
|
|
2979
3041
|
> Collapse:页面信息量大,需要将次要内容默认折叠、按需展开时。
|
|
2980
3042
|
|
|
2981
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3043
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
2982
3044
|
|
|
2983
3045
|
公开导出:`Collapse`。
|
|
2984
3046
|
|
|
@@ -3311,7 +3373,7 @@ export default () => (
|
|
|
3311
3373
|
|
|
3312
3374
|
> DatePicker:用户需要选择单个日期或日期范围,且精确到日、周、月、季、年等不同粒度时。
|
|
3313
3375
|
|
|
3314
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3376
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
3315
3377
|
|
|
3316
3378
|
公开导出:`DatePicker`、`RangePicker`。
|
|
3317
3379
|
|
|
@@ -3609,15 +3671,19 @@ export default () => (
|
|
|
3609
3671
|
|
|
3610
3672
|
### 只读
|
|
3611
3673
|
|
|
3612
|
-
`readOnly` 为 true
|
|
3674
|
+
`readOnly` 为 true 时仅展示选中值,不可打开面板或修改;视觉使用禁用配色,触发器仍可聚焦。示例对照空值与已填值的单日期和日期范围。
|
|
3613
3675
|
|
|
3614
3676
|
```tsx
|
|
3615
3677
|
import { DatePicker, RangePicker } from '@apexhub/apex-ui-react'
|
|
3616
3678
|
|
|
3679
|
+
import dayjs from 'dayjs'
|
|
3680
|
+
|
|
3617
3681
|
export default () => (
|
|
3618
3682
|
<div style={{ display: 'flex', flexDirection: 'column', gap: 12, padding: 24 }}>
|
|
3619
3683
|
<DatePicker readOnly placeholder="只读,不可打开面板" />
|
|
3684
|
+
<DatePicker readOnly defaultValue={dayjs('2026-11-19')} />
|
|
3620
3685
|
<RangePicker readOnly placeholder={['开始日期', '结束日期']} />
|
|
3686
|
+
<RangePicker readOnly defaultValue={[dayjs('2026-11-01'), dayjs('2026-11-19')]} />
|
|
3621
3687
|
</div>
|
|
3622
3688
|
)
|
|
3623
3689
|
```
|
|
@@ -3701,7 +3767,7 @@ export default () => (
|
|
|
3701
3767
|
|
|
3702
3768
|
## DOM 结构
|
|
3703
3769
|
|
|
3704
|
-
源码声明的静态 `data-slot`:`date-picker-shortcuts`、`date-picker-shortcut`、`date-picker-
|
|
3770
|
+
源码声明的静态 `data-slot`:`date-picker-shortcuts`、`date-picker-shortcut`、`date-picker-prefix`、`range-picker-trigger`、`date-picker-clear`、`range-picker-panel`、`date-picker-panel-body`、`date-picker-panel-day`、`date-picker-panel-footer`、`date-picker-panel-header`、`date-picker-panel`、`date-picker-panel-time-shortcut`、`date-picker-panel-time`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
3705
3771
|
|
|
3706
3772
|
## 样式定制
|
|
3707
3773
|
|
|
@@ -3738,7 +3804,7 @@ export default () => (
|
|
|
3738
3804
|
|
|
3739
3805
|
> Divider:需要在区块之间做视觉分隔、区分内容层次时。
|
|
3740
3806
|
|
|
3741
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3807
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
3742
3808
|
|
|
3743
3809
|
公开导出:`Divider`。
|
|
3744
3810
|
|
|
@@ -3902,7 +3968,7 @@ export default () => (
|
|
|
3902
3968
|
|
|
3903
3969
|
> Drawer:需要从屏幕边缘滑出面板展示详情、表单或临时任务,且保留原页面上下文时。
|
|
3904
3970
|
|
|
3905
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
3971
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
3906
3972
|
|
|
3907
3973
|
公开导出:`Drawer`。
|
|
3908
3974
|
|
|
@@ -4236,7 +4302,7 @@ export default () => {
|
|
|
4236
4302
|
body: 'custom-drawer-body',
|
|
4237
4303
|
}}
|
|
4238
4304
|
styles={{
|
|
4239
|
-
body: { paddingBlock: 'var(--drawer-padding)' },
|
|
4305
|
+
body: { paddingBlock: 'var(--drawer-spacing-padding)' },
|
|
4240
4306
|
}}
|
|
4241
4307
|
drawerRender={(node) => <div data-demo="drawer-shell">{node}</div>}
|
|
4242
4308
|
onClose={() => setOpen(false)}
|
|
@@ -4274,7 +4340,7 @@ export default () => {
|
|
|
4274
4340
|
|
|
4275
4341
|
> Dropdown:在触发器附近展示一组快捷操作或菜单项时。
|
|
4276
4342
|
|
|
4277
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
4343
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
4278
4344
|
|
|
4279
4345
|
公开导出:`Dropdown`。
|
|
4280
4346
|
|
|
@@ -4697,7 +4763,7 @@ v1 不提供该 prop;下拉菜单通过 Radix Portal 挂载到 `document.body`
|
|
|
4697
4763
|
|
|
4698
4764
|
> Form:需要收集、校验并提交一组结构化字段数据时。
|
|
4699
4765
|
|
|
4700
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
4766
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
4701
4767
|
|
|
4702
4768
|
公开导出:`Form`、`FormItem`、`useForm`。
|
|
4703
4769
|
|
|
@@ -5041,7 +5107,7 @@ v1 不支持点号或方括号嵌套路径,`name` 须为单层字符串字段
|
|
|
5041
5107
|
|
|
5042
5108
|
> Grid:页面区块需要按 24 栅格划分宽度与响应式列数时。
|
|
5043
5109
|
|
|
5044
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5110
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
5045
5111
|
|
|
5046
5112
|
公开导出:`Col`、`Row`、`useBreakpoint`。
|
|
5047
5113
|
|
|
@@ -5057,7 +5123,7 @@ import type { CSSProperties } from 'react'
|
|
|
5057
5123
|
import '@apexhub/apex-ui-react/style.css'
|
|
5058
5124
|
|
|
5059
5125
|
const boxStyle: CSSProperties = {
|
|
5060
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5126
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5061
5127
|
padding: '8px 0',
|
|
5062
5128
|
textAlign: 'center',
|
|
5063
5129
|
borderRadius: 4,
|
|
@@ -5214,7 +5280,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
|
|
|
5214
5280
|
import type { CSSProperties } from 'react'
|
|
5215
5281
|
|
|
5216
5282
|
const boxStyle: CSSProperties = {
|
|
5217
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5283
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5218
5284
|
padding: '8px 0',
|
|
5219
5285
|
textAlign: 'center',
|
|
5220
5286
|
borderRadius: 4,
|
|
@@ -5245,7 +5311,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
|
|
|
5245
5311
|
import type { CSSProperties } from 'react'
|
|
5246
5312
|
|
|
5247
5313
|
const boxStyle: CSSProperties = {
|
|
5248
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5314
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5249
5315
|
padding: '8px 0',
|
|
5250
5316
|
textAlign: 'center',
|
|
5251
5317
|
borderRadius: 4,
|
|
@@ -5301,7 +5367,7 @@ import { Col, Divider, Row, Typography } from '@apexhub/apex-ui-react'
|
|
|
5301
5367
|
import type { CSSProperties } from 'react'
|
|
5302
5368
|
|
|
5303
5369
|
const boxStyle: CSSProperties = {
|
|
5304
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5370
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5305
5371
|
padding: '8px 0',
|
|
5306
5372
|
textAlign: 'center',
|
|
5307
5373
|
borderRadius: 4,
|
|
@@ -5309,7 +5375,7 @@ const boxStyle: CSSProperties = {
|
|
|
5309
5375
|
|
|
5310
5376
|
const rowStyle: CSSProperties = {
|
|
5311
5377
|
width: '100%',
|
|
5312
|
-
backgroundColor: '
|
|
5378
|
+
backgroundColor: 'var(--apex-fill-neutral-primary)',
|
|
5313
5379
|
borderRadius: 4,
|
|
5314
5380
|
}
|
|
5315
5381
|
|
|
@@ -5359,7 +5425,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
|
|
|
5359
5425
|
import type { CSSProperties } from 'react'
|
|
5360
5426
|
|
|
5361
5427
|
const boxStyle: CSSProperties = {
|
|
5362
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5428
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5363
5429
|
padding: '8px 0',
|
|
5364
5430
|
textAlign: 'center',
|
|
5365
5431
|
borderRadius: 4,
|
|
@@ -5395,7 +5461,7 @@ export default () => (
|
|
|
5395
5461
|
import { Col, Row } from '@apexhub/apex-ui-react'
|
|
5396
5462
|
|
|
5397
5463
|
const boxStyle = {
|
|
5398
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5464
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5399
5465
|
padding: '8px 12px',
|
|
5400
5466
|
borderRadius: 4,
|
|
5401
5467
|
display: 'flex',
|
|
@@ -5425,7 +5491,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
|
|
|
5425
5491
|
import type { CSSProperties } from 'react'
|
|
5426
5492
|
|
|
5427
5493
|
const boxStyle: CSSProperties = {
|
|
5428
|
-
background: 'var(--apex-fill-neutral-secondary
|
|
5494
|
+
background: 'var(--apex-fill-neutral-secondary)',
|
|
5429
5495
|
padding: '8px 0',
|
|
5430
5496
|
textAlign: 'center',
|
|
5431
5497
|
borderRadius: 4,
|
|
@@ -5463,7 +5529,7 @@ export default () => (
|
|
|
5463
5529
|
|
|
5464
5530
|
> Image:需要以缩略图形式展示图片,并支持点击放大预览时。
|
|
5465
5531
|
|
|
5466
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5532
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
5467
5533
|
|
|
5468
5534
|
公开导出:`Image`。
|
|
5469
5535
|
|
|
@@ -5867,7 +5933,7 @@ export default () => {
|
|
|
5867
5933
|
## 行为要点
|
|
5868
5934
|
|
|
5869
5935
|
- **URL 所有权**:Image 只接收可用 URL 字符串,**不接收 `File`/`Blob`**,不调用 `revokeObjectURL`。如果你使用 `URL.createObjectURL` 生成的 `blob:` 地址,需自行管理生命周期。
|
|
5870
|
-
-
|
|
5936
|
+
- **变换工具栏**:预览层使用 medium 图标按钮,内置缩放(步进 0.25,范围 0.25–5)、左右旋转、1:1 原始尺寸、适应视口、占满视口。切图/关闭/重开时变换复位。
|
|
5871
5937
|
- **键盘**:打开后焦点陷阱;`Esc` 在占满视口时先退出占满再关闭;`←` / `→` 切图;关闭后焦点回触发元素。
|
|
5872
5938
|
- **边界**:单图无 prev/next 控件;索引越界时禁用不循环;`fallback` 再失败不递归。
|
|
5873
5939
|
|
|
@@ -5894,7 +5960,7 @@ PreviewGroup 的受控状态(`open`/`current`)在顶层而非嵌套在 `prev
|
|
|
5894
5960
|
|
|
5895
5961
|
> Input:需要通过键盘录入单行或多行文本内容时。
|
|
5896
5962
|
|
|
5897
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
5963
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
5898
5964
|
|
|
5899
5965
|
公开导出:`Input`。
|
|
5900
5966
|
|
|
@@ -6150,14 +6216,16 @@ export default () => (
|
|
|
6150
6216
|
|
|
6151
6217
|
### 只读
|
|
6152
6218
|
|
|
6153
|
-
`readOnly` 为 true 时可查看内容但不可修改,无 hover
|
|
6219
|
+
`readOnly` 为 true 时可查看内容但不可修改,无 hover 交互态;视觉使用禁用配色,但控件仍可聚焦。示例同时展示空值占位和已填内容。
|
|
6154
6220
|
|
|
6155
6221
|
```tsx
|
|
6156
6222
|
import { Input } from '@apexhub/apex-ui-react'
|
|
6157
6223
|
|
|
6158
6224
|
export default () => (
|
|
6159
6225
|
<div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
|
|
6226
|
+
<Input readOnly placeholder="只读空值" />
|
|
6160
6227
|
<Input readOnly defaultValue="只读输入框" />
|
|
6228
|
+
<Input type="textarea" readOnly rows={3} placeholder="只读文本域空值" />
|
|
6161
6229
|
<Input type="textarea" readOnly rows={3} defaultValue="只读文本域" />
|
|
6162
6230
|
</div>
|
|
6163
6231
|
)
|
|
@@ -6319,7 +6387,7 @@ export default () => {
|
|
|
6319
6387
|
|
|
6320
6388
|
> InputNumber:需要录入有上下界的数值,并支持步进增减时。
|
|
6321
6389
|
|
|
6322
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
6390
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6323
6391
|
|
|
6324
6392
|
公开导出:`InputNumber`。
|
|
6325
6393
|
|
|
@@ -6601,12 +6669,17 @@ export default () => <InputNumber disabled defaultValue={5} min={0} max={100} />
|
|
|
6601
6669
|
|
|
6602
6670
|
### 只读
|
|
6603
6671
|
|
|
6604
|
-
`readOnly` 为 true
|
|
6672
|
+
`readOnly` 为 true 时可查看数值但不可编辑,步进按钮与键盘输入一并禁用;空值占位和已填数值均使用禁用配色。
|
|
6605
6673
|
|
|
6606
6674
|
```tsx
|
|
6607
6675
|
import { InputNumber } from '@apexhub/apex-ui-react'
|
|
6608
6676
|
|
|
6609
|
-
export default () =>
|
|
6677
|
+
export default () => (
|
|
6678
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 280 }}>
|
|
6679
|
+
<InputNumber readOnly placeholder="只读空值" min={0} max={100} />
|
|
6680
|
+
<InputNumber readOnly defaultValue={5} min={0} max={100} />
|
|
6681
|
+
</div>
|
|
6682
|
+
)
|
|
6610
6683
|
```
|
|
6611
6684
|
|
|
6612
6685
|
### 小数步长与格式化
|
|
@@ -6808,7 +6881,7 @@ export default () => (
|
|
|
6808
6881
|
|
|
6809
6882
|
> Layout:搭建后台页面的 Header、侧栏、内容区与 Footer 等整体结构时。
|
|
6810
6883
|
|
|
6811
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
6884
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6812
6885
|
|
|
6813
6886
|
公开导出:`Layout`、`LayoutSiderDrawerBody`、`LayoutSiderDrawerHeader`、`LayoutSiderMenuCollapsed`、`LayoutSiderMenuMaximized`。
|
|
6814
6887
|
|
|
@@ -7109,7 +7182,7 @@ export default () => (
|
|
|
7109
7182
|
|
|
7110
7183
|
> Menu:侧栏持久导航,需要在图标 rail 与展开列表之间切换时。
|
|
7111
7184
|
|
|
7112
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
7185
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
7113
7186
|
|
|
7114
7187
|
公开导出:`isKeySelected`、`Menu`。
|
|
7115
7188
|
|
|
@@ -7118,7 +7191,7 @@ export default () => (
|
|
|
7118
7191
|
## 快速开始
|
|
7119
7192
|
|
|
7120
7193
|
```tsx
|
|
7121
|
-
import { Button, Menu, MenuItemType } from '@apexhub/apex-ui-react'
|
|
7194
|
+
import { Button, Menu, type MenuItemType } from '@apexhub/apex-ui-react'
|
|
7122
7195
|
|
|
7123
7196
|
import { useState } from 'react'
|
|
7124
7197
|
|
|
@@ -7140,13 +7213,20 @@ const items: MenuItemType[] = [
|
|
|
7140
7213
|
|
|
7141
7214
|
export default () => {
|
|
7142
7215
|
const [collapsed, setCollapsed] = useState(false)
|
|
7216
|
+
|
|
7143
7217
|
return (
|
|
7144
|
-
<
|
|
7145
|
-
|
|
7146
|
-
|
|
7147
|
-
|
|
7148
|
-
|
|
7149
|
-
|
|
7218
|
+
<Menu
|
|
7219
|
+
items={items}
|
|
7220
|
+
collapsed={collapsed}
|
|
7221
|
+
onCollapse={setCollapsed}
|
|
7222
|
+
defaultOpenKeys={['workspace']}
|
|
7223
|
+
defaultSelectedKeys={['projects']}
|
|
7224
|
+
footer={
|
|
7225
|
+
<Button type="text" onClick={() => setCollapsed((current) => !current)}>
|
|
7226
|
+
{collapsed ? '展开菜单' : '收起菜单'}
|
|
7227
|
+
</Button>
|
|
7228
|
+
}
|
|
7229
|
+
/>
|
|
7150
7230
|
)
|
|
7151
7231
|
}
|
|
7152
7232
|
```
|
|
@@ -7372,8 +7452,8 @@ const railStyle = {
|
|
|
7372
7452
|
flexDirection: 'column' as const,
|
|
7373
7453
|
width: 'fit-content',
|
|
7374
7454
|
height: '100%',
|
|
7375
|
-
backgroundColor: '
|
|
7376
|
-
borderRight: '
|
|
7455
|
+
backgroundColor: 'var(--apex-fill-neutral-secondary)',
|
|
7456
|
+
borderRight: 'var(--apex-border-1) solid var(--apex-stroke-neutral-tertiary)',
|
|
7377
7457
|
padding: 8,
|
|
7378
7458
|
boxSizing: 'border-box' as const,
|
|
7379
7459
|
justifyContent: 'space-between' as const,
|
|
@@ -7582,7 +7662,7 @@ export default () => {
|
|
|
7582
7662
|
|
|
7583
7663
|
### 自定义顶栏
|
|
7584
7664
|
|
|
7585
|
-
通过 `header` 与 `footer`
|
|
7665
|
+
通过 `header` 与 `footer` 插槽自定义收窄与展开态的顶栏、底栏内容;展开态的顶栏沿用菜单 Token 表面样式。
|
|
7586
7666
|
|
|
7587
7667
|
```tsx
|
|
7588
7668
|
import { Avatar, Button, Card, Dropdown, Menu, Typography } from '@apexhub/apex-ui-react'
|
|
@@ -7700,7 +7780,7 @@ export default () => {
|
|
|
7700
7780
|
height: '100%',
|
|
7701
7781
|
cursor: 'pointer',
|
|
7702
7782
|
backgroundColor: profileHovered
|
|
7703
|
-
? '
|
|
7783
|
+
? 'var(--apex-fill-neutral-tertiary)'
|
|
7704
7784
|
: undefined,
|
|
7705
7785
|
transition: 'background-color 0.15s ease',
|
|
7706
7786
|
}}
|
|
@@ -7792,7 +7872,7 @@ Dropdown 复用 `MenuItemType` 类型定义,但 UI 与交互独立:Menu 面
|
|
|
7792
7872
|
|
|
7793
7873
|
> Message:操作结果的轻量全局反馈(成功、失败、警告、进行中等)时。
|
|
7794
7874
|
|
|
7795
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
7875
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
7796
7876
|
|
|
7797
7877
|
公开导出:`message`。
|
|
7798
7878
|
|
|
@@ -8096,7 +8176,7 @@ v1 采用全局 singleton 挂载,不读取 React Context,因此不提供 `us
|
|
|
8096
8176
|
|
|
8097
8177
|
> Modal:需要用户阅读并确认、取消或提交,且应暂时阻断当前页面操作时。
|
|
8098
8178
|
|
|
8099
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
8179
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
8100
8180
|
|
|
8101
8181
|
公开导出:`Modal`。
|
|
8102
8182
|
|
|
@@ -8167,7 +8247,7 @@ export default () => {
|
|
|
8167
8247
|
| styles | 各语义节点的内联样式,支持对象或函数 | `Partial<Record<SemanticDOM, React.CSSProperties>> \| ((info: { props: ModalProps }) => Partial<Record<SemanticDOM, React.CSSProperties>>)` | 否 | — |
|
|
8168
8248
|
| title | 标题。`undefined`(缺省)且无关闭钮时自动补 sr-only 标题以满足无障碍;<br>`null` 时消费方在 `children` 中自行提供标题(如 `Modal.confirm`),不渲染标题区且不兜底 sr-only,须配合 `titleId` 关联无障碍名称。 | `React.ReactNode` | 否 | — |
|
|
8169
8249
|
| open | 是否显示弹窗(受控;必填) | `boolean` | 是 | — |
|
|
8170
|
-
| width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 /
|
|
8250
|
+
| width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 / 720 / 1000 断点匹配尺寸样式。<br>兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。 | `string \| number` | 否 | — |
|
|
8171
8251
|
| wrapClassName | 含蒙层的容器 className | `string` | 否 | — |
|
|
8172
8252
|
| onCancel | 点击蒙层、右上角关闭或 Cancel 时触发 | `(e: React.MouseEvent<HTMLElement> \| React.KeyboardEvent<HTMLElement>) => void` | 否 | — |
|
|
8173
8253
|
| onOk | 点击 OK 时触发 | `(e: React.MouseEvent<HTMLElement>) => void` | 否 | — |
|
|
@@ -8356,7 +8436,7 @@ export default () => {
|
|
|
8356
8436
|
|
|
8357
8437
|
### 尺寸与宽度
|
|
8358
8438
|
|
|
8359
|
-
`size`
|
|
8439
|
+
`size` 对应三档宽度:`sm` 420px、`md` 720px(默认)、`xl` 1000px;`lg` 为 720px 的兼容别名。传入 `width`(数字或 CSS 长度)时会覆盖预设宽度。
|
|
8360
8440
|
|
|
8361
8441
|
```tsx
|
|
8362
8442
|
import { Button, Modal } from '@apexhub/apex-ui-react'
|
|
@@ -8364,14 +8444,14 @@ import { Button, Modal } from '@apexhub/apex-ui-react'
|
|
|
8364
8444
|
import { useState } from 'react'
|
|
8365
8445
|
|
|
8366
8446
|
export default () => {
|
|
8367
|
-
const [kind, setKind] = useState<'sm' | 'md' | '
|
|
8447
|
+
const [kind, setKind] = useState<'sm' | 'md' | 'xl' | 'custom' | null>(null)
|
|
8368
8448
|
|
|
8369
8449
|
return (
|
|
8370
8450
|
<>
|
|
8371
8451
|
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
|
|
8372
8452
|
<Button onClick={() => setKind('sm')}>sm(420px)</Button>
|
|
8373
|
-
<Button onClick={() => setKind('md')}>md(
|
|
8374
|
-
<Button onClick={() => setKind('
|
|
8453
|
+
<Button onClick={() => setKind('md')}>md(720px)</Button>
|
|
8454
|
+
<Button onClick={() => setKind('xl')}>xl(1000px)</Button>
|
|
8375
8455
|
<Button onClick={() => setKind('custom')}>自定义 width</Button>
|
|
8376
8456
|
</div>
|
|
8377
8457
|
<Modal
|
|
@@ -8393,13 +8473,13 @@ export default () => {
|
|
|
8393
8473
|
使用 size="md"。
|
|
8394
8474
|
</Modal>
|
|
8395
8475
|
<Modal
|
|
8396
|
-
open={kind === '
|
|
8397
|
-
size="
|
|
8476
|
+
open={kind === 'xl'}
|
|
8477
|
+
size="xl"
|
|
8398
8478
|
title="大尺寸"
|
|
8399
8479
|
onCancel={() => setKind(null)}
|
|
8400
8480
|
onOk={() => setKind(null)}
|
|
8401
8481
|
>
|
|
8402
|
-
使用 size="
|
|
8482
|
+
使用 size="xl"。
|
|
8403
8483
|
</Modal>
|
|
8404
8484
|
<Modal
|
|
8405
8485
|
open={kind === 'custom'}
|
|
@@ -8683,7 +8763,7 @@ export default () => {
|
|
|
8683
8763
|
|
|
8684
8764
|
> Notification:操作完成后的全局反馈,需要用户注意到但不必立即处理时。
|
|
8685
8765
|
|
|
8686
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
8766
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
8687
8767
|
|
|
8688
8768
|
公开导出:`notification`。
|
|
8689
8769
|
|
|
@@ -9069,7 +9149,7 @@ v1 采用静态 singleton root 挂载,不经过组件树,因此无法读取
|
|
|
9069
9149
|
|
|
9070
9150
|
> Pagination:数据量较大、需要分批次浏览列表或表格时。
|
|
9071
9151
|
|
|
9072
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
9152
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
9073
9153
|
|
|
9074
9154
|
公开导出:`Pagination`。
|
|
9075
9155
|
|
|
@@ -9088,7 +9168,7 @@ export default () => <Pagination total={85} defaultCurrent={1} />
|
|
|
9088
9168
|
## 何时使用
|
|
9089
9169
|
|
|
9090
9170
|
- 数据量较大、需要分批次浏览列表或表格时。
|
|
9091
|
-
-
|
|
9171
|
+
- 需要让用户切换每页条数时;Vue 版也支持快速跳转到指定页。
|
|
9092
9172
|
- 纯滚动加载场景不必使用 Pagination;仅一页时可配合 `hideOnSinglePage` 隐藏分页器。
|
|
9093
9173
|
|
|
9094
9174
|
## API
|
|
@@ -9109,8 +9189,8 @@ export default () => <Pagination total={85} defaultCurrent={1} />
|
|
|
9109
9189
|
| pageSizeOptions | pageSize 切换器的可选档位。 | `number[]` | 否 | `[10, 20, 50, 100]` |
|
|
9110
9190
|
| disabled | 整体禁用 | `boolean` | 否 | `false` |
|
|
9111
9191
|
| showSizeChanger | 显示 pageSize 切换器。<br>未传 → total > 50 时自动 true;显式 false → 永远关;显式 true → 永远开 | `boolean` | 否 | — |
|
|
9112
|
-
| showQuickJumper |
|
|
9113
|
-
| showTotal |
|
|
9192
|
+
| showQuickJumper | 兼容旧调用方;当前 React 设计不渲染快速跳转输入 | `boolean` | 否 | — |
|
|
9193
|
+
| showTotal | 兼容旧调用方;当前 React 设计不渲染总数区域 | `ShowTotalFn` | 否 | — |
|
|
9114
9194
|
| hideOnSinglePage | 总页数 ≤ 1 时不渲染整个组件 | `boolean` | 否 | `false` |
|
|
9115
9195
|
| itemRender | 自定义每项渲染。<br>所有可点项(prev/next/jump-prev/jump-next/page)都调用此函数。<br>业务方应用 React.cloneElement(originalElement, ...) 保留 a11y props。 | `ItemRender` | 否 | — |
|
|
9116
9196
|
| responsive | 开启容器宽度自适应(ResizeObserver 四档)。 | `boolean` | 否 | `false` |
|
|
@@ -9156,7 +9236,7 @@ type PageItemType = 'page' | 'prev' | 'next' | 'jump-prev' | 'jump-next'
|
|
|
9156
9236
|
|
|
9157
9237
|
### 每页条数切换
|
|
9158
9238
|
|
|
9159
|
-
数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger`
|
|
9239
|
+
数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger` 强制开启或关闭。
|
|
9160
9240
|
|
|
9161
9241
|
```tsx
|
|
9162
9242
|
import { Pagination } from '@apexhub/apex-ui-react'
|
|
@@ -9201,7 +9281,9 @@ export default () => {
|
|
|
9201
9281
|
}
|
|
9202
9282
|
```
|
|
9203
9283
|
|
|
9204
|
-
###
|
|
9284
|
+
### 受控用法 (quick-jumper)
|
|
9285
|
+
|
|
9286
|
+
**快速跳转**
|
|
9205
9287
|
|
|
9206
9288
|
`showQuickJumper` 展示跳转输入框,输入页码后按 Enter 跳转。
|
|
9207
9289
|
|
|
@@ -9224,14 +9306,21 @@ export default () => {
|
|
|
9224
9306
|
}
|
|
9225
9307
|
```
|
|
9226
9308
|
|
|
9227
|
-
###
|
|
9309
|
+
### 受控用法 (show-total)
|
|
9310
|
+
|
|
9311
|
+
**显示总数**
|
|
9228
9312
|
|
|
9229
9313
|
`showTotal` 自定义总数展示文案,接收 `(total, range) => 自定义节点`。
|
|
9230
9314
|
|
|
9231
9315
|
```tsx
|
|
9232
9316
|
import { Pagination } from '@apexhub/apex-ui-react'
|
|
9233
9317
|
|
|
9234
|
-
export default () =>
|
|
9318
|
+
export default () => (
|
|
9319
|
+
<Pagination
|
|
9320
|
+
total={128}
|
|
9321
|
+
showTotal={(total, range) => `共 ${total} 条,当前 ${range[0]}-${range[1]}`}
|
|
9322
|
+
/>
|
|
9323
|
+
)
|
|
9235
9324
|
```
|
|
9236
9325
|
|
|
9237
9326
|
### 禁用
|
|
@@ -9268,7 +9357,7 @@ export default () => <Pagination total={50} disabled />
|
|
|
9268
9357
|
|
|
9269
9358
|
### `responsive` 如何工作?
|
|
9270
9359
|
|
|
9271
|
-
开启后组件通过 ResizeObserver
|
|
9360
|
+
开启后组件通过 ResizeObserver 监听容器宽度,按阈值自动调整布局;Vue 版会逐步隐藏总数与条数切换器,React 版只调整当前实际渲染的控件。默认 `false`,须显式传入 `responsive`。
|
|
9272
9361
|
|
|
9273
9362
|
### `pageSizeOptions` 可以自定义吗?
|
|
9274
9363
|
|
|
@@ -9280,7 +9369,7 @@ export default () => <Pagination total={50} disabled />
|
|
|
9280
9369
|
|
|
9281
9370
|
> Popover:需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
|
|
9282
9371
|
|
|
9283
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
9372
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
9284
9373
|
|
|
9285
9374
|
公开导出:`Popover`。
|
|
9286
9375
|
|
|
@@ -9306,7 +9395,7 @@ export default () => (
|
|
|
9306
9395
|
|
|
9307
9396
|
- 需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
|
|
9308
9397
|
- 点击或悬停展开补充说明、快捷操作面板时。
|
|
9309
|
-
-
|
|
9398
|
+
- 默认内容适合简短的补充信息;宽面板可通过 `className` 调整宽度,并在接近可用边界时自动收缩。
|
|
9310
9399
|
- 若只需单行文字提示、无交互内容,请使用 Tooltip,而不是 Popover。
|
|
9311
9400
|
|
|
9312
9401
|
## API
|
|
@@ -9508,7 +9597,7 @@ v1 仅支持单值触发方式,避免组合触发带来的状态复杂度;
|
|
|
9508
9597
|
|
|
9509
9598
|
### Popover 内容有固定最大宽度吗?
|
|
9510
9599
|
|
|
9511
|
-
|
|
9600
|
+
React Popover 默认最小宽度为 80px、最大宽度为 420px,并受浮层可用空间限制。需要更宽的业务面板时,可通过 `className` 覆盖最大宽度,并确保内容在可用空间内布局。
|
|
9512
9601
|
|
|
9513
9602
|
---
|
|
9514
9603
|
|
|
@@ -9516,7 +9605,7 @@ v1 仅支持单值触发方式,避免组合触发带来的状态复杂度;
|
|
|
9516
9605
|
|
|
9517
9606
|
> Progress:需要向用户展示任务、上传、加载等操作的完成百分比时。
|
|
9518
9607
|
|
|
9519
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
9608
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
9520
9609
|
|
|
9521
9610
|
公开导出:`Progress`。
|
|
9522
9611
|
|
|
@@ -9633,7 +9722,7 @@ export default () => (
|
|
|
9633
9722
|
|
|
9634
9723
|
通过 `success.percent` 在轨道内叠加已成功部分;`format` 第二个参数为成功段百分比,可用于自定义文案。
|
|
9635
9724
|
|
|
9636
|
-
以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-
|
|
9725
|
+
以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-bar-brand` / `--progress-bar-success` 对调(仅演示)。
|
|
9637
9726
|
|
|
9638
9727
|
```tsx
|
|
9639
9728
|
import { Progress, Tooltip } from '@apexhub/apex-ui-react'
|
|
@@ -9759,8 +9848,8 @@ const SuccessSegmentHoverMark = () => {
|
|
|
9759
9848
|
format={(_percent, success) => `${success ?? 0}%`}
|
|
9760
9849
|
style={
|
|
9761
9850
|
{
|
|
9762
|
-
'--progress-
|
|
9763
|
-
'--progress-
|
|
9851
|
+
'--progress-bar-brand': percentStripColor,
|
|
9852
|
+
'--progress-bar-success': successStripColor,
|
|
9764
9853
|
} as React.CSSProperties
|
|
9765
9854
|
}
|
|
9766
9855
|
/>
|
|
@@ -9798,7 +9887,7 @@ export default () => <SuccessSegmentHoverMark />
|
|
|
9798
9887
|
|
|
9799
9888
|
> Radio:用户必须从多个互斥选项中选择一个时(如性别、配送方式)。
|
|
9800
9889
|
|
|
9801
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
9890
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
9802
9891
|
|
|
9803
9892
|
公开导出:`Radio`、`RadioGroup`、`RadioIndicator`。
|
|
9804
9893
|
|
|
@@ -10005,6 +10094,43 @@ export default () => (
|
|
|
10005
10094
|
)
|
|
10006
10095
|
```
|
|
10007
10096
|
|
|
10097
|
+
### 状态对照
|
|
10098
|
+
|
|
10099
|
+
并排展示默认与禁用状态下的未选中、已选中 Radio,便于对照控件图形与文字间距。
|
|
10100
|
+
|
|
10101
|
+
```tsx
|
|
10102
|
+
import { Radio } from '@apexhub/apex-ui-react'
|
|
10103
|
+
|
|
10104
|
+
export default () => (
|
|
10105
|
+
<div
|
|
10106
|
+
style={{
|
|
10107
|
+
display: 'grid',
|
|
10108
|
+
gridTemplateColumns: 'auto repeat(2, minmax(88px, 1fr))',
|
|
10109
|
+
alignItems: 'center',
|
|
10110
|
+
columnGap: 16,
|
|
10111
|
+
rowGap: 12,
|
|
10112
|
+
width: 'min(100%, 280px)',
|
|
10113
|
+
}}
|
|
10114
|
+
>
|
|
10115
|
+
<span />
|
|
10116
|
+
<span>未选中</span>
|
|
10117
|
+
<span>已选中</span>
|
|
10118
|
+
<span>默认</span>
|
|
10119
|
+
<Radio value="default-unchecked">默认-未选中</Radio>
|
|
10120
|
+
<Radio value="default-checked" defaultChecked>
|
|
10121
|
+
默认-已选中
|
|
10122
|
+
</Radio>
|
|
10123
|
+
<span>禁用</span>
|
|
10124
|
+
<Radio value="disabled-unchecked" disabled>
|
|
10125
|
+
禁用-未选中
|
|
10126
|
+
</Radio>
|
|
10127
|
+
<Radio value="disabled-checked" disabled defaultChecked>
|
|
10128
|
+
禁用-已选中
|
|
10129
|
+
</Radio>
|
|
10130
|
+
</div>
|
|
10131
|
+
)
|
|
10132
|
+
```
|
|
10133
|
+
|
|
10008
10134
|
### 受控用法
|
|
10009
10135
|
|
|
10010
10136
|
通过 `value` 和 变更事件 控制选中项。
|
|
@@ -10149,7 +10275,7 @@ export default () => (
|
|
|
10149
10275
|
|
|
10150
10276
|
> Rate:需要对服务、内容或商品进行星级评价时。
|
|
10151
10277
|
|
|
10152
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
10278
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
10153
10279
|
|
|
10154
10280
|
公开导出:`Rate`、`StarFilled`。
|
|
10155
10281
|
|
|
@@ -10393,7 +10519,7 @@ export default () => {
|
|
|
10393
10519
|
|
|
10394
10520
|
> Select:选项来自预设列表,需要从其中选择一个或多个值时。
|
|
10395
10521
|
|
|
10396
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
10522
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
10397
10523
|
|
|
10398
10524
|
公开导出:`Select`。
|
|
10399
10525
|
|
|
@@ -10779,7 +10905,7 @@ type MaxTagCount = number | 'responsive'
|
|
|
10779
10905
|
|
|
10780
10906
|
### 尺寸
|
|
10781
10907
|
|
|
10782
|
-
支持 `large
|
|
10908
|
+
支持 `large`、`medium`(默认)、`small` 三种尺寸。示例选中值并开启清除:large/medium 的下拉箭头为 16px,small 为 14px,清除按钮均为 14px。
|
|
10783
10909
|
|
|
10784
10910
|
```tsx
|
|
10785
10911
|
import { Select } from '@apexhub/apex-ui-react'
|
|
@@ -10791,9 +10917,9 @@ const options = [
|
|
|
10791
10917
|
|
|
10792
10918
|
export default () => (
|
|
10793
10919
|
<div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
|
|
10794
|
-
<Select size="large"
|
|
10795
|
-
<Select size="medium"
|
|
10796
|
-
<Select size="small"
|
|
10920
|
+
<Select size="large" defaultValue="react" allowClear options={options} />
|
|
10921
|
+
<Select size="medium" defaultValue="react" allowClear options={options} />
|
|
10922
|
+
<Select size="small" defaultValue="react" allowClear options={options} />
|
|
10797
10923
|
</div>
|
|
10798
10924
|
)
|
|
10799
10925
|
```
|
|
@@ -10820,7 +10946,7 @@ export default () => (
|
|
|
10820
10946
|
|
|
10821
10947
|
### 只读
|
|
10822
10948
|
|
|
10823
|
-
`readOnly`
|
|
10949
|
+
`readOnly` 不可打开下拉、不可改值;视觉使用禁用配色,但仍可聚焦。示例包含空值、单选和多选。
|
|
10824
10950
|
|
|
10825
10951
|
```tsx
|
|
10826
10952
|
import { Select } from '@apexhub/apex-ui-react'
|
|
@@ -10833,6 +10959,7 @@ const options = [
|
|
|
10833
10959
|
|
|
10834
10960
|
export default () => (
|
|
10835
10961
|
<div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
|
|
10962
|
+
<Select readOnly placeholder="只读空值" options={options} style={{ minWidth: 160 }} />
|
|
10836
10963
|
<Select readOnly defaultValue="a" options={options} />
|
|
10837
10964
|
<Select
|
|
10838
10965
|
mode="multiple"
|
|
@@ -11218,7 +11345,7 @@ export default () => (
|
|
|
11218
11345
|
|
|
11219
11346
|
### `readOnly` 和 `disabled` 有什么区别?
|
|
11220
11347
|
|
|
11221
|
-
`disabled`
|
|
11348
|
+
`disabled` 不可交互;`readOnly` 同样使用禁用配色且不可打开下拉或改值,但保留可聚焦语义,适合表单只读场景。
|
|
11222
11349
|
|
|
11223
11350
|
---
|
|
11224
11351
|
|
|
@@ -11226,7 +11353,7 @@ export default () => (
|
|
|
11226
11353
|
|
|
11227
11354
|
> Skeleton:页面、卡片或表格数据仍在加载,需要先稳定布局并降低等待感时。
|
|
11228
11355
|
|
|
11229
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
11356
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
11230
11357
|
|
|
11231
11358
|
公开导出:`Skeleton`。
|
|
11232
11359
|
|
|
@@ -11504,7 +11631,7 @@ Skeleton 默认就是占位内容,因此不传 `loading` 与 `loading={true}`
|
|
|
11504
11631
|
|
|
11505
11632
|
> Spin:局部区域正在加载数据,需要覆盖指示器且不阻断整页时。
|
|
11506
11633
|
|
|
11507
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
11634
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
11508
11635
|
|
|
11509
11636
|
公开导出:`Spin`。
|
|
11510
11637
|
|
|
@@ -11801,7 +11928,7 @@ Spin 仅表达不确定等待;有具体百分比时请使用 Progress 组件
|
|
|
11801
11928
|
|
|
11802
11929
|
> Steps:分步表单、向导、下单流程等需要展示当前所处阶段时。
|
|
11803
11930
|
|
|
11804
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
11931
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
11805
11932
|
|
|
11806
11933
|
公开导出:`Steps`。
|
|
11807
11934
|
|
|
@@ -12104,7 +12231,7 @@ v1 仅提供默认序号图标步骤条,不提供点状(dot)类型;需
|
|
|
12104
12231
|
|
|
12105
12232
|
> Switch:需要立即生效的开关型设置(如启用通知、暗色模式)时。
|
|
12106
12233
|
|
|
12107
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
12234
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
12108
12235
|
|
|
12109
12236
|
公开导出:`Switch`、`SwitchRoot`、`SwitchThumb`。
|
|
12110
12237
|
|
|
@@ -12323,7 +12450,7 @@ Switch 不提供 `value` / `defaultValue` 别名;与 Form 集成时请使用 `
|
|
|
12323
12450
|
|
|
12324
12451
|
> Table:需要以行列形式展示、浏览结构化数据(列表、台账、报表)时。
|
|
12325
12452
|
|
|
12326
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
12453
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
12327
12454
|
|
|
12328
12455
|
公开导出:`Table`、`TableSummary`。
|
|
12329
12456
|
|
|
@@ -12375,8 +12502,8 @@ export default () => <Table columns={columns} data={data} />
|
|
|
12375
12502
|
| columns | 列定义 | `TableColumn<RecordType>[]` | 否 | `[]` |
|
|
12376
12503
|
| data | 数据;空数组渲染空态 | `RecordType[]` | 否 | `[]` |
|
|
12377
12504
|
| rowKey | 行键,映射到 TanStack `getRowId` | `RowKey<RecordType>` | 否 | `'key'` |
|
|
12378
|
-
| loading | 加载态;普通表格用 3 行骨架占位,`scroll.y` / `flexHeight` 场景按表体可用高度自动填满。<br>骨架行高跟随 `size`(`--table-size-height-content` + block padding,视觉
|
|
12379
|
-
| size | 尺寸;`small`
|
|
12505
|
+
| loading | 加载态;普通表格用 3 行骨架占位,`scroll.y` / `flexHeight` 场景按表体可用高度自动填满。<br>骨架行高跟随 `size`(`--table-size-height-content` + block padding,视觉 32/40/40),加载时替换数据行。 | `boolean` | 否 | `false` |
|
|
12506
|
+
| size | 尺寸;`small` 使用 block-md token,`medium` / `large` 使用 block-la token。<br>单元格内容区最小高度为 `--table-size-height-content`,加上 `--table-spacing-padding-y` 后视觉下限 32/40/40。<br>表体可继续被内容撑高,不锁死行高。<br>字号全 size 一致:表头 `text-*-body`(14/20),内容 `text-*-caption`(12/18)。<br>非 `ellipsis` 纯文本列可多行撑高;`ellipsis` 纯文本列保持单行截断。<br>- `small` — 紧凑<br>- `medium` — 标准<br>- `large` — 宽松(默认) | `"small" \| "medium" \| "large"` | 否 | `'large'` |
|
|
12380
12507
|
| showHeader | 是否渲染 `<thead>` | `boolean` | 否 | `true` |
|
|
12381
12508
|
| rowClassName | 行 className | `string \| ((record: RecordType, index: number) => string)` | 否 | — |
|
|
12382
12509
|
| onRow | 行原生属性透传 | `(record: RecordType, index: number) => React.HTMLAttributes<HTMLTableRowElement>` | 否 | — |
|
|
@@ -12417,7 +12544,7 @@ type TableEllipsisConfig = boolean | TypographyEllipsisConfig
|
|
|
12417
12544
|
| defaultSelectedRowKeys | 非受控初始已选 row key 数组 | `Key[]` | 否 | `[]` |
|
|
12418
12545
|
| columnWidth | 选择列宽 | `number \| string` | 否 | `48(`showIndex` 为 true)/ 40(`showIndex` 为 false)` |
|
|
12419
12546
|
| hideSelectAll | 是否隐藏全选 checkbox(仅 `checkbox` 模式) | `boolean` | 否 | `false` |
|
|
12420
|
-
| showIndex |
|
|
12547
|
+
| showIndex | 是否将序号与选择列合并:启用后默认显示序号,行 hover / 已选 / 键盘焦点时切换为选择控件。<br>序号按当前页连续编号(分页时为全局序号:`(current - 1) * pageSize + index + 1`)。 | `boolean` | 否 | `false` |
|
|
12421
12548
|
| fixed | 固定选择列方向;须配合 `scroll.x` 与数字 `columnWidth` 使用 | `"left" \| "right"` | 否 | — |
|
|
12422
12549
|
| onChange | 选中变化回调 | `(selectedRowKeys: Key[], selectedRows: RecordType[]) => void` | 否 | — |
|
|
12423
12550
|
| getCheckboxProps | 单行禁用配置 | `(record: RecordType) => { disabled?: boolean }` | 否 | — |
|
|
@@ -12586,7 +12713,7 @@ type RowKey<RecordType> = string | keyof RecordType | ((record: RecordType, inde
|
|
|
12586
12713
|
|
|
12587
12714
|
### 尺寸
|
|
12588
12715
|
|
|
12589
|
-
通过 `size`
|
|
12716
|
+
通过 `size` 切换密度:表头和表体行高下限为 `small`(32px)/ `medium`(40px)/ `large`(40px,默认);表体可由多行内容继续撑高。字号在各档保持一致:表头 14px、内容 12px。
|
|
12590
12717
|
|
|
12591
12718
|
```tsx
|
|
12592
12719
|
import { Table } from '@apexhub/apex-ui-react'
|
|
@@ -12668,7 +12795,7 @@ export default () => (
|
|
|
12668
12795
|
|
|
12669
12796
|
### 分页
|
|
12670
12797
|
|
|
12671
|
-
通过 `pagination` 配置分页;设为 `false`
|
|
12798
|
+
通过 `pagination` 配置分页;设为 `false` 可关闭分页区。两端均支持页码导航、`showSizeChanger` 和 `showTotal`。React Table 会在页码控件左侧单独渲染总数文案。Vue 版还支持 `showQuickJumper`;React 版仅保留该旧参数以兼容调用方,当前不渲染快速跳转。
|
|
12672
12799
|
|
|
12673
12800
|
```tsx
|
|
12674
12801
|
import { Table } from '@apexhub/apex-ui-react'
|
|
@@ -12690,7 +12817,11 @@ export default () => (
|
|
|
12690
12817
|
<Table
|
|
12691
12818
|
columns={columns}
|
|
12692
12819
|
data={data}
|
|
12693
|
-
pagination={{
|
|
12820
|
+
pagination={{
|
|
12821
|
+
defaultPageSize: 10,
|
|
12822
|
+
showSizeChanger: true,
|
|
12823
|
+
showTotal: (total, range) => `共 ${total} 条,当前 ${range[0]}-${range[1]}`,
|
|
12824
|
+
}}
|
|
12694
12825
|
/>
|
|
12695
12826
|
)
|
|
12696
12827
|
```
|
|
@@ -12764,7 +12895,7 @@ export default () => (
|
|
|
12764
12895
|
|
|
12765
12896
|
### 行选择
|
|
12766
12897
|
|
|
12767
|
-
配置 `rowSelection`
|
|
12898
|
+
配置 `rowSelection` 开启多选或单选列,选择控件默认常显,点击即可选中。需要在同一列复用序号时显式设置 `showIndex: true`,鼠标悬停当前行(或已选 / 键盘焦点)时切换为选择控件;分页开启时序号为全局连续编号。
|
|
12768
12899
|
|
|
12769
12900
|
```tsx
|
|
12770
12901
|
import { Table } from '@apexhub/apex-ui-react'
|
|
@@ -12803,7 +12934,7 @@ export default () => {
|
|
|
12803
12934
|
|
|
12804
12935
|
`rowSelection.fixed` 可将选择列固定在左侧或右侧;须配合 `scroll.x` 与数字 `columnWidth` 使用。与 `column.fixed: 'left'` 叠加时,选择列始终在最左并参与偏移计算。
|
|
12805
12936
|
|
|
12806
|
-
|
|
12937
|
+
本例使用默认配置,复选框始终显示,无需悬停行。
|
|
12807
12938
|
|
|
12808
12939
|
```tsx
|
|
12809
12940
|
import { Button, Table } from '@apexhub/apex-ui-react'
|
|
@@ -12855,7 +12986,6 @@ export default () => {
|
|
|
12855
12986
|
pagination={false}
|
|
12856
12987
|
rowSelection={{
|
|
12857
12988
|
fixed: 'left',
|
|
12858
|
-
showIndex: false,
|
|
12859
12989
|
columnWidth: 48,
|
|
12860
12990
|
selectedRowKeys: selectedKeys,
|
|
12861
12991
|
onChange: (keys) => setSelectedKeys(keys),
|
|
@@ -13019,7 +13149,7 @@ import { Table, Tag } from '@apexhub/apex-ui-react'
|
|
|
13019
13149
|
type ProductRecord = {
|
|
13020
13150
|
key: string
|
|
13021
13151
|
name: string
|
|
13022
|
-
tags: Array<{ label: string; color: 'brand' | 'success' | 'warning' | 'error' | '
|
|
13152
|
+
tags: Array<{ label: string; color: 'brand' | 'success' | 'warning' | 'error' | 'grey' }>
|
|
13023
13153
|
}
|
|
13024
13154
|
|
|
13025
13155
|
const LONG_TAG_LABELS = {
|
|
@@ -13044,7 +13174,7 @@ const data: ProductRecord[] = [
|
|
|
13044
13174
|
tags: [
|
|
13045
13175
|
{ label: LONG_TAG_LABELS.region, color: 'brand' },
|
|
13046
13176
|
{ label: '季度复盘待办:整理本月续约风险清单并同步客户成功经理', color: 'warning' },
|
|
13047
|
-
{ label: LONG_TAG_LABELS.category, color: '
|
|
13177
|
+
{ label: LONG_TAG_LABELS.category, color: 'grey' },
|
|
13048
13178
|
],
|
|
13049
13179
|
},
|
|
13050
13180
|
{
|
|
@@ -13343,7 +13473,7 @@ export default () => (
|
|
|
13343
13473
|
|
|
13344
13474
|
## DOM 结构
|
|
13345
13475
|
|
|
13346
|
-
源码声明的静态 `data-slot`:`table-element`、`table-scroll-shell`、`table-scroll`、`table-empty-fixed`、`table-summary-wrap`、`table-element-summary`、`table-container`、`table`、`table-header-wrap`、`table-element-header`、`table-expand-trigger`、`table-selection-cell`、`table-selection-index`、`table-selection-all`、`table-selection-radio`、`table-selection-checkbox`、`table-virtual-spacer`、`table-expanded-row`、`table-expanded-cell`、`table-tbody`、`table-cell-head`、`table-cell`、`table-col`、`table-row-empty`、`table-cell-empty`、`table-empty-image`、`table-thead`、`table-row`、`table-pagination`、`table-scrollbar`、`table-scrollbar-track-y`、`table-scrollbar-thumb-y`、`table-scrollbar-track-x`、`table-scrollbar-thumb-x`、`table-skeleton-row`、`table-skeleton-cell`、`table-summary`、`table-summary-row`、`table-summary-cell`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
13476
|
+
源码声明的静态 `data-slot`:`table-element`、`table-scroll-shell`、`table-scroll`、`table-empty-fixed`、`table-summary-wrap`、`table-element-summary`、`table-container`、`table`、`table-header-wrap`、`table-element-header`、`table-expand-trigger`、`table-selection-cell`、`table-selection-index`、`table-selection-all`、`table-selection-radio`、`table-selection-checkbox`、`table-virtual-spacer`、`table-expanded-row`、`table-expanded-cell`、`table-tbody`、`table-cell-head`、`table-cell`、`table-col`、`table-row-empty`、`table-cell-empty`、`table-empty-image`、`table-thead`、`table-row`、`table-pagination`、`table-pagination-total`、`table-scrollbar`、`table-scrollbar-track-y`、`table-scrollbar-thumb-y`、`table-scrollbar-track-x`、`table-scrollbar-thumb-x`、`table-skeleton-row`、`table-skeleton-cell`、`table-summary`、`table-summary-row`、`table-summary-cell`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
13347
13477
|
|
|
13348
13478
|
## 样式定制
|
|
13349
13479
|
|
|
@@ -13372,7 +13502,7 @@ export default () => (
|
|
|
13372
13502
|
|
|
13373
13503
|
> Tabs:需要在同一页面区域内切换多组相关内容,且各面板互斥展示时。
|
|
13374
13504
|
|
|
13375
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
13505
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
13376
13506
|
|
|
13377
13507
|
公开导出:`Tabs`。
|
|
13378
13508
|
|
|
@@ -13681,7 +13811,7 @@ Apex Tabs 仅支持 `items` 配置式,不支持 `Tabs.TabPane` 复合写法。
|
|
|
13681
13811
|
|
|
13682
13812
|
> Tag:需要标记状态、分类、属性等短文本信息时(如「进行中」「VIP」)。
|
|
13683
13813
|
|
|
13684
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
13814
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
13685
13815
|
|
|
13686
13816
|
公开导出:`Tag`。
|
|
13687
13817
|
|
|
@@ -13712,7 +13842,7 @@ export default () => <Tag>默认标签</Tag>
|
|
|
13712
13842
|
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
13713
13843
|
| --- | --- | --- | --- | --- |
|
|
13714
13844
|
| closeIcon | 自定义关闭按钮。`false`/`null` 隐藏,`true` 使用默认图标,传入 ReactNode 自定义。 | `React.ReactNode` | 否 | `false` |
|
|
13715
|
-
| color | 标签色(支持预设值与自定义色字符串)。<br>自定义字符串会作为 `backgroundColor` / `borderColor` 注入 inline style;<br>`data-color` 同步输出原始值,便于消费方覆盖。 | `TagColor` | 否 | `'
|
|
13845
|
+
| color | 标签色(支持预设值与自定义色字符串)。<br>自定义字符串会作为 `backgroundColor` / `borderColor` 注入 inline style;<br>`data-color` 同步输出原始值,便于消费方覆盖。 | `TagColor` | 否 | `'grey'` |
|
|
13716
13846
|
| disabled | 是否禁用标签交互。 | `boolean` | 否 | `false` |
|
|
13717
13847
|
| href | 点击跳转地址,存在时渲染为 a 标签。 | `string` | 否 | — |
|
|
13718
13848
|
| target | a 标签 target,href 存在时生效。 | `string` | 否 | — |
|
|
@@ -13731,7 +13861,7 @@ type TagVariant = 'filled' | 'solid' | 'outlined'
|
|
|
13731
13861
|
### TagPresetColor
|
|
13732
13862
|
|
|
13733
13863
|
```typescript
|
|
13734
|
-
type TagPresetColor = 'default' | 'brand' | 'success' | 'warning' | 'error'
|
|
13864
|
+
type TagPresetColor = 'default' | 'brand' | 'success' | 'warning' | 'error' | 'grey'
|
|
13735
13865
|
```
|
|
13736
13866
|
|
|
13737
13867
|
### TagColor
|
|
@@ -13754,7 +13884,7 @@ type TagSize = 'lg' | 'md' | 'sm'
|
|
|
13754
13884
|
|
|
13755
13885
|
### 样式变体
|
|
13756
13886
|
|
|
13757
|
-
|
|
13887
|
+
当前设计 Token 支持浅底 `filled` 和中性描边 `outlined` 两种预设视觉样式。
|
|
13758
13888
|
|
|
13759
13889
|
```tsx
|
|
13760
13890
|
import { Tag } from '@apexhub/apex-ui-react'
|
|
@@ -13762,7 +13892,6 @@ import { Tag } from '@apexhub/apex-ui-react'
|
|
|
13762
13892
|
export default () => (
|
|
13763
13893
|
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
|
|
13764
13894
|
<Tag variant="filled">Filled</Tag>
|
|
13765
|
-
<Tag variant="solid">Solid</Tag>
|
|
13766
13895
|
<Tag variant="outlined">Outlined</Tag>
|
|
13767
13896
|
</div>
|
|
13768
13897
|
)
|
|
@@ -13770,16 +13899,16 @@ export default () => (
|
|
|
13770
13899
|
|
|
13771
13900
|
### 多彩标签
|
|
13772
13901
|
|
|
13773
|
-
使用 `color` 表示语义色,也可以传入具体色值满足临时标记场景。
|
|
13902
|
+
使用 `color` 表示语义色,也可以传入具体色值满足临时标记场景。React 版提供 `grey` 预设。`solid` 暂无预设色 Token,不用于预设色示例。
|
|
13774
13903
|
|
|
13775
13904
|
```tsx
|
|
13776
13905
|
import type { TagPresetColor, TagVariant } from '@apexhub/apex-ui-react'
|
|
13777
13906
|
|
|
13778
13907
|
import { Divider, Tag } from '@apexhub/apex-ui-react'
|
|
13779
13908
|
|
|
13780
|
-
const variants: TagVariant[] = ['filled', '
|
|
13909
|
+
const variants: TagVariant[] = ['filled', 'outlined']
|
|
13781
13910
|
|
|
13782
|
-
const presets: TagPresetColor[] = ['
|
|
13911
|
+
const presets: TagPresetColor[] = ['grey', 'brand', 'success', 'warning', 'error']
|
|
13783
13912
|
|
|
13784
13913
|
const customs = ['#f50', '#2db7f5', '#87d068', '#108ee9']
|
|
13785
13914
|
|
|
@@ -13989,7 +14118,7 @@ export default () => (
|
|
|
13989
14118
|
|
|
13990
14119
|
> Tooltip:图标按钮、缩写、截断文本等需要补充说明时。
|
|
13991
14120
|
|
|
13992
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
14121
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
13993
14122
|
|
|
13994
14123
|
公开导出:`Tooltip`。
|
|
13995
14124
|
|
|
@@ -14296,7 +14425,7 @@ export default () => (
|
|
|
14296
14425
|
|
|
14297
14426
|
> Tree:需要展示具有父子层级关系的数据(目录、组织架构、权限树等)时。
|
|
14298
14427
|
|
|
14299
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
14428
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
14300
14429
|
|
|
14301
14430
|
公开导出:`Tree`。
|
|
14302
14431
|
|
|
@@ -14592,31 +14721,27 @@ Tree 实例方法(通过 `ref` 获取)
|
|
|
14592
14721
|
|
|
14593
14722
|
### 勾选
|
|
14594
14723
|
|
|
14595
|
-
设置 `checkable` 显示勾选框,配合 `checkedKeys` / 勾选变化事件
|
|
14724
|
+
设置 `checkable` 显示勾选框,配合 `checkedKeys` / 勾选变化事件 管理勾选状态。示例预选一个子节点,父节点显示半选;点击父节点可勾选其余可用子节点,禁用子节点保持未选。
|
|
14596
14725
|
|
|
14597
14726
|
```tsx
|
|
14598
|
-
import { Tree } from '@apexhub/apex-ui-react'
|
|
14599
|
-
|
|
14600
14727
|
import type { TreeDataNode } from '@apexhub/apex-ui-react'
|
|
14601
14728
|
|
|
14602
|
-
|
|
14729
|
+
import { Tree } from '@apexhub/apex-ui-react'
|
|
14730
|
+
|
|
14731
|
+
const treeData: TreeDataNode[] = [
|
|
14603
14732
|
{
|
|
14604
|
-
key: '
|
|
14605
|
-
title: '
|
|
14733
|
+
key: 'team',
|
|
14734
|
+
title: '项目组',
|
|
14606
14735
|
children: [
|
|
14607
|
-
{ key: '
|
|
14608
|
-
{ key: '
|
|
14736
|
+
{ key: 'design', title: '设计' },
|
|
14737
|
+
{ key: 'engineering', title: '研发' },
|
|
14738
|
+
{ key: 'archived', title: '已归档', disabled: true },
|
|
14609
14739
|
],
|
|
14610
14740
|
},
|
|
14611
|
-
{
|
|
14612
|
-
key: '0-1',
|
|
14613
|
-
title: '父节点 1',
|
|
14614
|
-
children: [{ key: '0-1-0', title: '叶子 0-1-0' }],
|
|
14615
|
-
},
|
|
14616
14741
|
]
|
|
14617
14742
|
|
|
14618
14743
|
export default () => (
|
|
14619
|
-
<Tree treeData={
|
|
14744
|
+
<Tree treeData={treeData} checkable defaultExpandAll defaultCheckedKeys={['design']} />
|
|
14620
14745
|
)
|
|
14621
14746
|
```
|
|
14622
14747
|
|
|
@@ -14804,7 +14929,7 @@ v1 未实现 `showLine`。若需要连接线样式,请关注后续版本或使
|
|
|
14804
14929
|
|
|
14805
14930
|
> TreeSelect:表单中需要从层级数据里选取一个或多个节点时(部门、分类、地区等)。
|
|
14806
14931
|
|
|
14807
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
14932
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
14808
14933
|
|
|
14809
14934
|
公开导出:`TreeSelect`。
|
|
14810
14935
|
|
|
@@ -15229,27 +15354,23 @@ export default () => (
|
|
|
15229
15354
|
|
|
15230
15355
|
### 勾选
|
|
15231
15356
|
|
|
15232
|
-
`treeCheckable` 与 `multiple`
|
|
15357
|
+
`treeCheckable` 与 `multiple` 配合,通过复选框选择多个节点。示例预选一个子节点,可观察父节点半选;悬停一行时,行背景与该行复选框共同显示悬停态。点击父节点只勾选可用子节点,禁用子节点保持未选。
|
|
15233
15358
|
|
|
15234
15359
|
```tsx
|
|
15235
|
-
import { TreeSelect } from '@apexhub/apex-ui-react'
|
|
15236
|
-
|
|
15237
15360
|
import type { TreeSelectDataNode } from '@apexhub/apex-ui-react'
|
|
15238
15361
|
|
|
15239
|
-
|
|
15362
|
+
import { TreeSelect } from '@apexhub/apex-ui-react'
|
|
15363
|
+
|
|
15364
|
+
const treeData: TreeSelectDataNode[] = [
|
|
15240
15365
|
{
|
|
15241
|
-
value: '
|
|
15242
|
-
title: '
|
|
15366
|
+
value: 'team',
|
|
15367
|
+
title: '项目组',
|
|
15243
15368
|
children: [
|
|
15244
|
-
{ value: '
|
|
15245
|
-
{ value: '
|
|
15369
|
+
{ value: 'design', title: '设计' },
|
|
15370
|
+
{ value: 'engineering', title: '研发' },
|
|
15371
|
+
{ value: 'archived', title: '已归档', disabled: true },
|
|
15246
15372
|
],
|
|
15247
15373
|
},
|
|
15248
|
-
{
|
|
15249
|
-
value: '0-1',
|
|
15250
|
-
title: '父节点 1',
|
|
15251
|
-
children: [{ value: '0-1-0', title: '叶子 0-1-0' }],
|
|
15252
|
-
},
|
|
15253
15374
|
]
|
|
15254
15375
|
|
|
15255
15376
|
export default () => (
|
|
@@ -15257,10 +15378,10 @@ export default () => (
|
|
|
15257
15378
|
style={{ width: '250px' }}
|
|
15258
15379
|
treeCheckable
|
|
15259
15380
|
multiple
|
|
15260
|
-
treeData={
|
|
15381
|
+
treeData={treeData}
|
|
15261
15382
|
treeDefaultExpandAll
|
|
15262
|
-
defaultValue={['
|
|
15263
|
-
placeholder="
|
|
15383
|
+
defaultValue={['design']}
|
|
15384
|
+
placeholder="选择团队"
|
|
15264
15385
|
/>
|
|
15265
15386
|
)
|
|
15266
15387
|
```
|
|
@@ -15297,7 +15418,7 @@ export default () => (
|
|
|
15297
15418
|
|
|
15298
15419
|
### 尺寸
|
|
15299
15420
|
|
|
15300
|
-
支持 `large`、`medium`(默认)、`small`
|
|
15421
|
+
支持 `large`、`medium`(默认)、`small` 三种触发器尺寸;弹层选项高度随尺寸档位对齐。示例选中值并开启清除,以便对照 large/medium 的 16px 箭头、small 的 14px 箭头与各档 14px 清除按钮。
|
|
15301
15422
|
|
|
15302
15423
|
```tsx
|
|
15303
15424
|
import { TreeSelect } from '@apexhub/apex-ui-react'
|
|
@@ -15322,14 +15443,27 @@ const TREE_SELECT_DATA: TreeSelectDataNode[] = [
|
|
|
15322
15443
|
|
|
15323
15444
|
export default () => (
|
|
15324
15445
|
<div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
|
|
15325
|
-
<TreeSelect
|
|
15446
|
+
<TreeSelect
|
|
15447
|
+
size="large"
|
|
15448
|
+
treeData={TREE_SELECT_DATA}
|
|
15449
|
+
defaultValue="0-0-0"
|
|
15450
|
+
allowClear
|
|
15451
|
+
treeDefaultExpandAll
|
|
15452
|
+
/>
|
|
15326
15453
|
<TreeSelect
|
|
15327
15454
|
size="medium"
|
|
15328
15455
|
treeData={TREE_SELECT_DATA}
|
|
15456
|
+
defaultValue="0-0-0"
|
|
15457
|
+
allowClear
|
|
15458
|
+
treeDefaultExpandAll
|
|
15459
|
+
/>
|
|
15460
|
+
<TreeSelect
|
|
15461
|
+
size="small"
|
|
15462
|
+
treeData={TREE_SELECT_DATA}
|
|
15463
|
+
defaultValue="0-0-0"
|
|
15464
|
+
allowClear
|
|
15329
15465
|
treeDefaultExpandAll
|
|
15330
|
-
placeholder="medium"
|
|
15331
15466
|
/>
|
|
15332
|
-
<TreeSelect size="small" treeData={TREE_SELECT_DATA} treeDefaultExpandAll placeholder="small" />
|
|
15333
15467
|
</div>
|
|
15334
15468
|
)
|
|
15335
15469
|
```
|
|
@@ -15366,7 +15500,7 @@ export default () => (
|
|
|
15366
15500
|
|
|
15367
15501
|
### 只读
|
|
15368
15502
|
|
|
15369
|
-
`readOnly` 为 true
|
|
15503
|
+
`readOnly` 为 true 时不可打开下拉、不可清除或修改;视觉使用禁用配色,但仍可聚焦。示例对照空值、单选和多选。
|
|
15370
15504
|
|
|
15371
15505
|
```tsx
|
|
15372
15506
|
import { TreeSelect } from '@apexhub/apex-ui-react'
|
|
@@ -15392,6 +15526,7 @@ const TREE_SELECT_DATA: TreeSelectDataNode[] = [
|
|
|
15392
15526
|
export default () => (
|
|
15393
15527
|
<div style={{ display: 'flex', flexDirection: 'column', gap: 16, maxWidth: 320 }}>
|
|
15394
15528
|
<TreeSelect treeData={TREE_SELECT_DATA} defaultValue="0-0-0" placeholder="可编辑" allowClear />
|
|
15529
|
+
<TreeSelect treeData={TREE_SELECT_DATA} readOnly placeholder="只读空值" />
|
|
15395
15530
|
<TreeSelect treeData={TREE_SELECT_DATA} defaultValue="0-0-0" readOnly placeholder="只读" />
|
|
15396
15531
|
<TreeSelect
|
|
15397
15532
|
treeData={TREE_SELECT_DATA}
|
|
@@ -15569,7 +15704,7 @@ v1 不提供该 prop;弹层通过 Portal 挂载到 `document.body`。若需在
|
|
|
15569
15704
|
|
|
15570
15705
|
> Typography:需要按设计字阶展示标题(`Title`)、正文(`Text`)或段落(`Paragraph`)时。
|
|
15571
15706
|
|
|
15572
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
15707
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
15573
15708
|
|
|
15574
15709
|
公开导出:`Typography`、`TypographyParagraph`、`TypographyText`、`TypographyTitle`。
|
|
15575
15710
|
|
|
@@ -15985,7 +16120,7 @@ export default () => (
|
|
|
15985
16120
|
|
|
15986
16121
|
> Upload:需要将本地文件上传到服务端,并展示上传进度与结果列表时。
|
|
15987
16122
|
|
|
15988
|
-
包:`@apexhub/apex-ui-react`;版本:`1.2.
|
|
16123
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
15989
16124
|
|
|
15990
16125
|
公开导出:`canPreviewFile`、`configureUploadLimits`、`formatFileSize`、`getFileExtension`、`getFileFormatIconName`、`getFileKind`、`getFilePreviewKind`、`getFilePreviewUrl`、`getUploadLimits`、`isDocumentFile`、`isImageFile`、`resetUploadLimits`、`UPLOAD_DEFAULT_MAX_COUNT`、`UPLOAD_DEFAULT_MAX_FILE_SIZE`、`UPLOAD_LIST_IGNORE`、`Upload`。
|
|
15991
16126
|
|
|
@@ -16346,7 +16481,7 @@ export default () => (
|
|
|
16346
16481
|
|
|
16347
16482
|
### 图片列表
|
|
16348
16483
|
|
|
16349
|
-
`listType="picture"`
|
|
16484
|
+
`listType="picture"` 以缩略图形式展示文件。示例包含图片与 PDF/DOCX:非图片文件使用 40px 文件类型缩略图,不显示扩展名角标,文件名仍完整显示。
|
|
16350
16485
|
|
|
16351
16486
|
```tsx
|
|
16352
16487
|
import type { UploadFile } from '@apexhub/apex-ui-react'
|
|
@@ -16406,6 +16541,8 @@ const defaultFileList = [
|
|
|
16406
16541
|
status: 'error',
|
|
16407
16542
|
thumbUrl: UPLOAD_DEMO_IMAGE_GRAY,
|
|
16408
16543
|
},
|
|
16544
|
+
{ uid: '4', name: 'report.pdf', status: 'done' },
|
|
16545
|
+
{ uid: '5', name: 'proposal.docx', status: 'done' },
|
|
16409
16546
|
] as unknown as UploadFile[]
|
|
16410
16547
|
|
|
16411
16548
|
export default () => (
|