Skip to content

全局参数

提示

所有全局配置的参数优先级都低于组件自身的配置,组件可以通过配置自有参数覆盖全局配置。

组件尺寸

组件的默认尺寸为 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'
cssVariablescss变量,会覆盖默认同名变量object-
props组件 props 默认值object-
useDefaultFont是否使用默认字体booleantrue
registerIcon是否自动注册图标booleantrue