Оформление
Пользовательские HTML параметры страницы
Для понимания HTML параметров страницы предварительно необходимо ознакомиться с пользовательскими параметрами страницы, которые указываются через вызов метода.
В некоторых случаях, при разработке пользовательского сайта практически вся генерация страницы осуществляется на стороне сервера. В этом случае передача пользовательских параметров страницы через JavaScript код может быть неудобной.
Для таких ситуаций существует еще один способ задать пользовательский параметр страницы прямо внутри HTML:
html
<input type="hidden" data-sn-key="parameter name" value="value">Например:
html
<input type="hidden" data-sn-key="Model year" value="2021">Что будет, если HTML параметр не вернули с сервера, а добавили динамически потом?
Такая ситуация может произойти, если:
- HTML параметр был добавлен через JS спустя какое-то время после загрузки страницы
- HTML параметр вставляется через Google Tag Manager
Что происходит при повторном чтении
HTML-параметры читаются при сборке контекста и обращении к getPageParams/getPageParam. Поздно добавленный input заполнит ещё отсутствующий ключ. Сохраняется первое прочитанное значение: изменение value того же input не заменяет уже записанный параметр.
Чтобы явно изменить значение, используйте setPageParam. После deletePageParam или clearPageParams оставшийся в HTML input может снова заполнить ключ при следующем чтении. Значения input читаются строками. В режиме fast HTML-параметры не читаются; JavaScript-команды работают.
Как проверить HTML-параметр
| Часть HTML | Что передать |
|---|---|
type="hidden" | Скрытый input, который не нужен посетителю в форме. |
data-sn-key | Имя параметра, которое читает сайт или использует условие показа. |
value | Значение как строка. Для числа или логического значения используйте JavaScript-параметры страницы. |
Например, если сервер вывел Model year со значением 2021, после init можно проверить значение так:
js
const year = await ninja('getPageParam', 'Model year');
// "2021" if the input has been read and the key has not been set elsewhereЕсли вместо значения вы получили null, проверьте наличие элемента в DOM на момент чтения, точное имя ключа и режим скрипта. Если получили прежнее значение, замените его через setPageParam. На SPA выставляйте значение, относящееся к новой странице, до запроса варианта, который его использует.