Перейти к содержимому
Поставьте ⭐️ проекту перевода GitHub

Конфигурация 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"}'>