简介 #
模板写久了,最常见的两个问题是「代码太长找不到地方」和「不知道这块 HTML 是脚本里哪段生成的」。编辑器为此提供了三样东西:按类型折叠的视图、左侧「脚本」面板、属性面板里的「关联脚本」。
这些都是只读的索引:面板只负责告诉你「在哪一行」,不会替你改写代码。唯一会写源码的动作是「+ 刷新语句」。
按类型折叠:全部 / HTML / CSS / JS #
顶栏中间的视图切换只改变「显示」,不改变内容:
| 视图 | 效果 |
|---|---|
| 全部 | 正常显示 |
| HTML | 每个 <script> 块折叠成一行占位(显示 script · N 行 · 第 M 行) |
| CSS | 只留 <style> 块 |
| JS | 脚本之外的部分折叠成一行(显示 HTML · 第 A-B 行) |
使用要点:
- 折叠只作用在单行以上的块,单行块不折
- 折叠标记是编辑器自己打的,只回收自己的标记,不会破坏你手工折叠的状态
- 保存后、切视图后、按
Ctrl/⌘ + Shift + F时会重新套用;正在打字时不会重排 - 从面板点击跳转时,会自动展开覆盖目标行的折叠
左侧「脚本」面板 #
左侧栏第三个页签,顶部可以按「函数 / 序号 / 元素」过滤,右边「刷新」重新扫描。面板分三节:
1. 脚本块 #
按 <script> 块列出里面的条目,点任意一行跳到源码对应位置:
| 条目类型 | 说明 |
|---|---|
| 函数 | 函数声明、函数表达式、箭头函数,显示 函数名() |
| 取数 | ds_refresh / ds_get 等取数调用,右侧标注 #序号 图形名,一眼看出在拉哪个图形的数据 |
| 选择器 | getElementById / querySelector / jQuery / container_N 等 |
| 写入 | .html(...) / .innerHTML = / .className = 一类往元素里写内容 |
| 事件 | .on / .bind / .delegate / addEventListener 以及 onclick= 上的处理函数,显示 处理函数 → 函数名 |
识别时会先把注释替换成等长空格,所以注释里的内容不会被误报,脚本里字符串拼出来的 id / class 也能被找到。
2. 公共参数 #
列出脚本里所有 ds_setParam 设置的键。这些键会作为所有 ds_refresh 的取数参数(filter_param)一起提交,排查「为什么取数带了不该带的参数」时看这里。
3. 事件绑定 #
把 HTML 上的事件属性整理成一张 元素 → 事件="调用" 的表:
- 点行跳到函数定义所在行(不是 HTML 属性行),
onclick="return fn(this)"这类非函数打头的写法也能识别 - 右侧「属性」跳到 HTML 上的那一行
- 处理函数不在本模板的
<script>里时,会明确提示
属性面板的「关联脚本」 #
选中元素后,属性面板底部会多出「关联脚本」一节,按四种关系反查脚本里对它的引用:
| 关系 | 含义 |
|---|---|
| 生成 | 脚本里用字符串拼出了这个元素的 id / class(通常说明这个元素本身是 JS 渲染出来的) |
| 选择器 | $('#id')、document.getElementById('id')、container_N 等选择 |
| 写入 | .html()、.innerHTML =、.className =、setAttribute('id', ...) 等写入 |
| 事件 | .on('click', fn)、.addEventListener(...)、HTML 上的 onclick 等 |
每行都会给出行号,并标出它落在哪个函数里(例如「在 initChart() 内」),点击即跳转。
其他细节:
- 元素自身没有 id / class 时,会向上找最近一个在脚本里被引用的父元素,标题变成「由 div.row 的脚本渲染」
- 找得到就显示处数,找不到会直接说明「脚本里没有引用 …,可能是模板/后端渲染的」
- 模板引了外部
<script src>时,会提示「内容不在本模板,这里搜不到」,避免误判 - 面板右上角的「+ 刷新语句」会弹窗帮你插入
ds_refresh(...):可选序号、取数方式(默认异步 / 同步返回 0 /'list'/'map')与参数,省得手写
跳转定位 #
所有面板条目的跳转都做了两件事:
- 先展开覆盖目标行的折叠,保证目标一定可见
- 把目标行放到视口约 30% 的高度(而不是刚好贴在最下面一行),上下文一眼可见
从面板跳到事件处理函数后,约 0.6 秒内属性面板不会因为光标移动而切成脚本节点的属性,避免「刚跳过去面板就变了」。