自定义默认配置

组件库支持自定义组件 props 的默认值。

预先配置默认值可以减少重复的 prop 书写，让模板更简洁、风格更统一。

基础用法

可通过组件提供的静态方法 setPropsDefaults 自定义默认 props。

TIP

默认配置仅对声明式组件生效，且必须在组件初始化之前完成设置。

配置是全局的：设置后，对所有注册了该组件的 Vue 应用生效。

组件首次渲染后，默认值即不可再修改。

main.ts

import { UButton } from 'uniboot-ui'

UButton.setPropsDefaults({
  type: 'primary',
  size: 'small',
})

应用上述配置后，下面两种写法等价：

App.vue

vue

<template>
  <u-button>Hello</u-button>
  <u-button type="primary" size="small">Hello</u-button>
</template>

WARNING

不建议为「被其他组件内部使用」的组件设置默认值。

例如：

// 会改变 el-autocomplete 等依赖组件的行为
UInput.setPropsDefaults({ maxlength: 1 })