事件 - htmx:onLoadError

htmx:onLoadError 是 HTMX 在加载远程内容失败（如网络错误、代码异常等）时，针对使用了 hx-on 属性监听 "loadError" 的元素，触发的事件。

这是一个通过 hx-on 属性捕捉错误的机制，并不是通过 JS addEventListener 监听的事件，即不是标准 DOM 事件，而是 HTMX 的声明式事件绑定。htmx:onLoadError，如果你想在 JS 中以事件方式处理错误，应该使用：htmx:responseError。

当请求某个资源失败时，希望特定元素响应错误（比如展示错误提示、切换样式、弹窗等）时使用该事件进行处理。

事件参数

• detail.xhr - XMLHttpRequest
• detail.elt - 触发请求的元素
• detail.target - 请求的目标
• detail.exception - 发生的异常
• detail.requestConfig - AJAX 请求的配置

示例代码

<button 
  hx-get="/may-fail" 
  hx-target="#result" 
  hx-on="loadError: alert('加载失败！')">
  加载可能失败的数据
</button>

<div id="result"></div>