#快速开始

annealer 有三个入口，共用同一个 Rust 核心：

• anyl：命令行工具。
• annealer（npm）：基于 WebAssembly 的 JavaScript API。
• annealer（Rust crate）：纯函数 format()。

#CLI

从仓库构建 CLI（npm 包和 crate 尚未发布）：

cargo install --path crates/annealer

然后格式化文件：

anyl src/App.vue                 # 输出结果
anyl --write src/**/*.vue        # 直接覆盖
anyl --check index.html          # 有文件会被修改时以 1 退出
anyl --profile my-profile.yaml page.html

支持的输入：.html、.htm、.vue、.css、.scss、.sass、.less。语言由扩展名判断，除非指定 --profile，否则每种语言使用对应的内置配置文件。所有选项参见 CLI。

#JavaScript

import { format } from 'annealer';

format('<a title="Home" href="/" id="home">Home</a>');
// => '<a id="home" title="Home" href="/">Home</a>'

format(source, { language: 'vue' });
format(source, { language: 'html', profile: yamlText });

format() 是同步的。WebAssembly 二进制文件已内嵌在包中，因此无需配置加载器或打包工具。参见 JavaScript API。

#示例

输入：

<nav aria-label="Main" class="nav" id="nav">
  <a href="/docs" class="nav__link" aria-current="page">Docs</a>
</nav>
<input
  required
  placeholder="[email protected]"
  name="email"
  type="email"
  id="email"
  class="form__input"
  aria-describedby="email-help"
/>

使用 html 配置文件的输出：

<nav id="nav" class="nav" aria-label="Main">
  <a class="nav__link" href="/docs" aria-current="page">Docs</a>
</nav>
<input
  id="email"
  class="form__input"
  placeholder="[email protected]"
  type="email"
  name="email"
  required
  aria-describedby="email-help"
/>

• id 和 class 排在最前，然后是补充（placeholder）、语义（type）、键值（name）和状态（required）属性，最后是 ARIA。
• 多行标签每行一个属性，结束括号单独占一行。
• 空元素 <input> 变为 <input />。

#配置文件

内置两个配置文件：

如需自定义，可以从内置配置文件开始（JavaScript 中使用 builtinProfile('vue')，或参考 crates/annealer/profiles/*.yaml），然后通过 --profile 或 profile 选项传入 YAML。参见配置文件参考。