Установка Tailwind CSS (NPM)

Прежде чем начать, убедитесь, что у вас установлены Node.js и npm. Проверить, установлены ли они, можно, выполнив следующие команды:

node -v
npm -v

Если ваша система ещё не поддерживает Node.js и npm, вы можете обратиться к нашемуучебнику по Node.js。

Использование npm в Китае может быть очень медленным. Вы можете использовать настроенный для Taobao инструмент командной строки cnpm (с поддержкой сжатия gzip) вместо npm по умолчанию:

$ npm install -g cnpm --registry=https://registry.npmmirror.com
$ npm config set registry https://registry.npmmirror.com

Затем вы можете использовать команду cnpm для установки модулей:

$ cnpm install [name]

Для получения дополнительной информации см.:http://npm.taobao.org/。


Установите Tailwind CSS 3

В этой главе рассматривается способ установки Tailwind CSS 3. Способ установки Tailwind CSS 4 изменился; он автоматически обнаруживает такие файлы, как HTML и JavaScript, избавляя вас от необходимости вручную настраивать источники контента.

Подробнее см.:Установка Tailwind CSS 4。

Установка через npm: установите и настройте Tailwind CSS в вашем локальном проекте:

npm install -D tailwindcss
npx tailwindcss init

После выполнения приведённой выше команды будет создан базовый файл конфигурации tailwind.config.js для настройки.

Настройка путей к шаблонам

Далее мы можем добавить пути к шаблонам в файле tailwind.config.js:

Код файла tailwind.config.js:

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js}"],  // Настройте в соответствии с фактическими типами файлов в вашем проекте
  theme: {
    extend: {},
  },
  plugins: [],
}

Добавьте директивы Tailwind в ваш CSS-файл

В вашем основном CSS-файлеsrc/input.css(создайте его, если у вас его нет), добавьте каждый функциональный модуль Tailwind с помощью директивы @tailwind.

Код файла src/input.css:

@tailwind base;
@tailwind components;
@tailwind utilities;

Запустите процесс сборки Tailwind CLI

Запустите инструмент CLI, чтобы просканировать файлы шаблонов на наличие классов и собрать CSS.
npx tailwindcss -i ./src/input.css -o ./src/output.css --watch

Используйте Tailwind в HTML

Добавьте скомпилированный CSS-файл в тег <head>, и затем вы можете начать использовать утилитарные классы Tailwind для стилизации вашего контента.

Код файла src/index.html:

<!doctype html>
<html>
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link href="./output.css" rel="stylesheet">
</head>
<body>
  <h1 class="text-3xl font-bold underline">
    Привет, мир!
  </h1>
</body>
</html>

Приведённые выше шаги применимы к большинству современных фронтенд-проектов, будь то использование Vue, React или других фреймворков. Убедитесь, что скомпилированный CSS-файл включён в процесс сборки, чтобы стили Tailwind CSS могли быть корректно применены к вашему проекту.


Использование PostCSS

Установка Tailwind CSS в качестве плагина PostCSS — лучший способ бесшовной интеграции с инструментами сборки, такими как webpack, Rollup, Vite и Parcel.

1. Установите Tailwind CSS

Установите Tailwind CSS и связанные с ним зависимости через npm и создайте файл конфигурации tailwind.config.js.

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init

2. Добавьте Tailwind в вашу конфигурацию PostCSS

В файле postcss.config.js проекта добавьте плагины tailwindcss и autoprefixer.

Код файла postcss.config.js:

module.exports = {
  plugins: {
    tailwindcss: {},
    autoprefixer: {},
  }
}

3. Настройте пути к шаблонам

В файле tailwind.config.js добавьте пути ко всем файлам шаблонов, чтобы Tailwind CSS мог генерировать нужные стили на основе этих файлов.

Код файла tailwind.config.js:

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js}"], // Замените на фактические пути к шаблонам в вашем проекте
  theme: {
    extend: {},
  },
  plugins: [],
}

4. Добавьте директивы Tailwind в ваш CSS-файл

В вашем основном CSS-файле добавьте следующие три основные директивы Tailwind для импорта базовых стилей, стилей компонентов и стилей служебных классов.

Код файла main.css:

@tailwind base;
@tailwind components;
@tailwind utilities;

5. Запустите процесс сборки

Запустите процесс сборки проекта с помощью npm run dev или соответствующих команд, настроенных в файле package.json.

npm run dev

6. Используйте Tailwind CSS в HTML

Убедитесь, что скомпилированный CSS-файл правильно подключён в теге <head> (некоторые фреймворки могут делать это автоматически), затем начните использовать служебные классы, предоставляемые Tailwind CSS, в вашем HTML для стилизации содержимого.

Код файла index.html:

<!doctype html>
<html>
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link href="/dist/main.css" rel="stylesheet"> <!-- Подключите скомпилированный CSS-файл -->
</head>
<body>
  <h1 class="text-3xl font-bold underline">
    Привет, мир!
  </h1>
</body>
</html>
Другие расширения