Блог разработчика 1С-Битрикс

Как настроить работу Tailwind CSS в CMS Битрикс?

Настройка Tailwind CSS в CMS Bitrix может быть не столь тривиальным процессом, как в обычных проектах, но это вполне осуществимо. Для начала вам понадобится установить несколько инструментов и выполнить определённые шаги, чтобы успешно интегрировать Tailwind CSS в вашу тему Bitrix. Итак, давайте рассмотрим основные этапы настройки

Как настроить работу Tailwind CSS в CMS Битрикс?

Первым шагом будет установка необходимых инструментов. Обычно для этого используются современные инструменты сборки, такие как npm и, возможно, Webpack. Убедитесь, что на вашем сервере или локальной машине установлены Node.js и npm. После их установки вы можете создать новый проект или использовать существующий.

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


npm install tailwindcss postcss autoprefixer

После этого необходимо инициализировать конфигурацию Tailwind. Это можно сделать с помощью команды:


npx tailwindcss init -p

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

Далее вам нужно создать файл CSS, где вы будете импортировать Tailwind. Создайте файл, например, `styles.css`, и добавьте в него следующие строки:


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

Теперь, для того чтобы ваши стили были собраны и оптимизированы, вам необходимо настроить процесс сборки. Используйте скрипты npm для компиляции файлов CSS. Для этого можно добавить в файл `package.json` следующий скрипт:


"scripts": {
  "build": "tailwindcss build styles.css -o dist/output.css"
}

Теперь каждый раз, когда вы будете выполнять команду `npm run build`, ваши стили будут компилироваться в файл `dist/output.css`.

После успешного создания файла стилей нужно подключить его в вашу тему Bitrix. Обычно это делается в шаблонах вашего сайта, где вам нужно будет добавить ссылку на скомпилированный CSS файл, например:


<link rel="stylesheet" href="/local/templates/ваш_шаблон/dist/output.css">

Теперь вы можете использовать утилиты из Tailwind CSS в ваших файлах шаблонов Bitrix. Имейте в виду, что если вы используете кэширование, может потребоваться очистка кэша, чтобы изменения вступили в силу.

Если вы планируете работать с развитием проекта, можно настроить режим наблюдения, чтобы автоматически перегенерировать CSS при изменениях в ваших исходниках. Для этого можно использовать команду:


npx tailwindcss -i ./styles.css -o ./dist/output.css --watch

Таким образом, ваш Tailwind будет обновляться в реальном времени, что значительно упростит процесс разработки.

Итак, следуя этим шагам, вы сможете интегрировать Tailwind CSS в вашу CMS Bitrix. Убедитесь, что вы тестируете изменения на локальной среде перед внедрением их на продакшен, чтобы избежать возможных проблем.

SenDev: DataGenerator. Генератор тестовых данных для разработки

SenDev: DataGenerator — это бесплатный инструмент для разработчиков 1С-Битрикс, позволяющий мгновенно наполнять сайт тестовыми данными. Генерируйте пользователей, структуру инфоблоков, товары с ценами и остатками, а также заказы в один клик. Модуль ведет журнал созданных сущностей, что гарантирует безопасную и полную очистку тестовых данных после завершения работ.

Теги: Tailwind CSS, настройка Tailwind в Битрикс, Tailwind CSS 1С-Битрикс, интеграция Tailwind, frontend 1С-Битрикс, стиль CSS в Битрикс, адаптивный дизайн Битрикс, настройка CSS, Tailwind конфигурация


Валерий Макеев
09.09.2025 13:04
Этот код подключает CSS-файл Tailwind с автоматическим обновлением версии при изменении файла, чтобы избежать проблем с кэшированием.
Код
<?php
$cssFile = '/local/templates/ваш_шаблон/dist/output.css';
$cssPath = $_SERVER['DOCUMENT_ROOT'] . $cssFile;
$cssUrl = $cssFile . '?v=' . (file_exists($cssPath) ? filemtime($cssPath) : '1');
echo '<link rel="stylesheet" href="' . htmlspecialchars($cssUrl) . '">';
?>

Стоимость услуг по разработке и сопровождению сайтов на 1C-Битрикс

Техническая поддержка

сайтов на CMS 1C-Битрикс

от 20 000 рублей/месяц
Оптимизация производительности действующих интернет-проектов, наполнение и сопровождение, полная техническая поддержка и продвижение в поисковых сетях.

* стоимость зависит от объема и сложности выполняемых работ

Модули и компоненты для «1С-Битрикс»

оценка производится на основе предоставленного Технического Задания

от 20 000 рублей
Разработка дополнительных модулей для 1С-Битрикс, расширение функционала, внедрение любых решений, требующихся для выполнения ваших бизнес-задач.

* стоимость зависит от конкретной задачи, ее объема и сложности выполняемых работ.

Комплексное обновление проекта

обновление до последних версий, без привязки к исходной версии

от 15 000 рублей
Выполняем работы любой сложности: обновление PHP (в т.ч. до 8.4), миграция MySQL (к примеру, с 5 до 8), обновление ядра «1С-Битрикс» до последней версии, рефакторинг кода кастомных модулей и адаптация компонентов под новые стандарты.

* стоимость зависит от текущего состояния проекта, объема legacy-кода и сложности адаптации шаблона.