@agentscope-ai/design 1.0.6 → 1.0.7

package/llms/components/commonComponents/Input/index.zh-CN.llms.txt

@@ -0,0 +1,168 @@
+
+
+<DemoTitle title="Input" desc="通过鼠标或键盘输入内容，为表单提供输入字段的基础容器。。"></DemoTitle>
+
+
+
+
+
+示例
+
+<Install>Input</Install>
+
+
+
+
+
+三种大小
+
+
+
+
+
+大圆角形态
+
+
+
+
+
+带前置图标
+
+
+
+
+
+支持拖拽高度的文本域
+
+
+
+
+
+适应文本高度的文本域
+
+
+
+
+
+带字数提示
+
+#### API
+
+| <div><span class="lang-en">Attribute</span><span class="lang-cn">属性名</span></div> | <div><span class="lang-en">Description</span><span class="lang-cn">描述</span></div> | <div><span class="lang-en">Type</span><span class="lang-cn">类型</span></div> | <div><span class="lang-en">Default</span><span class="lang-cn">默认值</span></div> | 
+|--------|--------|--------|--------|
+| shape | <div><span class="lang-en">Shape</span><span class="lang-cn">形态</span></div> | 'default' | 'round' | default 默认 | 
+
+
+本组件完全兼容 antd 同名组件，详情可访问 [antd input](https://ant.design/components/input-cn) 查看更多 API
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+### Input
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| addonAfter | 带标签的 input，设置后置标签 | ReactNode | - |  | 
+| addonBefore | 带标签的 input，设置前置标签 | ReactNode | - |  | 
+| allowClear | 可以点击清除图标删除内容 | boolean | { clearIcon: ReactNode } | - |  | 
+|  | 是否有边框, 请使用  | boolean | true | 4.5.0 | 
+| classNames | 语义化结构 class | Record< | - | 5.4.0 | 
+| count | 字符计数配置 |  | - | 5.10.0 | 
+| defaultValue | 输入框默认内容 | string | - |  | 
+| disabled | 是否禁用状态，默认为 false | boolean | false |  | 
+| id | 输入框的 id | string | - |  | 
+| maxLength | 最大长度 | number | - |  | 
+| prefix | 带有前缀图标的 input | ReactNode | - |  | 
+| showCount | 是否展示字数 | boolean | { formatter: (info: { value: string, count: number, maxLength?: number }) => ReactNode } | false | 4.18.0 info.value: 4.23.0 | 
+| status | 设置校验状态 | 'error' | 'warning' | - | 4.19.0 | 
+| styles | 语义化结构 style | Record< | - | 5.4.0 | 
+| size | 控件大小。注：标准表单内的输入框大小限制为  | large | - |  | 
+| suffix | 带有后缀图标的 input | ReactNode | - |  | 
+| type | 声明 input 类型，同原生 input 标签的 type 属性，见： | string | text |  | 
+| value | 输入框内容 | string | - |  | 
+| variant | 形态变体 | outlined | outlined | 5.13.0 |  | 
+| onChange | 输入框内容变化时的回调 | function(e) | - |  | 
+| onPressEnter | 按下回车的回调 | function(e) | - |  | 
+| onClear | 按下清除按钮的回调 | () => void | - | 5.20.0 | 
+
+
+如果 `Input` 在 `Form.Item` 内，并且 `Form.Item` 设置了 `id` 属性，则 `value` `defaultValue` 和 `id` 属性会被自动设置。
+
+Input 的其他属性和 React 自带的 [input](https://reactjs.org/docs/dom-elements.html#all-supported-html-attributes) 一致。
+
+#### CountConfig
+
+
+
+
+
+### Input.TextArea
+
+同 Input 属性，外加：
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| autoSize | 自适应内容高度，可设置为 true | false 或对象：{ minRows: 2, maxRows: 6 } | boolean | object | false |  | 
+| classNames | 语义化结构 class | Record< | - | 5.4.0 | 
+| styles | 语义化结构 style | Record< | - | 5.4.0 | 
+
+
+`Input.TextArea` 的其他属性和浏览器自带的 [textarea](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea) 一致。
+
+### Input.Search
+
+| 参数 | 说明 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| enterButton | 是否有确认按钮，可设为按钮文字。该属性会与  | ReactNode | false | 
+| loading | 搜索 loading | boolean | false | 
+| onSearch | 点击搜索图标、清除图标，或按下回车键时的回调 | function(value, event, { source: "input" | "clear" }) | - | 
+
+
+其余属性和 Input 一致。
+
+### Input.Password
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| iconRender | 自定义切换按钮 | (visible) => ReactNode | (visible) => (visible ? <EyeOutlined /> : <EyeInvisibleOutlined />) | 4.3.0 | 
+| visibilityToggle | 是否显示切换按钮或者控制密码显隐 | boolean |  | true |  | 
+
+
+### Input.OTP
+
+`5.16.0` 新增。
+
+开发者注意事项：当 `mask` 属性的类型为 string 时，我们强烈推荐接收单个字符或单个 emoji，如果传入多个字符或多个 emoji，则会在控制台抛出警告。
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultValue | 默认值 | string | - |  | 
+| disabled | 是否禁用 | boolean | false |  | 
+| formatter | 格式化展示，留空字段会被  | (value: string) => string | - |  | 
+| separator | 分隔符，在指定索引的输入框后渲染分隔符 | ReactNode |((i: number) => ReactNode) | - | 5.24.0 | 
+| mask | 自定义展示，和  | boolean | string | false | 5.17.0 | 
+| length | 输入元素数量 | number | 6 |  | 
+| status | 设置校验状态 | 'error' | 'warning' | - |  | 
+| size | 输入框大小 | small | middle |  | 
+| variant | 形态变体 | outlined | outlined | underlined | 
+| value | 输入框内容 | string | - |  | 
+| onChange | 当输入框内容全部填充时触发回调 | (value: string) => void | - |  | 
+| onInput | 输入值变化时触发的回调 | (value: string[]) => void | - | 5.22.0 | 
+
+
+#### VisibilityToggle
+
+| Property | Description | Type | Default | Version | 
+|--------|--------|--------|--------|--------|
+| visible | 用于手动控制密码显隐 | boolean | false | 4.24 | 
+| onVisibleChange | 显隐密码的回调 | (visible) => void | - | 4.24 | 
+
+
+#### Input Methods
+
+| 名称 | 说明 | 参数 | 版本 | 
+|--------|--------|--------|--------|
+| blur | 取消焦点 | - |  | 
+| focus | 获取焦点 | (option?: { preventScroll?: boolean, cursor?: 'start' | 'end' | 'all' }) | option - 4.10.0 | 

package/llms/components/commonComponents/InputNumber/index.zh-CN.llms.txt

@@ -0,0 +1,66 @@
+
+
+<DemoTitle title="InputNumber" desc="通过鼠标或键盘，输入范围内的数值。"></DemoTitle>
+
+
+
+
+
+示例
+
+<Install>InputNumber</Install>
+
+
+
+
+
+三种大小
+
+#### API
+
+本组件完全兼容 antd 同名组件，详情可访问 [antd input-number](https://ant.design/components/input-number-cn) 查看更多 API
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| addonAfter | 带标签的 input，设置后置标签 | ReactNode | - | 4.17.0 | 
+| addonBefore | 带标签的 input，设置前置标签 | ReactNode | - | 4.17.0 | 
+| autoFocus | 自动获取焦点 | boolean | false | - | 
+| changeOnBlur | 是否在失去焦点时，触发  | boolean | true | 5.11.0 | 
+| changeOnWheel | 允许鼠标滚轮改变数值 | boolean | - | 5.14.0 | 
+| controls | 是否显示增减按钮，也可设置自定义箭头图标 | boolean | { upIcon?: React.ReactNode; downIcon?: React.ReactNode; } | - | 4.19.0 | 
+| decimalSeparator | 小数点 | string | - | - | 
+| placeholder | 占位符 | string | - |  | 
+| defaultValue | 初始值 | number | - | - | 
+| disabled | 禁用 | boolean | false | - | 
+| formatter | 指定输入框展示值的格式 | function(value: number | string, info: { userTyping: boolean, input: string }): string | - | info: 4.17.0 | 
+| keyboard | 是否启用键盘快捷行为 | boolean | true | 4.12.0 | 
+| max | 最大值 | number |  | - | 
+| min | 最小值 | number |  | - | 
+| parser | 指定从  | function(string): number | - | - | 
+| precision | 数值精度，配置  | number | - | - | 
+| readOnly | 只读 | boolean | false | - | 
+| status | 设置校验状态 | 'error' | 'warning' | - | 4.19.0 | 
+| prefix | 带有前缀图标的 input | ReactNode | - | 4.17.0 | 
+| suffix | 带有后缀图标的 input | ReactNode | - | 5.20.0 | 
+| size | 输入框大小 | large | - | - | 
+| step | 每次改变步数，可以为小数 | number | string | 1 | - | 
+| stringMode | 字符值模式，开启后支持高精度小数。同时  | boolean | false | 4.13.0 | 
+| value | 当前值 | number | - | - | 
+| variant | 形态变体 | outlined | outlined | 5.13.0 |  | 
+| onChange | 变化回调 | function(value: number | string | null) | - | - | 
+| onPressEnter | 按下回车的回调 | function(e) | - | - | 
+| onStep | 点击上下箭头的回调 | (value: number, info: { offset: number, type: 'up' | 'down' }) => void | - | 4.7.0 | 
+
+
+## Ref
+
+| 名称 | 说明 | 参数 | 版本 | 
+|--------|--------|--------|--------|
+| blur() | 移除焦点 | - |  | 
+| focus() | 获取焦点 | (option?: { preventScroll?: boolean, cursor?: 'start' | 'end' | 'all' }) | cursor - 5.22.0 | 
+| nativeElement | 获取原生 DOM 元素 | - | 5.17.3 | 

package/llms/components/commonComponents/Message/index.zh-CN.llms.txt

@@ -0,0 +1,114 @@
+
+
+<DemoTitle title="Message" desc="一条简洁且临时显示的消息，为操作提供全局反馈"></DemoTitle>
+
+
+
+
+
+示例
+
+<Install>Message</Install>
+
+#### 全局提示示例
+
+以下是全局提示组件的示例和变体
+
+
+
+
+
+不同状态的的全局提示
+
+
+
+
+提供下一步操作
+
+#### API
+
+| <div><span class="lang-en">Attribute</span><span class="lang-cn">属性名</span></div> | <div><span class="lang-en">Description</span><span class="lang-cn">描述</span></div> | <div><span class="lang-en">Type</span><span class="lang-cn">类型</span></div> | <div><span class="lang-en">Default</span><span class="lang-cn">默认值</span></div> | 
+|--------|--------|--------|--------|
+| conent | <div><span class="lang-en">content to be displayed</span><span class="lang-cn">显示的内容</span></div> | string | "" | 
+
+本组件完全兼容 antd 同名组件，详情可访问 [antd message](https://ant.design/components/message-cn) 查看更多 API
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+组件提供了一些静态方法，使用方式和参数如下：
+
+
+- `message.success(content, [duration], onClose)`
+- `message.error(content, [duration], onClose)`
+- `message.info(content, [duration], onClose)`
+- `message.warning(content, [duration], onClose)`
+- `message.loading(content, [duration], onClose)`
+
+| 参数 | 说明 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| content | 提示内容 | ReactNode | config | - | 
+| duration | 自动关闭的延时，单位秒。设为 0 时不自动关闭 | number | 3 | 
+| onClose | 关闭时触发的回调函数 | function | - | 
+
+
+组件同时提供 promise 接口。
+
+
+- `message[level](content, [duration]).then(afterClose)`
+- `message[level](content, [duration], onClose).then(afterClose)`
+
+其中 `message[level]` 是组件已经提供的静态方法。`then` 接口返回值是 Promise。
+
+也可以对象的形式传递参数：
+
+
+- `message.open(config)`
+- `message.success(config)`
+- `message.error(config)`
+- `message.info(config)`
+- `message.warning(config)`
+- `message.loading(config)`
+
+`config` 对象属性如下：
+
+| 参数 | 说明 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| className | 自定义 CSS class | string | - | 
+| content | 提示内容 | ReactNode | - | 
+| duration | 自动关闭的延时，单位秒。设为 0 时不自动关闭 | number | 3 | 
+| icon | 自定义图标 | ReactNode | - | 
+| key | 当前提示的唯一标志 | string | number | - | 
+| style | 自定义内联样式 |  | - | 
+| onClick | 点击 message 时触发的回调函数 | function | - | 
+| onClose | 关闭时触发的回调函数 | function | - | 
+
+
+### 全局方法
+
+还提供了全局配置和全局销毁方法：
+
+
+- `message.config(options)`
+- `message.destroy()`
+
+也可通过 `message.destroy(key)` 来关闭一条消息。
+
+#### message.config
+
+当你使用 `ConfigProvider` 进行全局化配置时，系统会默认自动开启 RTL 模式。(4.3.0+)当你想单独使用，可通过如下设置开启 RTL 模式。
+
+
+
+
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| duration | 默认自动关闭延时，单位秒 | number | 3 |  | 
+| getContainer | 配置渲染节点的输出位置，但依旧为全屏展示 | () => HTMLElement | () => document.body |  | 
+| maxCount | 最大显示数，超过限制时，最早的消息会被自动关闭 | number | - |  | 
+| prefixCls | 消息节点的 className 前缀 | string | ant-message | 4.5.0 | 
+| rtl | 是否开启 RTL 模式 | boolean | false |  | 
+| top | 消息距离顶部的位置 | string | number | 8 |  | 

package/llms/components/commonComponents/Modal/index.zh-CN.llms.txt

@@ -0,0 +1,154 @@
+
+
+<DemoTitle title="Modal" desc="用于叠加当前页面上的对话框窗口，提供标题、内容区、操作区。"></DemoTitle>
+
+
+
+
+
+示例
+
+<Install>Modal</Install>
+
+
+
+
+
+自定义样式
+
+
+
+
+预设宽度
+
+#### API
+
+| <div><span class="lang-en">Attribute</span><span class="lang-cn">属性名</span></div> | <div><span class="lang-en">Description</span><span class="lang-cn">描述</span></div> | <div><span class="lang-en">Type</span><span class="lang-cn">类型</span></div> | <div><span class="lang-en">Default</span><span class="lang-cn">默认值</span></div> | 
+|--------|--------|--------|--------|
+| info | <div><span class="lang-en"></span><span class="lang-cn"></span></div> | string | React.ReactNode |  | 
+| showDivider | <div><span class="lang-en"></span><span class="lang-cn"></span></div> | boolean |  | 
+
+本组件完全兼容 antd 同名组件，详情可访问 [antd modal](https://ant.design/components/modal-cn) 查看更多 API
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| afterClose | Modal 完全关闭后的回调 | function | - |  | 
+| classNames | 配置弹窗内置模块的 className |  | - |  | 
+| styles | 配置弹窗内置模块的 style |  | - | 5.10.0 | 
+| cancelButtonProps | cancel 按钮 props |  | - |  | 
+| cancelText | 取消按钮文字 | ReactNode | 取消 |  | 
+| centered | 垂直居中展示 Modal | boolean | false |  | 
+| closable | 是否显示右上角的关闭按钮 | boolean | { closeIcon?: React.ReactNode; disabled?: boolean; } | true |  | 
+| closeIcon | 自定义关闭图标。5.7.0：设置为  | ReactNode | <CloseOutlined /> |  | 
+| confirmLoading | 确定按钮 loading | boolean | false |  | 
+|  | 关闭时销毁 Modal 里的子元素 | boolean | false |  | 
+| destroyOnHidden | 关闭时销毁 Modal 里的子元素 | boolean | false | 5.25.0 | 
+| focusTriggerAfterClose | 对话框关闭后是否需要聚焦触发元素 | boolean | true | 4.9.0 | 
+| footer | 底部内容，当不需要默认底部按钮时，可以设为  | ReactNode | (originNode: ReactNode, extra: { OkBtn: React.FC, CancelBtn: React.FC }) => ReactNode | (确定取消按钮) | renderFunction: 5.9.0 | 
+| forceRender | 强制渲染 Modal | boolean | false |  | 
+| getContainer | 指定 Modal 挂载的节点，但依旧为全屏展示， | HTMLElement | () => HTMLElement | Selectors | false | document.body |  | 
+| keyboard | 是否支持键盘 esc 关闭 | boolean | true |  | 
+| mask | 是否展示遮罩 | boolean | true |  | 
+| maskClosable | 点击蒙层是否允许关闭 | boolean | true |  | 
+| modalRender | 自定义渲染对话框 | (node: ReactNode) => ReactNode | - | 4.7.0 | 
+| okButtonProps | ok 按钮 props |  | - |  | 
+| okText | 确认按钮文字 | ReactNode | 确定 |  | 
+| okType | 确认按钮类型 | string | primary |  | 
+| style | 可用于设置浮层的样式，调整浮层位置等 | CSSProperties | - |  | 
+| loading | 显示骨架屏 | boolean |  | 5.18.0 | 
+| title | 标题 | ReactNode | - |  | 
+| open | 对话框是否可见 | boolean | - |  | 
+| width | 宽度 | string | number |  | 520 | Breakpoint: 5.23.0 | 
+| wrapClassName | 对话框外层容器的类名 | string | - |  | 
+| zIndex | 设置 Modal 的  | number | 1000 |  | 
+| onCancel | 点击遮罩层或右上角叉或取消按钮的回调 | function(e) | - |  | 
+| onOk | 点击确定回调 | function(e) | - |  | 
+| afterOpenChange | 打开和关闭 Modal 时动画结束后的回调 | (open: boolean) => void | - | 5.4.0 | 
+
+
+#### 注意
+
+
+- `<Modal />` 默认关闭后状态不会自动清空，如果希望每次打开都是新内容，请设置 `destroyOnHidden`。
+- `<Modal />` 和 Form 一起配合使用时，设置 `destroyOnHidden` 也不会在 Modal 关闭时销毁表单字段数据，需要设置 `<Form preserve={false} />`。
+- `Modal.method()` RTL 模式仅支持 hooks 用法。
+
+### Modal.method()
+
+包括：
+
+
+- `Modal.info`
+- `Modal.success`
+- `Modal.error`
+- `Modal.warning`
+- `Modal.confirm`
+
+以上均为一个函数，参数为 object，具体属性如下：
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| afterClose | Modal 完全关闭后的回调 | function | - | 4.9.0 | 
+| autoFocusButton | 指定自动获得焦点的按钮 | null |  | ok |  | 
+| cancelButtonProps | cancel 按钮 props |  | - |  | 
+| cancelText | 设置 Modal.confirm 取消按钮文字 | string | 取消 |  | 
+| centered | 垂直居中展示 Modal | boolean | false |  | 
+| className | 容器类名 | string | - |  | 
+| closable | 是否显示右上角的关闭按钮 | boolean | false | 4.9.0 | 
+| closeIcon | 自定义关闭图标 | ReactNode | undefined | 4.9.0 | 
+| content | 内容 | ReactNode | - |  | 
+| footer | 底部内容，当不需要默认底部按钮时，可以设为  | ReactNode | (originNode: ReactNode, extra: { OkBtn: React.FC, CancelBtn: React.FC }) => ReactNode | - | renderFunction: 5.9.0 | 
+| getContainer | 指定 Modal 挂载的 HTML 节点，false 为挂载在当前 dom | HTMLElement | () => HTMLElement | Selectors | false | document.body |  | 
+| icon | 自定义图标 | ReactNode | <ExclamationCircleFilled /> |  | 
+| keyboard | 是否支持键盘 esc 关闭 | boolean | true |  | 
+| mask | 是否展示遮罩 | boolean | true |  | 
+| maskClosable | 点击蒙层是否允许关闭 | boolean | false |  | 
+| okButtonProps | ok 按钮 props |  | - |  | 
+| okText | 确认按钮文字 | string | 确定 |  | 
+| okType | 确认按钮类型 | string | primary |  | 
+| style | 可用于设置浮层的样式，调整浮层位置等 | CSSProperties | - |  | 
+| title | 标题 | ReactNode | - |  | 
+| width | 宽度 | string | number | 416 |  | 
+| wrapClassName | 对话框外层容器的类名 | string | - | 4.18.0 | 
+| zIndex | 设置 Modal 的  | number | 1000 |  | 
+| onCancel | 点击取消回调，参数为关闭函数，若返回 promise 时 resolve 为正常关闭, reject 为不关闭 | function(close) | - |  | 
+| onOk | 点击确定回调，参数为关闭函数，若返回 promise 时 resolve 为正常关闭, reject 为不关闭 | function(close) | - |  | 
+
+
+以上函数调用后，会返回一个引用，可以通过该引用更新和关闭弹窗。
+
+
+
+
+
+
+- `Modal.destroyAll`
+
+使用 `Modal.destroyAll()` 可以销毁弹出的确认窗（即上述的 `Modal.info`、`Modal.success`、`Modal.error`、`Modal.warning`、`Modal.confirm`）。通常用于路由监听当中，处理路由前进、后退不能销毁确认对话框的问题，而不用各处去使用实例的返回值进行关闭（`modal.destroy()` 适用于主动关闭，而不是路由这样被动关闭）
+
+
+
+
+
+### Modal.useModal()
+
+当你需要使用 Context 时，可以通过 `Modal.useModal` 创建一个 `contextHolder` 插入子节点中。通过 hooks 创建的临时 Modal 将会得到 `contextHolder` 所在位置的所有上下文。创建的 `modal` 对象拥有与 [`Modal.method`](#modalmethod) 相同的创建通知方法。
+
+
+
+
+
+`modal.confirm` 返回方法：
+
+
+- `destroy`：销毁当前窗口
+- `update`：更新当前窗口
+- `then`：Promise 链式调用，支持 `await` 操作。该方法为 Hooks 仅有
+
+
+

package/llms/components/commonComponents/Notification/index.zh-CN.llms.txt

@@ -0,0 +1,118 @@
+
+
+<DemoTitle title="Notification" desc="用于指示任务的完成进度"></DemoTitle>
+
+
+
+
+
+示例
+
+<Install>Notification</Install>
+
+#### 带图标的通知提醒框
+
+使用 useNotification hooks 调用，支持不同类型的通知
+
+
+
+
+
+提供下一步操作
+
+
+
+
+不同状态的通知提醒框
+
+
+
+
+不同弹出位置
+
+#### API
+
+ApiParser解析结果为空
+本组件完全兼容 antd 同名组件，详情可访问 [antd notification](https://ant.design/components/notification-cn) 查看更多 API
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+
+- `notification.success(config)`
+- `notification.error(config)`
+- `notification.info(config)`
+- `notification.warning(config)`
+- `notification.open(config)`
+- `notification.destroy(key?: String)`
+
+config 参数如下：
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| actions | 自定义按钮组 | ReactNode | - | 5.24.0 | 
+|  | 自定义按钮组，请使用  | ReactNode | - | - | 
+| className | 自定义 CSS class | string | - | - | 
+| closeIcon | 自定义关闭图标 | ReactNode | true | 5.7.0：设置为 null 或 false 时隐藏关闭按钮 | 
+| description | 通知提醒内容，必选 | ReactNode | - | - | 
+| duration | 默认 4.5 秒后自动关闭，配置为 null 则不自动关闭 | number | 4.5 | - | 
+| showProgress | 显示自动关闭通知框的进度条 | boolean |  | 5.18.0 | 
+| pauseOnHover | 悬停时是否暂停计时器 | boolean | true | 5.18.0 | 
+| icon | 自定义图标 | ReactNode | - | - | 
+| key | 当前通知唯一标志 | string | - | - | 
+| message | 通知提醒标题，必选 | ReactNode | - | - | 
+| placement | 弹出位置，可选  | string | topRight | - | 
+| style | 自定义内联样式 |  | - | - | 
+| role | 供屏幕阅读器识别的通知内容语义，默认为  | alert | status | alert | 5.6.0 | 
+| onClick | 点击通知时触发的回调函数 | function | - | - | 
+| onClose | 当通知关闭时触发 | function | - | - | 
+| props | 透传至通知  | Object | - | - | 
+
+
+
+- `notification.useNotification(config)`
+
+config 参数如下：
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| bottom | 消息从底部弹出时，距离底部的位置，单位像素 | number | 24 |  | 
+| closeIcon | 自定义关闭图标 | ReactNode | true | 5.7.0：设置为 null 或 false 时隐藏关闭按钮 | 
+| getContainer | 配置渲染节点的输出位置 | () => HTMLNode | () => document.body |  | 
+| placement | 弹出位置，可选  | string | topRight |  | 
+| showProgress | 显示自动关闭通知框的进度条 | boolean |  | 5.18.0 | 
+| pauseOnHover | 悬停时是否暂停计时器 | boolean | true | 5.18.0 | 
+| rtl | 是否开启 RTL 模式 | boolean | false |  | 
+| stack | 堆叠模式，超过阈值时会将所有消息收起 | boolean |  | { threshold: 3 } | 5.10.0 | 
+| top | 消息从顶部弹出时，距离顶部的位置，单位像素 | number | 24 |  | 
+| maxCount | 最大显示数，超过限制时，最早的消息会被自动关闭 | number | - | 4.17.0 | 
+
+
+### 全局配置
+
+还提供了一个全局配置方法，在调用前提前配置，全局一次生效。
+
+`notification.config(options)`
+
+当你使用 `ConfigProvider` 进行全局化配置时，系统会默认自动开启 RTL 模式。(4.3.0+)当你想单独使用，可通过如下设置开启 RTL 模式。
+
+
+
+
+
+#### notification.config
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| bottom | 消息从底部弹出时，距离底部的位置，单位像素 | number | 24 |  | 
+| closeIcon | 自定义关闭图标 | ReactNode | true | 5.7.0：设置为 null 或 false 时隐藏关闭按钮 | 
+| duration | 默认自动关闭延时，单位秒 | number | 4.5 |  | 
+| showProgress | 显示自动关闭通知框的进度条 | boolean |  | 5.18.0 | 
+| pauseOnHover | 悬停时是否暂停计时器 | boolean | true | 5.18.0 | 
+| getContainer | 配置渲染节点的输出位置，但依旧为全屏展示 | () => HTMLNode | () => document.body |  | 
+| placement | 弹出位置，可选  | string | topRight |  | 
+| rtl | 是否开启 RTL 模式 | boolean | false |  | 
+| top | 消息从顶部弹出时，距离顶部的位置，单位像素 | number | 24 |  | 
+| maxCount | 最大显示数，超过限制时，最早的消息会被自动关闭 | number | - | 4.17.0 | 

package/llms/components/commonComponents/Pagination/index.zh-CN.llms.txt

@@ -0,0 +1,62 @@
+
+
+<DemoTitle title="Pagination" desc="分页器用于分隔长列表，每次只加载一个页面。"></DemoTitle>
+
+
+
+
+
+示例
+
+<Install>Pagination</Install>
+
+#### 翻页器示例
+
+以下是此组件的示例和变体
+
+
+
+
+
+更详细的展示
+
+#### API
+
+| <div><span class="lang-en">Attribute</span><span class="lang-cn">属性名</span></div> | <div><span class="lang-en">Description</span><span class="lang-cn">描述</span></div> | <div><span class="lang-en">Type</span><span class="lang-cn">类型</span></div> | <div><span class="lang-en">Default</span><span class="lang-cn">默认值</span></div> | 
+|--------|--------|--------|--------|
+| hideSwitchButton | <div><span class="lang-en">Whether to show previous/next page switch button</span><span class="lang-cn">是否展示上一页/下一页的切换按钮</span></div> | boolean | 'false' | 
+
+
+本组件完全兼容 antd 同名组件，详情可访问[antd pagination](https://ant.design/components/pagination-cn/)查看更多 API。
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+
+
+
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| align | 对齐方式 | start | center | end | - | 5.19.0 | 
+| current | 当前页数 | number | - |  | 
+| defaultCurrent | 默认的当前页数 | number | 1 |  | 
+| defaultPageSize | 默认的每页条数 | number | 10 |  | 
+| disabled | 禁用分页 | boolean | - |  | 
+| hideOnSinglePage | 只有一页时是否隐藏分页器 | boolean | false |  | 
+| itemRender | 用于自定义页码的结构，可用于优化 SEO | (page, type: 'page' | 'prev' | 'next', originalElement) => React.ReactNode | - |  | 
+| pageSize | 每页条数 | number | - |  | 
+| pageSizeOptions | 指定每页可以显示多少条 | number[] | [ |  | 
+| responsive | 当 size 未指定时，根据屏幕宽度自动调整尺寸 | boolean | - |  | 
+| showLessItems | 是否显示较少页面内容 | boolean | false |  | 
+| showQuickJumper | 是否可以快速跳转至某页 | boolean | { goButton: ReactNode } | false |  | 
+| showSizeChanger | 是否展示  | boolean |  | - | SelectProps: 5.21.0 | 
+| showTitle | 是否显示原生 tooltip 页码提示 | boolean | true |  | 
+| showTotal | 用于显示数据总量和当前数据顺序 | function(total, range) | - |  | 
+| simple | 当添加该属性时，显示为简单分页 | boolean | { readOnly?: boolean } | - |  | 
+| size | 当为  | default | default |  | 
+| total | 数据总数 | number | 0 |  | 
+| onChange | 页码或  | function(page, pageSize) | - |  | 
+| onShowSizeChange | pageSize 变化的回调 | function(current, size) | - |  |