"""移动端字段模型构建器 将 PC 端 jnpfKey 转换为移动端 f_app_column_data 的 columnData 配置。 参考: aibridge/docs/control/13-mobile-controls.md PC jnpfKey → 移动端 component 的映射规则。 移动端组件通过 props 对象传递配置,与 PC 端的 __config__ 机制不同。 """ from typing import Any, Dict, List, Optional # PC jnpfKey → 移动端 component 映射 _JNPF_KEY_TO_MOBILE_COMPONENT = { "input": "Input", "textarea": "Textarea", "inputNumber": "InputNumber", "numInput": "InputNumber", "select": "Select", "radio": "Radio", "checkbox": "Checkbox", "datePicker": "DatePicker", "timePicker": "TimePicker", "switch": "Switch", "uploadImg": "UploadImg", "uploadFile": "UploadFile", "treeSelect": "TreeSelect", "cascader": "Cascader", "organizeSelect": "OrganizeSelect", "userSelect": "UserSelect", "rate": "Rate", "colorPicker": "ColorPicker", "sign": "Sign", } # 移动端组件默认 props 模板 _DEFAULT_PROPS_TEMPLATE = { "Input": {"placeholder": "请输入{label}"}, "Textarea": {"placeholder": "请输入{label}", "rows": 3}, "InputNumber": {"placeholder": "请输入{label}", "step": 1}, "Select": {"placeholder": "请选择{label}", "options": []}, "Radio": {"options": []}, "Checkbox": {"options": []}, "DatePicker": {"format": "YYYY-MM-DD"}, "TimePicker": {"format": "HH:mm:ss"}, "Switch": {"checkedValue": 1, "unCheckedValue": 0}, "UploadImg": {}, "UploadFile": {}, "TreeSelect": {"options": []}, "Cascader": {"options": []}, "OrganizeSelect": {"placeholder": "请选择组织"}, "UserSelect": {"placeholder": "请选择用户"}, "Rate": {"max": 5}, "ColorPicker": {}, "Sign": {}, } def build_mobile_field( field_name: str, field_vmodel: str, jnpf_key: str = "input", required: bool = False, options: Optional[List[Dict[str, Any]]] = None, placeholder: Optional[str] = None, extra_props: Optional[Dict[str, Any]] = None, ) -> Dict[str, Any]: """构建移动端单个字段的 columnData 配置 Args: field_name: 字段中文名,如 "客户名称" field_vmodel: 数据库字段名,如 "f_customer_name" jnpf_key: PC 端控件类型,对应移动端 component required: 是否必填(移动端通过 rules.required 校验) options: 下拉选项列表,格式为 [{label: "显示文本", value: "值"}] 注意:移动端使用 label/value 格式,与 PC 端 fullName/id 不同 placeholder: 自定义 placeholder,默认从模板生成 extra_props: 额外 props,会合并到默认 props 中 Returns: 移动端 columnData 中的单个字段配置字典 Example: >>> build_mobile_field("状态", "F_Status", "select", options=[{"label": "启用", "value": "1"}]) { "column": "F_Status", "component": "Select", "props": { "placeholder": "请选择状态", "options": [{"label": "启用", "value": "1"}] }, "rules": [{"required": True, "message": "请选择状态"}] } """ component = _JNPF_KEY_TO_MOBILE_COMPONENT.get(jnpf_key, "Input") # 获取默认 props 模板 props_template = _DEFAULT_PROPS_TEMPLATE.get(component, {}).copy() # 处理 placeholder if placeholder: props_template["placeholder"] = placeholder elif "placeholder" in props_template: props_template["placeholder"] = props_template["placeholder"].format(label=field_name) # 处理 options(PC 端 fullName/id → 移动端 label/value) if options and component in ("Select", "Radio", "Checkbox", "TreeSelect", "Cascader"): if component in ("Select", "Radio", "Checkbox"): # 移动端使用 label/value 格式 props_template["options"] = [ {"label": opt.get("fullName", opt.get("label", "")), "value": opt.get("id", opt.get("value", ""))} for opt in options ] elif component in ("TreeSelect", "Cascader"): # 树形/级联组件保留完整结构,仅转换顶层字段名 props_template["options"] = _convert_tree_options(options) # 合并额外 props if extra_props: props_template.update(extra_props) # 构建字段配置 field_config: Dict[str, Any] = { "column": field_vmodel, "component": component, "props": props_template, } # 添加必填校验规则 if required: field_config["rules"] = [{"required": True, "message": f"请输入{field_name}"}] # 根据组件类型调整 rules.message if required: if component in ("Select", "Radio", "Checkbox", "TreeSelect", "Cascader", "OrganizeSelect", "UserSelect"): field_config["rules"] = [{"required": True, "message": f"请选择{field_name}"}] elif component in ("DatePicker", "TimePicker"): field_config["rules"] = [{"required": True, "message": f"请选择{field_name}"}] return field_config def _convert_tree_options(options: List[Dict[str, Any]]) -> List[Dict[str, Any]]: """转换树形选项结构(PC fullName/id → 移动端 label/value,保留 children) Args: options: PC 端格式的选项列表 [{fullName, id, children: [...]}] Returns: 移动端格式的选项列表 [{label, value, children: [...]}] """ result = [] for opt in options: item = { "label": opt.get("fullName", opt.get("label", "")), "value": opt.get("id", opt.get("value", "")), } if "children" in opt and opt["children"]: item["children"] = _convert_tree_options(opt["children"]) if "disabled" in opt: item["disabled"] = opt["disabled"] result.append(item) return result def build_mobile_column_data( fields: List[Dict[str, Any]], ) -> List[Dict[str, Any]]: """批量构建移动端 columnData 配置 Args: fields: 字段定义列表,每个元素参考以下格式: { "fieldName": "客户名称", # 字段中文名 "field": "f_customer_name", # 数据库字段名 "jnpfKey": "input", # PC 端控件类型 "required": False, # 是否必填 "options": [...], # 选项列表(可选) } Returns: 移动端 columnData 配置列表(JSON 字符串格式) Example: >>> fields = [ ... {"fieldName": "客户名称", "field": "f_customer_name", "jnpfKey": "input"}, ... {"fieldName": "状态", "field": "f_status", "jnpfKey": "select", ... "options": [{"fullName": "启用", "id": "1"}]}, ... ] >>> column_data = build_mobile_column_data(fields) >>> print(column_data) # 可以直接赋值给 f_app_column_data """ return [ build_mobile_field( field_name=f.get("fieldName", ""), field_vmodel=f.get("field", ""), jnpf_key=f.get("jnpfKey", "input"), required=f.get("required", False), options=f.get("options"), ) for f in fields ]