SQLPage表单组件：多选字段默认值设置详解

在SQLPage项目中，表单(Form)组件是构建交互式Web界面的重要工具。其中select类型的表单字段支持多选功能，但如何正确设置多个默认选中值可能让开发者感到困惑。本文将深入解析这一功能的使用方法。

多选字段的基本配置

SQLPage的select字段通过设置multiple=TRUE参数开启多选模式。此时用户可以通过按住Ctrl键(Windows/Linux)或Command键(Mac)来选择多个选项。

select 
    'form' as component,
    'submit_handler.sql' as action;
select 
    'Fruits' as label,
    'fruits[]' as name,
    'select' as type,
    TRUE as multiple;

设置默认选中项

要为多选字段预设默认值，需要通过options参数传递一个JSON数组，其中每个选项对象可以包含selected属性来标记是否默认选中：

select 
    'form' as component,
    'submit_handler.sql' as action;
select 
    'Fruits' as label,
    'fruits[]' as name,
    'select' as type,
    TRUE as multiple,
    '[{"label": "Apple", "value": 1}, 
      {"label": "Orange", "value": 2, "selected": true}, 
      {"label": "Banana", "value": 3, "selected": true}]' as options;

在这个例子中，"Orange"和"Banana"会被默认选中。

动态生成选项列表

实际应用中，我们通常需要从数据库动态生成选项列表。SQLPage支持使用json_group_array和json_object函数构建选项JSON：

select 
    'form' as component,
    'update_tags.sql?id='||$id as action;
    
select 
    'tag[]' as name, 
    'Tags' as label, 
    'select' as type, 
    TRUE as multiple,
    json_group_array(json_object(
        'label', tag_name, 
        'value', tag_id,
        'selected', EXISTS(SELECT 1 FROM item_tags WHERE tag_id=tags.id AND item_id=$id)
    )) as options  
from tags;

这个例子会从tags表中获取所有标签，并自动选中那些已经与当前项目关联的标签。

注意事项

1. 多选字段的name属性建议以[]结尾，这有助于后端处理多个值
2. 当使用动态生成的选项时，确保JSON格式正确
3. 可以通过dropdown=TRUE参数将选择框显示为下拉菜单样式
4. create_new=TRUE参数允许用户输入新值

SQLPage的表单组件通过这种灵活的JSON配置方式，既保持了SQL的简洁性，又提供了强大的动态表单生成能力。掌握这些技巧后，开发者可以轻松构建各种复杂的数据输入界面。