Configure全局化配置

为组件提供统一的全局化配置。

使用

  1. import { configure, getConfig } from 'choerodon-ui';
  2. configure({ prefixCls: 'ant' });
  3. const prefixCls = getConfig('prefixCls');

API

参数说明类型默认值
prefixCls设置统一样式前缀stringc7n
proPrefixCls设置统一样式前缀(pro 组件)stringc7n-pro
iconfontPrefix图标样式前缀stringicon
icons图标列表,用于 IconPicker。string[] | { [categoryName: string]: string[] }import { categories } from 'choerodon-ui-font'
ripple是否开启波纹效果booleantrue
lookupCachelookup 缓存配置。maxAge - 缓存时长 max - 缓存数量上限object{ maxAge: 1000 60 10, max: 100 }
lookupUrllookup 取值的地址或返回地址的钩子string | ((code: string) => string)code => /common/code/\${code}/
lookupAxiosConfig值列表请求的配置或钩子,详见AxiosRequestConfig。 配置中默认 url 为 lookupUrl, method 为 post。AxiosRequestConfig | ({ dataSet: DataSet, record: Record, params?: any, lookupCode: string }) => AxiosRequestConfig-
lovDefineUrlLov 取配置的地址或返回地址的钩子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-
lovQueryUrlLov 取值的地址或返回地址的钩子string | ((code: string) => string)code => /common/lov/dataset/\${code}
lovQueryAxiosConfigLov 查询数据请求的配置或钩子,详见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 的 dataKeystringrows
totalKey默认 DataSet 的 totalKeystringtotal
statusKey默认 DataSet 提交的数据中标识状态的 keystringstatus
tlsKey默认 DataSet 数据中标识多语言的 keystringtls
status默认 DataSet 提交的数据的状态映射{ add: string, update: string, delete: string }{ add: 'add', update: 'update', delete: 'delete' }
labelLayout默认 Form 的 labelLayoutstringhorizontal
queryBar默认 Table 的 queryBarstringnormal
tableBorder默认 Table 的 borderbooleantrue
tableHighLightRow默认 Table 当前行高亮booleantrue
tableRowHeight默认 Table 行高auto | number30
tableColumnResizable默认 Table 列可调整列宽booleantrue
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 的头和脚有边框线booleantrue
modalOkFirst默认 Modal 的 ok 按钮排在第一个booleantrue
buttonFuncType默认 Button 的功能类型stringraised
buttonColor默认 Button 的颜色stringdefault
renderEmpty自定义组件空状态。(componentName: string) => ReactNode-
defaultValidationMessages自定义校验信息, 详见ValidationMessagesValitionMessages-
generatePageQuery分页参数转换的钩子({ page?: number, pageSize?: number, sortName?: string, sortOrder?: string }) => object-
feedbackDataSet 查询和提交数据的反馈配置, 详见FeedbackFeedback
transportDataSet 默认 transport, 详见TransportTransport
formatter日期格式化。其中 jsonDate 是数据请求和响应时的格式,为空时日期会转化为 timestamp。详见FormatterFormatter

Formatter

属性默认值类型
jsonDateYYYY-MM-DD HH:mm:ssstring
dateYYYY-MM-DDstring
dateTimeYYYY-MM-DD HH:mm:ssstring
timeHH:mm:ssstring
weekYYYY-Wostring
monthYYYY-MMstring
yearYYYYstring

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
paramsurl 参数object
data请求体数据object
timeout请求超时时间number
withCredentials用于跨域传递 cookieboolean
transformRequest转变提交的数据(data: any, headers: any) => string
transformResponse转变响应的数据(data: any, headers: any) => any

更多配置请参考 Axios 官方文档,或参考 typescript 文件/node_modules/axios/index.d.ts