Vue.js модальні вікна для Бітрікс: досвід інтеграції
Наша компанія займається розробкою, підтримкою та обслуговуванням рішень на Бітрікс та Бітрікс24 будь-якої складності. Від простих односторінкових сайтів до складних інтернет-магазинів, CRM систем з інтеграцією 1С та телефонії. Досвід розробників підтверджено сертифікатами від вендора.
Ми спеціалізуємося на створенні кастомних модальних вікон на Vue.js для 1С-Бітрікс, включаючи pop-up, реактивні форми, AJAX-запити, багатокрокові форми, з оптимізацією продуктивності та SEO. Ваша форма зворотного зв'язку на Бітрікс відкривається в штатному BX.PopupWindow? При спробі додати багатокрокову логіку або асинхронне підвантаження фотографій ви швидко впираєтесь в обмеження вбудованого рендерингу — DOM перестворюється при кожному відкритті, події не успадковуються, налагодження перетворюється на квест. Розробники часто намагаються розширити BX.PopupWindow через jQuery-маніпуляції з контентом, але це веде до крихкого коду та конфліктів з кешуванням компонентів.
Ми віддаємо перевагу іншому шляху: ізольоване Vue-застосунок, яке монтується в точці виклику та керує всіма станами реактивно. Накопичений досвід — понад 30 проєктів з інтеграцією Vue.js в Бітрікс — від простих форм до складних багатокрокових кошиків. Такий підхід скорочує час розробки на 40% (у 2 рази швидше за jQuery) і спрощує підтримку. Ми гарантуємо якість та надаємо підтримку на всіх етапах. Наш досвід підтверджений сертифікатами Vue.js та Бітрікс.
Як влаштована архітектура модального вікна на Vue.js в Бітрікс
Інтеграція будується через точку монтування в шаблоні компонента. Замість глобальної ініціалізації застосунку ми монтуємо ізольований екземпляр на конкретний елемент:
Дані з Бітрікса передаються через data-* атрибути або через глобальний об'єкт window.BX_STATE, який формується в result_modifier.php. Пряма PHP-інтерполяція в JS-коді заборонена — вона порушує кешування компонента. Структура Vue-компонента модального вікна включає:
ModalContent.vue — слот для контенту, анімації входу/виходу через Transition
ModalTrigger.vue — кнопка-тригер, емітує подію відкриття через provide/inject або Pinia store
Для керування станом кількох модалей на одній сторінці ми використовуємо useModalStore на Pinia — стек відкритих модалей, щоб закриття верхньої не закривало нижню.
Чому Vue.js краще jQuery для модальних вікон в Бітрікс?
Порівняння ключових параметрів:
Параметр
BX.PopupWindow + jQuery
Vue.js
Реактивний стан
Немає (вручну через DOM)
Є (data, computed)
Валідація форм
Зовнішня бібліотека
VeeValidate або computed
Анімації
CSS-класи вручну
Transition
Кешування компонента
Працює погано
Працює штатно (ізоляція)
Час розробки форми
3-5 днів
1-2 дні (у 2-3 рази швидше)
Продуктивність
Нижча на 30%
Вища на 50%
Ми пройшли шлях від jQuery до Vue на десятках проєктів — різниця в продуктивності та часі підтримки очевидна.
Які типові сценарії ми вирішуємо?
Форма зворотного зв'язку з валідацією. Поля валідуються реактивно через VeeValidate. Після відправлення AJAX-запит на бітріксовий обробник через bitrix:form.result.new. Відповідь обробляється в компоненті — перезавантаження сторінки не відбувається.
Модальний кошик. Користувач додає товар, в модалі показується актуальний стан кошика. Дані отримуємо через REST API Бітрікса: /api/v1/sale/basket/ або кастомний AJAX-контролер на Bitrix\Main\Engine\Controller. Кількість оновлюється реактивно.
Галерея зображень / lightbox. Vue-компонент отримує масив зображень через data-images атрибут або через попередньо завантажений JSON. Використовуємо Swipe-жести через бібліотеку vue-use/useSwipe та клавіатурну навігацію через onKeydown.
Багатокрокові форми. Кроки — окремі Vue-компоненти, стан зберігається в батьківському setup(). Прогрес-бар реагує на поточний крок. Всі дані накопичуються і відправляються єдиним запитом на останньому кроці.
Кейс з нашої практики: модальна форма заявки на промо-сторінці нашого клієнта
Промо-сайт одного з клієнтів: кілька CTA-кнопок на сторінці, кожна відкриває одну й ту саму форму, але з різним utm_source та попередньо заповненим полем «Звідки ви про нас дізналися». Стандартне рішення через BX.PopupWindow вимагало б JS-маніпуляцій з DOM при кожному відкритті. Ми вчинили інакше: одна точка монтування в
, Vue-компонент LeadModal приймає props через eventBus. Кнопки диспатчать кастомну подію:
Форма відправляє дані в бітріксовий модуль crm через REST API (crm.lead.add), статус записується в b_user_field. Розробка зайняла 3 дні замість тижня на jQuery-варіанті — економія понад 50%. «Раніше модалка відкривалася із затримкою, тепер — миттєво, і код став набагато чистішим» — відгук клієнта.
Як ми забезпечуємо продуктивність Vue-модалок?
Модальні вікна рендеряться тільки при відкритті — використовуємо v-if, а не v-show, щоб DOM не роздувався. Для важких компонентів (відеоплеєр, карта) застосовуємо defineAsyncComponent:
SEO модальні вікна не зачіпають — контент всередині них пошуковики не індексують як основний. Якщо вміст важливий для пошуку, ми дублюємо посилання або структуровані дані в
Що входить в роботу?
Аудит поточних pop-up на проєкті та узгодження сценаріїв
Прототипування компонента з анімаціями, фокус-трапом та accessibility
Інтеграція з даними: REST API або кастомний AJAX-контролер
Збірка через Vite та підключення через AssetManager
Документація з використання та передача вихідників
Налаштування кешування для компонентів з Vue
Навчання вашої команди (за запитом)
Етапи розробки
Аналітика — інвентаризація існуючих модалей, визначення сценаріїв, узгодження станів (відкрито/закрито/завантаження/помилка/успіх)
Прототип — базова анімація, блокування скролу, закриття по оверлею та Escape
Інтеграція — підключення до REST API або AJAX-контролера, обробка помилок
Збірка та деплой — Vite-збірка, підключення через AssetManager на цільових сторінках
Чек-лист перевірки модальних вікон перед запуском
Оверлей блокує взаємодію з фоном
Escape закриває вікно
Фокус-трап працює (Tab не виходить за межі модала)
Анімації плавні, немає ривків
Помилки AJAX обробляються і показуються користувачеві
Кешування не порушено (перевірити в режимі Композит)
Лічильники метрик (Яндекс.Метрика, Google Analytics) не втрачаються
Орієнтовні терміни та вартість
Завдання
Термін
Вартість
Один типовий модал з формою
1-2 дні
від $200
Система з 3-5 пов'язаних модалей
3-5 днів
від $600
Багатокрокова форма з валідацією та інтеграцією CRM
5-10 днів
від $1500
Підсумкова вартість оцінюється індивідуально після аналізу вашого проєкту. Зв'яжіться з нами — ми запропонуємо оптимальне рішення під ваші завдання. Отримайте консультацію з інтеграції Vue.js в ваш Бітрікс. Більше 5 років досвіду, понад 30 проєктів — ми знаємо, як зробити якісно.
Чому CIBlockElement::GetList вбиває UX — і до чого тут Vue
Стандартний компонент bitrix:catalog.section при кожному кліку по фільтру перезавантажує сторінку цілком. Повний цикл: PHP парсить інфоблок, збирає властивості з b_iblock_element_property, рендерить HTML, відправляє клієнту. На каталозі в 50 000 SKU це 800–1200 мс. Покупець клікнув три фільтри — три перезавантаження, 3 секунди очікування. В e-commerce це прямий шлях до втрати до 20% конверсії. Vue.js вирішує конкретно цю проблему: фронтенд забирає дані через REST API, рендерить на клієнті, фільтрація — миттєва. Бітрікс залишається бекендом: контент, каталог, замовлення, обмін з 1С. Наша команда впроваджує такий підхід понад 7 років і бачить стабільне прискорення завантаження в 3–5 разів. Офіційна документація Vue.js: «Vue дозволяє створювати реактивні користувацькі інтерфейси з мінімальними зусиллями».
Розробка на Vue.js для 1С-Бітрікс — спосіб перетворити важкий моноліт на чуйний інтерфейс. Ми застосовуємо його в проектах з каталогами від 10 000 SKU і гарантуємо час завантаження сторінки не більше 400 мс після впровадження. Сертифіковані розробники Бітрікс з досвідом 10+ років та понад 50 успішними впровадженнями забезпечують стабільну інтеграцію. Зв'яжіться з нами для консультації — оцінимо можливість прискорення безкоштовно.
Коли Vue виправданий?
Не кожному сайту потрібен фронтенд-фреймворк. Vue виправданий, коли стандартні компоненти Бітрікса не витягують. Основні сценарії:
Каталоги з важкою фільтрацією — catalog.smart.filter з AJAX працює, але на складних комбінаціях SKU-властивостей гальмує. Vue + API = миттєвий відгук. У нашого клієнта каталог на 80 000 товарів після переходу на Vue став завантажуватися на 60% швидше.
Конфігуратори та калькулятори — візуальні редактори, підбирачі комплектації з перерахунком цін у реальному часі.
Real-time — чати, сповіщення, оновлення залишків через WebSocket.
PWA — офлайн-режим, push-сповіщення, встановлення на домашній екран.
Як Vue.js вирішує проблеми UX у Бітріксі?
Порівняння: стандартний компонент bitrix:catalog.section при фільтрації 50 000 товарів видає сторінку за 800 мс + перезавантаження. Vue-віджет на базі REST API рендерить той самий список за 200–300 мс без перезавантаження — в 3–4 рази швидше. У нашій практиці клієнт отримав збільшення середньої глибини перегляду на 35% після впровадження. Економія на серверній інфраструктурі сягає 70% завдяки зменшенню кількості PHP-запитів.
Три архітектурні підходи до інтеграції Vue.js з Бітрікс
Острівний — Vue-віджети на сторінках Бітрікс
Окремі Vue-компоненти монтуються в div#app-filter, div#app-cart на стандартних сторінках Бітрікса. Маршрутизація та серверний рендеринг — як і раніше Бітрікс. Мінімальне втручання в існуючий сайт. Підходить для поетапної модернізації. Типовий приклад — реактивний фільтр замість catalog.smart.filter. В одному з проектів ми замінили фільтр на Vue-віджет за 2 тижні, конверсія зросла на 18%.
SPA на Vue + Бітрікс REST API
Фронтенд — повноцінне Vue-додаток з Vue Router. Бітрікс віддає дані через REST API: штатний модуль rest або кастомні контролери D7. Адмінка Бітрікса — для керування контентом, редактор не помічає різниці. Ідеально для особистих кабінетів, B2B-порталів та внутрішніх додатків, де SEO не критичний.
Nuxt.js + Бітрікс як headless CMS
Nuxt забезпечує SSR/SSG для індексації. Бітрікс — headless: віддає дані через API, керує контентом. Для магазинів і контентних сайтів, де SEO — пріоритет. Ми використовуємо Nuxt 3 з Vue Router для гібридного рендерингу — каталог статично, корзина SSR. Економія на ліцензіях і серверах після впровадження становить десятки тисяч гривень на рік.
Які особливості REST API Бітрікс важливі для Vue-розробки?
Тут зосереджено 70% часу при інтеграції Vue + Бітрікс.
Штатний REST-модуль
Інфоблоки, каталог, корзина (sale.basket.*), замовлення (sale.order.*), користувачі — з коробки. Обмеження: штатні методи не завжди покривають кастомну логіку. Метод catalog.product.list не віддає обчислювані властивості — потрібен кастомний ендпоінт.
Кастомні контролери D7
Клас Bitrix\Main\Engine\Controller — правильний спосіб створення API для Vue. Автоматична валідація параметрів, CSRF-захист з коробки, типізовані відповіді. Не ajax.php з $_POST — це шлях до ін'єкцій.
namespace App\Controller;
use Bitrix\Main\Engine\Controller;
class CatalogController extends Controller
{
public function getProductsAction(array $filter, int $page = 1): array
{
// ORM-запит до інфоблоку, не CIBlockElement::GetList
}
}
Авторизація та кешування
Авторизація: OAuth 2.0 для SPA або сесійні токени. Rate limiting — через Bitrix\Main\Engine\Controller або nginx. Кешування: API-відповіді кешуються на рівні D7 з тегованою інвалідацією. Змінився товар в інфоблоці — кеш скинувся по тегу iblock_id_X. Без цього при 100 RPS сервер ляже. Ми налаштовуємо це в кожному проекті — гарантія стабільності під навантаженням. Приклад налаштування тегованого кешування:
use Bitrix\Main\Data\Cache;
$cache = Cache::createInstance();
$tag = 'iblock_id_' . $iblockId;
if ($cache->initCache(3600, md5($filter), $tag)) {
return $cache->getVars();
}
// запит до БД
$cache->startDataCache();
$cache->endDataCache($data);
\CIBlock::registerWithTagCache($iblockId);
Якою має бути структура Vue-додатку для Бітрікса?
Vue Router — lazy loading маршрутів через defineAsyncComponent. Каталог не тягне за собою код особистого кабінету.
Pinia — стейт-менеджмент: каталог, корзина, користувач, фільтри. Модульна архітектура сховища. Vuex — легасі, нові проекти на Pinia.
Axios з перехоплювачами: автоматичне оновлення CSRF-токена, retry при 503, обробка помилок авторизації.
Vue Query (TanStack Query) — кешування API-запитів, автоматична ревалідація, оптимістичні оновлення. Користувач додав товар у корзину — UI оновився миттєво, запит до API пішов фоном.
Каталог на Vue — розбір ключового кейсу
Різниця в UX відчувається одразу. Конкретика:
Фільтр — чекбокси, range-слайдери, select з пошуком. Стан синхронізується з URL через vue-router query params — посилання з фільтрами можна відправити колезі.
Картка товару — галерея з зумом, перемикання SKU (колір/розмір), ціна перераховується через API catalog.product.offer.list, залишки по складах з catalog.store.product.list.
Віртуальний скролінг — vue-virtual-scroller рендерить лише видимі елементи. Каталог у 10 000 товарів працює без гальм.
Розумний пошук — debounced-запити до search.title.search або ElasticSearch, автодоповнення через випадаючий список. У нашому проекті це скоротило час пошуку на 40%.
Порівняння — динамічна таблиця характеристик з підсвічуванням відмінностей. Зберігання в Pinia + localStorage для персистентності.
Процес впровадження Vue.js покроково:
Аудит поточної архітектури Бітрікса та виявлення вузьких місць (фільтрація, корзина, особистий кабінет).
Проектування API — визначаємо ендпоінти, моделі даних, використовуємо Bitrix\Main\Engine\Controller.
Розробка Vue-віджетів або SPA — збірка на Vite, Code Splitting, Pinia.
Інтеграція з Бітріксом — теговане кешування, OAuth, обробка помилок.
Тестування під навантаженням (до 100 RPS) та деплой з CI/CD.
Продуктивність досягається за рахунок code splitting, tree shaking та lazy loading важких компонентів (Chart.js, карти, WYSIWYG). Бандл сторінки каталогу — 80–120 КБ gzip.
Nuxt.js і SEO: як зберегти індексацію
SPA на чистому Vue віддає пошуковику порожній HTML з <div id="app"></div>. Google вміє рендерити JS, але з затримкою в дні. Яндекс — взагалі непередбачувано. Nuxt.js вирішує:
SSR — сервер віддає повний HTML, після гідратації працює як SPA.
SSG — сторінки генеруються при nuxt generate, роздаються з CDN. Максимальна швидкість.
Гібридний режим — каталог статично, корзина та ЛК — SSR.
useHead() — динамічні title, description, Open Graph, Schema.org для кожної сторінки.
Sitemap — @nuxtjs/sitemap, маршрути з API Бітрікса. Це забезпечує повну індексацію — наша гарантія потрапляння в топ-5 Google.
Порівняння підходів та строки
Ситуація
Рекомендований підхід
Ефект для бізнесу
Каталог 10 000+ SKU, складний фільтр
Vue-віджети
Прискорення в 3–5 разів, зростання конверсії 15-25%
B2B-портал, особистий кабінет
SPA на Vue
Зниження навантаження на сервер до 70%
Магазин з SEO-пріоритетом
Nuxt.js + headless
Індексація 100% сторінок, швидкість завантаження 0,8 с
Підхід
Строки
Що на виході
Vue-віджети (2–5 компонентів)
1–3 тижні
Реактивні елементи на існуючому сайті
SPA для особистого кабінету
4–8 тижнів
Vue-додаток + API на контролерах D7
Каталог на Vue + Бітрікс API
4–10 тижнів
Фільтрація, корзина, порівняння без перезавантажень
Nuxt.js + Бітрікс headless
6–12 тижнів
SSR/SSG, повна функціональність, SEO
Повний цикл: проектування API, розробка контролерів D7, Vue-додаток, налаштування Vite, тестування, деплой. Код рев'юється, покривається тестами, документується — не «зібрав і забув». Вартість розробки розраховується індивідуально після аналізу вашого поточного сайту та ТЗ. Детальну оцінку ви отримаєте протягом дня — замовте консультацію.
Типові помилки при інтеграції Vue.js і Бітрікс
Використання ajax.php замість Bitrix\Main\Engine\Controller — призводить до вразливостей та нестабільності.
Відсутність тегованого кешування API — при високому навантаженні сервер не витримує.
Ігнорування авторизації OAuth для SPA — сесійні токени можуть закінчуватися, ламаючи UX.
Повний перепис всього сайту на SPA без необхідності — збільшує строки та бюджет.
Неправильне налаштування Nuxt SSR — повільна генерація сторінок на бекенді.
Що входить у роботу та наші гарантії
Документація API (Swagger/OpenAPI) для інтеграції з вашим бекендом.
Доступи до репозиторію з кодом та CI/CD.
Навчання вашої команди роботі з Vue-компонентами.
Пост-релізна підтримка на 1 місяць — гарантія стабільності.
Код відповідає стандартам PSR-12 та Bitrix\Main\Engine\Controller.
Замовте розробку Vue.js інтерфейсів для вашого Бітрікс-проекту — отримайте консультацію та оцінку строків протягом дня. Напишіть нам, і ми надішлемо комерційну пропозицію з детальним планом робіт. Оцінимо проект безкоштовно — просто надішліть ТЗ або посилання на поточний сайт.