NNext.js 中文网 GitHub

Tailwind CSS

使用 Tailwind CSS 为你的 Next.js 应用设置样式。

本指南将带你了解如何在 Next.js 应用程序中安装 Tailwind CSS v3。

小知识: 有关最新的 Tailwind 4 配置,请参阅 Tailwind CSS 设置说明。

安装 Tailwind v3#

安装 Tailwind CSS 及其对等依赖,然后运行 init 命令以生成 tailwind.config.js 和 postcss.config.js 文件:

bash · pnpm
pnpm add -D tailwindcss@^3 postcss autoprefixer
npx tailwindcss init -p
bash · npm
npm install -D tailwindcss@^3 postcss autoprefixer
npx tailwindcss init -p
bash · yarn
yarn add -D tailwindcss@^3 postcss autoprefixer
npx tailwindcss init -p
bash · bun
bun add -D tailwindcss@^3 postcss autoprefixer
bunx tailwindcss init -p

配置 Tailwind v3#

在 tailwind.config.js 文件中配置模板路径:

tailwind.config.js
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    './app/**/*.{js,ts,jsx,tsx,mdx}',
    './pages/**/*.{js,ts,jsx,tsx,mdx}',
    './components/**/*.{js,ts,jsx,tsx,mdx}',
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}

将 Tailwind 指令添加到你的全局 CSS 文件中:

app/globals.css
@tailwind base;
@tailwind components;
@tailwind utilities;

在根布局中导入该 CSS 文件:

app/layout.tsx
import './globals.css'

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  )
}
app/layout.js
import './globals.css'

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  )
}
tailwind.config.js
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    './pages/**/*.{js,ts,jsx,tsx,mdx}',
    './components/**/*.{js,ts,jsx,tsx,mdx}',
    './app/**/*.{js,ts,jsx,tsx,mdx}',
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}

将 Tailwind 指令添加到你的全局 CSS 文件中:

styles/globals.css
@tailwind base;
@tailwind components;
@tailwind utilities;

在 pages/_app.js 文件中导入该 CSS 文件:

pages/_app.js
import '@/styles/globals.css'

export default function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />
}

使用类名#

安装 Tailwind CSS 并添加全局样式后,你就可以在应用程序中使用 Tailwind 的工具类了。

app/page.tsx
export default function Page() {
  return <h1 className="text-3xl font-bold underline">Hello, Next.js!</h1>
}
app/page.js
export default function Page() {
  return <h1 className="text-3xl font-bold underline">Hello, Next.js!</h1>
}
pages/index.tsx
export default function Page() {
  return <h1 className="text-3xl font-bold underline">Hello, Next.js!</h1>
}
pages/index.js
export default function Page() {
  return <h1 className="text-3xl font-bold underline">Hello, Next.js!</h1>
}

与 Turbopack 一起使用#

从 Next.js 13.1 起,Turbopack 已支持 Tailwind CSS 和 PostCSS。

Next.js 中文网