hx-delete

hx-delete 是 HTMX 提供的一个属性,用于通过 HTML 元素发送 DELETE 请求 到服务器,通常用于删除操作,比如删除用户、记录、文件等。

基本用法

<button hx-delete="/account" hx-target="body">
  Delete Your Account
</button>

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

说明

  • hx-delete不会被继承
  • 您可以使用 hx-target 属性指定交换的目标
  • 您可以使用 hx-swap 属性指定交换策略
  • 您可以使用hx-trigger 属性控制触发请求的事件
  • 您可以通过多种方式控制随请求提交的数据,详情请参见此处:参数
  • 若要在 DELETE 成功之后删除元素,请返回200带有空主体的状态代码;如果服务器以 204 响应,则不会进行交换,详细说明见:请求和响应

发送 Delete 请求通常是用来删除数据,所以常见的做法是搭配 hx-confirm 使用,避免用户误操作。

<button 
  hx-delete="/items/123" 
  hx-target="#result" 
  hx-confirm="确定要删除这条记录吗?">
  删除
</button>

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