已收录

案例分享:WPS专用版—本地表格下拉列表多选手把手教学—已实测跑通(适用于WPS for Mac)上

懒得批爆
懒得批爆 WPS资深用户WPS产品体验官WPS寻令官Lv.2 潜力创作者

Lv.2潜力创作者

〇、这份教程和 VBA 版教程的关系

之前写过一篇《案例分享:别再羡慕在线表格了!本地表格也能实现下拉列表多选—手把手教学》,讲的是用 VBA 宏在本地表格里实现下拉多选。那套方案的适用边界:

  • ✅ Windows 版 Excel

  • ✅ Windows 版 WPS(装了 VBA 宏支持)

  • ✅ Mac 版 Excel

  • ❌ Mac 版 WPS(只有自家的 JS 宏引擎)

本篇是 WPS 专用版(JS 宏):效果与 VBA 版完全一致,代码换成 JavaScript,Mac 和 Windows 的 WPS 都能跑。本篇代码与成品工作簿已在 Mac 版 WPS 上实测通过(多选追加、重复去重、Delete 清空全部正常)。两篇教程相互独立,没看过 VBA 版的直接从第一章开始即可。本套方案适用于:

  • ❌ Windows 版 Excel

  • ✅ Windows 版 WPS(支持自家的 JS 宏引擎)

  • ❌ Mac 版 Excel

  • ✅ Mac 版 WPS(只有自家的 JS 宏引擎)

一、效果清单

  • 数据验证下拉框,每选一次新值自动追加到单元格,不覆盖;

  • 重复选已有项不重复追加;

  • 按 Delete 键清空后可重新选;

  • 只对设置了数据验证的单元格生效,其他格不受影响。

  • 实际呈现效果如下图:

二、三个先说清楚的认知(避开最大的坑)

这几个点决定了"为什么你照 VBA 教程做不出效果",先建立正确认知再动手:

认知 1:WPS 跑的是 JS 宏(JSA),不是 VBA。

Mac 版 WPS 打开【工具】→【WPS 宏编辑器】,看到的是深色标题栏的"WPS 宏编辑器"(不是 Microsoft Visual Basic)。这是 WPS 自家的 JS 宏引擎(JSA,JavaScript for Applications),语法是 JavaScript,API 仿照 VBA 设计,Mac / Windows 版 WPS 都原生自带,无需装插件。

认知 2:JSA 工程树里没有"工作表"节点。

VBA 编辑器的工程树里有 Sheet1、Sheet2 这些工作表节点,事件代码贴在工作表节点里;JSA 不是——它的工程树只有"代码(Module1、Module2……)"和"窗体"。你打开宏编辑器只看到 Module1 是完全正常的状态,别去找工作表节点。JSA 的事件统一写在模块里,靠函数名区分是哪一层的事件。

认知 3:JSA 里没有 Worksheet_Change 这个事件。

这是从 VBA 教程迁移时最隐蔽的坑:网上搜到的很多 JSA 代码照抄 VBA 的 Worksheet_Change,在 JSA 里它只是个普通函数、永远不会被触发,症状就是"代码贴了、保存了、下拉还是单选"。JSA 的工作表级事件叫 Workbook_SheetChange(Sh, Target),多出来的参数 Sh 是"发生改动的那张工作表",自动传入。函数名必须一字不差,JSA 靠名字识别事件,错一个字母就静默失效(不报错、不提示,就是没反应)。

三、从零搭建(Mac 版 WPS 实操五步)

第 1 步:准备选项来源 + 数据验证下拉

  1. 空白列(案例放在 C 列)竖着录入可选项,如 C3:C9:北京/上海/广州/成都/杭州/武汉/西安;

  1. 选中目标单元格区域(案例 B3:B7);

  1. 【数据】→【数据验证】→ 允许"序列"→ 来源框选 C3:C9 → 确定。

第 2 步:打开 WPS 宏编辑器,双击 Module1

【工具】→【WPS宏编辑器】(Option ⌥ + F11)→ 左侧工程树双击 Module1(任意模块都行),右侧打开代码区。

第 3 步:用"复制粘贴"放入代码(不要用"导入文件")

把第四章的完整代码复制,粘贴进 Module1 的代码区。

不要用宏编辑器的"导入文件"功能加载 .js 文件——实测会弹出红色叹号错误:"不是一个合法的对象名"。这不是代码文件的问题,是 WPS 导入功能不支持任意 .js 源码(它期望自家导出的宏模块格式)。复制粘贴方式没有任何限制,代码原样进去原样生效。

macOS 小提醒:用系统自带"文本编辑"打开 .js 文件时,先按 Shift+Cmd+T 切成纯文本模式再复制,避免富文本格式混入代码。

第 4 步:保存为 .xlsm

Cmd+S 保存,保持「启用宏的工作簿(.xlsm)」格式。JSA 宏就封装在文件内,随文件走,关掉重开依然生效。

第 5 步:验收

  1. B3 选"上海" → 显示 上海;

  1. 再选"北京" → 变成 上海, 北京;

  1. 再点一次"北京" → 不变;

  1. 按 Delete → 清空,重新选 → 从头累积。

任何一步不符合,跳到第五章排查。

四、JS 宏完整代码(已实测可用)

// ============================================================
// WPS JS 宏版 · 下拉列表多选(Mac / Windows 通用)
// 粘贴位置:WPS宏编辑器 → 双击 Module1(任意模块即可)→ 代码区
//
// 重要说明:
// WPS 的 JSA 工程树里没有"工作表"节点(只有模块和窗体),
// 所以事件必须写成模块里的 Workbook_SheetChange 函数。
// 参数 Sh = 发生改动的那张工作表,自动传入,无需指定表名。
// 函数名必须一字不差,写错事件就不会触发。
// ============================================================

function Workbook_SheetChange(Sh, Target) {
    const delimiter = ", ";   // 分隔符,想改顿号就改成 "、"

    // 一次改动涉及多个单元格(批量删除等)不处理
    if (Target.Count > 1) { return; }

    // 只对设置了数据验证(下拉列表)的单元格生效
    if (Target.SpecialCells(xlCellTypeAllValidation) == null) { return; }

    // 关事件,防止代码写回单元格再次触发本事件造成死循环
    Application.EnableEvents = false;

    try {
        // 用户本次操作后的新值(可能为 null 或空串 = 用户想清空)
        let newValue = Target.Value();
        if (newValue == null) { newValue = ""; }

        // 撤销本次写入,拿到旧的多选内容
        Application.Undo();
        let oldValue = Target.Value();
        if (oldValue == null) { oldValue = ""; }

        if (newValue === "") {
            // 新值为空 → 直接清空,Delete 键有效
            Target.Value2 = "";
        } else if ((delimiter + oldValue + delimiter).indexOf(delimiter + newValue + delimiter) === -1) {
            // 头尾包裹分隔符判断重复,未重复则追加
            Target.Value2 = (oldValue === "") ? newValue : oldValue + delimiter + newValue;
        } else {
            // 已存在 → 保持旧值,等于没选
            Target.Value2 = oldValue;
        }
    } finally {
        // 无论是否出错,事件开关必须恢复
        Application.EnableEvents = true;
    }
}

代码逻辑简说(对照注释读):

  • 用户在下拉选了新值 → 单元格内容改变 → Workbook_SheetChange 被触发;

  • 先读新值,再 Application.Undo() 撤销这次写入、拿回旧值;

  • 新值为空(用户按 Delete)→ 直接写回空,实现清空;

  • 新值不在旧值里(头尾包裹分隔符精确匹配)→ 写回"旧值 + 分隔符 + 新值",实现追加;

  • 新值已存在 → 保持旧值,重复选等于没选;

  • 全程包在 try...finally 里,无论是否出错,结束时都把 EnableEvents 恢复为 true,事件永不"卡死"。

五、故障排查(贴完代码没反应时看这里)



本文字数较多,一帖放不下,请移步查看>>>>>https://bbs.wps.cn/topic/101767

浏览 302
1
9
分享
9 +1
1 +1
全部评论