用途:在 Builderius 构建器中创建语义正确、可访问的前端界面,适用于搭建页面、区块、布局、组件与视觉设计,也用于审查既有模块树的语义。
主要能力:
- 模块到 HTML 的映射:HtmlElement 按其 tag 设置渲染对应标签(section、article、nav、header、footer、main、aside、h1–h6、img、a、button),Collection 渲染为带 has="collection" 的容器,Template 渲染为 template 循环包装,SmartForm 渲染为 builderius-smart-form,HtmlCode/SvgCode 用于原始代码注入,Component 为透明包装。
- 地标优先:建议页面前规划地标结构,标准模板包含跳转导航链接、Site Header、main(id="content")、若干 section、Site Footer;section 需通过 aria-labelledby 关联标题才成为地标。
- 原生优先于 ARIA:能用原生标签就不用 ARIA;可点击元素中,导航用 tag=a 带 href,执行动用 tag=button,不用带 onclick 的 div。
- 视觉与语义分离:tag 决定含义,tagClass 决定样式,如语义 h2 可配小字号框架类。
- 标题层级:每模板一个 h1,不跳级;组件内标题标签可配置并说明上下文,默认 h3。
- 列表、表格、表单:列表用 ul/ol/dl(CSS 去掉 list-style 时补 role="list"),表格需 caption、thead/tbody 与带 scope 的 th,表单必须用 label,错误提示用 aria-invalid 与 aria-describedby。
- 循环与变量:使用 [[var]]、[[[var]]]、{{field}}、{{{field}}} 语法,URL 与 src 用非转义形式,可见文本用转义形式;嵌套数组用 SubCollection。
必要用法:先调用 builderius_builder_get_css_framework 获取可用类与变量,再阅读 builderius://design-guidelines 与 builderius://modules-reference。另参考 references/heading-patterns.md。
限制:资料未提供安装命令、收费与价格信息;技能主要针对 Builderius 环境,其他平台适用性暂未提供;HtmlCode/SvgCode 为叶模块,无子模块与 htmlAttribute 设置,内容需全部写入 contentHtml 或 contentSvg。