HTML 格式化工具:设置易读的排版,再检查源码变化
Admin ·
HTML 格式化工具把紧凑的标记整理成更容易检查的源代码。ToolMellow 使用 Prettier 的 HTML 解析器,提供缩进、建议行宽和每行一个属性选项。粘贴片段或导入本地文本文件,再点「格式化 HTML」,生成独立的「结果」。
把结果放入网页或模板之前,请先检查改动。格式化可能改变引号、标签布局和闭合标记;它不会净化 HTML、证明文档符合标准,也不会展示浏览器渲染效果。下面说明各选项的作用,以及怎样保留完整输出。
格式化整个输入,再检查结果
想比较选项时,可以先用「试用示例」载入一小段标记。处理自己的源码时,粘贴到「输入」或选择本地文件。「格式化 HTML」始终处理整个输入,选中一部分不会缩小处理范围。
格式化成功后,原输入不变,排版后的文字放入只读的「结果」。编辑输入或更改格式选项会清除旧结果;需要再次运行才能生成新结果。这样可避免复制属于旧版本的输出。
- 编辑或替换源码前,保留原文件副本。
- 选择两个或四个空格作为缩进。
- 把建议行宽设在 40 到 200 之间。
- 需要展开多属性标签时,启用「每行一个属性」。
- 运行「格式化 HTML」,检查标记改动及错误信息。
- 复制或下载完整结果;结果符合输入限制时,也可以将它用作输入。
哪些设置可以调整?
可见控件只开放了少量 Prettier 选项。空白敏感度和内嵌语言格式化在这里采用固定设置,没有额外开关可切换空白模式,或启用 script、style 内容的独立格式化。
同一个排版选项,遇到不同标记可能产生不同布局。长属性值仍可能超过建议行宽;即使启用了属性换行,只有一个属性的标签也可能保持在一行。
| 设置 | 本工具的值 | 含义 |
|---|---|---|
| 解析器 | html | 把整个输入作为 HTML 源码格式化。 |
| 缩进 | 2 或 4 个空格 | 设置每级缩进的宽度。 |
| 建议行宽 | 40–200;默认 80 | 引导换行,但不强制每行都小于该值。 |
| 每行一个属性 | 可选 | 对适用的多属性标签请求属性分行。 |
| 空白敏感度 | strict | 排版时把标签周围的空白视为有意义的内容。 |
| 内嵌语言格式化 | off | 不单独美化 HTML 内的 JavaScript 或 CSS。 |
| 自动换行 | 显示选项 | 改变文本框的折行显示,不改写源码。 |
| 结果 | 只读 | 只有新的格式化成功后,才接收输出。 |
为嵌套层级选择两个或四个空格
两个空格能让深层嵌套相对紧凑,四个空格则更突出层级。尽量遵循项目已有的约定,避免粘贴格式化片段时引入不必要的风格变化。
缩进是排版偏好,不能修复缺失元素或损坏的属性。严格空白处理可能让某些行内内容保持在一起,也可能把结束尖括号移到另一行。这些布局本身不表示缩进选项失效。
把行宽当作排版偏好
建议行宽接受 40 到 200,初始值为 80。较小的值倾向于生成短行,较大的值允许更多标记保持在一起。Prettier 的打印宽度是易读布局的目标,不是每一行都必须遵守的硬性上限。
例如,一个长达 250 个字符的属性值仍可能让某行超过设为 40 的行宽。格式化器不会仅为凑足列数而把该值拆开。请检查结果中的长 URL、模板表达式和其他不可拆分的文字。
| 场景 | 可尝试的设置 | 取舍 |
|---|---|---|
| 较窄的检查窗口 | 试用 40 | 在排版器能够引入换行的位置,可能出现更多换行。 |
| 一般编辑 | 从 80 开始 | 适中的建议宽度。 |
| 较宽的编辑器 | 试用 120 | 更多标签和属性可能保留在一起。 |
| 很宽的源码视图 | 最高 200 | 由行宽引起的换行可能更少,仍取决于标记。 |
| 很长的属性值 | 任意支持的行宽 | 属性值仍可能超过建议值。 |
| 已启用每行一个属性 | 结合所需的建议行宽 | 属性布局也会影响结果。 |
按需把属性分到不同行
启用「每行一个属性」,可以更方便地逐项检查适用的多属性标签,例如名称、无障碍属性或较长的数据属性。这是属性布局偏好,不要求每个开始标签都展开成多行。
只有一个属性的 <img src="x">,仍可能格式化为同一行的 <img src="x" />。特殊语法结构也可能遵循自己的排版规则。把这种布局用于整个模板前,先检查实际结果。
为什么有些标签和尖括号在意外的位置换行?
本工具把 HTML 空白敏感度固定为 strict。行内标签旁的空白会影响文字,因此排版器可能让 <p>Hello <strong>world</strong>!</p> 这样的内容保持在一起。其他布局中,结束尖括号也可能与标签名称分处两行。
严格处理不承诺逐字节保留空白,也不保证所有输入的渲染效果完全一致。特别是 pre 和 textarea 内容周围的布局也可能改变。请检查对空白敏感的文字,并在实际网页或模板环境中测试。
HTML 内的 JavaScript 和 CSS 不单独格式化
内嵌语言格式化固定为 off。const x={a:1,b:2}; 这样的脚本内容,或 .x{color:red;padding:0} 这样的样式内容,不会经过独立的 JavaScript 或 CSS 美化步骤。界面没有启用该步骤的开关。
HTML 排版器仍可能移动周围标签、缩进和换行,也可能改变这些代码内容周围的布局。因此,关闭内嵌格式化不等于整个脚本或样式区域逐字节不变。替换原文件前,检查内嵌代码和模板分隔符。
需要检查的不只是新增缩进
HTML 美化工具会解析并重新输出标记,改动可能超出行首空格。下表描述的是特定输入下已观察到的输出,不承诺每个格式不完整的文档都会被接受,或按同样方式补齐。
处理生成的标记、HTML 邮件或模板语言时,应有意识地比较源码差异。格式化不能代替项目测试,也不能代替在目标浏览器和模板引擎中检查结果。
| 输入特征 | 观察到的变化 | 需要检查 |
|---|---|---|
| 未加引号或使用单引号的属性 | 属性引号可能变成双引号。 | 检查引号及模板表达式。 |
空元素,例如 <input disabled> | 输出可能加入闭合斜杠。 | 检查接收系统要求的语法。 |
<div>hello 缺少结束标签 | 输出可能加入 </div>。 | 解析成功不等于完整的有效性检查。 |
| CRLF 行尾 | 格式化输出使用 LF。 | 在差异中检查行尾变化。 |
| 行内文字和标签 | 内容可能保持在同一行。 | 避免加入会改变文字的空格。 |
阅读解析错误,但别把成功当作完整校验
解析器拒绝源码时,工作区会显示本地化的错误概述和引擎原始详情,详情中可能含行号和列号。用该位置检查附近源码;原因也可能始于报告位置之前。修改「输入」后,再运行「格式化 HTML」。
解析器也可能接受省略或缺失结束标签的标记,并输出推断出的闭合标记。因此成功不证明 HTML 符合规范、具备无障碍性、内容安全或模板行为正确。这里没有独立校验报告或渲染预览。
分清输入、文件和历史记录的限制
文字限制按 UTF-16 代码单元计算,与文件字节数、可见字符数不同。基本拉丁字母占一个单元,🌿 这样的辅助平面字符占两个,显示为一个表情的序列可能包含多个码点。本地文件必须同时通过字节检查和解码后的文字检查。
格式化可能让输出超过输入上限。完整结果仍可复制和下载,但「将结果用作输入」会拒绝过大的结果,并保留已有输入与结果。下表把这些限制与查找、历史记录限制分开列出。
| 项目 | 限制 | 边界行为 |
|---|---|---|
| 粘贴或处理的输入 | 1,000,000 个 UTF-16 代码单元 | 恰好达到上限可以接受,更长的文字会被拒绝。 |
| 本地文件 | 严格小于 4,000,000 字节 | 恰好达到该字节数的文件会在读取前被拒绝。 |
| 解码后的文件文字 | 1,000,000 个 UTF-16 代码单元 | UTF-8 解码后仍须符合输入上限。 |
| 将结果用作输入 | 1,000,000 个 UTF-16 代码单元 | 过大的输出不会插入,但完整结果仍可导出。 |
| 查找文本 | 1,000 个 UTF-16 代码单元 | 输入中的原文查找有长度限制。 |
| 替换文字 | 10,000 个 UTF-16 代码单元 | 导致输入超过上限的替换会被拒绝。 |
| 撤销和重做历史 | 最多 20 个较早快照 | 记录已接受的输入变化,不单独记录格式化结果。 |
| 合计历史文字 | 4,000,000 个 UTF-16 代码单元 | 不包括当前输入;较早保存的状态受限。 |
以 UTF-8 文字导入本地 HTML
选择本地 HTML 或文本文件,把源码载入「输入」。工作区先检查文件大小,再用文件的文字读取方法按 UTF-8 解码,然后检查解码后的长度。这里没有编码选择器,修改文件名或 MIME 类型不会切换解码方式。
这是文本文件导入,不会从 URL 抓取页面、从 PDF 或 Word 提取 HTML,也不会打开关联脚本、样式或图片。如果文件采用其他编码而显示乱码,请先用合适的编辑器转为 UTF-8,再导入。
复制或下载完整的 HTML 结果
复制和下载使用整个「结果」,不限于当前选区或编辑器可见部分。下载会生成名为 toolmellow-result.html 的 UTF-8 文本文件,里面是格式化后的源码,不是截图或页面依赖打包文件。
请同时保留该源码所需的资源和构建步骤。下载文件不包含外部样式表、图片或脚本。发布之前先检查并测试标记,尤其是原始内容来自不可信来源时。
只有符合上限的输出才能重新作为输入
「将结果用作输入」会用符合文字上限的成功结果替换输入,便于继续编辑。单独生成「结果」不会改写输入。若还需要原文,请先保存,或在替换被接受后使用尚可用的输入历史。
如果输入恰好是一百万个普通字母,末尾新增一个换行便可能生成 1,000,001 个输出单元。它仍可完整复制或下载,但不能重新放回输入。拒绝复用不表示结果已被截断。
查找、折行、历史和清空作用不同
查找替换针对「输入」中的原文,可选择区分大小写。它不使用正则表达式,也不理解 HTML 节点和属性。$& 这样的替换文字会原样插入;修改重复标记前,先检查匹配。已接受的编辑会清除旧结果。
「自动换行」只改变输入和结果文本框显示长行的方式,不会在复制或下载的源码里新增换行。即使界面语言从右向左书写,HTML 源码仍保持从左向右。
撤销和重做记录已接受的输入编辑、导入、替换和结果复用,受历史上限约束。它们不撤销单独生成结果这个动作。「清空」会删除输入、结果、历史与查找状态,但保留格式选项和自动换行偏好,且不能撤销。
本地格式化仍需要载入处理引擎
格式化在浏览器工作线程中运行。输入和输出是文字,不会作为网页挂载,因此不会运行粘贴的脚本或加载粘贴的图片 URL。这种隔离不会把源码净化成可安全发布的内容。工作线程和格式化资源载入时可能需要网络,本地处理本身不保证离线可用。
如果引擎未能载入,请保留输入,在网络恢复后重新运行。「取消」可以终止待完成任务并保留输入。启动和处理设有 60 秒的时限,但实际完成时间取决于浏览器和源码。已取消或过时的工作不能当作新的结果。
常见问题
格式化 HTML 会净化内容吗?
不会。工作区把源码作为文字输出,不执行它,但不会移除危险内容或让结果自动适合发布。请在实际使用源码的位置采用适当的净化和安全措施。
建议行宽是硬性上限吗?
不是。支持 40–200 的偏好值,默认 80。长属性值和其他不可拆分内容可能超过所选宽度。
能修复不合法的 HTML 吗?
对某些可接受的输入,它可能补上推断的闭合标记;其他输入则会报解析错误。这不是通用修复工具或 HTML 合规校验器,请检查结果并在目标环境测试。
为什么行内 HTML 标签保持在一起?
空白敏感度固定为 strict。排版器重视标签周围的空白,可能保留行内文字,也可能把结束尖括号移到另一行。请检查对空白敏感的内容,不要假定每个标签都应独占一行。
HTML 内的 JavaScript 和 CSS 会重新格式化吗?
不会进行独立的内嵌 JavaScript 或 CSS 格式化,也没有启用它的开关。HTML 排版仍会改变周围的缩进和行布局,因此不保证内嵌区域逐字节不变。
最多能粘贴或导入多少 HTML?
输入最多 1,000,000 个 UTF-16 代码单元。本地文件必须严格小于 4,000,000 字节,且其 UTF-8 解码后的文字也要符合输入上限。字节、代码单元和可见字符是不同计量。
能只格式化选中的 HTML 吗?
不能。「格式化 HTML」处理整个输入,选区不会缩小范围。若只想整理某个片段,请把该片段单独放入输入。
格式化和清空能撤销吗?
格式化会生成独立结果,并保留输入。撤销和重做只用于可用历史中的已接受输入变化。「清空」删除输入、结果、查找和历史,不能撤销。
这里有实时 HTML 预览吗?
没有。输入和结果都是源码编辑器,工具不会把粘贴的标记渲染成页面、抓取关联资源或展示实时浏览器预览。
启用属性换行后,为什么标签仍在一行?
「每行一个属性」用于适用的多属性布局。只有一个属性的标签可能保持一行,特殊结构也可能有自己的排版规则。
自动换行会改变下载的 HTML 吗?
不会。它是文本框的显示偏好。下载始终包含完整格式化结果及实际源码换行,不取决于屏幕上的折行方式。
能导入 URL、PDF 或 Word 文档吗?
这里只接受本地文本文件内容,不会从 URL 获取 HTML,或从 PDF、Word 文件提取文档内容。
为什么结果可以下载,却大到不能用作输入?
格式化可能让文字超过输入上限。复制与下载仍保留完整结果,但放回输入会超过其 1,000,000 单元限制,因此被拒绝,结果本身不会被丢弃。
可以压缩 HTML 吗?
这里没有 HTML 压缩操作。「格式化 HTML」根据设置输出易读源码,不提供压缩模式,也不保证结果更小。