全局配置
VEUI 中很多组件都定义了全局配置项,允许开发者在使用时全局配置某个组件的行为细节。
例如,Uploader
组件可以统一配置上传模式,用户可以根据项目前后端接口、需要支持浏览器版本的具体情况选择使用 iframe 回调方式还是 XHR2 方式传递数据,也可以统一配置远端数据格式的转换函数。
VEUI 全局配置项可以通过 veui/managers/config
模块进行覆盖:
import config from 'veui/managers/config'
config.set('uploader.requestMode', 'iframe')
config.set('uploader.convertResponse', ({ code, error, result }) => {
/**
* Transform from
*
* {
* code: 0,
* error: '...',
* result: {
* url: '...'
* }
* }
*
* to
*
* {
* success: true,
* message: '...',
* src: '...'
* }
*/
return {
success: code === 0,
src: error ? null : result.url,
message: error || null
}
})
如果需要一次修改同一个组件的多项设置,可以使用如下写法:
import config from 'veui/managers/config'
config.set({
requestMode: 'iframe',
convertResponse: data => data
}, 'uploader')
config.set()
方法参数可为如下形式:
(key: string, value: *, namespace: string)
(values: Object<{key: string, value: *}>, namespace: string)
当提供了 namespace
参数时,最终生成的配置项键名为 `${namespace}.${key}`
。
除此以外,还提供了相同参数列表的 config.defaults()
方法,区别在于当需要在配置项中写入的键值已经存在,则不会覆盖。
每个组件、指令等支持的全局配置请查看对应组件、指令的详情页。