Разработка компонента сравнения товаров на Vue.js для 1С-Битрикс

Разработка компонента сравнения товаров на Vue.js для 1С-Битрикс

Стандартный компонент сравнения Битрикс (bitrix:catalog.compare.buy + bitrix:catalog.compare.result) работает через перезагрузку страницы: пользователь добавляет товар в сравнение, страница обновляется, счётчик меняется. На странице сравнения — статичная таблица. Всё это работало в 2010 году; сегодня UX-ожидания другие. Vue.js-версия: добавление в сравнение — мгновенно, счётчик в шапке обновляется без перезагрузки, таблица сравнения умеет скрывать одинаковые характеристики.

Хранение списка сравнения

Стандартный Битрикс хранит сравнение в сессии PHP ($_SESSION). Для Vue-версии лучше localStorage с синхронизацией на сервер для авторизованных пользователей — так список сохраняется между сессиями и устройствами.

// stores/compareStore.ts (Pinia)
export const useCompareStore = defineStore('compare', {
    state: () => ({
        items: [] as number[], // product IDs
    }),

    actions: {
        async add(productId: number) {
            if (this.items.includes(productId)) return
            if (this.items.length >= 4) {
                alert('Можно сравнивать до 4 товаров одновременно')
                return
            }
            this.items.push(productId)
            localStorage.setItem('compare_items', JSON.stringify(this.items))

            // Синхронизация с сервером для авторизованных
            if (isLoggedIn()) {
                await fetch('/local/api/compare/add/', {
                    method: 'POST',
                    body: JSON.stringify({ product_id: productId }),
                })
            }
        },

        remove(productId: number) {
            this.items = this.items.filter(id => id !== productId)
            localStorage.setItem('compare_items', JSON.stringify(this.items))
        },

        isInCompare: (state) => (productId: number) => state.items.includes(productId),
    },

    getters: {
        count: (state) => state.items.length,
    },
})

При инициализации приложения список загружается из localStorage (для гостей) или из API (для авторизованных, с мержем между устройствами).

Кнопка «Сравнить» на карточке товара

<!-- CompareButton.vue -->
<template>
  <button
    :class="['compare-btn', { 'compare-btn--active': isAdded }]"
    @click="toggle"
    :title="isAdded ? 'Убрать из сравнения' : 'Добавить к сравнению'"
  >
    <IconScale :filled="isAdded" />
    <span>{{ isAdded ? 'В сравнении' : 'Сравнить' }}</span>
  </button>
</template>

<script setup lang="ts">
const props = defineProps<{ productId: number }>()
const store = useCompareStore()
const isAdded = computed(() => store.isInCompare(props.productId))

function toggle() {
    isAdded.value ? store.remove(props.productId) : store.add(props.productId)
}
</script>

Кнопка монтируется на каждой карточке товара. В Битрикс-шаблоне:

// В template.php карточки товара
?>
<div data-compare-btn data-product-id="<?= $arItem['ID'] ?>"></div>
<?php
// После загрузки страницы Vue монтирует CompareButton в каждый [data-compare-btn]

Счётчик в шапке сайта

<!-- CompareCounter.vue (монтируется в header) -->
<template>
  <a href="/compare/" class="header-compare">
    <IconScale />
    <span class="badge" v-if="count > 0">{{ count }}</span>
  </a>
</template>

<script setup lang="ts">
const store = useCompareStore()
const count = computed(() => store.count)
</script>

Счётчик реактивно обновляется через Pinia — никакого глобального EventBus или DOM-манипуляций.

Страница сравнения

Самая сложная часть — таблица сравнения. Данные о товарах загружаются с сервера по списку ID:

// В CompareTable.vue
async function loadCompareData(ids: number[]) {
    const res  = await fetch(`/local/api/compare/?ids=${ids.join(',')}`)
    const data = await res.json() // [{id, name, price, specs: {...}}, ...]
    products.value = data
    buildDiffMap()
}

// Определяем одинаковые характеристики для возможности их скрыть
function buildDiffMap() {
    const allSpecs = new Set(products.value.flatMap(p => Object.keys(p.specs)))
    diffMap.value  = {}

    allSpecs.forEach(spec => {
        const values = products.value.map(p => p.specs[spec])
        diffMap.value[spec] = new Set(values).size > 1 // true = есть различия
    })
}

Фильтр «Показать только различия» — кнопка, которая скрывает строки, где все значения одинаковые:

<template>
  <table class="compare-table">
    <thead>
      <tr>
        <th>Характеристика</th>
        <th v-for="p in products" :key="p.id">
          <ProductCard :product="p" @remove="store.remove(p.id)" />
        </th>
      </tr>
    </thead>
    <tbody>
      <tr
        v-for="spec in visibleSpecs"
        :key="spec"
        :class="{ 'row--different': diffMap[spec] }"
      >
        <td class="spec-name">{{ specLabels[spec] }}</td>
        <td v-for="p in products" :key="p.id">{{ p.specs[spec] ?? '—' }}</td>
      </tr>
    </tbody>
  </table>
</template>

<script setup lang="ts">
const showOnlyDiff = ref(false)
const visibleSpecs = computed(() =>
    showOnlyDiff.value
        ? Object.keys(diffMap.value).filter(k => diffMap.value[k])
        : Object.keys(diffMap.value)
)
</script>

PHP-контроллер данных сравнения

// CompareController.php
public function getAction(string $ids): array {
    $idArr = array_filter(array_map('intval', explode(',', $ids)));
    if (!$idArr) return [];

    $products = [];
    $res = CIBlockElement::GetList(
        [],
        ['ID' => $idArr, 'IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'],
        false, false,
        ['ID', 'NAME', 'PREVIEW_PICTURE', 'DETAIL_PAGE_URL', 'CATALOG_PRICE_1_']
    );

    while ($el = $res->GetNext()) {
        // Получаем свойства для сравнения
        $props = [];
        $prRes = CIBlockElement::GetProperty(CATALOG_IBLOCK_ID, $el['ID'], [], ['COMPARE' => 'Y']);
        while ($pr = $prRes->Fetch()) {
            $props[$pr['CODE']] = $pr['VALUE'];
        }
        $products[] = [
            'id'    => $el['ID'],
            'name'  => $el['NAME'],
            'price' => $el['CATALOG_PRICE_1_'],
            'image' => $el['PREVIEW_PICTURE'] ? CFile::GetPath($el['PREVIEW_PICTURE']) : null,
            'url'   => $el['DETAIL_PAGE_URL'],
            'specs' => $props,
        ];
    }

    return $products;
}

Свойства, участвующие в сравнении, помечаются флагом COMPARE = 'Y' в настройках инфоблока — стандартный механизм Битрикс.

Зафиксированная первая колонка на мобильном

Таблица сравнения на мобильном — горизонтальная прокрутка. Первая колонка (названия характеристик) должна быть зафиксирована:

.compare-table {
    display: grid;
    grid-template-columns: 180px repeat(4, 1fr);
    overflow-x: auto;
}

.compare-table td:first-child,
.compare-table th:first-child {
    position: sticky;
    left: 0;
    background: white;
    z-index: 1;
}

CSS Grid с position: sticky — более надёжный подход, чем display: table с фиксированными колонками.

Сроки

Сравнение товаров — инструмент для покупателей, которые выбирают среди похожих позиций. Правильно реализованное сравнение помогает принять решение на сайте, а не уйти на агрегатор.