跳转到主要内容
只要你的项目用的是启用了 Tailwind 的 React 环境,shadcn/ui 在扩展中的工作方式就和在 web 应用中完全一样。组件直接放在你的源码里(而不是 node_modules),样式与行为完全由你掌控。

什么场景适合用 shadcn/ui

  • 你需要在 sidebar、popup 与 options 等界面之间复用可用的 UI 原子组件。
  • 你在产品代码里已经使用 React + Tailwind。
  • 你希望组件由源码自有,团队可以完全自定义。

shadcn/ui 的能力

模板示例

把 sidebar-shadcn 模板作为默认起点: sidebar-shadcn screenshot
此模板包含一个可用的 React sidebar 界面,结构基于 Tailwind + shadcn 风格的组件。 仓库:examples/sidebar-shadcn

技术栈假设

  • React + TypeScript
  • Tailwind CSS
  • PostCSS(@tailwindcss/postcss)
  • 本地 components/ui/* 组件文件(shadcn 风格的结构)

在现有项目中手动配置

  1. 设置 Tailwind 和 PostCSS(参见 Tailwind CSS)。
  2. 在项目里初始化 shadcn 并生成组件。
  3. 把生成的 UI 组件放在扩展源码里(例如 src/components/ui/)。
  4. 在需要渲染 UI 的扩展入口中引入 Tailwind 样式表。

PostCSS 示例(Tailwind v4)

components.json 示例

用法

通过本地导入使用生成的组件:

Content script 注意事项

  • 扩展页面(popup/options/sidebar/新标签页)是最容易上手 shadcn/ui 的地方。
  • 在 content script 里,单纯的 import "./styles.css" 求值得到的是这份样式表的 URL。它本身不会给任何东西加样式。
  • Extension.js 只在一种情况下替你放置这份样式表。这条导入必须写在已声明 content script 的入口文件里,而且脚本必须用 data-extension-root 标记一个宿主元素。
  • 样式表随后进入这个宿主的 shadow root。把组件挂载到这个 shadow root 里,Tailwind 样式表才能作用到它们。
从 4.1.39 之后的版本起,如果 content script 导入了一份没有任何代码放置的样式表,构建会打印警告:
最后两行只会在 manifest 声明的 content script 上打印。所有可用的方式见 content script 中的样式,宿主元素见 Shadow DOM。

最佳实践

  • 把 shadcn/ui 视作源码自有的组件,而不是运行时引入的 UI 包。
  • 让 Tailwind 的配置与 content 路径与扩展目录保持一致(pages、scripts、src)。
  • 先从一个界面(比如 sidebar 或 popup)开始,再去面对 content script 渲染的复杂度。
  • 把共享的 token 与工具函数放到专门的文件里(lib/utils、设计 token、主题变量)。

下一步

视频讲解