内容
配置 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"}'>