管理和排序列表

弹出窗口，让用户手工调整列表顺序，或添加、修改、删除项。动作里自动改列表用 列表操作。

当前模块定义​

概述​

运行时打开列表管理窗口，先在窗口中修改列表副本。点「完成」后才写回 列表 变量；取消或关闭窗口不写回。

管理界面​

添加：点右侧「添加」。

• 选中了某一项：新项加在它后面。
• 没有选中：加到末尾。
• 未指定自定义添加子程序且开启 解析菜单数据 时，添加会打开「编辑菜单项」窗口，可生成带图标的 菜单数据项。窗口里可以勾选「连续添加」。

编辑：选中后点「编辑」，或双击该项。

删除：选中后点「删除」。按 Ctrl 或 Shift 可多选。

排序：按住项拖到新位置。也可点右侧「A-Z」「Z-A」按字母序或倒序。

重置：恢复到打开窗口时的内容。

参数说明​

列表：要管理的列表变量。直接选变量，不要写表达式。

窗口标题：管理窗口的标题。

提示信息：显示给用户的说明。

允许添加项 / 允许编辑项 / 允许删除项：限制用户能做哪些操作。默认都开启。

取消后停止动作：点「取消」后是否中止后续步骤。默认关闭。

解析菜单数据：是否把 [fa:Solid_Pen:#FF0000]文字标题(提示文字内容)|值 当成菜单项。开启后列表显示图标和标题，未指定自定义子程序时使用「编辑菜单项」窗口。

关闭时按普通文本管理，未指定自定义子程序时使用文本框编辑。

分隔符：菜单项外观和值之间的分隔符，默认 |。

窗口宽度：可选。自定义窗口宽度，最小 200。旧稿未写。

显示内容提取表达式：可选。仅在 解析菜单数据 关闭时生效（1.42.34+）。列表项很长、但只有一部分是关键信息时，用表达式生成显示标题。写法接近 普通表达式，但：

• 不要以 $= 开头（加了会先被解析而出错）。
• 用 x 表示当前项，返回要显示的标题。例如路径列表只显示文件名：Path.GetFileName(x);

帮助按钮内容：Markdown。填写后窗口上出现「帮助」按钮。

用子程序自定义添加和编辑​

2.2.22 起，可在高级参数中填写 添加项子程序、编辑项子程序，用自己的子程序处理单项内容，例如打开多字段表单。两个参数可填写同一个子程序，也可分别设置；留空仍使用内置编辑器。对应的「允许添加项」或「允许编辑项」关闭时，不会调用子程序。

列表仍是文本列表。需要保存多个字段时，可将每项存为 JSON 文本，再用 显示内容提取表达式 生成便于阅读的标题。编辑子程序收到的是原始文本，不是显示标题。

子程序变量​

在子程序中声明以下变量，名称区分大小写，并勾选对应的输入、输出选项：

变量	类型	方向	用途
_item	文本	输入、输出	添加时为空串，编辑时为原始内容；确认后返回完整新内容
_index	数字	输入	从 0 开始的插入位置或当前项索引
_isNew	布尔	输入	添加为 true，编辑为 false
_confirmed	布尔	输出	true 才采用 _item；false 取消这一次添加或编辑

每次调用最多添加或替换一项。确认时允许返回空字符串；缺少必要输出、输出类型不正确或子程序运行失败时，窗口显示错误并保留原项。

示例：用表单编辑一项​

1. 创建「编辑配置」子程序，按上表声明变量。
2. 先把 _confirmed 设为 false；添加时准备空字段，编辑时解析 _item 中保存的 JSON。
3. 用 多字段表单编辑这些字段。取消表单则结束子程序；确认后把结果转换为 JSON 文本，写入 _item，最后把 _confirmed 设为 true。
4. 在本模块的「添加项子程序」「编辑项子程序」中填入「编辑配置」，关闭「解析菜单数据」。
5. 在列表窗口中添加、编辑和排序，点「完成」后再根据本模块的「是否确认」保存整份列表。

子程序打开多字段表单时，表单会关联到列表窗口。

子程序运行期间，列表的添加、编辑、删除、排序、重置和完成暂时不可用；仍可取消或关闭窗口。取消单项编辑会保留列表窗口；取消整个列表窗口会丢弃本轮列表修改。

输出​

• 是否确认：用户是否点了「完成」。

点「完成」后，列表修改写回原变量，没有单独的列表输出；取消不写回。

限制与排障​

列表 必须选变量，写表达式会无效。显示内容提取表达式里不要加 $=。取消时若未勾选 取消后停止动作，后续步骤仍会跑，且列表保持打开窗口前的内容。

相关链接​

列表操作在动作里自动增删排序，不弹窗。自定义右键菜单解析菜单数据时的项格式。用户选择只让用户选一项，不改列表本身。

更新内容​

• 2026-09-25（2.2.22）支持用子程序自定义添加和编辑列表项。
• 20240504 (1.42.34) 增加「显示内容提取表达式」和「取消后停止动作」。
• 20241023 修复错别字。