hx-patch

hx-patch 属性将实现元素向指定的 URL 发出一个 PATCH 请求,并使用交换策略将 HTML 交换到 DOM 中,通常用于部分更新资源。

说明

  • hx-patch不会被继承
  • 你可以使用 hx-target 属性指定交换的目标
  • 你可以使用 hx-swap 属性指定交换策略
  • 你可以使用 hx-trigger 属性控制触发请求的事件
  • 你可以通过多种方式控制随请求提交的数据,详情请参见此处:参数

基本语法

<button hx-patch="/account" hx-target="body">
  Patch Your Account
</button>

此示例中 button 发出 PATCH 并将 /account 返回的 HTML 交换到 body 中的 innerHTML 。

注意事项

  • 后端必须支持 PATCH 方法(有些框架默认不启用)。

  • 浏览器默认表单不支持 PATCH;HTMX 通过 JS 发起请求,兼容性好。

  • 请求体格式是普通的 form-urlencoded,除非你自定义 headers。