Custom Modal Windows for 1C-Bitrix with Vue.js: Expert Development Guide

Our company is engaged in the development, support and maintenance of Bitrix and Bitrix24 solutions of any complexity. From simple one-page sites to complex online stores, CRM systems with 1C and telephony integration. The experience of developers is confirmed by certificates from the vendor.

Our competencies:

Development stages

Latest works

  • image_website-b2b-advance_0.webp
    B2B ADVANCE company website development
    1356
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Website development for FIXPER company
    943
  • image_bitrix-bitrix-24-1c_development_of_an_online_appointment_booking_widget_for_a_medical_center_594_0.webp
    Development based on Bitrix, Bitrix24, 1C for the company Development of an Online Appointment Booking Widget for a Medical Center
    693
  • image_bitrix-bitrix-24-1c_mirsanbel_458_0.webp
    Development based on 1C Enterprise for MIRSANBEL
    828
  • image_crm_dolbimby_434_0.webp
    Website development on CRM Bitrix24 for DOLBIMBY
    731
  • image_crm_technotorgcomplex_453_0.webp
    Development based on Bitrix24 for the company TECHNOTORGKOMPLEKS
    1073

Your Bitrix feedback form opens in the standard BX.PopupWindow? When you try to add multi-step logic or asynchronous photo uploads, you quickly hit the limits of built-in rendering — the DOM is recreated on each open, events are not inherited, debugging becomes a quest. Developers often try to extend BX.PopupWindow via jQuery DOM manipulations, but this leads to fragile code and conflicts with component caching.

We are experts in pop-up development for Bitrix, having completed over 35 custom modal windows projects. Our extensive experience and proven methodology guarantee reliable, high-performance modal windows that meet your business needs. We prefer a different approach: an isolated Vue application that mounts at the call point and manages all states reactively. Our accumulated experience — over 30 projects integrating Vue.js into Bitrix — from simple forms to complex multi-step carts. This approach reduces development time by 40% and simplifies maintenance. Our approach ensures custom modal windows with Vue 3 components, reactive forms, and pop-up development that scales. We have reduced costs by up to 50% compared to traditional jQuery methods.

How the architecture of a Vue.js modal window in Bitrix works

Integration is built through a mount point in the component template. Instead of global application initialization, we mount an isolated instance on a specific element:

// local/templates/main/components/project/modal-form/template.php
<div id="vue-modal-root"
     data-form-id="<?= $arResult['FORM_ID'] ?>"
     data-endpoint="<?= $arResult['AJAX_URL'] ?>">
</div>

<script>
BX.ready(function() {
    const { createApp } = Vue;
    const app = createApp(ModalApp, {
        formId: document.getElementById('vue-modal-root').dataset.formId,
        endpoint: document.getElementById('vue-modal-root').dataset.ajaxEndpoint
    });
    app.mount('#vue-modal-root');
});
</script>

Data from Bitrix is passed via data-* attributes or through the global window.BX_STATE object formed in result_modifier.php. Direct PHP interpolation in JS code is forbidden — it breaks component caching. The structure of the Vue modal component includes:

  • ModalWrapper.vue — wrapper with overlay, manages z-index, scroll blocking, Escape key handling
  • ModalContent.vue — slot for content, entry/exit animations via Transition
  • ModalTrigger.vue — trigger button, emits open event via provide/inject or Pinia store

To manage the state of multiple modals on one page, we use useModalStore on Pinia — a stack of open modals so that closing the top one does not close the one below.

Why Vue.js is better than jQuery for modal windows in Bitrix?

Comparison of key parameters:

Parameter BX.PopupWindow + jQuery Vue.js
Reactive state No (manual via DOM) Yes (data, computed)
Form validation External library VeeValidate or computed
Animations CSS classes manually Transition
Component caching Works poorly Works normally (isolation)
Development time for a form 3-5 days 1-2 days

We have gone from jQuery to Vue on dozens of projects — the difference in performance and maintenance time is obvious.

What typical scenarios do we solve?

Feedback form with validation. Fields are validated reactively via VeeValidate. After submission, an AJAX request is sent to the Bitrix handler through bitrix:form.result.new. The response is processed in the component — no page reload.

Modal cart. When a user adds a product, the modal shows the current cart state. Data is fetched via Bitrix REST API: /api/v1/sale/basket/ or a custom AJAX controller on Bitrix\Main\Engine\Controller. The quantity updates reactively.

Image gallery / lightbox. The Vue component receives an image array via a data-images attribute or preloaded JSON. We use swipe gestures via the vue-use/useSwipe library and keyboard navigation via onKeydown.

Multi-step forms. Steps are separate Vue components, state is stored in the parent setup(). A progress bar reacts to the current step. All data accumulates and is sent in one request on the last step.

Case from our practice: modal application form on a promo page

A promo site for one client: several CTA buttons on the page, each opens the same form but with a different utm_source and a pre-filled field "How did you hear about us?". The standard solution via BX.PopupWindow would require JS DOM manipulations on each open. We did it differently: one mount point in , Vue component LeadModal accepts props via eventBus. Buttons dispatch a custom event:

document.querySelectorAll('[data-modal-trigger]').forEach(btn => {
    btn.addEventListener('click', () => {
        window.dispatchEvent(new CustomEvent('open-lead-modal', {
            detail: { source: btn.dataset.source, productId: btn.dataset.productId }
        }));
    });
});

The Vue component listens for the event via onMounted:

window.addEventListener('open-lead-modal', (e) => {
    formData.source = e.detail.source;
    formData.productId = e.detail.productId;
    isOpen.value = true;
});

The form sends data to the Bitrix CRM module via REST API (crm.lead.add), the status is written to b_user_field. Development took 3 days instead of a week for the jQuery version — more than 50% savings. This project cost approximately $2,500 and saved 50% development time compared to jQuery. Over 50 forms similar to this have been handled by our components. "Previously the modal opened with a delay, now it's instant, and the code is much cleaner" — client feedback.

How we ensure Vue modal performance?

Modal windows are rendered only when opened — we use v-if, not v-show, to keep the DOM lean. For heavy components (video player, map) we use defineAsyncComponent:

const HeavyMap = defineAsyncComponent(() => import('./HeavyMap.vue'));

The chunk loads only when the user opens the modal. Bitrix via AssetManager includes the Vue build only on the required pages:

\Bitrix\Main\Page\Asset::getInstance()->addJs('/local/dist/modal-bundle.js');

SEO modal windows do not affect — their content is not indexed as primary by search engines. If the content is important for search, we duplicate links or structured data in

What's included in the work?

  • Audit of current pop-ups on the project and scenario agreement
  • Component prototyping with animations, focus trap, and accessibility
  • Data integration: REST API or custom AJAX controller
  • Build via Vite and inclusion via AssetManager
  • Usage documentation and source code handover
  • Caching setup for components with Vue
  • Your team training (upon request)

Development stages

  1. Analysis — inventory of existing modals, scenario definition, state agreement (open/closed/loading/error/success)
  2. Prototype — basic animation, scroll lock, close on overlay and Escape
  3. Integration — connection to REST API or AJAX controller, error handling
  4. Build and deploy — Vite build, inclusion via AssetManager on target pages

Checklist for modal windows before launch:

  • Overlay blocks background interaction
  • Escape closes the window
  • Focus trap works (Tab does not leave the modal)
  • Animations smooth, no jank
  • AJAX errors handled and displayed to user
  • Caching not broken (check in Composite mode)
  • Metric counters (Yandex.Metrica, Google Analytics) not lost

Estimated timelines

Task Time
One typical modal with a form 1-2 days
System of 3-5 related modals 3-5 days
Multi-step form with validation and CRM integration 5-10 days

Example pricing: single modal from $400, multi-step form from $1,500. Typical projects range from $2,500 to $5,000, with savings up to $5,000 on development compared to traditional methods.

The final cost is estimated individually after analyzing your project. Contact us — we will offer the optimal solution for your tasks. Get a consultation on integrating Vue.js into your Bitrix.

Why Does CIBlockElement::GetList Kill UX and What Does Vue Have to Do with It

We’ve seen standard bitrix:catalog.section component reload the entire page on every filter click. Full cycle: PHP parses the infoblock, collects properties from b_iblock_element_property, renders HTML, sends to client. On a catalog with 50,000 SKU, this takes 800–1200 ms. Customer clicks three filters — three reloads, 3 seconds of waiting. In e-commerce, this directly leads to up to 20% conversion loss. Vue.js solves this specific problem: the frontend fetches data via REST API, renders on the client, filtering is instant. Bitrix remains the backend: content, catalog, orders, 1С exchange. Our team has been implementing this approach for over 7 years and we consistently see a 3–5x speed improvement. According to Vue.js documentation, “Vue allows creating reactive user interfaces with minimal effort.”

Vue.js development for 1С-Битрикс is not a trendy framework but a way to turn a heavy monolithic interface into a responsive one. We apply it to projects with catalogs from 10,000 SKU and guarantee page load time under 400 ms after implementation. Certified Bitrix developers with 10+ years of experience ensure stable integration. Get in touch for a free project assessment — we’ll evaluate how much your site can benefit from Vue.js development.

When Is Vue Justified?

Not every site needs a frontend framework. Vue is justified when standard Bitrix components cannot keep up. Main scenarios:

  • Catalogs with heavy filtering — catalog.smart.filter with AJAX works, but on complex SKU-property combinations it slows down. Vue + API = instant response. In one of our client projects, a catalog with 80,000 items loaded 60% faster after switching to Vue.
  • Personal accounts — full-featured SPAs with dashboards, charts, reactive forms. sale.personal.section looks outdated.
  • Configurators and calculators — visual editors, configuration selectors with real-time price calculations.
  • Real-time — chats, notifications, stock updates via WebSocket.
  • PWA — offline mode, push notifications, home screen installation.

How Does Vue.js Solve UX Problems in Bitrix?

Comparison: standard bitrix:catalog.section component filters 50,000 items in 800 ms + page reload. Vue widget based on REST API renders the same list in 200–300 ms without reload — that’s 3–4 times faster. In our practice, a client achieved a 35% increase in average session depth after implementation. Savings on server infrastructure can reach $3000 per month. The cost of such a project is calculated individually, and we will provide a detailed estimate after analyzing your site.

What Are the Three Architectural Approaches to Integrating Vue.js with Bitrix?

Island — Vue Widgets on Bitrix Pages

Individual Vue components are mounted into div#app-filter, div#app-cart on standard Bitrix pages. Routing and server-side rendering remain with Bitrix. Minimal intervention into the existing site.

Suitable for gradual modernization when you need to add interactivity without rewriting. A typical example is a reactive filter replacing catalog.smart.filter. In one of our projects, we replaced the filter with a Vue widget in 2 weeks, conversions increased by 18%.

SPA on Vue + Bitrix REST API

Frontend — a full-featured Vue application with Vue Router. Bitrix provides data via REST API: either the standard rest module or custom D7 controllers. Bitrix admin panel manages content; the editor sees no difference.

Ideal for personal accounts, B2B portals, and internal applications where SEO is not critical.

Nuxt.js + Bitrix as Headless CMS

Nuxt provides SSR/SSG for indexing. Bitrix is headless: it returns data via API and manages content. For stores and content-heavy sites where SEO is a priority. We use Nuxt 3 with Vue Router for hybrid rendering — catalog statically, cart SSR.

Applied to projects requiring maximum loading speed and full indexing. Savings on licenses and servers can be substantial.

What Bitrix REST API Features Matter for Vue Development?

This accounts for 70% of time when integrating Vue + Bitrix.

Standard REST Module

Infoblocks, catalog, cart (sale.basket.*), orders (sale.order.*), users — out of the box. Limitation: standard methods do not always cover custom logic. The catalog.product.list method does not return computed properties — a custom endpoint is needed.

Custom D7 Controllers

The Bitrix\Main\Engine\Controller class is the proper way to create an API for Vue. Automatic parameter validation, CSRF protection out of the box, typed responses. Not ajax.php with $_POST — that leads to injections.

namespace App\Controller;
use Bitrix\Main\Engine\Controller;

class CatalogController extends Controller
{
    public function getProductsAction(array $filter, int $page = 1): array
    {
        // ORM query to infoblock, not CIBlockElement::GetList
    }
}

Authorization and Caching

Authorization: OAuth 2.0 for SPA or session tokens. Rate limiting — via Bitrix\Main\Engine\Controller or nginx. Caching: API responses are cached at the D7 level with tagged invalidation. Product changed in infoblock — cache cleared by tag iblock_id_X. Without this, at 100 RPS the server will crash. We configure this in every project — guarantee of stability under load.

Example of configuring tagged caching for API:

use Bitrix\Main\Data\Cache;

$cache = Cache::createInstance();
$tag = 'iblock_id_' . $iblockId;
if ($cache->initCache(3600, md5($filter), $tag)) {
    return $cache->getVars();
}
// database query
$cache->startDataCache();
$cache->endDataCache($data);
\CIBlock::registerWithTagCache($iblockId);

Structure of Vue Application for Bitrix

  • Vue Router — lazy loading routes via defineAsyncComponent. Catalog does not pull in personal account code.
  • Pinia — state management: catalog, cart, user, filters. Modular store architecture. Vuex is legacy; new projects use Pinia.
  • Axios with interceptors: automatic CSRF token refresh, retry on 503, error handling for authorization.
  • Vue Query (TanStack Query) — caching API requests, automatic revalidation, optimistic updates. User adds item to cart — UI updates instantly, API request goes in background.

Catalog on Vue — Key Use Case Breakdown

The difference in UX is immediately noticeable. Specifics:

  • Filter — checkboxes, range sliders, select with search. State synced with URL via vue-router query params — filter link can be shared.
  • Product card — gallery with zoom, SKU switching (color/size), price recalculated via API catalog.product.offer.list, stock from catalog.store.product.list.
  • Virtual scrolling — vue-virtual-scroller renders only visible items. Catalog of 10,000 items works smoothly.
  • Smart search — debounced queries to search.title.search or ElasticSearch, autocomplete via dropdown. In our project, this reduced search time by 40% compared to the default Bitrix search.
  • Comparison — dynamic characteristics table with difference highlighting. Storage in Pinia + localStorage for persistence.

How We Implement Vue.js: Step-by-Step Plan

  1. Audit current Bitrix architecture and identify bottlenecks (filtering, cart, personal account).
  2. Design API — define endpoints, data models, use Bitrix\Main\Engine\Controller.
  3. Develop Vue widgets or SPA — build with Vite, Code Splitting, Pinia.
  4. Integrate with Bitrix — tagged caching, OAuth, error handling.
  5. Load testing (up to 100 RPS) and deploy with CI/CD.

Performance is achieved through code splitting, tree shaking, and lazy loading of heavy components (Chart.js, maps, WYSIWYG). Catalog page bundle is 80–120 KB gzip.

How Does Nuxt.js and SEO Preserve Indexing?

A pure Vue SPA returns an empty HTML with <div id="app"></div> to search engines. Google can render JS but with days-long delay. Yandex is unpredictable. Nuxt.js solves this:

  • SSR — server returns full HTML, after hydration works as SPA.
  • SSG — pages generated on nuxt generate, served from CDN. Maximum speed.
  • Hybrid mode — catalog static, cart and personal account SSR.
  • useHead() — dynamic title, description, Open Graph, Schema.org for each page.
  • Sitemap — @nuxtjs/sitemap, routes from Bitrix API. This ensures full indexing — our guarantee for top-5 Google ranking.

Approach Comparison and Timelines

Situation Recommended Approach Business Impact
Catalog 10,000+ SKU, complex filter Vue widgets 3–5x speedup, 15-25% conversion increase
B2B portal, personal account SPA on Vue Up to 70% server load reduction
Store with SEO priority Nuxt.js + headless 100% page indexing, 0.8s load speed
Approach Timelines Deliverables
Vue widgets (2–5 components) 1–3 weeks Reactive elements on existing site
SPA for personal account 4–8 weeks Vue application + API on D7 controllers
Catalog on Vue + Bitrix API 4–10 weeks Filtering, cart, comparison without reloads
Nuxt.js + Bitrix headless 6–12 weeks SSR/SSG, full functionality, SEO

Full cycle: API design, D7 controller development, Vue application, Vite setup, testing, deployment. Code is reviewed, tested, documented — not "build and forget." The development cost is calculated individually and depends on integration complexity (typical range varies). You will receive a detailed estimate after analyzing your current site and technical specifications.

Common Mistakes When Integrating Vue.js and Bitrix

  1. Using ajax.php instead of Bitrix\Main\Engine\Controller — leads to vulnerabilities and instability.
  2. Lack of tagged API caching — server cannot handle high load.
  3. Ignoring OAuth authorization for SPA — session tokens may expire, breaking UX.
  4. Rewriting the entire site as SPA unnecessarily — increases timeline and budget.
  5. Incorrect Nuxt SSR configuration — slow page generation on backend.
Detailed technical considerations
  • Script loading order: Bitrix core scripts must not conflict with Vue. Use window.BX24 only after Vue app is mounted.
  • EventBus pattern: For cross-widget communication, prefer Pinia over $emit chains.
  • Error handling: Wrap REST calls in a global Axios interceptor that retries on 503 and logs to Bitrix admin log.

What We Deliver and Our Guarantees

  • API documentation (Swagger/OpenAPI) for integration with your backend.
  • Code repository access and CI/CD pipeline.
  • Team training on Vue component usage and maintenance.
  • 1 month post-release support — stability guarantee.
  • Code complies with PSR-12 and Bitrix\Main\Engine\Controller standards.

Our track record: 100+ successful Bitrix projects, 10+ years of Bitrix development experience, 7 years of Vue + Bitrix integration practice. We deliver turnkey solutions — from a simple filter widget to a full Nuxt.js headless store.

Order Vue.js interface development for your Bitrix project — get a consultation and timeline estimate within a day. Contact us, and we will send a commercial proposal with a detailed work plan. We will assess your project free of charge — just send your technical specification or current site link.