Кастомні атрибути в 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-атрибути — уточнювати призначення елементів для користувачів допоміжних технологій.
Додавайте лише ті атрибути, які справді потрібні, використовуйте єдину систему назв і перевіряйте готову розмітку в браузері. Так структура сторінки залишатиметься зрозумілою, а інтеграції — стабільнішими.