Ant Design 多选组件中实现并可视化选择顺序的完整方案

云芳小哥_5954

云芳小哥_5954

2026-04-15

583人浏览

原创

本文详解如何在 Ant Design 的 Select[mode="multiple"] 中动态显示用户选择顺序(如 Label-1、Label-2),并在标签(Tag)和下拉选项中同步更新序号,同时避免高频重渲染性能问题。

本文详解如何在 ant design 的 `select[mode="multiple"]` 中动态显示用户选择顺序(如 label-1、label-2),并在标签(tag)和下拉选项中同步更新序号,同时避免高频重渲染性能问题。

在 Ant Design 的多选组件中,默认仅维护选中值的集合(string[] 或 number[]),不保留选择时序信息。但实际业务中常需向用户明确传达“哪个先选、哪个后选”——例如配置字段优先级、构建有序筛选条件、或实现拖拽式排序的前置交互。直接修改 options 数组以动态拼接序号(如 "Label-1")虽可行,却会触发全量 options 重新计算与 Diff,显著降低大列表场景下的响应性能。

理想的解法是分离数据源与视图表达:用 useRef 缓存原始不可变选项(避免重复创建),用 useState 管理当前带序号的渲染态 options,并通过 tagRender 自定义选中标签,确保序号在关闭下拉时仍清晰可见。

以下是推荐实现方案(基于 Ant Design v5+):

import { Select, Tag } from 'antd';
import React, { useState, useRef, useMemo } from 'react';

type Option = { label: string; value: string };

const OrderAwareMultiSelect = () => {
  // ✅ 原始选项 —— 用 useRef 静态持有,永不变更
  const optionsRef = useRef<option>([
    { label: 'Label', value: '1' },
    { label: 'Label', value: '2' },
    { label: 'Label', value: '3' },
    { label: 'Label', value: '4' },
  ]);

  // ✅ 当前选中值序列(保持插入顺序)
  const selectedValuesRef = useRef<string>([]);

  // ✅ 渲染态 options:label 动态追加序号(如 "Label-1")
  const [renderOptions, setRenderOptions] = useState<option>(optionsRef.current);

  // ? 核心逻辑:选中/取消时更新序号
  const handleChange = (values: string[]) => {
    selectedValuesRef.current = values;

    // 仅对当前 options 做映射更新,避免深拷贝开销
    setRenderOptions(prev =>
      prev.map(opt => {
        const index = values.indexOf(opt.value);
        // 移除旧序号(支持 label 含下划线等场景),再追加新序号
        const cleanLabel = opt.label.replace(/-\d+$/, '');
        return {
          ...opt,
          label: index === -1 ? cleanLabel : `${cleanLabel}-${index + 1}`,
        };
      })
    );
  };

  // ?️ 自定义 Tag 渲染:确保关闭面板时仍显示正确序号
  const tagRender = ({ value, label, closable, onClose }: any) => {
    const option = optionsRef.current.find(o => o.value === value);
    const index = selectedValuesRef.current.indexOf(value);

    return (
      <tag onmousedown="{e"> {
          e.preventDefault();
          e.stopPropagation();
        }}
        closable={closable}
        onClose={onClose}
        style={{ marginRight: 4 }}
      >
        {`${option?.label || label}-${index + 1}`}
      </tag>
    );
  };

  return (
    <select mode="multiple" allowclear style="{{" width: placeholder="请选择(序号反映选择顺序)" options="{renderOptions}" onchange="{handleChange}" tagrender="{tagRender}" label showsearch="{false}" filteroption="{false}"></select>
  );
};

export default OrderAwareMultiSelect;</option></string>
</option>

✅ 关键设计说明:

  • 性能保障:原始 optionsRef 不参与状态更新,renderOptions 仅做浅层 map 映射,无深层遍历或冗余对象创建;
  • 序号一致性:tagRender 与下拉 options 共享同一套序号逻辑,杜绝视觉错位;
  • 标签防误操作:onMouseDown.preventDefault() 阻止点击 Tag 时意外展开下拉框;
  • 序号鲁棒性:正则 /-\d+$/ 精准移除末尾序号,兼容 label 本身含连字符的场景(如 "User-Admin" → "User-Admin-1")。

⚠️ 注意事项:

  • 若原始 options 来自异步请求,请在数据就绪后一次性初始化 optionsRef,切勿在渲染中赋值;
  • 如需支持搜索(showSearch),需同步改造 filterOption 逻辑,使其基于 cleanLabel 匹配;
  • 对于超大数据集(>1000 项),建议结合虚拟滚动(如 rc-virtual-list)进一步优化。

该方案在保证交互直观性的同时,兼顾了性能与可维护性,是 Ant Design 多选序号化需求的生产就绪实践。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4966

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1229

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4884

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

960

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1876

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3505

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4553

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3000

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

948

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习