React 组件
UGConfigProvider 全局配置
统一组件子树的默认尺寸、禁用状态与命名空间,并支持嵌套局部覆盖。
导入方式
按需从包入口导入组件,并在应用入口引入一次样式文件。
tsx
import { UGConfigProvider } from '@ug666/ui-react'全局默认值
在应用根节点统一尺寸和禁用状态,后代控件自动继承。
局部覆盖
最近 Provider 覆盖父级,组件显式属性拥有最高优先级。
命名空间
namespace 作为稳定元数据写入 Provider 与已接入命名空间的组件,用于识别不同配置作用域。
组件默认配置
可统一设置 Button 与 Link 的默认外观;组件显式属性仍拥有最高优先级。
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| size | 'small' | 'medium' | 'large' | 继承 / medium | 设置后代控件的默认尺寸。 |
| disabled | boolean | 继承 / false | 设置后代交互控件的默认禁用状态。 |
| namespace | string | 继承 / ug | 设置配置作用域的稳定命名空间元数据。 |
| button | Partial<ButtonDefaults> | 继承 / {} | 设置 Button 的默认 variant、tone 与 shape。 |
| link | Partial<LinkDefaults> | 继承 / {} | 设置 Link 的默认 tone 与 underline。 |
| children | ReactNode | — | 接收配置的组件子树。 |
| 原生属性 | HTMLAttributes<HTMLDivElement> | — | 透传 aria-*、data-*、className、style 等容器属性。 |