For AI agents: the complete documentation index is available at /annealer/zh/llms.txt, the full documentation bundle is available at /annealer/zh/llms-full.txt, and this page is available as Markdown at /annealer/zh/guide/features/disable-directives.md.
  • 简体中文
  • 禁用指令

    有些代码必须保持原样,例如第三方代码片段或有意保留的旧顺序。可以用注释让 annealer 跳过这些代码。

    <!-- annealer-disable -->
    <!-- annealer-enable -->
    <!-- annealer-disable-next-line: [reason] -->
    /* annealer-disable */
    /* annealer-enable */
    /* annealer-disable-next-line: [reason] */

    规则

    • 仅限块注释。 不支持 //,因为 CSS 没有行注释。
    • annealer-disable 覆盖其后的所有内容,直到 annealer-enable 或文档末尾。在文档开头使用时,文件保持不变。
    • annealer-disable-next-line 覆盖从下一行开始的结构:
      • 一个起始标签(整个标签,即使跨越多行,以及 <style> 元素的内容),或
      • 一条 CSS 语句(一条声明或一整条规则)。
    • : 之后的原因是可选的,annealer 会忽略它。
    • 被覆盖的代码会逐字保留并留在原位。 在样式表中,即使相邻声明被排序,被覆盖的声明也保持在原处。
    • 作用范围: 标记注释作用于标记(以及整个 <style> 元素)。CSS 注释作用于其所在的样式表内部。
    • 未知指令会报错。 以 annealer- 开头但不是已知指令的注释(例如拼写错误 annealer-disabel)会使运行失败,而不是被忽略。
    <!-- annealer-disable-next-line: copied from the vendor's docs -->
    <a href="/" id="vendor-link">Kept as written</a>
    <a href="/" id="home">Reordered</a>

    实现说明(样式表)

    被覆盖的声明会保留在原位,并结束周围声明的排序连续段,因此没有任何内容会跨越它移动。被覆盖的规则(包括嵌套块)会原样保留。annealer 不使用 malva 自带的忽略注释(malva-ignore),因为它不接受 : reason 形式。