用途:为使用 SGDS 工具类(sgds: 前缀)做前置配置。所有 SGDS 工具类都采用 sgds: 前缀(Tailwind v4 @theme 语法),例如 sgds:p-4 sgds:bg-primary-default sgds:text-white;缺少前缀的写法无效。
主要能力:通过在项目主 CSS 文件中导入 utility.css 来生成全部 sgds: 工具类。utility.css 是 Tailwind 源文件,包含 @theme、@import "tailwindcss/theme.css" 等指令,必须经 Tailwind 构建流程处理,不能直接在 JavaScript 中导入。
使用方式:先按框架完成 Tailwind CSS 配置,再在 Tailwind 处理的同一 CSS 文件(如 globals.css、index.css、main.css)中加入:@import '@govtechsg/sgds-web-component/css/utility.css';。若需要随明暗模式变化的背景、文字、边框颜色,可追加 @import '@govtechsg/sgds-web-component/themes/day.css'; 与 @import '@govtechsg/sgds-web-component/themes/night.css';。切换主题可用 document.documentElement.classList.toggle('sgds-theme-night')。不导入 utility.css 时工具类不会生效。
适用场景:Next.js、Nuxt、Angular、SvelteKit、Astro、Gatsby、React Router、Vite 等需按 Tailwind 官方框架指南先行配置;完整框架清单见 tailwindcss.com/docs/installation/framework-guides。间距、字号、字重、圆角、透明度、布局等工具类无需主题文件;背景色、文字色、边框色等主题感知类需导入主题文件。
限制:资料未提供安装版本、依赖细节、收费信息及 SGDS 各工具类完整清单,具体以官方文档为准。