用途:该技能用于在 SGDS Web Component 项目中应用间距工具类,覆盖 margin、padding 与 gap,基于 4px 比例系统。使用前需先完成 sgds-utilities-setup 技能中的设置;间距工具需要引入工具 CSS,但不需要主题文件。
主要能力:所有间距工具使用 sgds: 前缀(Tailwind v4 @theme 语法)。每个间距值等于倍数 × 4px。官方建议优先使用语义化间距工具,而非原始数值工具,因为语义令牌定义在 responsive.css 中,会在移动端、平板(≥1024px)和桌面(≥1440px)断点自适应,并表达设计意图。
语义化工具:文本间距用 sgds:gap-text-2-xs 至 sgds:gap-text-2-xl;布局间距用 sgds:gap-layout-2-xs 至 sgds:gap-layout-xl;布局内边距支持 sgds:p-layout-、sgds:px-layout-、sgds:py-layout-;组件内部间距用 sgds:gap-component-xs 至 sgds:gap-component-xl;组件内边距支持 sgds:p-component-、sgds:px-component-、sgds:py-component-。容器宽度用 sgds:w-container,对应 --sgds-container-width,从移动端 360px 到平板 888px、桌面 1312px。
原始数值工具(仅作回退):sgds:p-{n}、sgds:px-{n}、sgds:py-{n}、sgds:pt/pr/pb/pl-{n} 用于内边距;sgds:m-{n}、sgds:mx-{n}、sgds:my-{n}、sgds:mt/mr/mb/ml-{n} 用于外边距;sgds:mx-auto 水平居中;sgds:gap-{n}、sgds:gap-x-{n}、sgds:gap-y-{n} 用于 flex/grid 间距;支持负值如 sgds:-mt-{n}。
适用场景:页面布局(布局间距 + 布局内边距 + 容器宽度)、自定义卡片组件(组件间距 + 组件内边距)、自定义表单组件、网格布局、文本内容块。
限制:仅在语义令牌不适用时才回退到原始数值工具;语义令牌均为响应式。资料未提供安装命令、版本要求或浏览器兼容性细节。