Skip to main content
用工具类快速搭建扩展 UI,覆盖 popup、options、新标签页、sidebar 以及 content script 等入口。 Extension.js 通过 PostCSS 集成 Tailwind,同时支持 Tailwind v3 和 v4。

什么场景适合用 Tailwind CSS

  • 你需要在多个扩展界面之间快速迭代 UI。
  • 你更喜欢工具类优先、带有共享 token 的样式写法。
  • 你希望在页面和 content script 入口之间使用一致的样式模式。

Tailwind 的能力

模板示例

当你想要一套完整的 Tailwind 设置并落到真实的扩展界面里时,用这个模板。 sidebar-shadcn screenshot
仓库:examples/sidebar-shadcn

在现有扩展中使用

安装

安装所需依赖:

配置

创建 postcss.config.js
对于 Tailwind v3 项目,请使用 tailwindcss 作为 PostCSS 插件,并维护一份 tailwind.config.js 的 content 列表。

Tailwind v4 与 v3 的快速设置对比

Tailwind content 路径(v3 风格)

用法

创建一个全局样式表并引入 Tailwind:

创建全局 CSS 文件

在需要使用 Tailwind 类的入口脚本里引入这个文件。

在页面脚本里(popup/options/新标签页)

在 content script 里

Extension.js 会把 content script 的 CSS 路由进其 content script 样式管线,并把这些资源输出到 content_scripts/ 下。

最佳实践

  • 把 Tailwind 源文件导入语句放在共享的样式入口里(styles/globals.css)。
  • 确保 content 扫描在相关情况下覆盖 pages/scripts/src/
  • 在 monorepo 里,确认 Tailwind 的 content 路径是从扩展项目根目录解析的。
  • 尽量使用模板,以避免 PostCSS 与 Tailwind 版本之间出现配置漂移。

下一步

  • 配置 PostCSS 做更多 CSS 转换。
  • Stylelint 确保 CSS 遵循最佳实践。