跳到主要內容

Tailwind CSS

Tailwind CSS 是一個實用優先的 CSS 框架,與 Next.js 搭配使用效果極佳。

安裝 Tailwind

安裝 Tailwind CSS 套件並執行 init 命令以產生 tailwind.config.jspostcss.config.js 檔案

終端機
npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init -p

設定 Tailwind

在你的 Tailwind 設定檔中,加入將使用 Tailwind 類別名稱的檔案路徑

tailwind.config.ts
import type { Config } from 'tailwindcss'
 
export default {
  content: [
    './app/**/*.{js,ts,jsx,tsx,mdx}', // Note the addition of the `app` directory.
    './pages/**/*.{js,ts,jsx,tsx,mdx}',
    './components/**/*.{js,ts,jsx,tsx,mdx}',
 
    // Or if using `src` directory:
    './src/**/*.{js,ts,jsx,tsx,mdx}',
  ],
  theme: {
    extend: {},
  },
  plugins: [],
} satisfies Config

你不需要修改 `postcss.config.js`。

匯入樣式

加入 Tailwind CSS 指示詞,Tailwind 將使用這些指示詞將其產生的樣式注入到應用程式的全域樣式表中,例如

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

自訂應用程式檔案 (pages/_app.js) 中,匯入 globals.css 樣式表以將樣式套用到應用程式中的每個路由。

pages/_app.tsx
// These styles apply to every route in the application
import '@/styles/globals.css'
import type { AppProps } from 'next/app'
 
export default function App({ Component, pageProps }: AppProps) {
  return <Component {...pageProps} />
}

使用類別

在安裝 Tailwind CSS 並加入全域樣式後,你可以在你的應用程式中使用 Tailwind 的實用類別。

pages/index.tsx
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 Turbopack