Skip to Content
文档参考与设置FillIn 变量

FillIn 模板变量

FillIn 是 CodeExpander 的「展开时弹窗填空」能力:在片段中插入 FillIn 变量(如 %filltext%%fillarea%),触发展开时先弹出表单填写,再替换为最终内容。适合提示词、邮件模板、带参数的代码块。

文档目录 · 参考


模板变量类型

1. %filltext% - 单行文本输入

格式

%filltext&name=变量名&default=默认值&width=宽度%

参数

参数必填说明
name变量唯一标识
default默认值
width输入框宽度 (px),默认 100

示例

Hello, %filltext&name=username&default=World&width=150%!

2. %fillarea% - 多行文本输入

格式

%fillarea&name=变量名&default=默认值&width=宽度&rows=行数%

参数name 必填;defaultwidthrows(默认 2)可选。

示例

描述: %fillarea&name=description&default="请输入描述"&width=300&rows=5%

3. %fillnote% - 注释 (不输出)

格式%fillnote&name=变量名&default=注释内容&width=宽度%
说明:注释变量仅在编辑时显示,最终输出时会被移除。


4. %fillcheck% - 复选框

格式

%fillcheck&name=变量名&default=选中时的值&isCheck=0或1&width=宽度%

示例

%fillcheck&name=urgent&default=[紧急]&isCheck=0% 请处理此事项
  • 选中时:[紧急] 请处理此事项
  • 未选中时:请处理此事项

5. %fillmenu% - 下拉菜单

格式

%fillmenu&name=变量名&default=默认选项&opt=选项1&opt=选项2&opt=选项3&isCheck=0或1&info=前缀文本&width=宽度%

参数nameopt(可多个)必填;defaultisCheckinfowidth 可选。

示例

优先级:%fillmenu&name=priority&default=中&opt=高&opt=中&opt=低&width=80%

日期变量 %date%

格式

%date&format=格式&lang=语言&calc=偏移天数%

常用格式

格式示例输出
YYYY-MM-DD2025-12-31
YY-M-D25-12-31
HH:mm:ss14:30:00
L / LL / LLL / LLLL本地化日期时间

示例

今天是 %date&format=LL&lang=zh-cn% 明天是 %date&format=LL&lang=zh-cn&calc=1%

键盘快捷键 %clavier%

格式%clavier&key=按键&modifier=修饰键%
预设%clavier&key=Enter%%clavier&key=Escape%%clavier&key=Tab%
自定义%clavier&key=V&modifier=command%(Cmd+V)


功能变量

变量说明
%c%光标位置 - 展开后光标停留在此处
%cv%剪贴板内容 - 插入当前剪贴板文本
%s:abbr%嵌套片段 - 插入指定缩写的片段内容

示例

function %filltext&name=funcName&default=myFunction%() { %c% }

FillIn 窗口交互

触发流程

用户输入缩写 → 检测到 FillIn 变量 → 弹出表单窗口 → 用户填写 → 替换变量 → 输出结果

快捷键

快捷键作用
Cmd/Ctrl + Enter确认并插入
Enter / Tab跳转下一个输入框

支持的内容类型

类型说明
plain纯文本
rich富文本 (HTML)
shellShell 脚本 (执行后输出结果)
jsJavaScript (执行后输出结果)
pythonPython (执行后输出结果)
applescriptAppleScript (macOS)
powershellPowerShell (Windows)