☰
ELEMENTOR / PRACTICE

Кастомні атрибути в Elementor: аналітика, JavaScript і доступність

Кастомні атрибути в Elementor: аналітика, JavaScript і доступність

Кастомні атрибути в Elementor дають змогу додавати до елементів власні HTML-параметри без редагування шаблонів і написання окремого коду. Найчастіше їх використовують для аналітики, обробки кліків через JavaScript, інтеграцій і покращення доступності.

Це практична альтернатива великій кількості унікальних ID та класів. Наприклад, однаковим кнопкам можна призначити атрибут data-cta з різними значеннями, а потім передавати ці значення в Google Tag Manager або власний скрипт.

Де додавати кастомні атрибути в Elementor

Відкрийте потрібну сторінку або шаблон в Elementor і виберіть віджет, контейнер чи інший елемент, до якого потрібно додати атрибут. У панелі налаштувань перейдіть до вкладки «Додатково», знайдіть блок «Кастомні атрибути» та введіть параметри у відповідному полі.

Кожен атрибут потрібно вказувати з нового рядка. Формат запису: назва|значення. Символ вертикальної риски розділяє назву атрибута та його значення.

  • data-cta|consultation
  • data-plan|pro
  • aria-label|Відкрити меню
  • rel|nofollow

Які атрибути використовують найчастіше

Найбезпечніший і найгнучкіший варіант для власних задач — атрибути data-*. Вони призначені для зберігання додаткових даних у HTML і не змінюють вигляд елемента. Назву після data- можна сформувати під конкретну задачу, але краще використовувати зрозумілу та послідовну схему.

Стандартні HTML-атрибути також можна додавати, однак їхня поведінка залежить від типу елемента. Наприклад, rel має сенс для посилань, а не для звичайного контейнера.

  • data-cta|consultation — категорія або тип цільової дії.
  • data-plan|pro — тариф, пакет чи варіант пропозиції.
  • data-location|hero — розташування елемента на сторінці.
  • aria-label|Відкрити меню — доступна назва для елемента без видимого тексту.
  • rel|nofollow — додатковий атрибут посилання, якщо він потрібен за SEO або технічними правилами.

Як використовувати атрибути для аналітики

Якщо на сайті є кілька однакових кнопок, одного тексту або класу може бути недостатньо для точного аналізу. Додайте до кожної кнопки зрозумілі data-атрибути, які описують її призначення та місце розташування.

Наприклад, для кнопки консультації у першому екрані можна задати data-cta|consultation і data-location|hero. Для такої самої дії в нижній частині сторінки значення data-location буде іншим. У Google Tag Manager можна налаштувати тригер кліку та передавати ці значення як параметри події.

Назви й значення бажано писати в одному стилі: латиницею, без випадкових пробілів і з узгодженим використанням дефісів або підкреслень. Це спрощує фільтрацію звітів і подальшу роботу з JavaScript.

  • Не використовуйте для аналітики персональні дані, email-адреси або іншу конфіденційну інформацію.
  • Не створюйте різні назви для однакової дії: наприклад, consultation, consult і request для одного типу заявки.
  • Перевіряйте не лише факт кліку, а й правильність значень, які передаються в систему аналітики.
  • Для критично важливих конверсій не покладайтеся тільки на один атрибут: додатково перевіряйте саму подію та її джерело.
data-cta|consultation
data-location|hero
data-plan|pro

Кастомні атрибути для JavaScript та інтеграцій

JavaScript може знаходити елементи за data-атрибутами та виконувати потрібну дію: відкривати модальне вікно, перемикати тариф, запускати калькулятор або передавати дані у сторонній сервіс. Це зручніше, ніж прив’язувати логіку до тексту кнопки, який редактор може змінити.

Для вибору елементів використовують CSS-селектори на кшталт [data-cta="consultation"]. Скрипт при цьому не залежить від конкретного ID, але його потрібно тестувати після змін у шаблоні та під час оновлення Elementor або інших плагінів.

Не додавайте атрибути із секретними ключами, токенами чи паролями. HTML, який отримує браузер, доступний користувачу, тому кастомні атрибути не є способом захисту даних.

  • Використовуйте атрибути для опису ролі елемента, а не для зберігання великого обсягу даних.
  • Якщо скрипт очікує конкретне значення, не змінюйте його вручну без перевірки пов’язаного коду.
  • Після додавання атрибутів перевірте роботу на комп’ютері, смартфоні та в різних станах елемента.
const buttons = document.querySelectorAll('[data-cta="consultation"]');

buttons.forEach((button) => {
  button.addEventListener('click', () => {
    console.log(button.dataset.location);
  });
});

Доступність: коли потрібен aria-label

ARIA-атрибути допомагають допоміжним технологіям зрозуміти призначення елемента. Проте aria-label не потрібно додавати до кожної кнопки. Якщо кнопка має видимий і зрозумілий текст «Замовити консультацію», цього тексту зазвичай достатньо як доступної назви.

aria-label доречний для іконки без підпису, кнопки відкриття мобільного меню, кнопки закриття модального вікна або іншого елемента, чию функцію неможливо зрозуміти з видимого вмісту.

Значення має коротко описувати дію, а не зовнішній вигляд. Варіант «Іконка» нічого не пояснює, тоді як «Відкрити меню» або «Закрити вікно» є зрозумілими.

  • Не дублюйте видимий текст без потреби: це може створити зайві або суперечливі назви для скринрідера.
  • Не використовуйте aria-label як заміну зрозумілому тексту на всіх елементах сторінки.
  • Перевіряйте, чи атрибут справді потрапив на інтерактивний HTML-елемент, а не лише на зовнішній контейнер.
  • Для іконкових кнопок також подбайте про клавіатурну доступність і помітний стан фокусу.
aria-label|Відкрити меню

Перевірка атрибутів і типові помилки

Після збереження сторінки відкрийте її у браузері та перегляньте HTML через інструменти розробника. Переконайтеся, що атрибут доданий до потрібного елемента, назва написана правильно, а значення не обрізане та не містить випадкових пробілів.

Окремо перевірте поведінку на опублікованій сторінці, а не лише в редакторі Elementor. Кешування, оптимізація HTML або додаткові плагіни можуть впливати на підсумкову розмітку чи роботу скриптів.

  • Не плутайте формат Elementor назва|значення зі звичайним HTML-синтаксисом name="value".
  • Не додавайте пробіли навколо вертикальної риски, якщо ваш сценарій або інтеграція чутливі до значень.
  • Не використовуйте однаковий ID для багатьох елементів; для групування краще підходять data-атрибути або класи.
  • Не додавайте rel|nofollow до елементів, які не є посиланнями.
  • Перевіряйте атрибути після копіювання віджета, імпорту шаблону та масового редагування.

Поширені запитання

Чи можна додати кілька кастомних атрибутів до одного елемента в Elementor?

Так. Вкажіть кожен атрибут з нового рядка у форматі назва|значення. Наприклад, data-cta|consultation і data-location|hero.

Чим data-атрибут відрізняється від класу або ID?

Клас зазвичай використовують для стилів або групування елементів, ID має бути унікальним, а data-атрибут зручно застосовувати для опису даних і передачі значень у GTM чи JavaScript.

Чи потрібно додавати aria-label до кнопки з текстом?

Зазвичай ні, якщо видимий текст коротко й однозначно описує дію. aria-label потрібен переважно для елементів без зрозумілого текстового підпису.

Чому атрибут не працює в Google Tag Manager?

Перевірте, чи атрибут доданий саме до елемента, на який натискають, чи правильно записані назва та значення, а також чи тригер GTM шукає потрібний параметр у правильному об’єкті події.

Висновок

Кастомні атрибути в Elementor допомагають розділити візуальне оформлення та технічну логіку сторінки. Через data-* можна зручно маркувати CTA для аналітики й скриптів, а ARIA-атрибути — уточнювати призначення елементів для користувачів допоміжних технологій.

Додавайте лише ті атрибути, які справді потрібні, використовуйте єдину систему назв і перевіряйте готову розмітку в браузері. Так структура сторінки залишатиметься зрозумілою, а інтеграції — стабільнішими.

← Усі матеріали Elementor