把指南转化为安全试用流程
在使用真实数据前,请先用合成示例完成这些步骤。勾选状态只保留在当前标签页。
定义结果与责任人
本指南的可衡量目标是:发布四语言页面模板:正确 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。
把指南转化为可重复的检查流程
请使用这套包含 4 个工具的检查计划来落实《无障碍 HTML 发布:语言、标题、表单与可访问名称》。目标:超越视觉整洁,通过真实任务验证语言、标题流程、控件名称、键盘操作与错误状态。 包含任务、失败场景、验收证据与信任边界的实践发布指南。 请先用安全示例代替真实数据,并记录每一步的预期结果与验收决定。
ARIA 可访问名称清单
- 准备
- ARIA 可访问名称清单的输入应为包含按钮、链接、图片与表单控件且无需执行脚本的 HTML 片段。本次处理目标是:盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件。处理敏感真实数据前,请先用合成示例确认格式。
- 执行
- 运行设备端处理。ARIA 可访问名称清单为实现“盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件”采用以下可解释方法:HTML 由 DOMParser 作为惰性文档解析,并按可访问名称优先级检查可见文本、label 关联、aria-labelledby、aria-label、alt 与 title。
- 验收检查
- 验收检查:接受ARIA 可访问名称清单的结果前,请完成使用键盘聚焦每个交互元素,并在真实屏幕阅读器与无障碍树中核对名称、角色、状态和错误信息;核验证据应与“盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件”这一目标一致。ARIA 可访问名称清单的使用边界:静态 HTML 清单无法完整观察 CSS 隐藏文本、Shadow DOM、运行时状态或屏幕阅读器行为,也不是 WCAG 合规报告。
- 预期输出
- ARIA 可访问名称清单完成后会提供包含元素类型、选择器提示、名称来源以及无名称或可疑控件状态的清单,并围绕“盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件”组织结果。. 盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件。
HTML 语言与标题结构审计器
- 准备
- HTML 语言与标题结构审计器的输入应为包含 html lang、title、meta description 与可见 h1-h6 结构的完整或局部 HTML。本次处理目标是:同时审计 HTML lang、title、meta 描述、单一 H1 与标题顺序。处理敏感真实数据前,请先用合成示例确认格式。
- 执行
- 运行设备端处理。HTML 语言与标题结构审计器为实现“同时审计 HTML lang、title、meta 描述、单一 H1 与标题顺序”采用以下可解释方法:内容在不执行的情况下解析,分别报告语言标签、标题和描述是否存在、H1 数量、空标题与层级跳跃。
- 验收检查
- 验收检查:接受HTML 语言与标题结构审计器的结果前,请完成在真实 URL 上检查源代码与渲染 DOM,确认只有一个聚焦任务的 H1,且标题顺序遵循内容结构;核验证据应与“同时审计 HTML lang、title、meta 描述、单一 H1 与标题顺序”这一目标一致。HTML 语言与标题结构审计器的使用边界:标题长度或层级信号不能保证排名、内容质量或屏幕阅读器兼容性;页面真实语言、目的与用户任务仍需人工判断。
- 预期输出
- HTML 语言与标题结构审计器完成后会提供文档信号摘要、有序标题树,以及针对每个问题源元素的修正说明,并围绕“同时审计 HTML lang、title、meta 描述、单一 H1 与标题顺序”组织结果。. 同时审计 HTML lang、title、meta 描述、单一 H1 与标题顺序。
颜色对比度检查器
- 准备
- 颜色对比度检查器的输入应为受支持的颜色、CSS、SVG、图像或尺寸值。本次处理目标是:按 WCAG 对比度与文本阈值比较两种颜色。处理敏感真实数据前,请先用合成示例确认格式。
- 执行
- 运行设备端处理。颜色对比度检查器为实现“按 WCAG 对比度与文本阈值比较两种颜色”采用以下可解释方法:使用浏览器 API 和公开的转换公式处理数值,同时保留源内容。
- 验收检查
- 验收检查:接受颜色对比度检查器的结果前,请完成在浅色/深色背景、不同屏幕尺寸、目标应用及源内容之间进行视觉比较;核验证据应与“按 WCAG 对比度与文本阈值比较两种颜色”这一目标一致。颜色对比度检查器的使用边界:请保留源文件,并在目标应用中验证输出兼容性。
- 预期输出
- 颜色对比度检查器完成后会提供可预览的视觉值、尺寸或格式摘要,以及可复制或下载的结果,并围绕“按 WCAG 对比度与文本阈值比较两种颜色”组织结果。. 按 WCAG 对比度与文本阈值比较两种颜色。
标题层级检查器
- 准备
- 标题层级检查器的输入应为在保留用途和目标语言的前提下需要编辑或比较的纯文本。本次处理目标是:查找 Markdown 标题跳级、重复与空标题。处理敏感真实数据前,请先用合成示例确认格式。
- 执行
- 运行设备端处理。标题层级检查器为实现“查找 Markdown 标题跳级、重复与空标题”采用以下可解释方法:在保留 Unicode、行和词边界的同时应用确定性文本规则。
- 验收检查
- 验收检查:接受标题层级检查器的结果前,请完成对可能改变语义的句子、专有名词、数字、标点和多语言字符进行前后比较;核验证据应与“查找 Markdown 标题跳级、重复与空标题”这一目标一致。标题层级检查器的使用边界:语言、语义和上下文仍需人工最终审核。
- 预期输出
- 标题层级检查器完成后会提供编辑后的文本、变更摘要以及可量化的语言或结构指标,并围绕“查找 Markdown 标题跳级、重复与空标题”组织结果。. 查找 Markdown 标题跳级、重复与空标题。
ARIA 可访问名称清单适用以下边界:ARIA 可访问名称清单的使用边界:静态 HTML 清单无法完整观察 CSS 隐藏文本、Shadow DOM、运行时状态或屏幕阅读器行为,也不是 WCAG 合规报告。 如果未满足该条件,请勿把输出传递到工作流的下一步。
落实《无障碍 HTML 发布:语言、标题、表单与可访问名称》时,请记录工具名称、所选设置、浏览器版本,以及“使用ARIA 可访问名称清单完成:盘点 HTML 中按钮、链接与表单控件的可访问名称,并找出无名称控件”的接受或拒绝理由,而不是敏感内容。这样既能重复检查,也不会复制真实数据。