Конфигурация htmx
Htmx имеет некоторые параметры конфигурации, которые можно получить как программно, так и декларативно. Они перечислены ниже:
| Параметр | Информация |
|---|---|
htmx.config.historyEnabled | по умолчанию true, действительно полезно только для тестирования |
htmx.config.historyCacheSize | по умолчанию 10 |
htmx.config.refreshOnHistoryMiss | по умолчанию false, если установлено в true, htmx выполнит полное обновление страницы при пропуске истории, а не использует AJAX-запрос |
htmx.config.defaultSwapStyle | по умолчанию innerHTML |
htmx.config.defaultSwapDelay | по умолчанию 0 |
htmx.config.defaultSettleDelay | по умолчанию 20 |
htmx.config.includeIndicatorStyles | по умолчанию true (определяет, загружаются ли стили индикаторов) |
htmx.config.indicatorClass | по умолчанию htmx-indicator |
htmx.config.requestClass | по умолчанию htmx-request |
htmx.config.addedClass | по умолчанию htmx-added |
htmx.config.settlingClass | по умолчанию htmx-settling |
htmx.config.swappingClass | по умолчанию htmx-swapping |
htmx.config.allowEval | по умолчанию true, может использоваться для отключения использования eval в htmx для определённых функций (например, фильтры триггеров) |
htmx.config.allowScriptTags | по умолчанию true, определяет, будет ли htmx обрабатывать теги script, найденные в новом контенте |
htmx.config.inlineScriptNonce | по умолчанию '', что означает, что nonce не будет добавлен к встроенным скриптам |
htmx.config.attributesToSettle | по умолчанию ["class", "style", "width", "height"], атрибуты, которые нужно установить во время фазы установки |
htmx.config.inlineStyleNonce | по умолчанию '', что означает, что nonce не будет добавлен к встроенным стилям |
htmx.config.useTemplateFragments | по умолчанию false, HTML-шаблоны для парсинга контента с сервера (не совместимо с IE11!) |
htmx.config.wsReconnectDelay | по умолчанию full-jitter |
htmx.config.wsBinaryType | по умолчанию blob, тип двоичных данных, получаемых через соединение WebSocket |
htmx.config.disableSelector | по умолчанию [hx-disable], [data-hx-disable], htmx не будет обрабатывать элементы с этим атрибутом или родителем |
htmx.config.withCredentials | по умолчанию false, разрешает кросс-доменные запросы Access-Control с использованием учетных данных, таких как cookies, заголовки авторизации или клиентские сертификаты TLS |
htmx.config.timeout | по умолчанию 0, количество миллисекунд, которое запрос может занимать, прежде чем будет автоматически завершен |
htmx.config.scrollBehavior | по умолчанию ‘instant’, поведение прокрутки при использовании модификатора show с hx-swap. Допустимые значения: instant (прокрутка должна происходить мгновенно в одном прыжке), smooth (прокрутка должна анимироваться плавно) и auto (поведение прокрутки определяется вычисленным значением scroll-behavior). |
htmx.config.defaultFocusScroll | должно ли фокусированное элемент быть прокручено в видимую область, по умолчанию false и может быть переопределено с помощью модификатора замены focus-scroll. |
htmx.config.getCacheBusterParam | по умолчанию false, если установлено в true, htmx добавит элемент цели к GET-запросу в формате org.htmx.cache-buster=targetElementId |
htmx.config.globalViewTransitions | если установлено в true, htmx будет использовать View Transitions API при замене нового контента. |
htmx.config.methodsThatUseUrlParams | по умолчанию ["get", "delete"], htmx будет форматировать запросы с этими методами, кодируя их параметры в URL, а не в теле запроса. |
htmx.config.selfRequestsOnly | по умолчанию true, разрешать ли только AJAX-запросы к тому же домену, что и текущий документ. |
htmx.config.ignoreTitle | по умолчанию false, если установлено в true, htmx не будет обновлять заголовок документа, когда в новом контенте найден тег title. |
htmx.config.disableInheritance | отключает наследование атрибутов в htmx, которое затем может быть переопределено атрибутом hx-inherit. |
htmx.config.scrollIntoViewOnBoost | по умолчанию true, должно ли целевое значение усиленного элемента прокручиваться в область видимости. Если hx-target опущен на усиленном элементе, цель по умолчанию будет body, что приведет к прокрутке страницы вверх. |
htmx.config.triggerSpecsCache | по умолчанию null, кэш для хранения оцененных спецификаций триггеров, что улучшает производительность парсинга за счет большего использования памяти. Вы можете определить простой объект для использования кэша, который никогда не очищается, или реализовать свою собственную систему с использованием прокси-объекта. |
htmx.config.responseHandling | поведение обработки ответов по умолчанию для кодов состояния ответа можно настроить здесь, чтобы либо заменить, либо выдать ошибку. |
htmx.config.allowNestedOobSwaps | по умолчанию true, разрешать ли обработку OOB замен на элементах, которые вложены в основной элемент ответа. См. Вложенные OOB замены. |
Вы можете установить их напрямую в JavaScript или использовать мета-тег:
<meta name="htmx-config" content='{"defaultSwapStyle":"outerHTML"}'>