#说明

antd 是基于 Ant Design 设计体系的 React UI 组件库,主要用于研发企业级中后台产品。也是是本人目前实习公司所用框架技术之一

本笔记主要记录工作中项目中遇到的与官方文档有差异化的 的使用方式、或者是自己对于文档记录的组件的使用,方便自己查阅

除此笔记外大家可以看我其他笔记 :全栈笔记数据结构与算法编程_前端开发学习笔记编程_后台服务端学习笔记JavaNodejsJavaScript笔记编程工具使用笔记ES6及后续版本学习笔记Vue笔记整合React笔记微信小程序学习笔记Chrome开发使用及学习笔记 以及许多其他笔记就不一一例举了

#目录

Ant Design of React 文档

  1. 官方文档地址

  2. 组件

一、数据录入

1、From表单

许多数据录入是与From表单相结合的

Ⅰ- 限制表单中输入框不能为空以及中文

  1. 通过From.Item 中的 normalize属性进行处理对value的处理:组件获取值后进行转换,再放入 Form 中。不支持异步

  2. 通过正则替换,将键入的空格以及中文替换为空字符串

  3. 代码示例

  1. <Form form={form} onFinish={handleFinish}>
  2. <Item
  3. label="密码"
  4. name="password"
  5. rules={[{ required: true, message: '密码不能为空' }]}
  6. //密码框不允许为空格,且不允许输入中文
  7. normalize={(value) => value.replace(/\s/g, '').replace(/[\u4E00-\u9FA5]|[\uFE30-\uFFA0]/gi, '')
  8. }
  9. <Input.Password
  10. placeholder="请输入密码"
  11. autoComplete="new-password"
  12. />
  13. </Item>
  14. </From>

Ⅱ - 自定义校验

  1. 详见Rule属性中自定义validator

  2. 通常用作用户名等校验

  1. <Form form={form} onFinish={handleFinish}>
  2. <Item
  3. label="用户名"
  4. name="username"
  5. validateTrigger="onBlur"
  6. normalize={(value) => value.replace(/\s/g, '')}
  7. rules={[
  8. //此处message为空字符串是为了防止下方自定义校验返回的字符串重叠
  9. { required: true, message: '' },
  10. {
  11. validator: async (_, value) => {
  12. //如果是修改时,可以用这句话,当你内容没改变时,不进行校验
  13. if (editData.name === value) return;
  14. //判断空以及输入空字符串的报错
  15. if (value == null || value.trim() == '') return Promise.reject("用户名不能为空");
  16. //请求接口,查询通过上述两个校验后的字符串是否与数据库中重复,如果重复,则提示用户名已存在
  17. const res: IResult<IExist> = await ChannelApi.isUserExist( value );
  18. if (res?.data.status) return Promise.reject('用户名已存在');
  19. else return Promise.resolve();
  20. },
  21. },
  22. ]}
  23. <Input placeholder="请输入用户名" />
  24. </Item>
  25. </From>
  1. 通常用作必须字段校验(不进行数据库查询)
  1. <Item
  2. label="必填项"
  3. name="incomeType"
  4. rules={[
  5. { required: true, message: '' },
  6. {
  7. validator: async (_, value) => {
  8. if (value == null || value.trim() == '')
  9. return Promise.reject('必填项不能为空');
  10. },
  11. },
  12. ]}
  13. <Input.TextArea placeholder="请输入必填项信息" />
  14. </Item>

Ⅲ - 表单中动态修改数字输入框的value

  1. 出现场景:在 第一次对InputNumber组件输入0时,就自动填充为设置的min了,这时我的需求是改成输入框失去焦点时再自动填充为min

  2. 用到的组件:FromInputNumber

  3. 代码示例

```jsx //最小折扣,用于动态改变最小折扣 const [min, setMin] = useState(0);

{ if (Number(e.target.value) < 0.9) form.setFieldsValue({ discount: 0.9 }) setMin(0.9) }} />

  1. <a name="55cc907e"></a>
  2. ### Ⅳ - 限制表单中输入框-不能只输入纯空格以及为空(保留value中间空格)
  3. > 1. 出现场景:详见截图
  4. > ![](AntDesign_ofReact使用笔记中的图片/image-20210519174400852.png#alt=image-20210519174400852)
  5. > 2. 代码示例:此处指举例第一个输入框,并在里面进行注释
  6. > ```jsx
  7. <Form {...FORM_LAYOUT} form={form} onFinish={handleFinish}>
  8. <Item
  9. label="xxx名"
  10. name="name"
  11. validateTrigger="onBlur"
  12. // normalize={(value) => value.replace(/\s/g, '')} //此行代码是直接限制无法输入空格,不符需求所以废弃
  13. rules={[
  14. //1. 此处message要置空,因为下方`value == null `就是为空提示,不置空会出现提示两遍的错误
  15. //2. 为何保留此处? 需要输入框前有*提示必填 如果不是必填项就不需要
  16. { required: true, message: '' },
  17. {
  18. validator: async (_, value) => {
  19. //此行是去除前后空格后为空字符串或者直接为空的话返回 不能为空提示
  20. if (value == null ||value.trim() == '') {
  21. return Promise.reject('xxx名不能为空');
  22. } else {
  23. const res: IResult<IExist> = await ChannelApi.isChannelExist(
  24. value
  25. );
  26. if (res?.data.status) {
  27. return Promise.reject('xxx名已存在');
  28. } else {
  29. return Promise.resolve();
  30. }
  31. }
  32. },
  33. },
  34. ]}
  35. >
  36. <Input placeholder="请输入渠道商名" />
  37. </Item>
  38. //不是必须项的对比
  39. <Item label="联系人" name="contactName">
  40. <Input placeholder="请输入联系人" />
  41. </Item>
  42. </Form>
  1. 解析

    1. rulesmessage为什么要置空?
      因为下方value == null就是为空提示,不置空会出现提示两遍的错误

    2. 为什么下方validator中已经给出为空提示,为何还要保留{ required: true, message: '' }?
      因为需要输入框前有提示必填 如果不是必填项就不需要,此项会给你增加``号标识

    3. 为何不直接给输入内容.trim()去除前后空格?
      因为输入监听导师value是单次输入,需要你在后面提交时将参数进行一次trim()去除前后空格

Ⅴ - 实现嵌套结构-多类型输入效果

  1. 需求场景:当要求通过下拉框切换后面输入框类别,同时后面的输入框绑定的值不同(与文档中给出的不同:文档中后续输入框时同一个,只是简单时输入框组合)

  2. 需求示例截图

antdREADME - 图1

  1. 实现思路:
  • Form.Item中再嵌套Form.Item,然后将各自规则分开写(不能写在父item中).分别绑定不同变量名,通过选择的类型切换渲染后面的Form.Item
  • 在取数据时,可以判断其中一个变量为空时进行对另一个变量的数据(如果不渲染Form.Item,其绑定的变量为undefined),如此就能实现此需求
  • 此处记录主要起到借鉴作用,我感觉应有更好的写法,但是暂时没想出,同学们如果有好写法希望可以提出交流
  1. 解决代码:
  1. <Form.Item {...formItemLayout} label="公司">
  2. <Select
  3. defaultValue="0"
  4. style={{ width: 120 }}
  5. onChange={(v) => setinputType(v)}
  6. <Option value="0">公司名</Option>
  7. <Option value="1">公司ID</Option>
  8. </Select>
  9. {/* 当前方选择框选择公司ID输入时,渲染输入公司ID
  10. 当前方选择框选择公司名输入时,渲染请选择可见公司 */}
  11. {inputType != '0' ? (
  12. <Form.Item
  13. {...formItemLayout}
  14. //此处name需要绑定不同变量名,否则会导致与下方`选择可见公司`选择框变量互相污染
  15. name="company_inputIds"
  16. noStyle
  17. rules={[{ required: true, message: '输入公司ID' }]}
  18. {/* 此处使用antd自带下拉框 */}
  19. <Select
  20. mode="tags"
  21. value={showCompanyIDList}
  22. onChange={(val) => changeCompanyIds(val)}
  23. showArrow={true}
  24. placeholder="输入公司ID"
  25. style={{ minWidth: 250, maxWidth: 350 }}
  26. tokenSeparators={[',']}
  27. />
  28. </Form.Item>
  29. ) : (
  30. //此处调用公用组件
  31. <Form.Item
  32. {...formItemLayout}
  33. name="company_ids"
  34. noStyle
  35. rules={[{ required: true, message: '请选择指定公司' }]}
  36. <SuperSelect
  37. value={showCompanyList}
  38. placeholder="请选择可见公司"
  39. loading={companyLoading}
  40. options={companyList}
  41. showArrow={true}
  42. onChange={(val) => {
  43. companyListChange(val);
  44. }}
  45. getData={() => {
  46. getCompanyList();
  47. }}
  48. onSearch={onSearchCompany}
  49. />{' '}
  50. </Form.Item>
  51. )}
  52. </Form.Item>
  53. --------------------------------- 数据处理 ----------------------------------------------------
  54. const params = {
  55. //当 `company_ids`为空时,取`company_inputIds`的值(反之相反),然后将值转为字符串形式(以,隔开)
  56. company_ids:
  57. data?.company_ids?.length > 0
  58. ? data?.company_ids?.map((value) => value.key).join(',')
  59. : !toJS(data?.company_inputIds)
  60. ? undefined
  61. : data?.company_inputIds?.toString(),
  62. };

Ⅵ - 实现From中使用富文本编辑器

  1. 需求场景:当你的表单提交中有富文本编辑器,且你要将其变为受控组件时

  2. 难点分析:

  • 如何将让from认到富文本编辑器中的值:使用form.setFieldsValue方法设置Form.Item绑定的默认值,用作校验
  • 为什么不用setState去将其绑定成受控组件?—>你不应该用 setState,可以使用 form.setFieldsValue 来动态改变表单值
    —> (此处为官方文档原话,点我传送)
  1. 代码及其注解
  1. ----------------------- 组件调用处 ------------------------
  2. <Form.Item
  3. {...formItemLayout}
  4. name="EditorContent"
  5. style={{ width: '120%' }}
  6. rules={[
  7. {
  8. required: true,
  9. validator: (_, value) => {
  10. //此处只是简单判断是否为空,
  11. //但其实value在store中将undefined的值赋值成了'<p><br/></p>';
  12. //如果要严格判断是否为空,应加正则进行判断
  13. if (value) return Promise.resolve();
  14. return Promise.reject('请输入推送内容');
  15. },
  16. },
  17. ]}
  18. {/* 富文本编辑器-- 此组件为封装的组件*/}
  19. <SuperWangeditor
  20. EditorContent={newEditorContent}
  21. setEditorContent={setEditorContent}
  22. setContentType={setContentType}
  23. disable={true}
  24. //此处将`changeHandle`方法传给子组件,目的是让其将值传递出来给`form.setFieldsValue`使用
  25. changeHandle={(content) => {
  26. form.setFieldsValue({
  27. 'EditorContent': content,
  28. });
  29. }}
  30. />
  31. </Form.Item>
  32. ------------------------ 封装的富文本组件中的`onchange`事件处代码 ----------------------------------------
  33. import Wangeditor from 'wangeditor';
  34. ..省略..
  35. componentDidMount() {
  36. const { changeHandle } = this.props;
  37. //当输入修改时触发
  38. //3.x版本写法
  39. // editor.customConfig.onchange = (html) => {
  40. // //将子组件的值抛给父类,这样可以使得此组件更有通用性 ----------------->主要是这步
  41. // if (changeHandle) changeHandle?.(html);
  42. // //文本
  43. // if (setEditorContent || setContentType) {
  44. // //设置内容
  45. // setEditorContent(editor.txt.html());
  46. // setContentType(false);
  47. // }
  48. // };
  49. //4.x版本应将`customConfig`更改为config
  50. editor.config.onchange = (html) => {
  51. // console.log(html)
  52. //将子组件的值抛给父类,这样可以使得此组件更有通用性
  53. if (changeHandle) changeHandle?.(html);
  54. //文本
  55. // console.log(editor.txt.text())
  56. if (setEditorContent || setContentType) {
  57. //设置内容
  58. setEditorContent(editor.txt.html());
  59. setContentType(false);
  60. }
  61. };
  62. }
  63. ---------------------- 对于输入富文本数据进行处理(此处可忽略,只是指出数据处理) --------------------------------------
  64. @computed
  65. get newEditorContent() {
  66. let content;
  67. //此处如果为undefined时置换成'<p><br/></p>' -->所以在上述校验条件中指出:如果严格校验输入为空以及纯空格需要用正则判断
  68. if (typeof this.tableData.content == 'undefined') {
  69. content = '<p><br/></p>';
  70. } else {
  71. content = toJS(this.tableData?.content);
  72. }
  73. return content;
  74. }
  1. 富文本编辑器官网 —>点我跳转

Ⅶ - 给表单中输入框(其他如选择框)等赋初始值

此处拿 inputNumber 作为例子

a) 我们的错误做法

我们从官方文档中可以知道,设置默认值有一个专门的API: defaultValue —> 初次渲染时会进行赋初始值,且只会执行一次,但是在某些场景下,却发现 defaultValue 并不能完成我们预期的初始化操作,此处举一例本人开发中遇到的场景:

当我们需要写一个 inputNumber 同时设置其 最大值(max)、最小值(min)、初始值(defaultValue) ,通常我们是这样做的

  • 这三个值绑定的都是可改变的state
  • 在页面加载初始化函数中调用接口从而获取这三个值
  • 获取到值后state改变,重新渲染页面,将这三个值渲染到页面上

b) 这时候问题来了:

  • 首先一种情况:你会发现你使用 inputNumber 给的初始值并不是绑定的state的最新值,更像是初始化定义时的值(定义state时没给初始值就是undefined)
  • 另一种情况:也就是在 inputNumber 中出现的 —> 输入框的默认值会是最小值 or 最大值

c) 问题

① 为何设置的默认值不是最新的state

当你 初始值(defaultValue) 绑定的值需要从异步接口中获取那么实际上我们页面不会等到请求结束才渲染,而是先渲染页面(此时就运行了 defaultValue)这个API了),等到接口返回将state修改了再重新渲染绑定这些state部分的页面元素 那么即使后面接口获得数据改变了这个值,页面也只会渲染刚开始的值

② 为何 inputNumber 默认值会成为最大值 or 最小值

其实在上面的问题解析中就知道了, 初始值(defaultValue) 只会渲染一次,不论你一开始 state 给定的值是0(防止错误)、正常的值甚至是直接不给初始化(就默认为undefined),实际上他都是只有初次渲染时生效,你可以理解为实际上页面可能进行了不止一次渲染

  • 第一次渲染: 此时页面不管你state是否还要改变,就当前给定的 最大值(max)、最小值(min)、初始值(defaultValue) 渲染到页面上,此时 初始值(defaultValue) 是生效的
  • 再渲染:当 最大值(max)、最小值(min)、初始值(defaultValue) 绑定的state发生改变时(实际上就是请求的接口数据返回了),初始值(defaultValue)因为再第一次渲染中已经调用过一次,所以无法再给这个 inputNumber 设置初始值了,这时如果你第一次的 初始值 超出当前最大值、最小值范围时,就会被最大值最小值限制

d) 解决方案

实际上有很多解决方案,这里列举一两个

  • 定义一个 state,但不再使用 defaultValue 方法,而是直接将 value绑定state,初始化给默认值也直接修改state即可
  • 如果你的输入框在 From 表单中 ,那么你可以在初始化生命周期(或useEffect) 中 调用 from.setFieldsValue({…}),相当于在每次重绘时都进行一次初始值写入

2、Select 选择器

Ⅰ - filterOption 筛选下拉项自定义筛选条件

filterOption :是否根据输入项进行筛选。当其为一个函数时,会接收 inputValue option 两个参数,当 option 符合筛选条件时,应返回 true,反之则返回 false

注意:要配合 showSearch 一起使用,首先要支持搜索 然后用

a) 使用场景

一般常见场景来说,我们可以只通过 showSearch为true 的方式做到输入内容关联下拉项,但是某些场景就需要配合 filterOption使用了

  • 当我们进行搜索的内容不是 Option 项中绑定的 value, 而是它的 children 值呢? 比如你value绑定的是订单id 而 children 则是显示时展示的 订单名称
  • 那么这时候单单使用 showSearch 就不足以完成我们的需求了:我们输入订单名称去关联搜索下面下拉项订单名称

b) 使用示例
  1. <Select
  2. placeholder="请输入或下拉选择IP名称"
  3. showSearch
  4. //动态搜索Option的值 而不是value中的值
  5. //正则:当 inputValue 包含于 option 时返回true
  6. filterOption={(inputValue, option) => new RegExp(inputValue).test(option.children)}
  7. >>
  8. {nameList?.map(item => (//下拉项value绑定id 展示却展示名称
  9. <Option key={item?.id} value={item?.id}>
  10. {item?.proxy_name}
  11. </Option>
  12. ))}
  13. </Select>

antdREADME - 图2

Ⅱ - 自定义添加下拉项

```tsx const [form] = Form.useForm(); const [initsPlatforms, setInitsPlatforms] = useState([]); //总的下拉列表 const [newPlatforms, setNewPlatforms] = useState(‘’); //新增内容输入框绑定数据 //自定义平台输入框数据绑定 const onChangeName = (event) => { if (event?.target?.value?.trim()?.length != 0) setNewPlatforms(event.target.value); else setNewPlatforms(undefined); }; //自定义平台的添加操作 const addItem = (type) => { //如果为空字符串或者为undefined 则直接中断 if (!newPlatforms || newPlatforms.trim().length == 0) return; //将添加标签输入框的内容加入 下拉列表中 setInitsPlatforms([…initsPlatforms, newPlatforms]); //本人用的from提交,这行代码是将自定义平台直接加到选中框中 form.setFieldsValue({ [type]: […form.getFieldValue(type), newPlatforms], });

setNewPlatforms(‘’); };
/* RreatNode */

addItem(‘yes_platforms’)} > 添加自定义平台 )} > {initsPlatforms?.map(( item //下拉项value绑定id 展示却展示名称 ) => ( ))}

  1. > > <a name="a13b548f"></a>
  2. ###### 效果展示
  3. > ![](AntDesign_ofReact%E4%BD%BF%E7%94%A8%E7%AC%94%E8%AE%B0%E4%B8%AD%E7%9A%84%E5%9B%BE%E7%89%87/image-20210928120121096.png#alt=image-20210928120121096)
  4. <a name="9e3466e8"></a>
  5. # 二、数据展示
  6. <a name="5248efce"></a>
  7. ## 1、[Table表格](https://ant.design/components/table-cn/)
  8. > 基本前端大部分页面数据展示都是使用`Table`进行展示
  9. <a name="7b6aa8bd"></a>
  10. ### Ⅰ-列表渲染映射文字
  11. > 1.
  12. 场景:当你对下列表渲染时,服务端传送过来的`值是数字`(0,1,2),而你要`显示成相对应的文字时`
  13. > 2.
  14. 代码示例1:
  15. > ```jsx
  16. <Table>
  17. <Column
  18. title="状态"
  19. dataIndex="status"
  20. render={(data) => {
  21. const text = {
  22. 0: '已绑定',
  23. 1: '未绑定',
  24. 2: '已删除',
  25. };
  26. return text[data];
  27. }}
  28. />
  29. </Table>
  1. 代码示例2,写法不同效果相同,下面是本人喜欢的写法:

```jsx / 数据字典 company-const.ts / const SHOPSTATUSDICT = { 0: ‘已删除’, 1: ‘正常’, 2: ‘未绑定IP’, }; export{ SHOPSTATUSDICT }

/* 页面调用出 / import { SHOPSTATUSDICT } from ‘../common/company-const’//导入数据字典 const columns = [ { title: ‘状态’, dataIndex: ‘status’, ellipsis: true,
render: text=>SHOPSTATUSDICT[text]//进行状态数据映射 },]

return (

);

  1. <a name="df8109cd"></a>
  2. ### Ⅱ-列表渲染映射-小数转百分比
  3. > 1.
  4. 当服务端给你的数据是小数,而你需要将其渲染成百分比进行展示 0.25-->25%
  5. > 2.
  6. 解析:应用的是`render`相关知识点
  7. > 3.
  8. 代码示例:
  9. > 4.
  10. 转换函数代码
  11. ```jsx
  12. /**
  13. * 将小数转化为百分比
  14. * @param point
  15. * @returns
  16. */
  17. toPercent=(point:number)=>{
  18. //判断是否为空,如果为空不做处理 -->此处如果为空要转换成0,将此行代码下移一位即可
  19. if(!!!point) return point
  20. //服务端可能传来的数据是字符串,转换一下
  21. point=Number(point)
  22. if (point==0) return 0;
  23. let str=Number(point*100).toFixed()+"%";
  24. return str;
  25. }
  1. 列表table组件代码 ```jsx //写法一 (typeof data ==’number’)? tool.toPercent(data):data } />

//写法二 const columns = [ { title: ‘抽成比例’, dataIndex: ‘rate’, width: 150, ellipsis: true, //将小数转换成百分比 render: data => tool.toPercent(data)

},];

  1. > 6.
  2. 如果对于`if(!!!point)`此行代码不懂的同学可以看本人在js笔记中的[`js中为什么需要!!?`](https://gitee.com/hongjilin/hongs-study-notes/blob/master/%E7%BC%96%E7%A8%8B_%E5%89%8D%E7%AB%AF%E5%BC%80%E5%8F%91%E5%AD%A6%E4%B9%A0%E7%AC%94%E8%AE%B0/(html+css+js)%E9%9B%B6%E6%95%A3%E7%AC%94%E8%AE%B0,%E5%BE%85%E6%A2%B3%E7%90%86/JavaScript%E7%AC%94%E8%AE%B0(%E9%9B%B6%E6%95%A3%E5%BE%85%E6%A2%B3%E7%90%86)/js%E4%B8%AD%E4%B8%BA%E4%BB%80%E4%B9%88%E9%9C%80%E8%A6%81!!%EF%BC%9F.md)部分
  3. <a name="e5b58ebe"></a>
  4. ### Ⅲ-表格列固定
  5. > 1.
  6. 需求场景:当你的列表过长时,使用滚轮进行拖动会导致用户体验感较差,这时就需要进行表格列固定
  7. > 2.
  8. 未使用时效果
  9. ![](AntDesign_ofReact使用笔记中的图片/image-20210519180836289.png#alt=image-20210519180836289)
  10. > 2. 使用后效果
  11. > ![](AntDesign_ofReact使用笔记中的图片/image-20210519180215667.png#alt=image-20210519180215667)
  12. > <br />> `ps`:截图中展示的都是开发中的> `测试假数据`
  13. > 3.
  14. 代码示例:只给出必要部分
  15. > 1.
  16. css样式代码(需要给定`width`,否则无法生效,给定高度,防止超出)
  17. ```scss
  18. .tableWidth{
  19. width: 1600px;
  20. height: calc(100% - 48px);
  21. :global {
  22. .ant-table-wrapper,
  23. .ant-spin-nested-loading,
  24. .ant-spin-container,
  25. .ant-table-container {
  26. height: 100%;
  27. }
  28. .ant-table {
  29. height: calc(100% - 48px);
  30. }
  31. .ant-table-pagination.ant-pagination,
  32. div.ant-typography,
  33. .ant-typography p {
  34. margin-bottom: 0;
  35. }
  36. }
  37. }
  1. js调用代码示例1
    1. const columns = [
    2. {
    3. title: '公司ID',
    4. fixed: 'left', //这就是固定在左边写法
    5. dataIndex: 'companyId',
    6. width: 150,
    7. ellipsis: true,
    8. },
    9. ]
    10. return (
    11. <Table
    12. className={` ${style.tableWidth}`}
    13. columns={columns}
    14. scroll={{ x: 600 }}
    15. />
    16. );
  1. js调用2:(都可实现,效果一样)
    1. const columns = [
    2. {
    3. title: '名称',
    4. dataIndex: 'name',
    5. width: 150,
    6. fixed: 'left' as const,
    7. }, {
    8. title: '操作',
    9. dataIndex: 'agentId',
    10. width: 400,
    11. fixed: 'right' as const,
    12. }
    13. ]
    14. return (
    15. <div className={style.tableWidth}>
    16. <Table
    17. scroll={{ x: 600, y: 'calc(100% - 48px)' }}
    18. columns={columns}
    19. />
    20. </div>
    21. );
  1. 注意:需要给定宽度,不然不会生效

Ⅳ-列表内容超出隐藏且悬停显示全

这属于超长连续字段(长数字和长单词)破坏表格布局的问题(即使你指定了列的宽度也会被挤开),组件之前默认内加过word-break: break-word;去纠正此类布局,又会引起#13624的问题—列高也会被撑开(此处给的例子于其不一样,但原理相似)

  1. 需求场景:当我的列表内容过多使得表格撑开,导致整个表格样式与希望效果不符合时,我希望能将其超出隐藏,并能悬停显示全部信息

antdREADME - 图3

  1. 代码实现
  1. import { Tooltip } from 'antd';
  2. const columns=[
  3. { title: '渠道商账号', dataIndex: 'username',
  4. width: 150,
  5. onCell: () => {
  6. return {
  7. style: {
  8. maxWidth: 180,
  9. overflow: 'hidden',
  10. whiteSpace: 'nowrap',
  11. textOverflow:'ellipsis',
  12. cursor:'pointer'
  13. }
  14. }
  15. },
  16. //此处引入用作悬停显示全
  17. render: (text) => <Tooltip placement="topLeft" title={text}>{text}</Tooltip>
  18. },
  19. ]
  1. 效果实现图

antdREADME - 图4

Ⅴ-Table表中使用气泡提示Tooltip

AntD的Table表头title加Icon图标和气泡提示Tooltip

  1. 需求场景:当你的产品要你实现这个效果时

antdREADME - 图5

  1. 代码实现:直接在title中写即可

```tsx import React, { Component } from ‘react’; import { Table, Button, Modal, Typography } from ‘antd’; import { QuestionCircleOutlined } from ‘@ant-design/icons’; import { Tooltip } from ‘antd’; interface IProps { store: Store; }

const ManageTable = (props: IProps) => { const { store } = props; const columns = [ { dataIndex: ‘monthCount’, ellipsis: true, //效果实现就在这行 title:

本月新增付费IP数 
, },

]; return (

record.id || index} className=”table-box” columns={columns} /> ); };

export default observer(ManageTable);

  1. > 3. 效果展示
  2. > ![](AntDesign_ofReact%E4%BD%BF%E7%94%A8%E7%AC%94%E8%AE%B0%E4%B8%AD%E7%9A%84%E5%9B%BE%E7%89%87/image-20210617185606230.png#alt=image-20210617185606230)
  3. <a name="a95bc11f"></a>
  4. #### ②_列表中正常使用气泡提示Tooltip_
  5. > 1.
  6. 正常列表中使用气泡提示
  7. > 2.
  8. 代码示例:---在`columns`render中使用
  9. > ```tsx
  10. const columns = [ {
  11. title: '列名',
  12. dataIndex: '属性名',
  13. render: (text, record) => (
  14. <Tooltip placement="top" title={text}>
  15. <a onClick={() => showModal(true, record.id, text)}>{text}</a>
  16. </Tooltip>
  17. ),
  18. },
  19. ]
  1. 实现效果

antdREADME - 图6

列表中使用[Tooltip]组件却出现两个提示的问题解决

  1. 问题场景:当你想为表格中超出隐藏文字部分加气泡提示时却发现出现两个提示
  • 问题代码:

      1. <Column
      2. title="支付宝账户"
      3. dataIndex="zfb_account_name"
      4. ellipsis
      5. width={120}
      6. render={text => (
      7. <Tooltip placement="top" title={text}>
      8. {/* {text} //此处直接将内容数据返回出去渲染 */}
      9. {`这是返回出去列表渲染的:${text}`}
      10. </Tooltip>
      11. )}
      12. />
  • 问题截图与分析:
    antdREADME - 图7 .
  1. 问题分析:
  • render()中返回如果是纯文本,会被[Table]自动渲染成白色气泡提示,但此提示不符合我们自己的需求(无法复制、不够美观)

  • 所以我们返回给render()的可以是自己定义的DOM.但是此处也会引出一个新的问题,看下方—>

    • 初次改进代码:
      1. -----------------------修改后出现问题的代码------------------------------------;
      2. <Column
      3. title="支付宝账户"
      4. dataIndex="zfb_account_name"
      5. ellipsis
      6. width={120}
      7. render={text => (
      8. <Tooltip placement="top" title={text}>
      9. {/* {text} //此处直接将内容数据返回出去渲染 */}
      10. <div>{`这是返回出去列表渲染的:${text}`}</div>
      11. </Tooltip>
      12. )}
      13. />
  • 初次改进效果:
    antdREADME - 图8.
  • 可以看出虽然解决了双气泡提示的问题,但也引出了一个新问题::返回的新的DOM它不受前方ellipsis属性影响,虽然气泡提示成功变为只有一个,但是下方文本仍然超出,怎么办?
  1. 最正确写法(数组写法也一样,自行转换下即可):
  • 代码 ``tsx ----------------------- 正确写法1:给dom加以下样式 -----------------------------------; //tsx <Column title="支付宝账户" dataIndex="zfb_account_name" // ellipsis 此属性无法影响到render返回出来的dom节点,无用了,去除 width={120} render={text => ( <Tooltip placement="top" title={text}> {/* {text} //此处直接将内容数据返回出去渲染 */} <div className={style.text}>{这是返回出去列表渲染的:${text}`}
    )} /> //scss .text { white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } ———————————- 正确写法2:直接将写成内联样式(不推荐) —————————————————-;

(

{text}
)} />

  1. > -
  2. 效果截图:
  3. <br />![](AntDesign_ofReact%E4%BD%BF%E7%94%A8%E7%AC%94%E8%AE%B0%E4%B8%AD%E7%9A%84%E5%9B%BE%E7%89%87/image-20210712163609695.png#alt=image-20210712163609695)
  4. > 于此问题完美解决了
  5. <a name="51ba2b2f"></a>
  6. ### Ⅵ-table排序对比大小相关
  7. > antd列表排序`第一次点击逆序第二次正序第三次是恢复到默认`,依次循环.所以每第三次点击并不是无效,而是本身需要此效果
  8. > 其实可以直接写,只是如果不抽出,多处使用重复的代码,万一修改就很麻烦
  9. <a name="d5338c58"></a>
  10. #### ①_`table按时间排序`_
  11. > 1.
  12. 需求场景分析:当你需要对列表中数据按照时间排序,但是antd默认排序方法无法认出根据你传入对象的何属性进行排序,此时你就需要自己写时间排序
  13. > 2.
  14. 代码实现与截图
  15. > ```tsx
  16. //此处贴士:antd第一次点击逆序第二次正序第三次是回复到默认,依次循环
  17. {
  18. title: '采集结束时间',
  19. dataIndex: 'end_time',
  20. key: 'end_time',
  21. sorter: (a, b) => new Date(a.end_time).getTime() - new Date(b.end_time).getTime()
  22. },
  23. -----------------封装与调用--------------------------
  24. 工具函数抽出:
  25. /**
  26. * 时间列表排序方法
  27. * 可以更换a,b顺序,做到初次为逆序还是正序排序
  28. * @param a 包含时间属性的对象a
  29. * @param b 包含时间属性的对象b
  30. * @param type 作为排序依据的时间属性名字
  31. * @returns number 利用正负数进行判断
  32. */
  33. timeSorter = (a:object, b:object):Function => (type):number => new Date(a[type]).getTime() - new Date(b[type]).getTime()
  34. //此处b-a(看自己需求)原因为要符合服务端给定的数据,服务端给的数据默认越以前的时间在前面,防止第一次看上去无效
  35. 调用: sorter: (a, b) => tool.timeSorter(b, a)('start_time')

antdREADME - 图9

table通用对比大小

  1. 包括时间排序,你都能使用此封装函数

  2. 代码实现与截图

  1. -----------------封装与调用--------------------------
  2. 工具函数抽出:
  3. /**
  4. * 通用对比法
  5. * @param a 包含要对比属性的对象a
  6. * @param b 包含要对比属性的对象b
  7. * @param type 作为排序依据的属性名字
  8. * @returns boolean
  9. */
  10. //commonSorter = (a:object, b:object):Function=> (type):boolean => a[type] > b[type] -->错误,返回应为1或者-1
  11. commonSorter = (a:object, b:object):Function=> (type):number => a[type] > b[type] ? 1 : -1
  12. sorter={(a: object, b: object) => tool.commonSorter(a, b)('url')}

antdREADME - 图10

注意:排序返回应为正负数[如1、-1]而不是boolean类型

Ⅶ - 以其他列作为本列展示筛选条件

  1. 举个实际场景:
  • 当我需要根据 [is_dynamic] 字段判断 本列展示的是 [IP名称] 还是 [IP地址] 时
  1. api概述: 列的 render() 方法自动接受两个参数
  • 第一个参数: daraIndex 中绑定字段的值
  • 第二个参数: 本行数据所有属性名与值
  1. 代码实现与截图
  • 实现方法1:row含有本行所有字段 antdREADME - 图11
  • 实现方法2:其实就是换个写法 antdREADME - 图12

2、Tree 树形控件

官方文档部分

ps:下方解决代码只给出本效果所需必要代码,其余代码不展示出来—>必须代码上都有相应注释

Ⅰ- 实现点击复选框后的文字也能进行选择的效果

  1. 需求场景:

antdREADME - 图13

  1. API概述:
  • [checkedKeys]API是显示记录表单中选中的节点
  • [onCheck]API是针对前面的复选框点击,点击时传参数为所有选中的数组,此处可以直接看官方文档就能实现
  • [onSelect]API是针对后面文字树节点的点击,但是点击时传参数为当前选中树节点,且其选中与未选中与[checkedKeys]无关联
  1. 思路分析:
  • 首先,声明[checkedKeys]变量,然后从服务端获取已有选中项,进行初始化
  • 不论是[onCheck]还是[onSelect],都是对于checkedKeys变量进行拼装操作,再写入渲染
  • 只是说[onSelect]传来的参数需要经过加工,略显复杂,详情请看下方代码
  1. 代码:

```tsx import { Button, Form, Input, Tree } from ‘antd’; import { inject, observer, useLocalStore } from ‘mobx-react’; import React, { useEffect, useMemo, useRef, useState } from ‘react’; import style from ‘./style.scss’;

const EditModal = (props) => { //用来存 [checkedKeys]—>已经选中的状态 通常需要从服务端先获取初始化原先已经选中的数据 const [checkedKeys, setCheckedKeys] = useState([]); const [form] = Form.useForm();

/**

  • 一 复选框选中函数
  • @param checked 传入当前勾选上的所有节点key / const handleSearchTreeNode = (checked) => { setCheckedKeys(checked); }; /*
  • 二 树节点选中函数
  • @param checked 选中时传入当前树节点 —注意:当为未选中状态时传入为空,所以不能用作[权限选中判断]
  • @param e 点击树节点时传入整个树节点数据信息 —不论是否选中都会传入
  • @param node
  • @param event */ const handleSelectTreeNode = (checked, e, node, event) => { //将点击的树节点的[key]解构出来 const { node: { key }, } = e; //声明一个SET数组,将key存入(以防万一同时防止重复赋值) const data = Array.from(new Set([…checkedKeys, key])); //首先判断原有[树数组:checkedKeys]中是否含有当前点击的[key],如果有则筛选掉, if (checkedKeys.includes(key)) setCheckedKeys(checkedKeys.filter((value) => value != key)); //如果原有[树数组]中不含有,则直接将新增好的[data]写入替代掉[树数组:checkedKeys] else setCheckedKeys(data); };

    return ( <Form.Item

    1. name="roles"
    2. noStyle
    3. rules={[
    4. () => ({
    5. validator(rule: any, value: any) {
    6. if (checkedKeys && checkedKeys.length === 0) return Promise.reject('请选择角色对应的权限');
    7. return Promise.resolve();
    8. },
    9. }),
    10. ]}

    >

    1. <Tree
    2. defaultCheckedKeys={[]}
    3. checkable
    4. expandedKeys={expandedKeys}
    5. onExpand={(keys) => {
    6. setExpandedKeys(keys);
    7. }}
    8. //此处绑定所有Tree数据
    9. treeData={menuTree}
    10. //此处绑定选中的key
    11. checkedKeys={checkedKeys}
    12. //此处为复选框点击触发API
    13. onCheck={handleSearchTreeNode}
    14. //此处为后面的文字树节点点击触发API
    15. onSelect={handleSelectTreeNode}
    16. height={300}
    17. />

    ); }; ```

  1. 效果展示:

antdREADME - 图14

3、Tooltip文字提示

Ⅰ - 自定义悬停提示

一般我们的悬停提示就是直接将数据赋值到 [title] 上,但是目前遇到一个需求,是要求悬停提示需要换行、指定行带颜色

实际上 [ title ] 可以接受参数是一个ReactNode 即直接一个节点

  1. <Tooltip title={this.remarksNode(remarks, remarks_v5, yes_platforms, no_platforms)}>
  2. <p className={style.remarks}>{data}</p>
  3. </Tooltip>
  4. // 生成ReactNode 函数
  5. const remarksNode = (remarks, remarks_v5, yes_platforms, no_platforms) => {
  6. return (
  7. <div className={style.zz}>
  8. <span>3版本提示语:</span>
  9. <span>{remarks}</span>
  10. <span> 5版本提示语:</span>
  11. <span> {remarks_v5}</span>
  12. <span>常见可用平台: {yes_platforms?.toString()}</span>
  13. <span style={{color:'red'}}>不推荐使用平台: {no_platforms?.toString()}</span>
  14. </div>
  15. );
  16. };

效果展示

antdREADME - 图15