@apexhub/apex-ui-react 0.0.0-stage → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +37 -2
- package/dist/en_US.d.ts +191 -0
- package/dist/index.cjs +40727 -0
- package/dist/index.d.ts +6873 -0
- package/dist/index.mjs +40711 -0
- package/dist/llm/alert.tokens.txt +44 -0
- package/dist/llm/alert.txt +167 -0
- package/dist/llm/apex-provider.txt +369 -0
- package/dist/llm/auto-complete.tokens.txt +77 -0
- package/dist/llm/auto-complete.txt +373 -0
- package/dist/llm/avatar.tokens.txt +38 -0
- package/dist/llm/avatar.txt +199 -0
- package/dist/llm/breadcrumb.tokens.txt +143 -0
- package/dist/llm/breadcrumb.txt +251 -0
- package/dist/llm/button.tokens.txt +470 -0
- package/dist/llm/button.txt +270 -0
- package/dist/llm/card.tokens.txt +29 -0
- package/dist/llm/card.txt +118 -0
- package/dist/llm/cascader.tokens.txt +261 -0
- package/dist/llm/cascader.txt +917 -0
- package/dist/llm/checkbox.tokens.txt +36 -0
- package/dist/llm/checkbox.txt +343 -0
- package/dist/llm/collapse.tokens.txt +84 -0
- package/dist/llm/collapse.txt +330 -0
- package/dist/llm/date-picker.tokens.txt +171 -0
- package/dist/llm/date-picker.txt +428 -0
- package/dist/llm/divider.tokens.txt +22 -0
- package/dist/llm/divider.txt +161 -0
- package/dist/llm/drawer.tokens.txt +71 -0
- package/dist/llm/drawer.txt +369 -0
- package/dist/llm/dropdown.tokens.txt +59 -0
- package/dist/llm/dropdown.txt +420 -0
- package/dist/llm/form.tokens.txt +28 -0
- package/dist/llm/form.txt +341 -0
- package/dist/llm/grid.txt +419 -0
- package/dist/llm/image.tokens.txt +28 -0
- package/dist/llm/image.txt +428 -0
- package/dist/llm/input-number.tokens.txt +159 -0
- package/dist/llm/input-number.txt +491 -0
- package/dist/llm/input.tokens.txt +136 -0
- package/dist/llm/input.txt +424 -0
- package/dist/llm/layout.tokens.txt +29 -0
- package/dist/llm/layout.txt +298 -0
- package/dist/llm/menu.tokens.txt +100 -0
- package/dist/llm/menu.txt +687 -0
- package/dist/llm/message.tokens.txt +25 -0
- package/dist/llm/message.txt +301 -0
- package/dist/llm/modal.tokens.txt +96 -0
- package/dist/llm/modal.txt +584 -0
- package/dist/llm/notification.tokens.txt +79 -0
- package/dist/llm/notification.txt +383 -0
- package/dist/llm/pagination.tokens.txt +35 -0
- package/dist/llm/pagination.txt +217 -0
- package/dist/llm/popover.tokens.txt +18 -0
- package/dist/llm/popover.txt +233 -0
- package/dist/llm/progress.tokens.txt +83 -0
- package/dist/llm/progress.txt +279 -0
- package/dist/llm/radio.tokens.txt +26 -0
- package/dist/llm/radio.txt +385 -0
- package/dist/llm/rate.tokens.txt +20 -0
- package/dist/llm/rate.txt +241 -0
- package/dist/llm/select.tokens.txt +160 -0
- package/dist/llm/select.txt +831 -0
- package/dist/llm/skeleton.tokens.txt +15 -0
- package/dist/llm/skeleton.txt +275 -0
- package/dist/llm/spin.tokens.txt +21 -0
- package/dist/llm/spin.txt +294 -0
- package/dist/llm/steps.tokens.txt +30 -0
- package/dist/llm/steps.txt +300 -0
- package/dist/llm/switch.tokens.txt +38 -0
- package/dist/llm/switch.txt +216 -0
- package/dist/llm/table.tokens.txt +94 -0
- package/dist/llm/table.txt +1049 -0
- package/dist/llm/tabs.tokens.txt +78 -0
- package/dist/llm/tabs.txt +306 -0
- package/dist/llm/tag.tokens.txt +75 -0
- package/dist/llm/tag.txt +304 -0
- package/dist/llm/tooltip.tokens.txt +22 -0
- package/dist/llm/tooltip.txt +304 -0
- package/dist/llm/tree-select.tokens.txt +175 -0
- package/dist/llm/tree-select.txt +772 -0
- package/dist/llm/tree.tokens.txt +34 -0
- package/dist/llm/tree.txt +501 -0
- package/dist/llm/typography.tokens.txt +60 -0
- package/dist/llm/typography.txt +413 -0
- package/dist/llm/upload.tokens.txt +205 -0
- package/dist/llm/upload.txt +708 -0
- package/dist/llms-full.txt +16826 -0
- package/dist/llms-theme.txt +32 -0
- package/dist/llms.txt +59 -0
- package/dist/locale/en_US.cjs +160 -0
- package/dist/locale/en_US.d.ts +4 -0
- package/dist/locale/en_US.mjs +161 -0
- package/dist/locale/zh_CN.cjs +160 -0
- package/dist/locale/zh_CN.d.ts +4 -0
- package/dist/locale/zh_CN.mjs +161 -0
- package/dist/style.css +20095 -0
- package/dist/zh_CN.d.ts +191 -0
- package/llms-full.txt +16826 -0
- package/llms-theme.txt +32 -0
- package/llms.txt +59 -0
- package/package.json +118 -3
- package/src/alert/llm.txt +167 -0
- package/src/alert/tokens.txt +44 -0
- package/src/apex-provider/llm.txt +369 -0
- package/src/auto-complete/llm.txt +373 -0
- package/src/auto-complete/tokens.txt +77 -0
- package/src/avatar/llm.txt +199 -0
- package/src/avatar/tokens.txt +38 -0
- package/src/breadcrumb/llm.txt +251 -0
- package/src/breadcrumb/tokens.txt +143 -0
- package/src/button/llm.txt +270 -0
- package/src/button/tokens.txt +470 -0
- package/src/card/llm.txt +118 -0
- package/src/card/tokens.txt +29 -0
- package/src/cascader/llm.txt +917 -0
- package/src/cascader/tokens.txt +261 -0
- package/src/checkbox/llm.txt +343 -0
- package/src/checkbox/tokens.txt +36 -0
- package/src/collapse/llm.txt +330 -0
- package/src/collapse/tokens.txt +84 -0
- package/src/date-picker/llm.txt +428 -0
- package/src/date-picker/tokens.txt +171 -0
- package/src/divider/llm.txt +161 -0
- package/src/divider/tokens.txt +22 -0
- package/src/drawer/llm.txt +369 -0
- package/src/drawer/tokens.txt +71 -0
- package/src/dropdown/llm.txt +420 -0
- package/src/dropdown/tokens.txt +59 -0
- package/src/form/llm.txt +341 -0
- package/src/form/tokens.txt +28 -0
- package/src/grid/llm.txt +419 -0
- package/src/image/llm.txt +428 -0
- package/src/image/tokens.txt +28 -0
- package/src/input/llm.txt +424 -0
- package/src/input/tokens.txt +136 -0
- package/src/input-number/llm.txt +491 -0
- package/src/input-number/tokens.txt +159 -0
- package/src/layout/llm.txt +298 -0
- package/src/layout/tokens.txt +29 -0
- package/src/menu/llm.txt +687 -0
- package/src/menu/tokens.txt +100 -0
- package/src/message/llm.txt +301 -0
- package/src/message/tokens.txt +25 -0
- package/src/modal/llm.txt +584 -0
- package/src/modal/tokens.txt +96 -0
- package/src/notification/llm.txt +383 -0
- package/src/notification/tokens.txt +79 -0
- package/src/pagination/llm.txt +217 -0
- package/src/pagination/tokens.txt +35 -0
- package/src/popover/llm.txt +233 -0
- package/src/popover/tokens.txt +18 -0
- package/src/progress/llm.txt +279 -0
- package/src/progress/tokens.txt +83 -0
- package/src/radio/llm.txt +385 -0
- package/src/radio/tokens.txt +26 -0
- package/src/rate/llm.txt +241 -0
- package/src/rate/tokens.txt +20 -0
- package/src/select/llm.txt +831 -0
- package/src/select/tokens.txt +160 -0
- package/src/skeleton/llm.txt +275 -0
- package/src/skeleton/tokens.txt +15 -0
- package/src/spin/llm.txt +294 -0
- package/src/spin/tokens.txt +21 -0
- package/src/steps/llm.txt +300 -0
- package/src/steps/tokens.txt +30 -0
- package/src/switch/llm.txt +216 -0
- package/src/switch/tokens.txt +38 -0
- package/src/table/llm.txt +1049 -0
- package/src/table/tokens.txt +94 -0
- package/src/tabs/llm.txt +306 -0
- package/src/tabs/tokens.txt +78 -0
- package/src/tag/llm.txt +304 -0
- package/src/tag/tokens.txt +75 -0
- package/src/tooltip/llm.txt +304 -0
- package/src/tooltip/tokens.txt +22 -0
- package/src/tree/llm.txt +501 -0
- package/src/tree/tokens.txt +34 -0
- package/src/tree-select/llm.txt +772 -0
- package/src/tree-select/tokens.txt +175 -0
- package/src/typography/llm.txt +413 -0
- package/src/typography/tokens.txt +60 -0
- package/src/upload/llm.txt +708 -0
- package/src/upload/tokens.txt +205 -0
|
@@ -0,0 +1,428 @@
|
|
|
1
|
+
# DatePicker
|
|
2
|
+
|
|
3
|
+
> DatePicker:用户需要选择单个日期或日期范围,且精确到日、周、月、季、年等不同粒度时。
|
|
4
|
+
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
|
+
|
|
7
|
+
公开导出:`DatePicker`、`RangePicker`。
|
|
8
|
+
|
|
9
|
+
以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
|
|
10
|
+
|
|
11
|
+
## 快速开始
|
|
12
|
+
|
|
13
|
+
```tsx
|
|
14
|
+
import { DatePicker } from '@apexhub/apex-ui-react'
|
|
15
|
+
|
|
16
|
+
import '@apexhub/apex-ui-react/style.css'
|
|
17
|
+
|
|
18
|
+
export default () => (
|
|
19
|
+
<div style={{ padding: 24, minHeight: 360 }}>
|
|
20
|
+
<DatePicker />
|
|
21
|
+
</div>
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## 何时使用
|
|
26
|
+
|
|
27
|
+
- 用户需要选择单个日期或日期范围,且精确到日、周、月、季、年等不同粒度时。
|
|
28
|
+
- 需要禁用特定日期、允许清除、或受控管理选中值时。
|
|
29
|
+
- 若只需输入固定格式字符串且无需日历面板,可考虑 Input;若需时间选择,可配合 `showTime`。
|
|
30
|
+
|
|
31
|
+
## API
|
|
32
|
+
|
|
33
|
+
仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
|
|
34
|
+
|
|
35
|
+
### DatePicker
|
|
36
|
+
|
|
37
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
38
|
+
| --- | --- | --- | --- | --- |
|
|
39
|
+
| value | — | `DateValue` | 否 | — |
|
|
40
|
+
| defaultValue | — | `DateValue` | 否 | — |
|
|
41
|
+
| onChange | — | `(date: DateValue, dateString: string) => void` | 否 | — |
|
|
42
|
+
| disabledDate | — | `DisabledDateFn` | 否 | — |
|
|
43
|
+
| presets | 面板左侧的业务快捷日期;未传或为空时不展示快捷区。 | `DatePickerPreset[]` | 否 | — |
|
|
44
|
+
| placeholder | — | `string` | 否 | — |
|
|
45
|
+
| showToday | 是否显示面板底部当前周期快捷按钮。<br>`date`:「今天」;`week`:「本周」;`month`:「本月」;`quarter`:「本季」;`year`:「本年」。 | `boolean` | 否 | `true` |
|
|
46
|
+
| ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
|
|
47
|
+
| variant | 输入框表面变体,与 Input 一致;不改变日期面板样式。 | `"default" \| "elevated"` | 否 | `'default'` |
|
|
48
|
+
| picker | — | `"date" \| "week" \| "month" \| "quarter" \| "year"` | 否 | — |
|
|
49
|
+
| format | — | `string` | 否 | — |
|
|
50
|
+
| showTime | 是否展示时间选择。仅 `picker="date"` 时生效。<br>- `true`:默认精确到秒(展示 `YYYY-MM-DD HH:mm:ss`,面板三列);须点「确定」后才会 `onChange`<br>- `{ format: 'HH:mm' }`:仅时/分(两列);触发器 format 未指定时跟随时段<br>- **RangePicker**:`showTime` 时分步确认——先 start 日期+时间 → 确定 → 再 end 日期+时间 → 确定 | `boolean \| { format?: string; defaultValue?: Dayjs \| [Dayjs, Dayjs] }` | 否 | `false` |
|
|
51
|
+
| needConfirm | 为 `true` 时,面板内选择仅作为草稿,须点击「确定」后才会触发 `onChange` 并更新触发器展示值。 | `boolean` | 否 | `false` |
|
|
52
|
+
| allowClear | — | `boolean \| { clearIcon?: ReactNode }` | 否 | — |
|
|
53
|
+
| disabled | — | `boolean` | 否 | — |
|
|
54
|
+
| readOnly | 只读:不可打开面板、不可改值,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
|
|
55
|
+
| size | — | `"small" \| "medium" \| "large"` | 否 | — |
|
|
56
|
+
| status | — | `"error" \| "warning"` | 否 | — |
|
|
57
|
+
| open | — | `boolean` | 否 | — |
|
|
58
|
+
| closeOnScroll | 外部滚动祖先滚动时关闭;内部列表滚动不关闭。触发器完全不可见时始终请求关闭。 | `boolean` | 否 | `false` |
|
|
59
|
+
| onOpenChange | — | `(open: boolean) => void` | 否 | — |
|
|
60
|
+
| popupClassName | — | `string` | 否 | — |
|
|
61
|
+
| getPopupContainer | 已弃用:浮层统一挂载 `[data-slot="overlay-root"]`,该 prop 不再生效。 | `(triggerNode: HTMLElement) => HTMLElement` | 否 | — |
|
|
62
|
+
| timezone | — | `string` | 否 | — |
|
|
63
|
+
| autoFocus | — | `boolean` | 否 | — |
|
|
64
|
+
| className | — | `string` | 否 | — |
|
|
65
|
+
| style | — | `React.CSSProperties` | 否 | — |
|
|
66
|
+
|
|
67
|
+
### CommonPickerProps
|
|
68
|
+
|
|
69
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
70
|
+
| --- | --- | --- | --- | --- |
|
|
71
|
+
| variant | 输入框表面变体,与 Input 一致;不改变日期面板样式。 | `"default" \| "elevated"` | 否 | `'default'` |
|
|
72
|
+
| picker | — | `"date" \| "week" \| "month" \| "quarter" \| "year"` | 否 | — |
|
|
73
|
+
| format | — | `string` | 否 | — |
|
|
74
|
+
| showTime | 是否展示时间选择。仅 `picker="date"` 时生效。<br>- `true`:默认精确到秒(展示 `YYYY-MM-DD HH:mm:ss`,面板三列);须点「确定」后才会 `onChange`<br>- `{ format: 'HH:mm' }`:仅时/分(两列);触发器 format 未指定时跟随时段<br>- **RangePicker**:`showTime` 时分步确认——先 start 日期+时间 → 确定 → 再 end 日期+时间 → 确定 | `boolean \| { format?: string; defaultValue?: Dayjs \| [Dayjs, Dayjs] }` | 否 | `false` |
|
|
75
|
+
| needConfirm | 为 `true` 时,面板内选择仅作为草稿,须点击「确定」后才会触发 `onChange` 并更新触发器展示值。 | `boolean` | 否 | `false` |
|
|
76
|
+
| allowClear | — | `boolean \| { clearIcon?: ReactNode }` | 否 | — |
|
|
77
|
+
| disabled | — | `boolean` | 否 | — |
|
|
78
|
+
| readOnly | 只读:不可打开面板、不可改值,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
|
|
79
|
+
| size | — | `"small" \| "medium" \| "large"` | 否 | — |
|
|
80
|
+
| status | — | `"error" \| "warning"` | 否 | — |
|
|
81
|
+
| open | — | `boolean` | 否 | — |
|
|
82
|
+
| closeOnScroll | 外部滚动祖先滚动时关闭;内部列表滚动不关闭。触发器完全不可见时始终请求关闭。 | `boolean` | 否 | `false` |
|
|
83
|
+
| onOpenChange | — | `(open: boolean) => void` | 否 | — |
|
|
84
|
+
| popupClassName | — | `string` | 否 | — |
|
|
85
|
+
| getPopupContainer | 已弃用:浮层统一挂载 `[data-slot="overlay-root"]`,该 prop 不再生效。 | `(triggerNode: HTMLElement) => HTMLElement` | 否 | — |
|
|
86
|
+
| timezone | — | `string` | 否 | — |
|
|
87
|
+
| autoFocus | — | `boolean` | 否 | — |
|
|
88
|
+
| className | — | `string` | 否 | — |
|
|
89
|
+
| style | — | `React.CSSProperties` | 否 | — |
|
|
90
|
+
|
|
91
|
+
### RangePickerProps
|
|
92
|
+
|
|
93
|
+
继承:`CommonPickerProps`;本节列出新增或重声明字段。
|
|
94
|
+
|
|
95
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
96
|
+
| --- | --- | --- | --- | --- |
|
|
97
|
+
| value | — | `RangeValue` | 否 | — |
|
|
98
|
+
| defaultValue | — | `RangeValue` | 否 | — |
|
|
99
|
+
| onChange | — | `(value: RangeValue, formatString: [string, string]) => void` | 否 | — |
|
|
100
|
+
| disabledDate | — | `DisabledRangeDateFn` | 否 | — |
|
|
101
|
+
| presets | RangePicker 面板左侧的业务快捷区。 | `RangePickerPreset[]` | 否 | — |
|
|
102
|
+
| placeholder | — | `[string, string]` | 否 | — |
|
|
103
|
+
| separator | — | `ReactNode` | 否 | — |
|
|
104
|
+
| ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
|
|
105
|
+
|
|
106
|
+
### RangePresetValue
|
|
107
|
+
|
|
108
|
+
```typescript
|
|
109
|
+
type RangePresetValue = [Dayjs, Dayjs] | (() => [Dayjs, Dayjs] | null)
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### DatePresetValue
|
|
113
|
+
|
|
114
|
+
固定日期,或仅在点击时计算的日期;返回 null 时不改值。
|
|
115
|
+
|
|
116
|
+
```typescript
|
|
117
|
+
type DatePresetValue = Dayjs | (() => Dayjs | null)
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### DatePickerPreset
|
|
121
|
+
|
|
122
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
123
|
+
| --- | --- | --- | --- | --- |
|
|
124
|
+
| key | 稳定身份;同一组快捷项中必须唯一。 | `string` | 是 | — |
|
|
125
|
+
| label | 快捷按钮内容。 | `ReactNode` | 是 | — |
|
|
126
|
+
| value | 保留业务传入的完整日期与时间,遵循 needConfirm / showTime 确认规则。 | `DatePresetValue` | 是 | — |
|
|
127
|
+
| disabled | 禁用后不可触发。 | `boolean` | 否 | — |
|
|
128
|
+
|
|
129
|
+
### RangePickerPreset
|
|
130
|
+
|
|
131
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
132
|
+
| --- | --- | --- | --- | --- |
|
|
133
|
+
| key | 稳定身份;同一组快捷项中必须唯一。 | `string` | 是 | — |
|
|
134
|
+
| label | 快捷按钮内容。 | `ReactNode` | 是 | — |
|
|
135
|
+
| value | 固定区间,或点击时计算的区间。 | `RangePresetValue` | 是 | — |
|
|
136
|
+
| disabled | 禁用后不可触发。 | `boolean` | 否 | — |
|
|
137
|
+
|
|
138
|
+
### PickerType
|
|
139
|
+
|
|
140
|
+
```typescript
|
|
141
|
+
type PickerType = 'date' | 'week' | 'month' | 'quarter' | 'year'
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### DateSize
|
|
145
|
+
|
|
146
|
+
```typescript
|
|
147
|
+
type DateSize = 'small' | 'medium' | 'large'
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### DateStatus
|
|
151
|
+
|
|
152
|
+
```typescript
|
|
153
|
+
type DateStatus = 'error' | 'warning'
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### DateValue
|
|
157
|
+
|
|
158
|
+
```typescript
|
|
159
|
+
type DateValue = Dayjs | null
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### DisabledDateFn
|
|
163
|
+
|
|
164
|
+
单参用法兼容;双参时可读取 info.type / info.from
|
|
165
|
+
|
|
166
|
+
```typescript
|
|
167
|
+
type DisabledDateFn = (current: Dayjs, info?: DisabledDateInfo) => boolean
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
### RangeValue
|
|
171
|
+
|
|
172
|
+
```typescript
|
|
173
|
+
type RangeValue = [DateValue, DateValue]
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
### DisabledRangeDateFn
|
|
177
|
+
|
|
178
|
+
RangePicker 用:统一双参签名(可忽略字段)
|
|
179
|
+
|
|
180
|
+
```typescript
|
|
181
|
+
type DisabledRangeDateFn = (current: Dayjs, info: DisabledDateInfo) => boolean
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
### DisabledDateInfo
|
|
185
|
+
|
|
186
|
+
disabledDate 第二参。
|
|
187
|
+
|
|
188
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
189
|
+
| --- | --- | --- | --- | --- |
|
|
190
|
+
| type | 判定来源面板;含 `week`(WeekPanel,非 PanelView) | `"date" \| "week" \| "month" \| "quarter" \| "year" \| "decade"` | 否 | — |
|
|
191
|
+
| from | — | `Dayjs` | 否 | — |
|
|
192
|
+
|
|
193
|
+
### PanelView
|
|
194
|
+
|
|
195
|
+
```typescript
|
|
196
|
+
type PanelView = 'date' | 'month' | 'quarter' | 'year' | 'decade'
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
其他组件的类型不在此展开:`InputVariant` 见 `../input/llm.txt`。
|
|
200
|
+
|
|
201
|
+
### 导出类型
|
|
202
|
+
|
|
203
|
+
另可从 `@apexhub/apex-ui-react` 导入:`DatePickerPreset`、`DatePickerProps`、`DatePresetValue`、`DateValue`、`DisabledDateFn`、`DisabledDateInfo`、`DisabledRangeDateFn`、`PickerType`、`RangePickerPreset`、`RangePickerProps`、`RangePresetValue`、`RangeValue`(与上文子类型配合使用)。
|
|
204
|
+
|
|
205
|
+
## 代码演示
|
|
206
|
+
|
|
207
|
+
### 受控用法
|
|
208
|
+
|
|
209
|
+
通过 `value` 与 变更事件 由外部管理选中日期;变更事件 同时提供 `Dayjs` 与格式化字符串。
|
|
210
|
+
|
|
211
|
+
```tsx
|
|
212
|
+
import { DatePicker, type DateValue } from '@apexhub/apex-ui-react'
|
|
213
|
+
|
|
214
|
+
import { useState } from 'react'
|
|
215
|
+
|
|
216
|
+
export default () => {
|
|
217
|
+
const [value, setValue] = useState<DateValue>(null)
|
|
218
|
+
|
|
219
|
+
return (
|
|
220
|
+
<div style={{ padding: 24, minHeight: 360 }}>
|
|
221
|
+
<DatePicker value={value} onChange={(d) => setValue(d)} />
|
|
222
|
+
</div>
|
|
223
|
+
)
|
|
224
|
+
}
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
### 范围选择
|
|
228
|
+
|
|
229
|
+
使用 `RangePicker` 选择起止日期区间。
|
|
230
|
+
|
|
231
|
+
```tsx
|
|
232
|
+
import { RangePicker } from '@apexhub/apex-ui-react'
|
|
233
|
+
|
|
234
|
+
export default () => (
|
|
235
|
+
<div style={{ padding: 24, minHeight: 360 }}>
|
|
236
|
+
<RangePicker />
|
|
237
|
+
</div>
|
|
238
|
+
)
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
### 选择月份
|
|
242
|
+
|
|
243
|
+
通过 `picker="month"` 切换为 3 列 × 4 行的月份选择面板。默认点击月份后立即提交并关闭;设置 `needConfirm` 后先保留草稿,点击「确定」才提交。「本月」会选择当前月份,并始终停留在月份面板。
|
|
244
|
+
|
|
245
|
+
```tsx
|
|
246
|
+
import { ApexProvider, DatePicker } from '@apexhub/apex-ui-react'
|
|
247
|
+
|
|
248
|
+
import zhCN from '@apexhub/apex-ui-react/locale/zh_CN'
|
|
249
|
+
|
|
250
|
+
export default () => (
|
|
251
|
+
<ApexProvider theme="dark" locale={zhCN}>
|
|
252
|
+
<div style={{ display: 'flex', gap: 16, padding: 24, minHeight: 360 }}>
|
|
253
|
+
<DatePicker picker="month" placeholder="点击月份立即选择" />
|
|
254
|
+
<DatePicker picker="month" needConfirm placeholder="确认后选择月份" />
|
|
255
|
+
</div>
|
|
256
|
+
</ApexProvider>
|
|
257
|
+
)
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
### 禁用
|
|
261
|
+
|
|
262
|
+
`disabled` 禁用整个控件;`disabledDate` 可禁止选中特定日期。
|
|
263
|
+
|
|
264
|
+
```tsx
|
|
265
|
+
import { DatePicker } from '@apexhub/apex-ui-react'
|
|
266
|
+
|
|
267
|
+
export default () => (
|
|
268
|
+
<div style={{ padding: 24 }}>
|
|
269
|
+
<DatePicker disabled />
|
|
270
|
+
</div>
|
|
271
|
+
)
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
### 跨月、跨年查看禁用日期
|
|
275
|
+
|
|
276
|
+
`disabledDate` 按天判断。当月份或年份中仍有至少一天可选时,对应的月/年单元格会保持可进入;只有整个周期都不可选时才禁用,避免月初或年初被禁用后无法继续下钻选择。
|
|
277
|
+
|
|
278
|
+
下面仅开放 2026 年 8 月 10 日至 20 日。打开面板并切换到年份、月份视图,2026 年和 8 月仍可进入。
|
|
279
|
+
|
|
280
|
+
```tsx
|
|
281
|
+
import { DatePicker } from '@apexhub/apex-ui-react'
|
|
282
|
+
|
|
283
|
+
import dayjs from 'dayjs'
|
|
284
|
+
|
|
285
|
+
const selectableStart = dayjs('2026-08-10')
|
|
286
|
+
|
|
287
|
+
const selectableEnd = dayjs('2026-08-20')
|
|
288
|
+
|
|
289
|
+
export default () => (
|
|
290
|
+
<div style={{ padding: 24, minHeight: 360 }}>
|
|
291
|
+
<DatePicker
|
|
292
|
+
defaultValue={dayjs('2026-08-15')}
|
|
293
|
+
disabledDate={(current) =>
|
|
294
|
+
current.isBefore(selectableStart, 'day') || current.isAfter(selectableEnd, 'day')
|
|
295
|
+
}
|
|
296
|
+
/>
|
|
297
|
+
</div>
|
|
298
|
+
)
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
### 只读
|
|
302
|
+
|
|
303
|
+
`readOnly` 为 true 时仅展示选中值,不可打开面板或修改;视觉使用禁用配色,触发器仍可聚焦。示例对照空值与已填值的单日期和日期范围。
|
|
304
|
+
|
|
305
|
+
```tsx
|
|
306
|
+
import { DatePicker, RangePicker } from '@apexhub/apex-ui-react'
|
|
307
|
+
|
|
308
|
+
import dayjs from 'dayjs'
|
|
309
|
+
|
|
310
|
+
export default () => (
|
|
311
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 12, padding: 24 }}>
|
|
312
|
+
<DatePicker readOnly placeholder="只读,不可打开面板" />
|
|
313
|
+
<DatePicker readOnly defaultValue={dayjs('2026-11-19')} />
|
|
314
|
+
<RangePicker readOnly placeholder={['开始日期', '结束日期']} />
|
|
315
|
+
<RangePicker readOnly defaultValue={[dayjs('2026-11-01'), dayjs('2026-11-19')]} />
|
|
316
|
+
</div>
|
|
317
|
+
)
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
### 日期时间
|
|
321
|
+
|
|
322
|
+
`showTime` 仅在 `picker="date"` 时生效。`showTime` 设为 `true` 默认精确到秒(面板三列),须点「确定」后才会触发 变更事件;传 `{ format: 'HH:mm' }` 可改为仅选时/分(两列)。
|
|
323
|
+
|
|
324
|
+
```tsx
|
|
325
|
+
import { DatePicker } from '@apexhub/apex-ui-react'
|
|
326
|
+
|
|
327
|
+
export default () => (
|
|
328
|
+
<div style={{ display: 'flex', gap: 24, flexWrap: 'wrap', alignItems: 'center' }}>
|
|
329
|
+
<DatePicker showTime style={{ width: 240 }} placeholder="精确到秒" />
|
|
330
|
+
<DatePicker showTime={{ format: 'HH:mm' }} style={{ width: 240 }} placeholder="仅时/分" />
|
|
331
|
+
</div>
|
|
332
|
+
)
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
### 范围日期时间
|
|
336
|
+
|
|
337
|
+
`RangePicker` 开启 `showTime` 后分步确认:先选起点日期与时间并确定,再选终点日期与时间并确定,两次确认后才触发 变更事件。
|
|
338
|
+
|
|
339
|
+
```tsx
|
|
340
|
+
import { RangePicker } from '@apexhub/apex-ui-react'
|
|
341
|
+
|
|
342
|
+
export default () => <RangePicker showTime style={{ width: 520 }} />
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
### 快捷日期
|
|
346
|
+
|
|
347
|
+
`DatePicker` 的 `presets` 在面板左侧展示业务快捷日期,例如从今天起的 15 天、30 天、45 天。`value` 支持固定 `Dayjs` 或点击时计算的函数,组件保留业务提供的日期与时间。
|
|
348
|
+
|
|
349
|
+
默认点击立即提交;设置 `needConfirm` 或 `showTime` 后先选中草稿,点击「确定」才触发变更事件。按 Escape 或点击外部取消草稿;清空操作立即清除已提交值。`showToday={false}` 可以隐藏底栏「今天」,呈现设计稿中的快捷区与确认按钮。
|
|
350
|
+
|
|
351
|
+
```tsx
|
|
352
|
+
import { DatePicker, type DatePickerPreset } from '@apexhub/apex-ui-react'
|
|
353
|
+
|
|
354
|
+
import dayjs from 'dayjs'
|
|
355
|
+
|
|
356
|
+
const presets: DatePickerPreset[] = [15, 30, 45].map((days) => ({
|
|
357
|
+
key: `expires-in-${days}-days`,
|
|
358
|
+
label: `${days}天`,
|
|
359
|
+
// 点击时以当天为起点计算;业务也可返回指定的截止时间。
|
|
360
|
+
value: () => dayjs().add(days, 'day').startOf('day'),
|
|
361
|
+
}))
|
|
362
|
+
|
|
363
|
+
export default () => (
|
|
364
|
+
<DatePicker placeholder="过期时间" presets={presets} needConfirm showToday={false} />
|
|
365
|
+
)
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
### 快捷区间
|
|
369
|
+
|
|
370
|
+
通过 `presets` 在面板左侧提供业务快捷区间;`value` 可以是固定的 `[Dayjs, Dayjs]`,也可以是点击时计算区间的函数。
|
|
371
|
+
|
|
372
|
+
```tsx
|
|
373
|
+
import { RangePicker, type RangePickerPreset } from '@apexhub/apex-ui-react'
|
|
374
|
+
|
|
375
|
+
import dayjs from 'dayjs'
|
|
376
|
+
|
|
377
|
+
const presets: RangePickerPreset[] = [
|
|
378
|
+
{
|
|
379
|
+
key: 'this-week',
|
|
380
|
+
label: '本周',
|
|
381
|
+
value: () => [dayjs().startOf('week'), dayjs().endOf('week')],
|
|
382
|
+
},
|
|
383
|
+
{
|
|
384
|
+
key: 'last-7-days',
|
|
385
|
+
label: '最近 7 天',
|
|
386
|
+
value: () => [dayjs().subtract(6, 'day').startOf('day'), dayjs().endOf('day')],
|
|
387
|
+
},
|
|
388
|
+
]
|
|
389
|
+
|
|
390
|
+
export default () => (
|
|
391
|
+
<div style={{ padding: 24, minHeight: 360 }}>
|
|
392
|
+
<RangePicker presets={presets} />
|
|
393
|
+
</div>
|
|
394
|
+
)
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
## DOM 结构
|
|
398
|
+
|
|
399
|
+
源码声明的静态 `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`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
400
|
+
|
|
401
|
+
## 样式定制
|
|
402
|
+
|
|
403
|
+
优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../llms-theme.txt)。
|
|
404
|
+
|
|
405
|
+
需要定制具体样式时再读取 [Token 明细](./date-picker.tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
|
|
406
|
+
|
|
407
|
+
## FAQ
|
|
408
|
+
|
|
409
|
+
### 必须安装 dayjs 吗?
|
|
410
|
+
|
|
411
|
+
使用 DatePicker / RangePicker 时需要安装 `dayjs`(peer dependency);未使用日期组件时可不装。
|
|
412
|
+
|
|
413
|
+
### 占位符文案能随 ApexProvider 切换吗?
|
|
414
|
+
|
|
415
|
+
可以。未传 `placeholder` 时,组件会读取 ApexProvider 下发的 DatePicker locale;自定义 placeholder 则始终显示你传入的字符串。
|
|
416
|
+
|
|
417
|
+
### RangePicker 的 `disabledDate` 第二参 `info.from` 是什么?
|
|
418
|
+
|
|
419
|
+
选择结束日期时,`info.from` 为已选起点,便于实现「结束日期不能早于开始日期」等规则。
|
|
420
|
+
|
|
421
|
+
### 为什么月初被 `disabledDate` 禁用后,月份仍然可以点击?
|
|
422
|
+
|
|
423
|
+
月/年单元格代表一个时间周期,不只代表周期首日。只要周期内仍存在可选日期,单元格就会保持可进入,并从第一个可选日期继续下钻;只有周期内所有日期都不可选时才会禁用。
|
|
424
|
+
|
|
425
|
+
|
|
426
|
+
### `showTime` 为什么选完时间不立刻回填?
|
|
427
|
+
|
|
428
|
+
开启 `showTime` 时,日期与时间均在面板内草稿态,须点击「确定」后才会更新触发器并触发 `onChange`。RangePicker 还需分别确认起点与终点。
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Divider Token 明细
|
|
2
|
+
|
|
3
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
|
|
4
|
+
|
|
5
|
+
按需读取:[组件用法](./divider.txt) · [主题与覆盖规则](../llms-theme.txt)。
|
|
6
|
+
|
|
7
|
+
以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
|
|
8
|
+
|
|
9
|
+
定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
|
|
10
|
+
|
|
11
|
+
| Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
|
|
12
|
+
| --- | --- | --- | --- |
|
|
13
|
+
| `--divider-spacing-gap` | `gap`、`margin-block`、`margin-inline` | `var(--apex-spacing-8)` | `.apex-divider.apex-primary-divider` |
|
|
14
|
+
| `--divider-spacing-gap` | `gap`、`margin-block`、`margin-inline` | `var(--apex-spacing-8)` | `.apex-divider.apex-secondary-divider` |
|
|
15
|
+
| `--divider-spacing-width-lefttext` | `flex`、`max-width`、`min-width` | `var(--apex-size-80)` | `.apex-divider.apex-primary-divider` |
|
|
16
|
+
| `--divider-spacing-width-lefttext` | `flex`、`max-width`、`min-width` | `var(--apex-size-80)` | `.apex-divider.apex-secondary-divider` |
|
|
17
|
+
| `--divider-spacing-width-righttext` | `flex`、`max-width`、`min-width` | `var(--apex-size-80)` | `.apex-divider.apex-primary-divider` |
|
|
18
|
+
| `--divider-spacing-width-righttext` | `flex`、`max-width`、`min-width` | `var(--apex-size-80)` | `.apex-divider.apex-secondary-divider` |
|
|
19
|
+
| `--divider-stroke-default` | `border-left`、`border-top` | `var(--apex-stroke-neutral-quaternary)` | `.apex-divider.apex-elevated-divider` |
|
|
20
|
+
| `--divider-stroke-default` | `border-left`、`border-top` | `var(--apex-stroke-neutral-tertiary)` | `.apex-divider.apex-primary-divider` |
|
|
21
|
+
| `--divider-stroke-stroke` | `border-left`、`border-top` | `var(--apex-border-1)` | `.apex-divider.apex-primary-divider` |
|
|
22
|
+
| `--divider-stroke-stroke` | `border-left`、`border-top` | `var(--apex-border-08)` | `.apex-divider.apex-secondary-divider` |
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# Divider
|
|
2
|
+
|
|
3
|
+
> Divider:需要在区块之间做视觉分隔、区分内容层次时。
|
|
4
|
+
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
|
|
6
|
+
|
|
7
|
+
公开导出:`Divider`。
|
|
8
|
+
|
|
9
|
+
以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
|
|
10
|
+
|
|
11
|
+
## 快速开始
|
|
12
|
+
|
|
13
|
+
```tsx
|
|
14
|
+
import { Divider } from '@apexhub/apex-ui-react'
|
|
15
|
+
|
|
16
|
+
import '@apexhub/apex-ui-react/style.css'
|
|
17
|
+
|
|
18
|
+
export default () => (
|
|
19
|
+
<div style={{ width: 720, maxWidth: '100%', paddingBlock: 24 }}>
|
|
20
|
+
<p style={{ margin: '0 0 16px' }}>上方内容</p>
|
|
21
|
+
<Divider />
|
|
22
|
+
<p style={{ margin: '16px 0 0' }}>下方内容</p>
|
|
23
|
+
</div>
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## 何时使用
|
|
28
|
+
|
|
29
|
+
- 需要在区块之间做视觉分隔、区分内容层次时。
|
|
30
|
+
- 水平方向要在中线插入章节标题时,通过 子内容 实现带文字的分割线。
|
|
31
|
+
- 行内元素之间需要竖向分隔时,使用 `orientation="vertical"`。
|
|
32
|
+
|
|
33
|
+
## API
|
|
34
|
+
|
|
35
|
+
仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
|
|
36
|
+
|
|
37
|
+
### Divider
|
|
38
|
+
|
|
39
|
+
| 属性 | 说明 | 类型 | 必填 | 默认值 |
|
|
40
|
+
| --- | --- | --- | --- | --- |
|
|
41
|
+
| children | Divider title content (horizontal only). | `React.ReactNode` | 否 | — |
|
|
42
|
+
| orientation | Divider layout orientation. | `"horizontal" \| "vertical"` | 否 | `'horizontal'` |
|
|
43
|
+
| titlePlacement | Title placement when `children` exists in horizontal mode. | `"start" \| "center" \| "end"` | 否 | `'center'` |
|
|
44
|
+
| type | Divider stroke weight: primary (thicker) or secondary (thinner). | `"primary" \| "secondary"` | 否 | `'primary'` |
|
|
45
|
+
| className | 根节点类名 | `string` | 否 | — |
|
|
46
|
+
| style | 根节点内联样式(layout 微调可用;禁止硬编码色值,优先 CSS Token) | `React.CSSProperties` | 否 | — |
|
|
47
|
+
| ref | 根元素 ref(React 19 普通 prop) | `React.Ref<HTMLDivElement>` | 否 | — |
|
|
48
|
+
|
|
49
|
+
### DividerOrientation
|
|
50
|
+
|
|
51
|
+
Divider layout orientation.
|
|
52
|
+
|
|
53
|
+
```typescript
|
|
54
|
+
type DividerOrientation = 'horizontal' | 'vertical'
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### DividerType
|
|
58
|
+
|
|
59
|
+
Divider stroke weight (maps to primary/secondary component tokens).
|
|
60
|
+
|
|
61
|
+
```typescript
|
|
62
|
+
type DividerType = 'primary' | 'secondary'
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### DividerTitlePlacement
|
|
66
|
+
|
|
67
|
+
Divider title placement when `children` is set in horizontal mode.
|
|
68
|
+
|
|
69
|
+
```typescript
|
|
70
|
+
type DividerTitlePlacement = 'start' | 'center' | 'end'
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### 导出类型
|
|
74
|
+
|
|
75
|
+
另可从 `@apexhub/apex-ui-react` 导入:`DividerOrientation`、`DividerProps`、`DividerTitlePlacement`、`DividerType`(与上文子类型配合使用)。
|
|
76
|
+
|
|
77
|
+
## 代码演示
|
|
78
|
+
|
|
79
|
+
### 竖向分割线
|
|
80
|
+
|
|
81
|
+
`orientation="vertical"` 为行内纯线,忽略 子内容 与 `titlePlacement`。
|
|
82
|
+
|
|
83
|
+
```tsx
|
|
84
|
+
import { Divider } from '@apexhub/apex-ui-react'
|
|
85
|
+
|
|
86
|
+
export default () => (
|
|
87
|
+
<span>
|
|
88
|
+
文本
|
|
89
|
+
<Divider orientation="vertical" />
|
|
90
|
+
链接
|
|
91
|
+
</span>
|
|
92
|
+
)
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### 带文字的分割线
|
|
96
|
+
|
|
97
|
+
水平模式下可通过 子内容 在中线插入标题。
|
|
98
|
+
|
|
99
|
+
```tsx
|
|
100
|
+
import { Divider } from '@apexhub/apex-ui-react'
|
|
101
|
+
|
|
102
|
+
export default () => (
|
|
103
|
+
<div style={{ width: 720, maxWidth: '100%' }}>
|
|
104
|
+
<Divider>Section Title</Divider>
|
|
105
|
+
</div>
|
|
106
|
+
)
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### 文字位置
|
|
110
|
+
|
|
111
|
+
`titlePlacement` 控制中插文字相对左右 rail 的位置:`start` / `center` / `end`。
|
|
112
|
+
|
|
113
|
+
```tsx
|
|
114
|
+
import { Divider } from '@apexhub/apex-ui-react'
|
|
115
|
+
|
|
116
|
+
export default () => (
|
|
117
|
+
<div style={{ width: 720, maxWidth: '100%', display: 'flex', flexDirection: 'column', gap: 24 }}>
|
|
118
|
+
<Divider titlePlacement="start">Start</Divider>
|
|
119
|
+
<Divider titlePlacement="center">Center</Divider>
|
|
120
|
+
<Divider titlePlacement="end">End</Divider>
|
|
121
|
+
</div>
|
|
122
|
+
)
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
### 粗细类型
|
|
126
|
+
|
|
127
|
+
通过 `type` 在 `primary` 与 `secondary` 两种线宽之间切换。
|
|
128
|
+
|
|
129
|
+
```tsx
|
|
130
|
+
import { Divider } from '@apexhub/apex-ui-react'
|
|
131
|
+
|
|
132
|
+
export default () => (
|
|
133
|
+
<div style={{ width: 720, maxWidth: '100%', display: 'flex', flexDirection: 'column', gap: 24 }}>
|
|
134
|
+
<Divider type="primary" />
|
|
135
|
+
<Divider type="secondary" />
|
|
136
|
+
<Divider type="primary">Primary label</Divider>
|
|
137
|
+
<Divider type="secondary">Secondary label</Divider>
|
|
138
|
+
</div>
|
|
139
|
+
)
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## DOM 结构
|
|
143
|
+
|
|
144
|
+
源码声明的静态 `data-slot`:`divider-rail`、`divider-content`。具体节点随模式和状态出现,不表示固定嵌套顺序。
|
|
145
|
+
|
|
146
|
+
## 样式定制
|
|
147
|
+
|
|
148
|
+
优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../llms-theme.txt)。
|
|
149
|
+
|
|
150
|
+
需要定制具体样式时再读取 [Token 明细](./divider.tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
|
|
151
|
+
|
|
152
|
+
## FAQ
|
|
153
|
+
|
|
154
|
+
### 竖向模式下传了 `children` 为什么没显示?
|
|
155
|
+
|
|
156
|
+
竖向分割线为行内纯线,会忽略 `children` 与 `titlePlacement`。章节标题请放在分割线外的标题元素中,或改用水平模式。
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
### `type` 和 `orientation` 有什么区别?
|
|
160
|
+
|
|
161
|
+
`orientation` 控制水平或竖向布局;`type` 仅控制线宽粗细(`primary` 粗线 / `secondary` 细线),与方向无关。
|