htmx.config

Глобальная настройка поведения htmx

Объект htmx.config содержит текущую конфигурацию htmx. Вы можете изменить её в JavaScript или задать значения с помощью тега <meta>.

Настройка с помощью метатега

Задайте значения конфигурации с помощью HCON:

<meta name="htmx-config"
      content="defaultSwap:outerHTML defaultTimeout:5000">

Или JSON:

<meta name="htmx-config"
      content='{"defaultSwap":"outerHTML","defaultTimeout":5000}'>

Настройка с помощью JavaScript

Измените значения конфигурации напрямую:

htmx.config.defaultSwap = 'outerHTML';
htmx.config.defaultTimeout = 5000;

Доступные параметры

Параметр	По умолчанию	Описание
`logAll`	`false`	Записывать в журнал все события htmx
`prefix`	`"data-hx-"`	Префикс дополнительных атрибутов, распознаваемый наряду с `hx-`
`metaCharacter`	`undefined`	Символ, используемый вместо `:` в именах атрибутов
`transitions`	`false`	Включить переходы между представлениями
`history`	`true`	Включить поддержку истории
`mode`	`"same-origin"`	Режим запроса для `fetch()`
`defaultSwap`	`"innerHTML"`	Стиль замены по умолчанию
`allowEmptySwapAfterOOB`	`false`	Разрешить пустую основную замену после извлечения OOB
`defaultFocusScroll`	`false`	Прокручивать страницу к элементу в фокусе после замены
`defaultSettleDelay`	`1`	Задержка перед завершением, в миллисекундах
`indicatorClass`	`"htmx-indicator"`	CSS-класс для индикаторов
`requestClass`	`"htmx-request"`	CSS-класс во время запросов
`includeIndicatorCSS`	`true`	Подключать CSS индикатора по умолчанию
`defaultTimeout`	`60000`	Тайм-аут запроса в миллисекундах
`extensions`	`""`	Расширения для загрузки
`morphIgnore`	`["data-htmx-powered"]`	Атрибуты, игнорируемые при морфинге
`morphSkip`	`"[hx-morph-skip]"`	Элементы, пропускаемые при морфинге
`morphSkipChildren`	`"[hx-morph-skip-children]"`	Элементы, дочерние элементы которых не подвергаются морфингу
`morphScanLimit`	`10`	Количество соседних элементов, просматриваемых при сопоставлении элементов
`noSwap`	`[204, 304]`	Коды состояния HTTP, при которых замена пропускается
`implicitInheritance`	`false`	Включить неявное наследование атрибутов
`inlineScriptNonce`	`undefined`	Nonce, добавляемый к встроенным скриптам

См. также

Licensed under the Zero-Clause BSD License.
https://four.htmx.org/reference/config/htmx-config/