定义结果与责任人
本指南的可衡量目标是:发布四语言页面模板:正确 html lang、一个描述性 H1、无标题跳级,并为每个交互控件提供可见或可访问名称及有效错误帮助。
输入数据前先明确决策责任人、错误结果影响、停止条件与不得自动化的最终批准。不要把“运行成功”当标准,应设定用户任务、准确性、时间、可逆性与可解释性阈值。
- 发布四语言页面模板:正确 html lang、一个描述性 H1、无标题跳级,并为每个交互控件提供可见或可访问名称及有效错误帮助。
准备输入契约
在根元素设置文档语言,并在相应片段标记语言变化。标题从用户任务出发,H2 表示主要步骤,H3 表示子决策。使用 label 而非 placeholder,为图标按钮提供动作名称,并通过 aria-describedby 关联错误帮助。
仅从合成、自有或重用权明确的数据开始。分别记录字段、类型、单位、语言、时区、敏感级别、缺失值与重复规则,并把原始输入保存为只读样本。
用小步骤构建正常路径
把 aria-erisebilir-ad-envanteri、html-dil-baslik-yapisi-denetleyici、renk-kontrast-denetleyici、baslik-hiyerarsisi-denetleyici 排列为输入验证、转换、结果复核与交付门槛,而不是一个不透明大操作。每个门槛都应有预期输出、失败消息、继续规则与责任人。
先用一条记录或小样本测试。在把结果与来源核对、并把假设显示在结果旁之前,不要扩展到大文件、自动发布或真实个人数据。
主动测试失败路径
常见错误包括仅用颜色表达状态、移除焦点指示、重复 aria-label、隐藏名称与可见标签不一致,以及错误后焦点丢失。还应测试 200% 缩放、较长德语文案、中文换行与移动键盘打开时的溢出。
把空、损坏、超大、重复、乱序、跨语言与故意矛盾输入保留为负面测试。错误必须指出字段、原因与修正动作,不能静默修复。
验证用户与系统影响
在键盘操作、移动断点与受限设备上验证完整用户任务。核对来源与结果的数量、总计、标识、缺失值与变化字段。
视觉整洁不等于正确。重要主张应关联第一手证据,安全影响关联威胁模型,内容影响关联真实读者任务,性能影响关联浏览器测量。
记录发布证据
验收证据应把自动清单与纯键盘任务完成、焦点顺序、屏幕阅读器名称/状态、错误恢复及 320–1440 像素断点结合。自动发现与真实用户任务证据应分开报告。
记录日期、工具与数据版本、验收阈值、负面测试、结果摘要、已知风险、人工批准与回滚步骤。单独截图不具可重复性;应同时保留配置与样本。
说明边界与下次复核
静态 HTML 检查无法完整测量 CSS 可见性、Shadow DOM、水合后变化或辅助技术行为;不能凭单一工具结果宣称符合 WCAG。
让边界与结果同样醒目,并设定下次复核日期。涉及法律、安全、健康或财务影响时,应把合格专家依据最新一手来源的复核设为强制发布门槛。
- 静态 HTML 检查无法完整测量 CSS 可见性、Shadow DOM、水合后变化或辅助技术行为;不能凭单一工具结果宣称符合 WCAG。
把指南转化为安全试用流程
使用真实资料前,请先在ARIA 可访问名称清单中用合成数据试做《无障碍 HTML 发布:语言、标题、表单与可访问名称》的步骤。勾选状态只保留在当前标签页。
把指南转化为可重复的检查流程
请使用这套包含 4 个工具的检查计划来落实《无障碍 HTML 发布:语言、标题、表单与可访问名称》。目标:超越视觉整洁,通过真实任务验证语言、标题流程、控件名称、键盘操作与错误状态。 包含任务、失败场景、验收证据与信任边界的实践发布指南。 请先用安全示例代替真实数据,并记录每一步的预期结果与验收决定。
ARIA 可访问名称清单
- 准备
- 加载示例,或按清晰标注填写自己的场景。
- 执行
- 在设备端运行检查,并同时查看指标、警告与修正建议。
- 验收检查
- 在真实目标环境中验证结果,并记录所用假设。
- 预期输出
- 包含元素类型、选择器提示、名称来源以及无名称或可疑控件状态的清单. 盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件。
HTML 语言与标题结构审计器
- 准备
- 加载示例,或按清晰标注填写自己的场景。
- 执行
- 在设备端运行检查,并同时查看指标、警告与修正建议。
- 验收检查
- 在真实目标环境中验证结果,并记录所用假设。
- 预期输出
- 文档信号摘要、有序标题树,以及针对每个问题源元素的修正说明. 同时审计 HTML lang、title、meta 描述、单一 H1 与标题顺序。
颜色对比度检查器
- 准备
- 受支持的颜色、CSS、SVG、图像或尺寸值处理敏感真实数据前,请先用合成示例确认格式。
- 执行
- 运行设备端处理。使用浏览器 API 和公开的转换公式处理数值,同时保留源内容。
- 验收检查
- 验收检查:在浅色/深色背景、不同屏幕尺寸、目标应用及源内容之间进行视觉比较请保留源文件,并在目标应用中验证输出兼容性。
- 预期输出
- 可预览的视觉值、尺寸或格式摘要,以及可复制或下载的结果. 按 WCAG 对比度与文本阈值比较两种颜色。
标题层级检查器
- 准备
- 加载安全示例或输入自己的数据。
- 执行
- 在设备端运行并检查错误、警告与指标。
- 验收检查
- 在目标环境和边界案例中验证输出。
- 预期输出
- 编辑后的文本、变更摘要以及可量化的语言或结构指标. 查找 Markdown 标题跳级、重复与空标题。
ARIA 可访问名称清单适用以下边界:静态 HTML 清单无法完整观察 CSS 隐藏文本、Shadow DOM、运行时状态或屏幕阅读器行为,也不是 WCAG 合规报告。 如果未满足该条件,请勿把输出传递到工作流的下一步。
落实《无障碍 HTML 发布:语言、标题、表单与可访问名称》时,请记录工具名称、所选设置、浏览器版本,以及“表单发布前审计”的接受或拒绝理由,而不是敏感内容。这样既能重复检查,也不会复制真实数据。