跳到正文
cccskills
免费在 GitHub 公开中文介绍

listitem

检查HTML列表项与父元素的关系,协助修正列表嵌套和ARIA设置,让屏幕阅读器识别列表类型与项目数量,并检查导航及用于样式布局的列表标记。

原文查看原文说明

Use when applies to HTML documents with `<li>` elements. Also applies to custom ARIA lists where `role='listitem'` must be owned by `role='list'`. Common violations occur in templating systems where list markup is split across components or in CSS resets where developers use `<li>` for layout without proper list parents.

AI 评分100分/ 100查看安装方法

适用场景

  • 检查拆分在多个组件中的列表结构
  • 修正导航列表的嵌套
  • 检查自定义列表的父级角色
  • 确认CSS重置后的列表识别

中文介绍

功能

此技能检查HTML列表结构,协助修正标记,让屏幕阅读器能够识别列表类型并读出项目数量。它会确认每个<li>的直接父元素是否为<ul>、<ol>或<menu>。对于通过ARIA构建的自定义列表,也会检查role='listitem'与role='list'的关系。ARIA用于向辅助技术提供元素的相关信息。

适用场景

适合审查因组合多个组件而破坏列表父子关系的页面,也可检查导航列表的嵌套,以及仅为调整外观而使用的<li>。通过CSS隐藏项目符号后,还可确认屏幕阅读器是否仍能识别列表结构。

使用示例

  • “检查这个页面中的<li>,指出父元素不合适的位置,并提出修改建议。”
  • “检查这个自定义列表的ARIA设置,并说明如何用屏幕阅读器验证。”

注意事项

除了源代码,还需检查浏览器实际渲染的HTML。list-style: none可能使部分浏览器不再将其识别为列表,必要时需添加role='list'。

本介绍由 AI(OpenAI Codex)根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

客观评估

AI 仅根据 SKILL.md 的内容,从 4 个方面进行了评估。星标数和热度不计入评估。

指令清晰度能否看出何时使用、做什么
A良好明确以li元素和ARIA列表为对象,并说明检查和修正父级关系。
步骤具体性步骤、输入输出和示例是否具体
A良好列出父元素判定条件、添加列表容器的修正方法、问题定位及验证方式。
安全性发送数据、删除文件、执行命令等是否有说明
A良好范围为检查和修正HTML结构,没有要求向外部发送数据或删除内容。
安装难易度所需工具和 API 密钥是否少且有说明
A良好未要求API密钥或专用环境,使用浏览器无障碍工具或辅助技术验证。

总分按每项 A=25 分、B=15 分、C=5 分相加。 由 AI(OpenAI Codex)于 2026年10月23日 评估。仅供参考,安装前请同时查看原文。

如果您认为评估有误,请申请复核

请写明哪一项有误以及原因。无需登录。我们会对照 SKILL.md 重新评估,并在此处更新结果。

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

包含的文件(2)

  • SKILL.md3.2 KB
  • references/rule.md3.4 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Place list items within list containers

When a <li> element exists outside a list container, screen readers lose the ability to announce critical context: NVDA and JAWS will not say 'list of 5 items' or 'item 2 of 5' because there is no list context. VoiceOver may announce the orphan <li> as plain text without any group context, stripping users of the structural information that helps them understand how many items exist and where they are in the list.

Quick Reference

  • Every <li> element must have a direct parent of <ul>, <ol>, or <menu>
  • Orphan <li> elements are invalid HTML per the HTML Living Standard
  • Screen readers announce list type and item count (e.g., 'list, 3 items') only when <li> is inside a valid list container
  • Similarly, role='listitem' must be owned by a role='list' element per WAI-ARIA requirements

Check

Find all <li> elements in the DOM. For each, check that its direct parent element is <ul>, <ol>, or <menu>. Flag any <li> whose parent is <div>, <section>, <nav>, <span>, or any element other than those three. Also check role='listitem' elements to ensure their closest ancestor with a list-related role is role='list'.

Fix

For each orphan <li>: (1) Wrap it and any sibling <li> elements in the appropriate list container — use <ul> for unordered items or <ol> for sequentially ordered items. (2) If the <li> was being used purely for styling (e.g., a bullet point visual), replace it with a <div> or <p> and apply the visual style via CSS. (3) If inside a navigation element, ensure <nav><ul><li> nesting is maintained.

Explain

The HTML Living Standard specifies that <li> elements are only valid as children of <ul>, <ol>, or <menu>. This is a structural requirement, not a style preference. Screen readers use the list container to announce the list type ('bullet list' vs 'numbered list') and the total item count. Without the container, this context is lost entirely. Additionally, when list-style: none is applied to a <ul>, some browsers strip the list semantics — if this is intentional (e.g., a navigation menu), add role='list' to the <ul> to restore list semantics for screen readers.

Code Review

Review the rendered markup and interactive states that affect Place list items within list containers. Flag exact elements, roles, labels, focus behavior, or keyboard interactions that violate the rule, and note how to verify the fix with browser accessibility tooling or assistive tech.


For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/rules/accessibility/listitem

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

404-page

免费有简介AI 评分 100分

创建并检查自定义404页面,通过搜索、导航和主要页面链接,为访问失效或已迁移页面的访客指明去向,同时核对页面显示内容与HTTP状态码。

  • 创建自定义404页面
  • 完善失效链接的搜索与导航
  • 检查不存在的页面是否返回200
thedaviddias/Front-End-Checklist7.5万2026年10月6日 更新

about-page

免费有简介AI 评分 90分

检查或创建说明网站用途与运营方的介绍页面,核对组织历史、使命、专业能力及联系方式,并检查实际页面输出,找出信息缺漏。

  • 检查现有的网站介绍页面
  • 创建介绍组织与使命的页面
  • 核对页面输出中的运营方信息
thedaviddias/Front-End-Checklist7.5万2026年10月6日 更新

accessibility-testing

免费有简介AI 评分 80分

为页面和共用组件添加自动无障碍测试,检查现有测试的覆盖缺口,并将检查接入持续集成流程,以发现结构、属性问题及修改引入的新问题。

  • 检查共用组件的测试覆盖范围
  • 为页面交互测试添加无障碍检查
  • 在持续集成中运行无障碍检查
thedaviddias/Front-End-Checklist7.5万2026年10月6日 更新

accessible-authentication

免费有简介AI 评分 90分

检查从登录、多因素认证到账户恢复的完整流程,找出禁止粘贴、验证码必须手动输入等使用障碍,并协助改进认证方式。

  • 检查完整登录流程的无障碍性
  • 确认验证码粘贴与自动填充
  • 检查密码重置与账户恢复流程
thedaviddias/Front-End-Checklist7.5万2026年10月6日 更新

accessible-notifications

免费有简介AI 评分 100分

检查表单错误、完成通知和实时更新能否通过屏幕阅读器传达,核对实际显示的HTML属性、通知停留时间及关闭方式,并指出具体问题。

  • 检查表单错误是否被朗读
  • 调整完成通知的显示时间
  • 检查实时通知
thedaviddias/Front-End-Checklist7.5万2026年10月6日 更新

accessible-tables

免费有简介AI 评分 100分

检查表头与数据单元格的对应关系,将 HTML 调整为屏幕阅读器也能传达数据含义的结构。从简单表格到包含合并单元格的复杂表格都可检查。

  • 检查表格的屏幕阅读器支持
  • 检查合并单元格与表头的关联
  • 审查设计系统中的表格
thedaviddias/Front-End-Checklist7.5万2026年10月6日 更新

查看 thedaviddias 的全部技能

报告此技能的问题