Alpine.js — легковесный JavaScript-фреймворк для интерактивных интерфейсов прямо в HTML-разметке. Актуальная ветка — 3.x: на 20 октября 2026 года последняя официальная версия — 3.17.5. Он рассчитан на точечную интерактивность существующих страниц, а не на сборку крупных SPA.
Преимущества Alpine.js
- Легковесность
Часто встречающаяся оценка «около 3 КБ в минифицированном виде» устарела и не относится к текущей ветке 3.x. Официальная CDN-сборка 3.17.5 (cdn.min.jsна jsDelivr) занимает 55 КБ минифицированная и около 20 КБ после gzip. Это по-прежнему один файл без обязательного сборщика, но размер нужно сравнивать с актуальным артефактом, а не с цифрой ранних обзоров. - Простота использования
У Alpine.js небольшой декларативный API из HTML-атрибутов. Двусторонняя привязка делается директивойx-model:<div x-data="{ message: '' }"> <input type="text" x-model="message"> <p x-text="'Вы ввели: ' + message"></p> </div>Важно объявить переменную в
x-data(здесьmessage: ''), иначеx-modelне к чему привязаться. Выводить значения нужно черезx-text(илиx-html, если требуется разметка): синтаксис{{ message }}из Vue в Alpine.js не поддерживается и не обрабатывается. - Работа с DOM
В версии 3.x реактивность построена наProxy(внутри используется@vue/reactivity). Alpine обновляет существующий DOM и не вводит виртуальный DOM в духе React. Поэтому его удобно встраивать в уже сверстанную страницу, когда нужен контроль над разметкой. - Подключение без обязательных зависимостей
CDN-сборка — один скрипт, отдельно ничего подключать не нужно. Официальная документация рекомендует jsDelivr и атрибутdefer:<script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js"></script>@3.x.xвсегда отдаёт последнюю версию ветки 3. Для production документация советует зафиксировать конкретный номер; на момент проверки это 3.17.5:<script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.17.5/dist/cdn.min.js"></script>При установке через npm в v3 недостаточно сделать
import 'alpinejs', как в v2: нужно явно вызватьAlpine.start().import Alpine from 'alpinejs' window.Alpine = Alpine Alpine.start() - Документация
Документация на alpinejs.dev описывает директивы, магические свойства,Alpine.data(),Alpine.store()и официальные плагины, с рабочими примерами и руководством по переходу с v2 на v3.
Недостатки Alpine.js
- Ограниченная область применения
Встроенного роутинга и модели полноценного SPA, как у React или Vue, у Alpine нет. При этом в 3.x уже есть переиспользуемые компоненты: их регистрируют черезAlpine.data(), общее состояние — черезAlpine.store(). Официальные плагины закрывают persist, intersect, morph, mask и соседние задачи. Это по-прежнему библиотека для разметки, а не экосистема для крупного клиентского приложения. - Слабая типизация
В пакетеalpinejsнет официальных TypeScript-типов. Для программного API можно подключить сообществовые определения@types/alpinejs, но выражения в HTML-атрибутах по-прежнему слабо типизируются, и часть контрактов приходится описывать вручную. - Отсутствие горячей перезагрузки
Сам Alpine.js не даёт HMR: он не рассчитан на сложные SPA. При необходимости горячую перезагрузку настраивают через сборщик вроде Vite или Webpack.
Особенности Alpine.js
- Реакция на события
События вешают директивойx-on. Официальный сокращённый синтаксис —@clickвместоx-on:click:<div x-data="{ count: 0 }"> <button x-on:click="count++">Нажмите меня</button> <p x-text="'Количество кликов: ' + count"></p> </div>В этом примере
countобъявлен вx-data: по клику значение увеличивается, текст обновляется черезx-text. - Переиспользуемые компоненты и область видимости
В Alpine 3 данные родительскогоx-dataдоступны дочерним элементам, пока их не перекроет вложенныйx-data. Выносить повторную логику в глобальные функции и вызывать их какx-data="dropdown()"в v3 считается устаревшим приёмом: документация рекомендуетAlpine.data():<div x-data="counter"> <button x-on:click="inc">Нажмите меня</button> <p x-text="'Количество кликов: ' + count"></p> </div> <script> document.addEventListener('alpine:init', () => { Alpine.data('counter', () => ({ count: 0, inc() { this.count++ } })) }) </script>Слушатель
alpine:initнужно зарегистрировать до старта Alpine (скрипт сdeferв<head>как раз даёт такое окно). Общее состояние между независимыми корнями удобнее держать вAlpine.store(), а не читать HTML-атрибуты черезx-initи$el.getAttribute.
Здравствуйте, rwsite.ru..
Наткнулся на вашу статью, где вы предлагаете использовать {{ name }} в Alpine.js.. Хотел бы уточнить: это не работает. Alpine не поддерживает такой синтаксис — вместо этого используется x-text="location".
Похоже, вы перепутали с Vue. В Alpine подобные конструкции не парсятся, и это вводит читателей в заблуждение.
Если вы позиционируете себя как ресурс для разработчиков, стоит проверять примеры перед публикацией.
С уважением, Разработчик, которому не всё равно . Copilot
Спасибо, за замечание! Статья исправлена.
p x-text="'Количество кликов: ' + count" /p