前端【免费下载链接】htmxhtmx - high power tools for HTML项目地址https://gitcode.com/GitHub_Trending/ht/htmx点击查看免费下载导读本文以仓库根目录下的 CHANGELOG.md 为骨架梳理 htmx 从 0.0.1原名 kutty到当前 2.0.11 的完整版本演进脉络并对照 src/htmx.js 的源码实现逐一印证hx-partial、历史缓存、reportValidity、CSS.escape、配置项等关键机制的底层原理。读完本文你将掌握 htmx 2.x 的核心能力边界、各类配置项的实际语义与默认值以及如何依据版本历史为升级与排障定位源码证据。版本节奏从 kutty 到 htmx 2.0 的发布脉络CHANGELOG 完整记录了项目从 2020 年 5 月 15 日的 0.0.1 初始发布当时名为kutty到 2026 年 9 月 22 日 2.0.11 的演进。整个发布史可以划分为三个清晰的阶段0.x 起步期2020-05 ~ 2020-11核心机制成型。0.0.3 正式更名为 htmx0.0.4 引入扩展机制、SSE 与 WebSocket 支持0.1.0 将hx-sse/hx-ws语法改为冒号分隔0.3.0 重写hx-trigger解析并支持触发过滤器0.4.0 加入HX-Redirect、HX-Refresh响应头并推出更安全的hx-vals。1.x 成熟期2020-11 ~ 2024-06功能密度最高的阶段产生了hx-on、view transitions、hx-sync、hx-disabled-elt、hx-preserve、htmx.ajax()、hx-validate等一大批至今仍在使用的能力同时将 SSE/WebSocket 迁移为独立扩展。2.x 重构期2024-06 ~ 至今移除hx-sse/hx-ws内置属性与旧版hx-on语法拆分 ESM/AMD/CJS 模块产物按规范调整DELETE请求的载荷方式并持续修复历史导航、OOB 交换、类型定义等深层问题。从 package.json 可以看到当前版本号为2.0.11main指向dist/htmx.esm.js这一指向正是 2.0.1 变更的成果types指向dist/htmx.esm.d.ts并提供了jsdelivr/unpkg两个 CDN 字段。2.x 系列重构、模块化与关键修复2.0.11hx-partial标签与 OOB 修复2.0.112026-09-22最重要的变化是从 4.0 反向移植了hx-partial标签支持服务端响应可以携带hx-partial hx-target...元素这些元素会被交换到各自指定的目标位置。其源码实现位于 src/htmx.js 的findAndSwapPartials()function findAndSwapPartials(fragment, settleInfo, sourceElement) { var hxTemplates findAll(fragment, template[hx]) forEach(hxTemplates, function(template) { var type getRawAttribute(template, type) if (type partial) { var targetSelector getAttributeValue(template, hx-target) || (template.id ? # CSS.escape(template.id) : null) ... var swapSpec getSwapSpecification(template, swapOverride) var targets querySelectorAllExt(sourceElement || getDocument().body, targetSelector, false) ...从源码可以推断关键语义hx-partial以template typepartial的形式存在hx-target指定交换目标缺省时回退到模板自身的id选择器支持hx-swap覆盖默认交换策略围绕它定义了三个专用事件目标未找到时触发htmx:partialErrorNoTarget同时记录失败的选择器便于排查、交换前htmx:partialBeforeSwap可通过shouldSwap拦截、交换后htmx:partialAfterSwap在交换管线中partial 交换排在 OOB 交换之后、主交换之前src/htmx.js如果响应只包含hx-partial标签而无其他内容则跳过主交换。仓库在 test/attributes/hx-partial.js 中提供了对应的行为测试并在 test/index.html 中注册可以按 TESTING.md 的说明运行验证。同版本还修复了hx-push-urlfalse在 boost 元素祖先上被忽略的问题对应 Issue 3966、hasHeader()对响应头名称做子串匹配可能抛出TypeError的问题Issue 527、上下文元素脱离文档时 OOB 交换目标找不到的问题Issue 3959并将内部对象遍历从for...in统一改为Object.keys()。其中hasHeader()的修复可以在 src/htmx.js 看到现在严格使用xhr.getResponseHeader(name) ! null判断头是否存在避免了子串误匹配。2.0.10 / 2.0.9类型定义与历史路径修复2.0.102026-04-21恢复了 2.0.9 中误删的 TypeScript 类型定义htmx.esm.d.ts并改用CSS.escape()改进 settle 查找中标签名与 id 的转义。CSS.escape目前已在多处使用例如 OOB 元素 id 选择器构造src/htmx.js与 settle 阶段的旧节点查找src/htmx.js。2.0.92026-04-15主要修复了HX-Location在push为false时正确遵循replace历史normalizePath改为相对当前页面 location 解析相对路径而不是基于一个假的 base URL移除 htmx 工具类htmx-swapping、htmx-settling、htmx-request后不再残留空class属性hx-disabled-elt不再破坏源 HTML 中本就disabled的元素htmx:oobErrorNoTarget事件的 detail 与错误日志中附带失败的选择器便于调试。2.0.8parseHTMLUnsafe、htmx.ajax()的pushURL与历史相对路径修复2.0.82025-10-24是一次由MichaelWest22主导的修复版本parseHTML改用Document.parseHTMLUnsafe()以获得更好的 Web Components 支持htmx.ajax()API 新增pushURL选项实现于 src/htmx.js 附近的ajaxHelper上下文参数中修复了 Shadow DOM 内hx-sync与htmx:abort的问题Issue 3419以及历史支持中长期存在的相对路径 bugIssue 3449。2.0.7 ~ 2.0.5表单验证、100% 测试覆盖与默认行为调整2.0.72025-09-08在配置开关reportValidityOfForms后实现了reportValidity()用于向用户呈现表单校验错误。对应源码在 src/htmx.js 的validateElement()元素willValidate时先触发htmx:validation:validate校验失败则触发htmx:validation:failed并在配置开启且为首个错误时调用element.reportValidity()。同期还修复了swapouterHTML时style属性导致htmx-swapping类残留的问题。2.0.52025-06-20是功能密度很高的一版达成100% 测试覆盖率默认推荐 CDN 改为 jsDelivrhx-include、hx-indicator、hx-disabled-elt支持inherit关键字可从父元素继承并扩展值hx-on监听器改为在节点处理前注册从而能捕获处理过程中的事件button hx-verb/endpoint typereset会在提交后再重置表单formmethoddialog不再提交关联表单本地历史缓存从localStorage改为sessionStorage避免跨标签页污染历史恢复改为走标准交换代码路径。历史缓存的实现集中在 src/htmx.jssetCurrentPathForHistory()通过sessionStorage记录htmx-current-path-for-historysaveToHistoryCache()将页面 HTML、标题与滚动位置写入htmx-history-cache并按htmx.config.historyCacheSize默认 10见 src/htmx.js裁剪缓存当存储写入失败时会触发htmx:historyCacheError并逐步缩小缓存重试。2.0.4 ~ 2.0.1默认行为收口与模块拆分2.0.42024-12-13规定htmx.ajax不传 target/source 时默认以 body 为目标此前是静默无操作修复嵌套 shadow root 问题htmx:trigger事件在合成load事件上正确触发且元素经htmx.process()重新初始化时合成load不再被重复调用。扩展方面preload扩展被完整重写以兼容hx-boostresponse-targets移除弃用方法head-support与sse扩展协同工作。2.0.32024-10-03增加了对 Chrome Canary 实验性moveBefore()的支持仓库 test/manual/move-before 有对应演示页revealed事件在元素因 resize 显现时触发hx-preserve在 OOB 交换中生效。2.0.12024-07-12将/dist/htmx.esm.js设为package.json的main更新并包含htmx.d.ts修复清理时误删纯文本模板以及body标签 outerHTML 交换的问题。2.0.0里程碑式重构2.0.02024-06-17是一次大版本重构主要变化包括扩展全部移出主仓库独立发布并通过 extensions 站点索引移除已弃用的内置hx-sse/hx-ws属性v1 旧站点仍保留历史用法说明对 Web Components 与 Shadow DOM 提供更好支持HTTPDELETE请求改用 URL 参数而非 form-encoded body符合规范/dist拆分多种模块格式ESMhtmx.esm.js、AMDhtmx.amd.js、CJShtmx.cjs.jshtmx.js继续支持浏览器直接加载旧的hx-on特殊语法被移除改用更清晰的hx-on:语法内部 APIselectAndSwap()被公开的swap()方法取代对应 src/htmx.js 的swap: null公共入口与 src/htmx.js 的swap()实现。升级细节可参考仓库内 www/content/migration-guide-htmx-1.md。1.x 系列功能大爆发的时代事件与配置的里程碑1.9.x1.9.02023-04-11引入了三个至今重要的能力通用内联事件处理属性hx-on当前文档见 www/content/attributes/hx-on.md弥补 HTMLonevent属性只能绑定单一事件的短板基于 View Transitions API 的视图过渡支持裸hx-trigger元素上只有hx-trigger而没有hx-get等请求属性时触发新的htmx:triggered事件交由脚本响应。1.9.3 将hx-on正式弃用并迁移到hx-on:event name形式同时引入htmx.config.methodsThatUseUrlParams让开发者按需决定哪些 HTTP 方法使用 URL 参数——这一配置在 2.x 中默认值为[get, delete]见 src/htmx.js。1.9.5 增加了htmx.config.allowScriptTags与htmx.config.selfRequestsOnly两个安全配置后者在 2.x 中默认为truesrc/htmx.js用于禁止对非同源主机的请求。1.9.6 引入了hx-disabled-elt属性请求期间禁用指定元素与htmx.config.ignoreTitle配置1.9.7 增加了htmx:beforeHistoryUpdate事件与htmx.config.scrollIntoViewOnBoost2.x 默认true见 src/htmx.js。1.9.10 支持hx-on-带尾横线形式以兼容 EJS 等模板系统并新增htmx.config.triggerSpecsCache对应 src/htmx.js缓存触发规格解析。历史、同步与 OOB1.8.x1.8.02022-07-12为 boost 表单默认推送 URL 到历史引入hx-replace-url属性与HX-Replace-Url响应头m成为合法的定时修饰符如hx-triggerevery 2mnext/previous成为合法的扩展查询选择器HX-Location响应头实现完全在 htmx 内部的客户端重定向新增hx-select-oob属性与HX-Reswap响应头。1.8.3 增加了异步确认机制htmx:confirm事件以及 head-support、multi-swap 两个扩展。同步、扩展化与继承1.7.x1.7.02022-02-22引入hx-sync属性同步多个元素的请求可配合htmx:abort事件中止请求SSE 与 WebSocket 作为独立扩展发布2.0 起完全外置新增hx-disinherit屏蔽属性继承HX-Push头可取值false阻止历史快照hx-vals中的对象转为 JSON 而非渲染为[Object object]新增htmx:oobBeforeSwap与htmx:oobAfterSwap两个 OOB 事件。事件细节与脚本支持1.6.x1.6.1 新增HX-Retarget响应头htmx:beforeSwap的 detail 增加isError属性htmx:afterRequest增加success/failed两个 detail 属性可直接用于 hyperscript 过滤on htmx:afterRequest[failed] set #myCheckboxs checked to true1.6.0 重写了script标签支持支持script src.../形式引入htmx-added类交换前添加、settle 阶段后移除便于编写新内容的 CSS 过渡hx-trigger的from:修饰符支持监听window对象。请求控制与配置沉淀1.4.x ~ 1.5.x1.5.0 新增hx-request属性可配置timeout、credentials、noHeaders并可通过htmx.config.timeout等对应属性设置默认值2.x 中timeout默认 0、withCredentials默认false见 src/htmx.jshx-swap的scroll/show支持window:top、window:bottom伪选择器。1.4.0 增加hx-trigger的queue选项新增htmx.config.useTemplateFragmentsdefaultSettleDelay从 100ms 降至 20ms2.x 保持 20ms见 src/htmx.js引入基于 IntersectionObserver 的合成事件intersect新增htmx.config.withCredentials。1.3.x 引入hx-disabled属性关闭局部 DOM 的 htmx 能力对应 src/htmx.js 的disableSelector默认值[hx-disable], [data-hx-disable]SSE 重连采用 full-jitter 指数退避由htmx.config.wsReconnectDelay控制默认full-jitter。早期 1.x 的奠基1.0.x ~ 1.2.x1.2.0 弃用hx-vars并推广hx-vals支持javascript:前缀新增hx-headers属性hx-include可包含非 form 元素下的所有输入历史缓存未命中时通过HX-History-Restore-Request头告知服务器。1.2.1 增加htmx.config.refreshOnHistoryMiss2.x 默认false见 src/htmx.js。1.1.0 引入htmx.ajax()JavaScript 函数、hx-preserve属性、from:子句与htmx.config.allowEvalCSP 兼容2.x 默认true。1.0.1/1.0.2 起所有 API 方法支持字符串选择器hx-swap-oob可接受 CSS 选择器重定向目标。0.x 起步期核心机制的原点0.4.0 支持HX-Redirect/HX-Refresh响应头、响应中的title更新页面标题并把所有eval()替换为Function0.3.0 重写hx-trigger解析、新增HX-Trigger-After-Swap/HX-Trigger-After-Settle响应头0.2.0 支持 AJAX 文件上传并尊重 HTML 校验 API0.1.0 是破坏性变更版本——hx-sse/hx-ws改为冒号语法hx-sseconnect:/chat swap:messagehx-target支持find语法所有事件同时以 camelCase 与 kebab-case 双形式派发。0.0.x 阶段奠定了hx-swap的scroll/show修饰符、hx-push-url的 URL 参数、hx-vars、hx-trigger的throttle修饰符与扩展机制其中 0.0.3 还加入了htmx.config.includeIndicatorStyles配置2.x 默认true见 src/htmx.js允许关闭自动注入的指示器 CSS。从 CHANGELOG 到源码验证演进主线把 CHANGELOG 的条目与源码对照可以提炼出几条贯穿始终的演进主线配置收敛散布在各版本中的配置项最终统一收敛为 src/htmx.js 的htmx.config对象。例如methodsThatUseUrlParams1.9.3 引入、selfRequestsOnly1.9.5、scrollIntoViewOnBoost1.9.7、triggerSpecsCache1.9.10、reportValidityOfForms2.0.7加上responseHandling默认对 204 不交换、2xx/3xx 交换、4xx/5xx 报错见 src/htmx.js等既有配置共同构成运行时行为的总开关。交换管线分层OOB 交换findAndSwapOobElementssrc/htmx.js、partial 交换findAndSwapPartials与主交换swapsrc/htmx.js在同一个管线中依序执行响应可能同时携带 OOB 元素、hx-partial标签与主内容——这是 1.8 的hx-select-oob、2.0.11 的hx-partial得以共存的结构基础。历史支持持续加固从 1.4.0 的缓存问题修复、1.8.0 的 URL 推送、2.0.5 的sessionStorage迁移、2.0.8/2.0.9 的相对路径修复到 2.0.11 的hx-push-urlfalse修复历史模块src/htmx.js始终是修复密度最高的区域。安全与兼容双线并行allowEval、allowScriptTags、selfRequestsOnly、nonce 支持inlineScriptNonce/inlineStyleNonce见 src/htmx.js构成 CSP 与跨源安全防线CSS.escape、parseHTMLUnsafe、Object.keys()等现代 API 的采用则持续改善 Web Components 与严格环境下的健壮性。结语CHANGELOG.md 本身就是一份浓缩的技术地图2.x 重在重构与稳定性1.x 贡献了绝大多数今天仍在使用的属性与配置0.x 则奠定了 htmx以 HTML 属性驱动 AJAX的核心哲学。对照 src/htmx.js 阅读这份变更记录可以快速定位每个特性在源码中的落点配置默认值、事件名、交换管线顺序也能在升级或遇到回归问题时按哪个版本引入、哪个版本修复的线索精准检索对应实现与 test 目录下的测试用例。赞分享前端【免费下载链接】htmxhtmx - high power tools for HTML项目地址https://gitcode.com/GitHub_Trending/ht/htmx点击查看免费下载相关推荐Medusa 核心包 CHANGELOG 深度解读2.x 版本演进路线与技术要点Medusa 核心包 CHANGELOG 深度解读2.x 版本演进路线与技术要点 本文以 packages/medusa/CHANGELOG.md https后端电商前端dc.js 版本演进全解析从 Changelog 看 2.x/3.x/4.x 的核心变更、迁移路径与源码级佐证dc.js 版本演进全解析从 Changelog 看 2.x/3.x/4.x 的核心变更、迁移路径与源码级佐证 导读 本文以仓库根目录 Changelog.数据可视化前端VisiData 版本演进全览从 CHANGELOG 解读 v3.x 核心特性、命令行与配置选项VisiData 版本演进全览从 CHANGELOG 解读 v3.x 核心特性、命令行与配置选项 VisiData 是一款在终端中探索与整理数据的多工具数据分析CLI数据可视化上一篇Area51代码质量工具链自动化检查与报告生成下一篇Android-ObservableScrollView常见错误与调试技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
前端【免费下载链接】htmxhtmx - high power tools for HTML项目地址https://gitcode.com/GitHub_Trending/ht/htmx点击查看免费下载导读本文以仓库根目录下的 CHANGELOG.md 为骨架梳理 htmx 从 0.0.1原名 kutty到当前 2.0.11 的完整版本演进脉络并对照 src/htmx.js 的源码实现逐一印证hx-partial、历史缓存、reportValidity、CSS.escape、配置项等关键机制的底层原理。读完本文你将掌握 htmx 2.x 的核心能力边界、各类配置项的实际语义与默认值以及如何依据版本历史为升级与排障定位源码证据。版本节奏从 kutty 到 htmx 2.0 的发布脉络CHANGELOG 完整记录了项目从 2020 年 5 月 15 日的 0.0.1 初始发布当时名为kutty到 2026 年 9 月 22 日 2.0.11 的演进。整个发布史可以划分为三个清晰的阶段0.x 起步期2020-05 ~ 2020-11核心机制成型。0.0.3 正式更名为 htmx0.0.4 引入扩展机制、SSE 与 WebSocket 支持0.1.0 将hx-sse/hx-ws语法改为冒号分隔0.3.0 重写hx-trigger解析并支持触发过滤器0.4.0 加入HX-Redirect、HX-Refresh响应头并推出更安全的hx-vals。1.x 成熟期2020-11 ~ 2024-06功能密度最高的阶段产生了hx-on、view transitions、hx-sync、hx-disabled-elt、hx-preserve、htmx.ajax()、hx-validate等一大批至今仍在使用的能力同时将 SSE/WebSocket 迁移为独立扩展。2.x 重构期2024-06 ~ 至今移除hx-sse/hx-ws内置属性与旧版hx-on语法拆分 ESM/AMD/CJS 模块产物按规范调整DELETE请求的载荷方式并持续修复历史导航、OOB 交换、类型定义等深层问题。从 package.json 可以看到当前版本号为2.0.11main指向dist/htmx.esm.js这一指向正是 2.0.1 变更的成果types指向dist/htmx.esm.d.ts并提供了jsdelivr/unpkg两个 CDN 字段。2.x 系列重构、模块化与关键修复2.0.11hx-partial标签与 OOB 修复2.0.112026-09-22最重要的变化是从 4.0 反向移植了hx-partial标签支持服务端响应可以携带hx-partial hx-target...元素这些元素会被交换到各自指定的目标位置。其源码实现位于 src/htmx.js 的findAndSwapPartials()function findAndSwapPartials(fragment, settleInfo, sourceElement) { var hxTemplates findAll(fragment, template[hx]) forEach(hxTemplates, function(template) { var type getRawAttribute(template, type) if (type partial) { var targetSelector getAttributeValue(template, hx-target) || (template.id ? # CSS.escape(template.id) : null) ... var swapSpec getSwapSpecification(template, swapOverride) var targets querySelectorAllExt(sourceElement || getDocument().body, targetSelector, false) ...从源码可以推断关键语义hx-partial以template typepartial的形式存在hx-target指定交换目标缺省时回退到模板自身的id选择器支持hx-swap覆盖默认交换策略围绕它定义了三个专用事件目标未找到时触发htmx:partialErrorNoTarget同时记录失败的选择器便于排查、交换前htmx:partialBeforeSwap可通过shouldSwap拦截、交换后htmx:partialAfterSwap在交换管线中partial 交换排在 OOB 交换之后、主交换之前src/htmx.js如果响应只包含hx-partial标签而无其他内容则跳过主交换。仓库在 test/attributes/hx-partial.js 中提供了对应的行为测试并在 test/index.html 中注册可以按 TESTING.md 的说明运行验证。同版本还修复了hx-push-urlfalse在 boost 元素祖先上被忽略的问题对应 Issue 3966、hasHeader()对响应头名称做子串匹配可能抛出TypeError的问题Issue 527、上下文元素脱离文档时 OOB 交换目标找不到的问题Issue 3959并将内部对象遍历从for...in统一改为Object.keys()。其中hasHeader()的修复可以在 src/htmx.js 看到现在严格使用xhr.getResponseHeader(name) ! null判断头是否存在避免了子串误匹配。2.0.10 / 2.0.9类型定义与历史路径修复2.0.102026-04-21恢复了 2.0.9 中误删的 TypeScript 类型定义htmx.esm.d.ts并改用CSS.escape()改进 settle 查找中标签名与 id 的转义。CSS.escape目前已在多处使用例如 OOB 元素 id 选择器构造src/htmx.js与 settle 阶段的旧节点查找src/htmx.js。2.0.92026-04-15主要修复了HX-Location在push为false时正确遵循replace历史normalizePath改为相对当前页面 location 解析相对路径而不是基于一个假的 base URL移除 htmx 工具类htmx-swapping、htmx-settling、htmx-request后不再残留空class属性hx-disabled-elt不再破坏源 HTML 中本就disabled的元素htmx:oobErrorNoTarget事件的 detail 与错误日志中附带失败的选择器便于调试。2.0.8parseHTMLUnsafe、htmx.ajax()的pushURL与历史相对路径修复2.0.82025-10-24是一次由MichaelWest22主导的修复版本parseHTML改用Document.parseHTMLUnsafe()以获得更好的 Web Components 支持htmx.ajax()API 新增pushURL选项实现于 src/htmx.js 附近的ajaxHelper上下文参数中修复了 Shadow DOM 内hx-sync与htmx:abort的问题Issue 3419以及历史支持中长期存在的相对路径 bugIssue 3449。2.0.7 ~ 2.0.5表单验证、100% 测试覆盖与默认行为调整2.0.72025-09-08在配置开关reportValidityOfForms后实现了reportValidity()用于向用户呈现表单校验错误。对应源码在 src/htmx.js 的validateElement()元素willValidate时先触发htmx:validation:validate校验失败则触发htmx:validation:failed并在配置开启且为首个错误时调用element.reportValidity()。同期还修复了swapouterHTML时style属性导致htmx-swapping类残留的问题。2.0.52025-06-20是功能密度很高的一版达成100% 测试覆盖率默认推荐 CDN 改为 jsDelivrhx-include、hx-indicator、hx-disabled-elt支持inherit关键字可从父元素继承并扩展值hx-on监听器改为在节点处理前注册从而能捕获处理过程中的事件button hx-verb/endpoint typereset会在提交后再重置表单formmethoddialog不再提交关联表单本地历史缓存从localStorage改为sessionStorage避免跨标签页污染历史恢复改为走标准交换代码路径。历史缓存的实现集中在 src/htmx.jssetCurrentPathForHistory()通过sessionStorage记录htmx-current-path-for-historysaveToHistoryCache()将页面 HTML、标题与滚动位置写入htmx-history-cache并按htmx.config.historyCacheSize默认 10见 src/htmx.js裁剪缓存当存储写入失败时会触发htmx:historyCacheError并逐步缩小缓存重试。2.0.4 ~ 2.0.1默认行为收口与模块拆分2.0.42024-12-13规定htmx.ajax不传 target/source 时默认以 body 为目标此前是静默无操作修复嵌套 shadow root 问题htmx:trigger事件在合成load事件上正确触发且元素经htmx.process()重新初始化时合成load不再被重复调用。扩展方面preload扩展被完整重写以兼容hx-boostresponse-targets移除弃用方法head-support与sse扩展协同工作。2.0.32024-10-03增加了对 Chrome Canary 实验性moveBefore()的支持仓库 test/manual/move-before 有对应演示页revealed事件在元素因 resize 显现时触发hx-preserve在 OOB 交换中生效。2.0.12024-07-12将/dist/htmx.esm.js设为package.json的main更新并包含htmx.d.ts修复清理时误删纯文本模板以及body标签 outerHTML 交换的问题。2.0.0里程碑式重构2.0.02024-06-17是一次大版本重构主要变化包括扩展全部移出主仓库独立发布并通过 extensions 站点索引移除已弃用的内置hx-sse/hx-ws属性v1 旧站点仍保留历史用法说明对 Web Components 与 Shadow DOM 提供更好支持HTTPDELETE请求改用 URL 参数而非 form-encoded body符合规范/dist拆分多种模块格式ESMhtmx.esm.js、AMDhtmx.amd.js、CJShtmx.cjs.jshtmx.js继续支持浏览器直接加载旧的hx-on特殊语法被移除改用更清晰的hx-on:语法内部 APIselectAndSwap()被公开的swap()方法取代对应 src/htmx.js 的swap: null公共入口与 src/htmx.js 的swap()实现。升级细节可参考仓库内 www/content/migration-guide-htmx-1.md。1.x 系列功能大爆发的时代事件与配置的里程碑1.9.x1.9.02023-04-11引入了三个至今重要的能力通用内联事件处理属性hx-on当前文档见 www/content/attributes/hx-on.md弥补 HTMLonevent属性只能绑定单一事件的短板基于 View Transitions API 的视图过渡支持裸hx-trigger元素上只有hx-trigger而没有hx-get等请求属性时触发新的htmx:triggered事件交由脚本响应。1.9.3 将hx-on正式弃用并迁移到hx-on:event name形式同时引入htmx.config.methodsThatUseUrlParams让开发者按需决定哪些 HTTP 方法使用 URL 参数——这一配置在 2.x 中默认值为[get, delete]见 src/htmx.js。1.9.5 增加了htmx.config.allowScriptTags与htmx.config.selfRequestsOnly两个安全配置后者在 2.x 中默认为truesrc/htmx.js用于禁止对非同源主机的请求。1.9.6 引入了hx-disabled-elt属性请求期间禁用指定元素与htmx.config.ignoreTitle配置1.9.7 增加了htmx:beforeHistoryUpdate事件与htmx.config.scrollIntoViewOnBoost2.x 默认true见 src/htmx.js。1.9.10 支持hx-on-带尾横线形式以兼容 EJS 等模板系统并新增htmx.config.triggerSpecsCache对应 src/htmx.js缓存触发规格解析。历史、同步与 OOB1.8.x1.8.02022-07-12为 boost 表单默认推送 URL 到历史引入hx-replace-url属性与HX-Replace-Url响应头m成为合法的定时修饰符如hx-triggerevery 2mnext/previous成为合法的扩展查询选择器HX-Location响应头实现完全在 htmx 内部的客户端重定向新增hx-select-oob属性与HX-Reswap响应头。1.8.3 增加了异步确认机制htmx:confirm事件以及 head-support、multi-swap 两个扩展。同步、扩展化与继承1.7.x1.7.02022-02-22引入hx-sync属性同步多个元素的请求可配合htmx:abort事件中止请求SSE 与 WebSocket 作为独立扩展发布2.0 起完全外置新增hx-disinherit屏蔽属性继承HX-Push头可取值false阻止历史快照hx-vals中的对象转为 JSON 而非渲染为[Object object]新增htmx:oobBeforeSwap与htmx:oobAfterSwap两个 OOB 事件。事件细节与脚本支持1.6.x1.6.1 新增HX-Retarget响应头htmx:beforeSwap的 detail 增加isError属性htmx:afterRequest增加success/failed两个 detail 属性可直接用于 hyperscript 过滤on htmx:afterRequest[failed] set #myCheckboxs checked to true1.6.0 重写了script标签支持支持script src.../形式引入htmx-added类交换前添加、settle 阶段后移除便于编写新内容的 CSS 过渡hx-trigger的from:修饰符支持监听window对象。请求控制与配置沉淀1.4.x ~ 1.5.x1.5.0 新增hx-request属性可配置timeout、credentials、noHeaders并可通过htmx.config.timeout等对应属性设置默认值2.x 中timeout默认 0、withCredentials默认false见 src/htmx.jshx-swap的scroll/show支持window:top、window:bottom伪选择器。1.4.0 增加hx-trigger的queue选项新增htmx.config.useTemplateFragmentsdefaultSettleDelay从 100ms 降至 20ms2.x 保持 20ms见 src/htmx.js引入基于 IntersectionObserver 的合成事件intersect新增htmx.config.withCredentials。1.3.x 引入hx-disabled属性关闭局部 DOM 的 htmx 能力对应 src/htmx.js 的disableSelector默认值[hx-disable], [data-hx-disable]SSE 重连采用 full-jitter 指数退避由htmx.config.wsReconnectDelay控制默认full-jitter。早期 1.x 的奠基1.0.x ~ 1.2.x1.2.0 弃用hx-vars并推广hx-vals支持javascript:前缀新增hx-headers属性hx-include可包含非 form 元素下的所有输入历史缓存未命中时通过HX-History-Restore-Request头告知服务器。1.2.1 增加htmx.config.refreshOnHistoryMiss2.x 默认false见 src/htmx.js。1.1.0 引入htmx.ajax()JavaScript 函数、hx-preserve属性、from:子句与htmx.config.allowEvalCSP 兼容2.x 默认true。1.0.1/1.0.2 起所有 API 方法支持字符串选择器hx-swap-oob可接受 CSS 选择器重定向目标。0.x 起步期核心机制的原点0.4.0 支持HX-Redirect/HX-Refresh响应头、响应中的title更新页面标题并把所有eval()替换为Function0.3.0 重写hx-trigger解析、新增HX-Trigger-After-Swap/HX-Trigger-After-Settle响应头0.2.0 支持 AJAX 文件上传并尊重 HTML 校验 API0.1.0 是破坏性变更版本——hx-sse/hx-ws改为冒号语法hx-sseconnect:/chat swap:messagehx-target支持find语法所有事件同时以 camelCase 与 kebab-case 双形式派发。0.0.x 阶段奠定了hx-swap的scroll/show修饰符、hx-push-url的 URL 参数、hx-vars、hx-trigger的throttle修饰符与扩展机制其中 0.0.3 还加入了htmx.config.includeIndicatorStyles配置2.x 默认true见 src/htmx.js允许关闭自动注入的指示器 CSS。从 CHANGELOG 到源码验证演进主线把 CHANGELOG 的条目与源码对照可以提炼出几条贯穿始终的演进主线配置收敛散布在各版本中的配置项最终统一收敛为 src/htmx.js 的htmx.config对象。例如methodsThatUseUrlParams1.9.3 引入、selfRequestsOnly1.9.5、scrollIntoViewOnBoost1.9.7、triggerSpecsCache1.9.10、reportValidityOfForms2.0.7加上responseHandling默认对 204 不交换、2xx/3xx 交换、4xx/5xx 报错见 src/htmx.js等既有配置共同构成运行时行为的总开关。交换管线分层OOB 交换findAndSwapOobElementssrc/htmx.js、partial 交换findAndSwapPartials与主交换swapsrc/htmx.js在同一个管线中依序执行响应可能同时携带 OOB 元素、hx-partial标签与主内容——这是 1.8 的hx-select-oob、2.0.11 的hx-partial得以共存的结构基础。历史支持持续加固从 1.4.0 的缓存问题修复、1.8.0 的 URL 推送、2.0.5 的sessionStorage迁移、2.0.8/2.0.9 的相对路径修复到 2.0.11 的hx-push-urlfalse修复历史模块src/htmx.js始终是修复密度最高的区域。安全与兼容双线并行allowEval、allowScriptTags、selfRequestsOnly、nonce 支持inlineScriptNonce/inlineStyleNonce见 src/htmx.js构成 CSP 与跨源安全防线CSS.escape、parseHTMLUnsafe、Object.keys()等现代 API 的采用则持续改善 Web Components 与严格环境下的健壮性。结语CHANGELOG.md 本身就是一份浓缩的技术地图2.x 重在重构与稳定性1.x 贡献了绝大多数今天仍在使用的属性与配置0.x 则奠定了 htmx以 HTML 属性驱动 AJAX的核心哲学。对照 src/htmx.js 阅读这份变更记录可以快速定位每个特性在源码中的落点配置默认值、事件名、交换管线顺序也能在升级或遇到回归问题时按哪个版本引入、哪个版本修复的线索精准检索对应实现与 test 目录下的测试用例。赞分享前端【免费下载链接】htmxhtmx - high power tools for HTML项目地址https://gitcode.com/GitHub_Trending/ht/htmx点击查看免费下载相关推荐Medusa 核心包 CHANGELOG 深度解读2.x 版本演进路线与技术要点Medusa 核心包 CHANGELOG 深度解读2.x 版本演进路线与技术要点 本文以 packages/medusa/CHANGELOG.md https后端电商前端dc.js 版本演进全解析从 Changelog 看 2.x/3.x/4.x 的核心变更、迁移路径与源码级佐证dc.js 版本演进全解析从 Changelog 看 2.x/3.x/4.x 的核心变更、迁移路径与源码级佐证 导读 本文以仓库根目录 Changelog.数据可视化前端VisiData 版本演进全览从 CHANGELOG 解读 v3.x 核心特性、命令行与配置选项VisiData 版本演进全览从 CHANGELOG 解读 v3.x 核心特性、命令行与配置选项 VisiData 是一款在终端中探索与整理数据的多工具数据分析CLI数据可视化上一篇Area51代码质量工具链自动化检查与报告生成下一篇Android-ObservableScrollView常见错误与调试技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
