SuperAPI AI 工具集

liquid-theme-standards

编程与开发

查看项目

更新于 10-15 17:25

技能介绍

用途:为 Shopify Liquid 主题提供统一的 CSS、JavaScript 和 HTML 编码规范,帮助保持代码一致、可维护并符合可访问性与性能要求。

核心原则:渐进增强,先语义化 HTML,再 CSS,最后 JS;不依赖外部库,JavaScript 只用原生浏览器 API;不硬编码颜色、间距或字体,统一使用设计令牌;全程采用 BEM 命名;编写防御性 CSS 处理边界情况。

CSS 部分:区分三种样式位置——{% stylesheet %} 用于组件级样式但不处理 Liquid;{% style %} 可处理 Liquid,适合需要动态值的场景;assets/*.css 用于共享全局样式。动态值应通过内联 style 属性传 CSS 变量。BEM 规则要求连字符分词、只允许单层元素、修饰符必须与基础类同用。选择器特指度目标为单个类,最高不超过 0 4 0,禁用 ID 与 !important。CSS 嵌套仅限第一层。设计令牌用 CSS 自定义属性,rem 单位,语义化命名,组件级令牌需加命名空间避免冲突。属性按布局、盒模型、排版、视觉、动画排序。使用逻辑属性支持 RTL。包含防御性 CSS、容器查询、clamp 与 min() 等现代特性、性能与减少动态效果建议。

JavaScript 部分:位置分 {% javascript %}(组件脚本)与 assets/*.js(共享工具、Web Component)。规则涵盖 for...of 遍历、async/await、const 优先、早返回、new URL()、私有方法 #、JSDoc 类型、AbortController 中断请求。组件通信:父调子用公开方法,子告父用自定义事件。

HTML 部分:优先原生元素(details/summary、dialog、popover、search、output)。图片需懒加载、设置宽高、填写 alt。

JSON 模板与配置:templates/.json、sections/.json、config/settings_data.json 均可用 jq 通过 bash 工具安全编辑,示例命令保持原样,如 jq '.current.sections.header.settings.logo_width = 200' 等,避免字符串替换。

限制:以上为编码约定,未提供具体价格、平台支持范围或效果承诺。