主题
全局参数
提示
所有全局配置的参数优先级都低于组件自身的配置,组件可以通过配置自有参数覆盖全局配置。
组件尺寸
组件的默认尺寸为 base
,可以通过 size
选项全局修改组件的尺寸。
typescript
import kswUx from '@ksware/ksw-ux';
import '@ksware/ksw-ux/kingsware-ui/style.css'
app.use(kswUx, {
size: 'sm'
});
修改组件props默认值
通过 props
参数可以修改所有组件的 props 默认值。
typescript
import kswUx from '@ksware/ksw-ux';
app.use(kswUx, {
props: {
KTreeTable: { // 修改KTreeTable组件的props默认值
showPage: false,
showFilter: false
},
KInput: { // 修改KInput组件的props默认值
clearable: true,
placeholder: '请输入符合要求的内容'
}
}
});
修改组件内置图标
通过 props.icon
可以修改部分内置图标,该功能处于完善阶段,暂时只支持部分组件的图标修改,后续会逐步支持修改更多组件内置图标。
typescript
import kswUx from '@ksware/ksw-ux';
app.use(kswUx, {
props: {
icon: {
folderOpen: 'IconAdd', // 表格文件夹展开图标
folderClose: 'IconMinus', // 表格文件夹收起图标
tableRefresh: 'IconRefresh' // 表格刷新按钮图标
}
}
});
可修改的图标
配置 | 描述 |
---|---|
folderOpen | 表格文件夹展开图标 |
folderClose | 表格文件夹收起图标 |
tableRefresh | 表格刷新按钮图标 |
tableSearch | 表格搜索框图标 |
tableFilter | 表格高级筛选图标 |
tableFiltered | 表格高级筛选时图标 |
tableTransfer | 表格列头控制器图标 |
tableSizeControl | 表格尺寸控制器图标 |
更多配置
配置项 | 描述 | 类型 | 默认值 |
---|---|---|---|
locale | 语言 | enum | 'zh' |
styleModule | 项目主题样式 | enum | 'AOM' |
size | 组件尺寸 | enum | 'base' |
cssVariables | css变量,会覆盖默认同名变量 | object | - |
props | 组件 props 默认值 | object | - |
useDefaultFont | 是否使用默认字体 | boolean | true |
registerIcon | 是否自动注册图标 | boolean | true |