方法 - htmx.swap()

执行 HTML 内容的交换

参数

  • target - 交换目标的 HTML 元素或字符串选择器
  • content - 要交换的内容的字符串表示
  • swapSpec - 交换规范,表示来自hx-swap
  • swapStyle(必需) - 交换样式(innerHTML、outerHTML、beforebegin等)
  • swapDelay, settleDelay(number) - 分别在交换和结算之前的延迟
  • transition(bool) - 是否使用 HTML 转换进行交换
  • ignoreTitle(bool) - 禁用页面标题更新
  • head(string) - 指定 head 标签处理策略(merge或append)。留空则禁用头部处理
  • scroll, scrollTarget, show, showTarget, focusScroll - 指定交换后的滚动处理

  • swapOptions - 用于交换的附加可选参数

  • select - 需要交换的内容的选择器(相当于 hx-select)
  • selectOOB - 带外交换内容的选择器(相当于 hx-select-oob)
  • eventInfo - 要附加对象 htmx:afterSwap 和 htmx:afterSettle 的元素
  • anchor - 将在稳定后滚动到视图中的锚点元素。提供完全滚动处理的简单替代方案
  • contextElement - 作为交换操作上下文的 DOM 元素。当前用于查找针对特定元素启用的扩展
  • afterSwapCallback, afterSettleCallback - 分别在 swap 和 setter 之后调用的回调函数。不带参数

例子

    // swap #output element inner HTML with div element with "Swapped!" text
    htmx.swap("#output", "<div>Swapped!</div>", {swapStyle: 'innerHTML'});