intercooler.js → htmx 迁移指南

本指南的目的是：

• 映射 Intercooler 中可用的等效 htmx 属性、标头、事件、方法等
• 提供解决方法 在 htmx 核心没有直接等效的情况下，实现相同或类似的结果（通常通过 htmx 扩展或通过 hyperscript）
• 突出显示差距 无法（尚）通过 htmx 核心、任何现有扩展或 hyperscript优雅地解决

#开始之前

值得注意的是，Intercooler 试图做的事情和 htmx 正在做的事情之间的区别。

Intercooler 试图为其大部分功能提供自定义 html 属性。这在它更长的属性列表中很明显，其中许多属性可以被描述为便利性或以客户端为中心的属性。

htmx 遵循试图保持核心精简的做法，使用更少数量的可用属性，这些属性主要集中在内容加载和交换上。

此功能主要通过两种方式增强

1. 扩展。htmx 扩展框架允许自定义扩展/插件来实现特定功能。例如，Intercooler 中的依赖关系机制，它不在 htmx 核心内。但可通过 扩展获取。还有其他扩展使 Intercooler 无法立即实现的新行为成为可能，例如 preload 扩展

2. 使用 htmx 事件系统，结合原生 javascript、alpine.js 或 hyperscript。Hyperscript 是一种小型、开放的脚本语言，旨在嵌入 HTML 中，灵感来自 HyperTalk，它是 htmx 的配套项目。

htmx 还包含 Intercooler 中没有的功能。这超出了本指南的范围。

最后，值得注意的是，这仍然是一个正在进行的工作，并且可能会随着时间的推移而发生变化。

#迁移信息

本指南的其余部分按表格的形式排列，每个表格都试图将 Intercooler 的以下常见功能区域映射到 htmx 等效项上

• 属性
• 请求参数
• 请求标头
• 响应标头
• 事件
• Javascript API 方法
• 元标记

#属性

注意：对于某些 Intercooler 属性（主要是客户端特定的属性，例如 ic-action 和相关属性），没有直接的 htmx 等效项。相反，可以使用一种称为 hyperscript 的小型、富有表现力的语言（参见 http://hyperscript.org），它旨在嵌入 HTML 中，并作为 htmx 的无缝伴侣。它允许您实现与某些 Intercooler 属性（尤其是以客户端为中心的属性）相同的功能，但在更灵活和开放的方式下。

请参阅 htmx 关于 hyperscript 的文档，获取实际示例，以及更多关于 hyperscipt 背后理念的信息。

#请求参数

#请求标头

#响应标头

#事件

注意：所有 htmx 事件 都会以驼峰式和 kebab 式两种形式触发。

#JavaScript API 方法

#元标签