Ant Design Skills&Tips

重点记录一些antd组件库使用时遇到的问题以及解决方法

Form组件

使用

Form

• labelCol: { span: 6, offset: 2 }, 大小;
• wrapperCol: { span: 16 };
• preserve: boolean 当字段被删除时保留字段值;
• initialValues: 设置表单域的值，优先级高于Item，不能被 setState 动态更新，需要用 setFieldsValue 来更新;
• validateTrigger: 统一设置字段触发验证的时机-['onChange','onFocus','onBlur'];
• onFieldsChange: 字段更新时触发回调事件function(changedFields, allFields);
• onFinish: 提交表单且数据验证成功后回调事件;
• onValuesChange: 字段值更新时触发回调事件;

Form.Item

• initialValue: 设置子元素默认值，如果与 Form 的 initialValues 冲突则以 Form 为准;
• normalize: 组件获取值后进行转换，再放入 Form 中。不支持异步,(value, prevValue, prevValues) => any;
• tooltip: 配置提示信息;
• colon: 配合 label 属性使用，表示是否显示 label 后面的冒号;
• rules: 校验规则;

{ required: true, message: 'Please input your password!', max:20, validator: customFunc(rule: Rule, value: string, cb: Promise) }

Form.List

• 为字段提供数组化管理;

<Form.List>
  {fields =>
    fields.map(field => (
      <Form.Item {...field}>
        <Input />
      </Form.Item>
    ))
  }
</Form.List>

校验

• const [form] = Form.useForm();此时会报错：Warning: Instance created by useForm is not connected to any Form element. Forget to pass form prop?官方没给出合理的处理方式；

• 有form属性，设为上面的{form}， 可以通过form.validateFields().then()去校验整个Form表单的字段；

• scrollToFirstError：长表单校验自动滚动；

• form.getFieldsValue();获取表单各项的值；

• form.setFieldsValue();设置表单区域的值；

• form.resetFields();重置表单的值；// tips:在onOK方法中使用resetFields不当会导致视觉交互问题。

• onValuesChange：表单数据变化监听事件；

• <Form.Item> 设置rule进行单项校验：required、max、validateTrigger:['onChange', 'onBlur','onFocus']、validator:customFunc自定义校验方法；

• 对于customFunc自定义校验方法：能接收到rule、value、callback，通过判断value，然后返回Promise.resolve()/Promise.reject('提示内容')；

Modal组件

使用

• getContainer={Boolean | HTMLElement}：默认挂载到document.body；
• forceRender：强制刷新；
• destroyOnClose：关闭的时候销毁组件；
• maskClosable={false}：点击蒙层是否关闭；

AutoComplete、Select组件

使用

• getPopupContainer={(triggerNode) => triggerNode.parentNode}：挂载到DOM，防止options列表滑动；
• dropdownRender：渲染自定义ReactNode；
• onSelect={this.onSelect}
• onSearch={this.onSearch}
• dataSource：数据；
• 阻止冒泡：Option的点击事件e中会抛出，e.stopPropagation();e.preventDefault();return false;三连看情况；

Upload

使用

• customRequest={this.upload}：自定义上传方法；upload(option):option包含文件信息：option.file.type、option.file.name...可以进行文件校验；

Table

使用

• scroll={{x: 1200,y: 500, scrollToFirstRowOnChange: true,}}：设置表格滚动；
• pagination：分页：
• expandable={{ defaultExpandedRowKeys: ['row1', 'row3'] }}：某行是否默认展开；
• dataSource：数据；
• columns：列头；

{
  size: 'small',
  total: data.total,
  showQuickJumper: true,
  defaultCurrent: 1,
  current: state.pageNow,
  pageSize: 50,
  showTotal: total => '每页50条 共${total}条',
  onChange: page => onPageSizeChange(page),
}

• locale：{{emptyText: }}：自定义空内容；
• loading={{spinning: loading, tip: "加载中...",}}：加载loading；
• columns：表格列配置：

{
      title: 'columnName',
      dataIndex: 'columnData',
      key: 'column',
      align: 'right',
      width: 120,
      render: text => handleVal(text),// 处理文本
      sorter: (a, b) => a.columnData - b.columnData,// 排序
}

Menu组件

使用

<Menu
  onSelect={handleMenuClick} // 选中事件
  onClick={..} // 点击事件
  onOpenChange={onOpenChange} // submenu展开事件
  style={{ width: 255 }} // 宽
  // defaultOpenKeys={['sub1']} // 默认展开的submenu
  openKeys={selectedSubMenu} // 当前选中的submenu
  // defaultSelectedKeys={['key1']} // 默认选中的menuItem
  mode="inline" // 展示形态
  >
    {renderSubMenu(menuList)} // 自定义方法去渲染
</Menu>

Input组件

使用

• autoComplete: "off", 可以禁止掉原生input的默认提示行为;