intercooler.js → htmx 迁移指南

本指南的目的是：

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

在开始之前

值得注意的是，Intercooler 旨在实现的目标与 htmx 的方法存在差异。

Intercooler 试图为其大多数功能提供自定义 HTML 属性。这在其较长的属性列表中显而易见，其中许多属性可以描述为便利性或客户端侧焦点性质的。

htmx 采用的方法是保持核心简小，提供一小组可用的属性，这些属性主要关注内容加载和交换。

这种能力主要通过以下两种方式增强：

1. Extensions。htmx 扩展框架允许自定义扩展/插件来实现特定功能。例如，Intercooler 中内置的依赖机制在 htmx 核心中不存在，但可以通过 一个扩展 获得。还有其他扩展，可以实现 Intercooler 开箱即用无法实现的新行为，例如 preload 扩展。

2. 使用 htmx 事件系统结合原生 JavaScript、alpine.js 或 hyperscript。Hyperscript 是一种小型开源脚本语言，设计用于嵌入 HTML，受 HyperTalk 启发，是 htmx 的配套项目。

htmx 还包含 Intercooler 中不存在的功能。这超出了本指南的范围。

最后，值得注意的是，这仍处于开发中，可能会随着时间变化。

迁移信息

本指南的其余部分以表格形式布局，每张表格试图将 Intercooler 的以下常见功能区域映射到 htmx 等效项：

• Attributes
• Request Parameters
• Request Headers
• Response Headers
• Events
• Javascript API Methods
• Meta Tags

Attributes

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

请参阅 htmx 关于 hyperscript 的文档 以获取实际示例，以及更多关于 hyperscript 背后的哲学。

Request parameters

Request headers

Response headers

Events

注意：所有 htmx 事件 都会以 Camel 和 Kebab 命名法触发。

JavaScript API methods

Meta tags