配置 htmx

Htmx 有一些配置选项,可以通过编程或声明方式访问。它们列在下面:

配置变量 信息
htmx.config.historyEnabled 默认为true,实际上只用于测试
htmx.config.historyCacheSize 默认为 10
htmx.config.refreshOnHistoryMiss 默认为false,如果设置为truehtmx,将在历史记录未命中时发出整页刷新,而不是使用 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,可用于禁用 htmx 对 eval 的某些功能(例如触发过滤器)的使用
htmx.config.allowScriptTags 默认为true,确定 htmx 是否处理在新内容中找到的脚本标签
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,允许使用诸如 cookies、授权标头或 TLS 客户端证书之类的凭证进行跨站点访问控制请求
htmx.config.timeout 默认为 0,即请求在自动终止前可以花费的毫秒数
htmx.config.scrollBehavior 默认为“instant”,即使用show修饰符时的滚动行为hx-swap。允许的值为instant(滚动应在一次跳转中立即发生)、smooth(滚动应流畅地进行动画)和(滚动行为由scroll-behaviorauto的计算值决定)。
htmx.config.defaultFocusScroll 如果焦点元素应该滚动到视图中,则默认为 false ,并且可以使用焦点滚动交换修改器进行覆盖。
htmx.config.getCacheBusterParam GET默认为 false,如果设置为 true,htmx 将以格式将目标元素附加到请求中org.htmx.cache-buster=targetElementId
htmx.config.globalViewTransitions 如果设置为true,htmx 将在交换新内容时使用View Transition API。
htmx.config.methodsThatUseUrlParams 默认为["get", "delete"],htmx 将通过在 URL 中编码其参数来格式化使用这些方法的请求,而不是请求正文
htmx.config.selfRequestsOnly 默认为true,是否仅允许对与当前文档相同的域进行 AJAX 请求
htmx.config.ignoreTitle 默认为false,如果设置为htmx,则在新内容中发现标签true时不会更新文档的标题title
htmx.config.disableInheritance hx-inherit禁用 htmx 中的属性继承,然后可以通过属性覆盖该继承
htmx.config.scrollIntoViewOnBoost 默认为true,无论增强元素的目标是否滚动到视口中。如果hx-target在增强元素上省略 ,则目标默认为body,导致页面滚动到顶部。
htmx.config.triggerSpecsCache 默认为null,用于存储评估的触发器规范的缓存,以更多的内存使用为代价来提高解析性能。你可以定义一个简单的对象来使用永不清除的缓存,或者使用代理对象实现你自己的系统
htmx.config.responseHandling 可以在此处配置响应状态代码的默认响应处理行为,以交换或错误
htmx.config.allowNestedOobSwaps 默认为true,是否处理嵌套在主响应元素中的元素的 OOB 交换。请参阅嵌套 OOB 交换。

你可以直接在 javascript 中设置它们,也可以使用meta标签:

<meta name="htmx-config" content='{"defaultSwapStyle":"outerHTML"}'>