方法 - 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'});