From d85a4d5de42b98a8e0a9b0420f65ef08ed430ce8 Mon Sep 17 00:00:00 2001
From: Felix <spiritfelix@users.noreply.github.com>
Date: Mon, 14 Jul 2025 16:14:20 +0800
Subject: [PATCH] Update basic.md for SetQueryFilterFn

Add Example Code to SetQueryFilterFn
---
 zh/admin/table/basic.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/zh/admin/table/basic.md b/zh/admin/table/basic.md
index 050f87b..597314f 100644
--- a/zh/admin/table/basic.md
+++ b/zh/admin/table/basic.md
@@ -181,6 +181,27 @@ info.SetFilterFormInputWidth(w int)
 ```go
 info.SetQueryFilterFn(func(param parameter.Parameters, conn db.Connection) (ids []string, stopQuery bool) {
     // 根据参数与连接对象返回表格筛选id，stopQuery代表是否停止框架逻辑的筛选，是的话直接则返回当前结果
+    // 以下为简单示例，在 my_table 表中模糊匹配筛选 name 和 description 字段数据
+    name := param.GetFieldValue("name")
+    description := param.GetFieldValue("description")
+    if name == "" && description == "" {
+        return nil, false // 无查询条件，走默认
+    }
+
+    // 使用原生 SQL 查询
+    sqlStr := "SELECT id FROM my_table WHERE name LIKE ? AND description LIKE ?"
+    rows, err := conn.Query(sqlStr, "%"+name+"%", "%"+description+"%")
+    if err != nil {
+        return nil, false
+    }
+
+    for _, row := range rows {
+        id := row["id"].(int64)
+        ids = append(ids, strconv.FormatInt(id, 10))
+    }
+
+    // 返回主键列表，并停止框架后续查询
+    return ids, true
 })
 ```
 
@@ -539,4 +560,4 @@ func GetUserTable(ctx *context.Context) (userTable table.Table) {
 >
 > __columns: 隐藏的字段
 
-接口需拿取对应的URL参数进行处理返回对应的JSON格式数据，GoAdmin会将数据展示出来。
\ No newline at end of file
+接口需拿取对应的URL参数进行处理返回对应的JSON格式数据，GoAdmin会将数据展示出来。