禁用指令
有些代码必须保持原样,例如第三方代码片段或有意保留的旧顺序。可以用注释让 annealer 跳过这些代码。
规则
- 仅限块注释。 不支持
//,因为 CSS 没有行注释。 annealer-disable覆盖其后的所有内容,直到annealer-enable或文档末尾。在文档开头使用时,文件保持不变。annealer-disable-next-line覆盖从下一行开始的结构:- 一个起始标签(整个标签,即使跨越多行,以及
<style>元素的内容),或 - 一条 CSS 语句(一条声明或一整条规则)。
- 一个起始标签(整个标签,即使跨越多行,以及
:之后的原因是可选的,annealer 会忽略它。- 被覆盖的代码会逐字保留并留在原位。 在样式表中,即使相邻声明被排序,被覆盖的声明也保持在原处。
- 作用范围: 标记注释作用于标记(以及整个
<style>元素)。CSS 注释作用于其所在的样式表内部。 - 未知指令会报错。 以
annealer-开头但不是已知指令的注释(例如拼写错误annealer-disabel)会使运行失败,而不是被忽略。
实现说明(样式表)
被覆盖的声明会保留在原位,并结束周围声明的排序连续段,因此没有任何内容会跨越它移动。被覆盖的规则(包括嵌套块)会原样保留。annealer 不使用 malva 自带的忽略注释(malva-ignore),因为它不接受 : reason 形式。