jQuery EasyUI 表单 – 格式化下拉框（ComboBox）（超详细）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 Web 开发中，表单是用户与系统交互的核心组件。而下拉框（ComboBox）作为表单中常见的元素，不仅需要具备基础的输入功能，还需要通过格式化操作提升用户体验。jQuery EasyUI 表单 – 格式化下拉框（ComboBox） 是这一过程中一个关键的技术点。本文将从基础到进阶，结合实际案例，讲解如何通过 EasyUI 的 ComboBox 组件实现数据的动态展示与格式化，帮助开发者高效构建直观、友好的交互界面。

一、jQuery EasyUI 表单基础

1.1 EasyUI 的定位与优势

jQuery EasyUI 是一个基于 jQuery 的开源前端框架，专注于简化 Web 界面的开发。其核心优势在于：

• 组件丰富：提供表格、树形菜单、对话框等数十种 UI 组件，满足常见场景需求。
• 易用性高：通过简单的 HTML 标签和配置参数即可快速搭建界面。
• 跨浏览器兼容：支持主流浏览器，减少适配成本。

对于表单开发，EasyUI 的 ComboBox 组件尤其适合需要动态加载和格式化数据的场景，例如用户角色选择、地区层级切换等。

1.2 ComboBox 的基本使用

ComboBox 是 EasyUI 提供的下拉选择组件，结合了输入框和下拉列表的功能。其基础用法如下：

<!-- 基础 HTML 结构 -->
<input class="easyui-combobox" 
       name="fruit" 
       style="width:200px"
       data-options="  
           valueField: 'id',  
           textField: 'text',  
           data: [  
               {id:'1', text:'苹果'},  
               {id:'2', text:'香蕉'},  
               {id:'3', text:'橙子'}  
           ]  
       "  
/>

关键参数解释：

• valueField：定义选项的值字段（如 id）。
• textField：定义选项的显示文本字段（如 text）。
• data：静态数据源，支持直接定义数组或通过 Ajax 动态加载。

二、格式化下拉框的核心方法

2.1 什么是格式化？

格式化（Formatting）是指将数据转换为更易读或符合业务需求的展示形式。例如，将日期字符串转换为“YYYY-MM-DD”格式，或在选项文本前添加图标。对于 ComboBox，格式化主要通过 formatter 函数 实现。

2.2 formatter 函数的使用

formatter 函数是一个回调函数，用于定义每个下拉项的渲染规则。其基本语法如下：

formatter: function(row) {  
    // row 是当前数据项的原始对象  
    return `<span style="color: blue;">${row.text}</span>`;  
}

示例：为选项添加图标

假设我们希望在每个水果名称前添加对应图标：

<input class="easyui-combobox" 
       style="width:200px"  
       data-options="  
           valueField: 'id',  
           textField: 'text',  
           data: [  
               {id:'1', text:'苹果', icon: 'apple.png'},  
               {id:'2', text:'香蕉', icon: 'banana.png'}  
           ],  
           formatter: function(row) {  
               return `<img src="${row.icon}" width="20" /> ${row.text}`;  
           }  
       "  
/>

效果：每个选项会显示图标和文本，增强视觉区分度。

2.3 进阶格式化技巧

2.3.1 根据条件动态调整样式

通过判断数据字段的值，可以动态改变文本颜色或背景色。例如，标记库存不足的商品：

formatter: function(row) {  
    let color = row.stock < 10 ? 'red' : 'black';  
    return `<span style="color: ${color};">${row.text}</span>`;  
}

2.3.2 结合模板引擎简化复杂渲染

若需复杂布局（如多行文本或自定义 CSS 类），可使用模板引擎（如 Handlebars）：

formatter: function(row) {  
    const template = `<div class="combo-item">  
        <div class="name">{{name}}</div>  
        <div class="price">${row.price} 元</div>  
    </div>`;  
    return Handlebars.compile(template)(row);  
}

三、动态数据加载与格式化

3.1 通过 Ajax 加载数据

实际开发中，数据通常来自后端接口。此时需结合 url 参数和 onLoadSuccess 回调：

<input class="easyui-combobox" 
       style="width:200px"  
       data-options="  
           valueField: 'id',  
           textField: 'text',  
           url: '/api/fruits',  
           onLoadSuccess: function(data) {  
               // 数据加载完成后的处理逻辑  
           }  
       "  
/>

结合 formatter 处理异步数据

假设后端返回的数据结构如下：

[  
    {  
        "id": "1",  
        "name": "苹果",  
        "category": "水果",  
        "price": 5.99  
    },  
    {  
        "id": "2",  
        "name": "香蕉",  
        "category": "水果",  
        "price": 3.49  
    }  
]

可以通过 formatter 将 name 和 price 合并为显示文本：

formatter: function(row) {  
    return `${row.name}（¥${row.price.toFixed(2)}）`;  
}

3.2 处理分层数据（如省市区）

对于多级联动的下拉框（如省市区选择），可通过嵌套数据结构实现。例如：

const regions = [  
    {  
        "id": "1",  
        "text": "北京市",  
        "children": [  
            {id: '1-1', text: '海淀区'},  
            {id: '1-2', text: '朝阳区'}  
        ]  
    },  
    {  
        "id": "2",  
        "text": "上海市",  
        "children": [...]  
    }  
];  

此时需设置 parentField 参数定义层级关系，并通过 formatter 递归渲染子项：

formatter: function(row) {  
    if (row.children) {  
        return `<b>${row.text}</b>`; // 父级项加粗显示  
    } else {  
        return row.text;  
    }  
}

四、常见问题与解决方案

4.1 下拉框不显示数据

可能原因：

• 数据格式不符合 valueField 和 textField 的定义。
• 动态加载时未正确设置 url 或接口返回异常。

解决方案：

• 使用浏览器开发者工具检查网络请求和返回数据。
• 确保数据字段名称与配置参数一致。

4.2 格式化后选中值丢失

当使用 formatter 修改显示内容后，ComboBox 默认会以 textField 的值作为显示文本，而非原始数据。若需保留原始值，需同时设置 valueField 和 textField，并通过 formatter 控制显示逻辑。

4.3 性能优化

对于大数据量的下拉框（如超过 1000 条选项），建议：

• 启用分页或搜索过滤功能。
• 减少 formatter 的复杂计算，优先使用 CSS 预处理样式。

五、实际案例：用户权限管理界面

5.1 需求背景

在用户管理模块中，需允许管理员选择用户的权限角色，并以更直观的方式展示角色名称和描述。

5.2 实现步骤

1. 定义数据结构：

   [  
       {  
           "id": "admin",  
           "name": "管理员",  
           "description": "拥有所有权限"  
       },  
       {  
           "id": "guest",  
           "name": "访客",  
           "description": "仅可查看基础信息"  
       }  
   ]  
   

2. 配置 ComboBox：

   <input id="roleComboBox" class="easyui-combobox" style="width:200px"  
          data-options="  
              valueField: 'id',  
              textField: 'name',  
              data: rolesData,  
              formatter: function(row) {  
                  return `<div class="role-item">  
                      <h4>${row.name}</h4>  
                      <p>${row.description}</p>  
                  </div>`;  
              }  
          "  
   />  
   

3. 样式增强：

   .role-item {  
       padding: 5px;  
       border-bottom: 1px solid #eee;  
   }  
   .role-item h4 {  
       margin: 0;  
       font-size: 14px;  
   }  
   

效果：下拉项显示角色名称和描述，帮助管理员快速判断权限范围。

结论

通过本文的讲解，开发者可以掌握 jQuery EasyUI 表单 – 格式化下拉框（ComboBox） 的核心技巧，包括基础配置、动态数据加载、复杂格式化场景及常见问题的解决方案。无论是简单的文本渲染，还是结合业务逻辑的多条件格式化，EasyUI 的 ComboBox 组件都能提供灵活且高效的实现方式。

未来在开发中，建议结合具体业务场景进一步探索以下方向：

• 国际化支持：通过 EasyUI 的国际化插件（如 easyui-lang-zh_CN.js）实现多语言适配。
• 与表单验证结合：利用 EasyUI 的验证规则（如 required）增强表单交互体验。

希望本文能成为您使用 EasyUI 开发高质量表单界面的实用指南！