脚本面板与关联索引

简介 #

模板写久了,最常见的两个问题是「代码太长找不到地方」和「不知道这块 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')与参数,省得手写

跳转定位 #

所有面板条目的跳转都做了两件事:

  1. 先展开覆盖目标行的折叠,保证目标一定可见
  2. 把目标行放到视口约 30% 的高度(而不是刚好贴在最下面一行),上下文一眼可见

从面板跳到事件处理函数后,约 0.6 秒内属性面板不会因为光标移动而切成脚本节点的属性,避免「刚跳过去面板就变了」。

EN