SuperAPI AI 工具集

frontend-syntax-html5-semantic

前端与建站

查看项目

更新于 10-15 22:18

技能介绍

用途:该技能修复每个页面区域与内容类型的 HTML 元素选型问题。它建立在“标记层是基础”的架构立场上:原生语义元素在做无障碍树映射、焦点管理和平台集成时,始终优于 <div role="...">。目标是 evergreen-2026 浏览器,<search>、<details name=""> 互斥手风琴等特性被视为无需 polyfill 即可用。

主要能力:提供地标元素与隐式 ARIA 角色的对照表,包括 header、nav、main、aside、footer、article、section、search、figure、details、dialog 的角色、每页可出现的次数与用途;给出“原生优先”规则,明确需要导航、搜索控件、banner、contentinfo、main、aside、折叠、模态时应使用哪个原生元素而非 role 方案。

使用方式:以决策树驱动选型——顶部识别用 header,导航链接块用 nav(多个时加 aria-label),页面主内容用恰好一个 main,相关侧面内容用 aside,页脚用 footer,可独立分发内容用 article,需要标题的主题分组用带标题的 section,搜索控件用 search(不要包住结果列表),可折叠区域用 details+summary,模态用 dialog+showModal()。accordion 互斥通过给同级 details 相同 name 实现;声明式 Shadow DOM 通过 template shadowrootmode 实现。

适用场景:编写地标骨架、选择 article/section/div、判断是否需要 role、组织标题层级(每文档一个 h1、section/article 内需标题、不跳级)。

限制:属于规范与选型指导,不含具体产品收费信息;效果取决于实际实现与浏览器支持,需用无障碍树检查器验证;文中未提供的功能与步骤不应臆测。