为组件提供统一的全局化配置。
使用
import { configure, getConfig } from 'choerodon-ui';
configure({ prefixCls: 'ant' });
const prefixCls = getConfig('prefixCls');
API
参数 | 说明 | 类型 | 默认值 |
---|
prefixCls | 设置统一样式前缀 | string | c7n |
proPrefixCls | 设置统一样式前缀(pro 组件) | string | c7n-pro |
iconfontPrefix | 图标样式前缀 | string | icon |
icons | 图标列表,用于 IconPicker。 | string[] | { [categoryName: string]: string[] } | import { categories } from 'choerodon-ui-font' |
ripple | 是否开启波纹效果 | boolean | true |
lookupCache | lookup 缓存配置。maxAge - 缓存时长 max - 缓存数量上限 | object | { maxAge: 1000 60 10, max: 100 } |
lookupUrl | lookup 取值的地址或返回地址的钩子 | string | ((code: string) => string) | code => /common/code/\${code}/ |
lookupAxiosConfig | 值列表请求的配置或钩子,详见AxiosRequestConfig。 配置中默认 url 为 lookupUrl, method 为 post。 | AxiosRequestConfig | ({ dataSet: DataSet, record: Record, params?: any, lookupCode: string }) => AxiosRequestConfig | - |
lovDefineUrl | Lov 取配置的地址或返回地址的钩子 | string | ((code: string) => string) | code => /sys/lov/lov_define?code=\${code} |
lovDefineAxiosConfig | 返回 Lov 配置的请求的配置或钩子,详见AxiosRequestConfig。 配置中默认 url 为 lovDefineUrl, method 为 post。 | AxiosRequestConfig | (code: string, lovConfig?: LovConfig, { dataSet, params, data }) => AxiosRequestConfig | - |
lovQueryUrl | Lov 取值的地址或返回地址的钩子 | string | ((code: string) => string) | code => /common/lov/dataset/\${code} |
lovQueryAxiosConfig | Lov 查询数据请求的配置或钩子,详见AxiosRequestConfig。 配置中默认 url 为 lovQueryUrl, method 为 post。 | AxiosRequestConfig | (code: string, lovConfig?: LovConfig, { dataSet, params, data }) => AxiosRequestConfig | - |
lookupBatchAxiosConfig | 返回 lookup 批量查询配置的钩子,详见AxiosRequestConfig。 | (codes: string[]) => AxiosRequestConfig | - |
axios | 替换内置的 axios 实例 | AxiosInstance | |
dataKey | 默认 DataSet 的 dataKey | string | rows |
totalKey | 默认 DataSet 的 totalKey | string | total |
statusKey | 默认 DataSet 提交的数据中标识状态的 key | string | status |
tlsKey | 默认 DataSet 数据中标识多语言的 key | string | tls |
status | 默认 DataSet 提交的数据的状态映射 | { add: string, update: string, delete: string } | { add: 'add', update: 'update', delete: 'delete' } |
labelLayout | 默认 Form 的 labelLayout | string | horizontal |
queryBar | 默认 Table 的 queryBar | string | normal |
tableBorder | 默认 Table 的 border | boolean | true |
tableHighLightRow | 默认 Table 当前行高亮 | boolean | true |
tableRowHeight | 默认 Table 行高 | auto | number | 30 |
tableColumnResizable | 默认 Table 列可调整列宽 | boolean | true |
tableExpandIcon | 默认 Table 自定义展开图标 | ({ prefixCls, expanded, expandable, needIndentSpaced, record, onExpand }) => ReactNode | |
tableButtonProps | 默认 TableButton 的属性 | ButtonProps | { color: 'primary', funcType: 'flat' } |
tableCommandProps | 默认 TableCommand 的属性 | ButtonProps | { color: 'primary', funcType: 'flat' } |
modalSectionBorder | 默认 Modal 的头和脚有边框线 | boolean | true |
modalOkFirst | 默认 Modal 的 ok 按钮排在第一个 | boolean | true |
buttonFuncType | 默认 Button 的功能类型 | string | raised |
buttonColor | 默认 Button 的颜色 | string | default |
renderEmpty | 自定义组件空状态。 | (componentName: string) => ReactNode | - |
defaultValidationMessages | 自定义校验信息, 详见ValidationMessages | ValitionMessages | - |
generatePageQuery | 分页参数转换的钩子 | ({ page?: number, pageSize?: number, sortName?: string, sortOrder?: string }) => object | - |
feedback | DataSet 查询和提交数据的反馈配置, 详见Feedback | Feedback | |
transport | DataSet 默认 transport, 详见Transport | Transport | |
formatter | 日期格式化。其中 jsonDate 是数据请求和响应时的格式,为空时日期会转化为 timestamp。详见Formatter | Formatter | |
属性 | 默认值 | 类型 |
---|
jsonDate | YYYY-MM-DD HH:mm:ss | string |
date | YYYY-MM-DD | string |
dateTime | YYYY-MM-DD HH:mm:ss | string |
time | HH:mm:ss | string |
week | YYYY-Wo | string |
month | YYYY-MM | string |
year | YYYY | string |
ValidationMessages
属性 | 默认值 | 类型 |
---|
badInput | 请输入一个数字。 | ReactNode |
patternMismatch | 请输入有效的值。 | ReactNode |
rangeOverflow | {label}必须小于或等于{max}。 | ReactNode |
rangeUnderflow | {label}必须大于或等于{min}。 | ReactNode |
stepMismatch | 请输入有效值。最接近的有效值为{0}。 | ReactNode |
stepMismatchBetween | 请输入有效值。两个最接近的有效值分别为{0}和{1}。 | ReactNode |
tooLong | 请将该内容减少到{maxLength}个或更少字符(目前您使用了{length}个字符)。 | ReactNode |
tooShort | 请将该内容增加到{minLength}个或更多字符(目前您使用了{length}个字符)。 | ReactNode |
typeMismatch | 请输入与类型匹配的有效值。 | ReactNode |
valueMissing | 请输入{label}。 | ReactNode |
valueMissingNoLabel | 请填写此字段。 | ReactNode |
uniqueError | 该字段值重复,请重新填写。 | ReactNode |
unknown | 未知错误。 | ReactNode |
AxiosRequestConfig
属性 | 说明 | 类型 |
---|
url | 地址 | string |
method | 方法 | string |
baseURL | 基础地址 | string |
headers | 请求头 | object |
params | url 参数 | object |
data | 请求体数据 | object |
timeout | 请求超时时间 | number |
withCredentials | 用于跨域传递 cookie | boolean |
transformRequest | 转变提交的数据 | (data: any, headers: any) => string |
transformResponse | 转变响应的数据 | (data: any, headers: any) => any |
更多配置请参考 Axios 官方文档,或参考 typescript 文件/node_modules/axios/index.d.ts