hx-params

hx-params 是 HTMX 中用于控制哪些参数会被发送到服务器端的属性。

它的作用是从触发请求的表单或元素中，筛选指定的参数发送到服务器。

当你使用 <form> 或包含多个 <input>、<button> 等控件时，有时你不希望发送全部字段，这时候可以通过 hx-params 来精确控制。

该属性可能的值包括：

• * - 包含所有参数（默认）
• none - 不包括任何参数
• not <param-list> - 包括除逗号分隔的参数名称列表之外的所有内容
• <param-list> - 包括所有以逗号分隔的参数名称列表

示例代码

<form hx-post="/search">
  <input name="query" placeholder="搜索关键词">
  <input name="debug" value="true" type="checkbox">
  <button type="submit" hx-params="query">搜索</button>
</form>

当点击按钮时，只会发送 query 字段，debug 字段会被忽略。

hx-params 可以用在大型表单，但允许局部提交的场景。例如：渐进式步骤表单填写，每一个步骤只提交对应的字段。