Tailwind CSS home page
  1. Installation
  2. 在 Symfony 中安装 Tailwind CSS

  1. 创建你的项目

    如果你还没有设置 Symfony 项目，可以先创建一个新的 Symfony 项目。最常见的方法是使用 Symfony 安装程序。

    终端
    symfony new --webapp my-projectcd my-project

  2. 安装 Webpack Encore

    安装 Webpack Encore，它负责构建你的资源。更多信息请参见 文档 。

    终端
    composer require symfony/webpack-encore-bundle

  3. 安装 Tailwind CSS

    使用 npm 安装 tailwindcss 及其同级依赖，以及 postcss-loader，然后运行 init 命令以生成 tailwind.config.js 和 postcss.config.js。

    终端
    npm install -D tailwindcss@3 postcss postcss-loader autoprefixernpx tailwindcss init -p

  4. 启用 PostCSS 支持

    在你的 webpack.config.js 文件中，启用 PostCSS Loader。更多信息请参阅 文档 。

    webpack.config.js
    Encore
  // ...
  .enablePostCssLoader()
;

  5. 配置你的模板路径

    在你的 tailwind.config.js 文件中添加所有模板文件的路径。

    tailwind.config.js
    /** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    "./assets/**/*.js",
    "./templates/**/*.html.twig",
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}

  6. 将 Tailwind 指令添加到你的 CSS 中

    将 Tailwind 各层的 @tailwind 指令添加到你的 ./assets/styles/app.css 文件中。

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

  7. 开始构建流程

    使用 npm run watch 运行你的构建过程。

    终端
    npm run watch

  8. 开始在你的项目中使用 Tailwind

    确保你的编译后的 CSS 已包含在 <head> 中，然后开始使用 Tailwind 的工具类来为你的内容设置样式。

    base.html.twig
    <!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  {% block stylesheets %}
    {{ encore_entry_link_tags('app') }}
  {% endblock %}
</head>
<body>
  <h1 class="text-3xl font-bold underline">
    Hello world!
  </h1>
</body>
</html>