Ant Design Vue使用记录,持续记录

好些问题,每次解决了,下次遇到了又要重新翻文档,干脆就自己记录一下。

Ant Design Vue 1.x

1.Form组件(2.x之后用法不同)

  • Form.create(options) | this.$form.createForm(this, options) ,通过JFX方式去定义一个Form组件的各种属性。经 Form.create() 包装过的组件会自带 this.form 属性,如果使用 template 语法,可以使用 this.$form.createForm(this, options);
  • Form对象-----Form.Item对象 ------ decorator相关对象(参数为输入组件绑定的属性,相关数据选项),相关选项解释:https://antdv.com/components/form-cn/#API
  • 通过Form.create()创建的Form对象,绑定在a-form组件上,然后就可以把整个表单当做一整个对象去处理,每个输入型组件都可以通过v-decorator自定义自己的行为(表单验证等)。
  • 经过 getFieldDecoratorv-decorator 包装的控件,表单控件会自动添加 value(或 valuePropName 指定的其他属性) onChange(或 trigger 指定的其他属性),数据同步将被 Form 接管。
  • 使用 Form.create 处理后的表单具有自动收集数据并校验的功能,但如果您不需要这个功能,或者默认的行为无法满足业务需求,可以选择不使用 Form.create 并自行处理数据。
  • setFieldsValue设置表单默认值,必须在Form渲染之后进行,必须和参数对应,参数数量只能少或者相对相等,不能多。

2.使用过的组件

3.表格(a-table)

提示
官方文档:https://antdv.com/components/table-cn/#API

API详解:

  1. columns,指定一个对象用于配置表格列。
  2. dataSource,用于指定表格的数据源。
  3. loading,是否显示加载特效。
  4. rowKey,用于指定每个表格列的key值,可指定一个字符串或者一个参数为每行的数据对象的函数。
  5. pagination,绑定的分页组件,https://antdv.com/components/pagination-cn/

表格列描述对象(Column):

  1. dataIndex,对应数据对象中哪一个数据?(指定属性名),可以不指定该属性,使用插槽时slot-scope传递的是整个数据行对象。
    {
        title: 'Action',
        key: 'action',
        scopedSlots: { customRender: 'action' },
    }
    
  2. key,绑定一个vue需要的key值。(数据对象内的属性名)
  3. customRender,绑定一个处理数据的自定义函数。
  4. title,显示的列标题文字。
  5. slots,使用 columns 时,可以通过该属性配置支持 slot 的属性,如 slots: { filterIcon: 'XXX'},代表这个在表格内可以使用插槽名为XXX的插槽来代替filterIcon属性(column支持的一个属性)的值。
  6. scopedSlots: { customRender: 'tags' }, 指定一个名为tags的插槽,用来展示当前列的值,slot-scope值为指定列的值和行值。和customRender只能生效一个。
  7. customRender,自定义该列的数据渲染,列的值为函数的返回值。和scopedSlots只能生效一个。
    scopedSlots: { customRender: 'name' },
    customRender:(text, record, index)=>{
          return text;
    }
    
    //表格内插槽
    <template slot="extra">
    </template>

在 Table 中,dataSource 和 columns 里的数据值都需要指定 key 值。对于 dataSource 默认将每列数据的 key 属性作为唯一的标识。

注意
如果你的数据没有这个属性,务必使用 rowKey 来指定数据列的主键。若没有指定,控制台会出现缺少 key 的提示,表格组件也会出现各类奇怪的错误。

3.select选择框

value传过去了但是显示的是value 而不是显示对应的选项,是因为传过去的值是number类型,而值是string类型,设置的value值跟选项的value值不相等,所以就找不到对应的选项值,转化为string类型就可以解决了。

4.upload

官方链接:https://1x.antdv.com/components/upload-cn/#components-upload-demo-default-files

受控的上传文件列表。可以自定义fileList的元素,upload的上传列表将对应的显示。使用 defaultFileList 设置已上传的内容。支持列表图片、照片墙、插槽等自定义上传的UI样式。

 fileList: [
        {
          uid: '-1',
          name: 'xxx.png',
          status: 'done',
          url: 'http://www.baidu.com/xxx.png',
        },
 ],

Ant Design Vue 2.x

1.Table组件常用属性

<a-table
        :columns="columns"
        @change="getTables"
        :loading="loadingTable"
        :data-source="data.data"
        :pagination="data.paginate"
        :bordered="false"
        :scroll="{ y: height }"
        :rowKey="key">
</a-table>

相关 属性

  1. columns,列的配置对象,https://2x.antdv.com/components/table-cn#API
  2. loading布尔值,是否显示表格的加载效果。
  3. data-source,表格的数据源对象。
  4. pagination,表格的分页相关配置,https://2x.antdv.com/components/pagination-cn
  5. bordered,布尔值,是否显示表格竖向的边框。
  6. scroll,用于固定表头,以及行数据滚动。
  7. rowKey,每列的key值,作用同vue 的key。
  8. @change,分页、排序、筛选变化时触发的事件。
  9. size,表格的大小。

columns 配置对象

  1. align,设置内容的对齐方式,left、right、center
  2. ellipsis,超过宽度将自动省略,暂不支持和排序筛选一起使用。
  3. title,表格头的标题。
  4. dataIndex,对应数据对象内的键。
  5. width:,指定表格列的宽度,字符串类型。
  6. key ,Vue 需要的 key,如果已经设置了唯一的 dataIndex,可以忽略这个属性。
  7. customRender,自定义渲染函数,Function({text, record, index});
  8. slots,指定某些列属性作为插槽来使用,例如指定customRender属性后,可直接使用插槽代替自定义输出; slots: {customRender: 'content'}
  9. sorter,指定一个自定义排序的函数,同Array的排序。

pagination分页

首先需要在表格组件上配置pagination属性,点击换页时会触发change事件,事件参数为改变后的pagination对象。

pagination: {
    pageSize: 30,//每页条数
    showSizeChanger: true,
    current: 1,
    total:0,
    pageSizeOptions:["30","50","100"]
}, //分页器

配合Thinkphp分页时,传递size和page给后端,请求成功后更新总数量、当前页。

自定义列

通过回调函数输出值:

customRender:(moments)=>{
     return '每月的'+moments+"号"
}

通过插槽自定义输出,下面是指定某个列属性通过插槽输出,指定customRender代表自定义列:

slots: {customRender: 'action'},

//表格插槽输出
<template #action>
</template>

2.栅格布局

没有匹配到设置的响应式参数时,会使用默认参数,例如没有设置xl的参数,xl大小的屏幕会使用默认值。

3.datepicker汉化无效

Antd-design-vue 2.x  ,使用datepicker选择器在vite工具下,中文设置无效的解决办法(大概原因是中文语言包没有被正常引入,只能强行设置中文):

import moment from 'moment';
moment.locale('zh-cn',{
  months: '一月_二月_三月_四月_五月_六月_七月_八月_九月_十月_十一月_十二月'.split(
      '_'
  ),
  monthsShort: '1月_2月_3月_4月_5月_6月_7月_8月_9月_10月_11月_12月'.split(
      '_'
  ),
  weekdays: '星期日_星期一_星期二_星期三_星期四_星期五_星期六'.split('_'),
  weekdaysShort: '周日_周一_周二_周三_周四_周五_周六'.split('_'),
  weekdaysMin: '日_一_二_三_四_五_六'.split('_'),
  longDateFormat: {
    LT: 'HH:mm',
    LTS: 'HH:mm:ss',
    L: 'YYYY/MM/DD',
    LL: 'YYYY年M月D日',
    LLL: 'YYYY年M月D日Ah点mm分',
    LLLL: 'YYYY年M月D日ddddAh点mm分',
    l: 'YYYY/M/D',
    ll: 'YYYY年M月D日',
    lll: 'YYYY年M月D日 HH:mm',
    llll: 'YYYY年M月D日dddd HH:mm',
  }});
import moment from 'moment'
import 'moment/dist/locale/zh-cn'
moment.locale('en')

4.DatePicker 组件

绑定的是一个ref的响应式变量(moment()),返回的是一个普通的时间字符串;

let datetime = ref(moment());
 /*计算当前的时间范围*/
let current = computed(() => {

let datetimes = moment(datetime.value);

if (type.value == 'day') {
      return datetimes.format("MM月DD日") + "0点" + " 到 " + datetimes.format("MM月DD日") + "24点";
} else if (type.value == 'week') {
      return datetimes.startOf('week').format("MM月DD日") + "0点" + " 到 " + datetimes.endOf('week').format("MM月DD日") + "24点";
} else if (type.value == 'month') {
      return datetimes.startOf('month').format("MM月DD日") + "0点" + " 到 " + datetimes.endOf('month').format("MM月DD日") + "24点";
}

5.Form组件。绑定数据和表单验证

<a-form layout="vertical"
  ref="formRef"
  :model="formState"
  :rules="rules">

  <!--姓名-->
  <a-form-item required>

    <template #label>
      <span style="margin-right: 3px">姓名</span>
      <a-tooltip title="填写客户姓名" placement="right">
        <QuestionCircleOutlined style="color: rgb(192, 196, 204); font-size: 13px;" />
      </a-tooltip>
    </template>

    <a-input size="large" placeholder="姓名" allowClear>
      <!-- 图标 -->
      <template #prefix>
        <UserOutlined style="color: rgb(192, 196, 204); font-size: 13px;" />
      </template>
    </a-input>
  </a-form-item>
</a-form>
const formState = reactive({
  name: '',
  idCard:''
});

const rules = {
  name: [
    {
      required: true,
      message: 'Please input Activity name',
      trigger: 'blur',
    },
    {
      min: 3,
      max: 5,
      message: 'Length should be 3 to 5',
      trigger: 'blur',
    },
  ],
  idCard: [
    {
      required: true,
      message: 'Please select Activity zone',
      trigger: 'change',
    },
  ]
};

const onSubmit = () => {
  formRef.value
      .validate()
      .then(() => {
        console.log('values', formState, toRaw(formState));
      })
      .catch(error => {
        console.log('error', error);
      });
};

6. 单独使用message和Modal组件时,需要单独引入css

import "ant-design-vue/es/message/style/css"
import "ant-design-vue/es/modal/style/css"

7.软件包动态引入

let icon=()=>import('@ant-design/icons-vue');
console.log(icon());

8.菜单

<a-menu>
<a-menu-item-group>
<a-menu-item>
<a-menu-divider>

问题总结

1.Form组件表单校验规则不生效

Form-Item组件的name属性必须和属性名一致,不填写name时不会进行校验

通过自定义验证方法,来验证form绑定的数据对象,内部对象的属性是否有效。

2.属性不生效

defaultExpandAllRows  仅用于首次渲染时生效(所有 default 开头属性均相同规范)。