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

Метод htmx.swap()

Выполняет замену (и установку) HTML-контента.

  • target — HTML-элемент или строковый селектор целевого элемента для замены
  • content — строковое представление контента, который будет заменен
  • swapSpec — спецификация замены, представляющая параметры из hx-swap
    • swapStyle (обязательно) — стиль замены (innerHTML, outerHTML, beforebegin и т. д.)
    • swapDelay, settleDelay (число) — задержки перед заменой и установкой соответственно
    • transition (bool) — использовать ли HTML-переходы для замены
    • ignoreTitle (bool) — отключает обновление заголовка страницы
    • head (строка) — указывает стратегию обработки тега head (слияние или добавление). Оставьте пустым, чтобы отключить обработку head
    • scroll, scrollTarget, show, showTarget, focusScroll — указывает обработку прокрутки после замены
  • swapOptions — дополнительные необязательные параметры для замены
    • select — селектор для контента, который будет заменен (эквивалент hx-select)
    • selectOOB — селектор для контента, который будет заменен вне цикла (эквивалент hx-select-oob)
    • eventInfo — объект, который будет прикреплен к элементам htmx:afterSwap и htmx:afterSettle
    • anchor — элемент-якорь, который вызвал прокрутку, будет прокручен в область видимости при установке. Предоставляет простую альтернативу полной обработке прокрутки
    • contextElement — DOM-элемент, который служит контекстом для операции замены. В настоящее время используется для поиска расширений, включенных для конкретного элемента
    • afterSwapCallback, afterSettleCallback — функции обратного вызова, вызываемые после замены и установки соответственно. Не принимают аргументов
// заменяем innerHTML элемента #output элементом div с надписью "Заменено!"
htmx.swap("#output", "<div>Заменено!</div>", { swapStyle: 'innerHTML' });