游乐游手机版
首页/前端开发/文章详情

自定义ExtJS下拉树与下拉表格控件(附源码)

时间:2026-06-11 07:05
继承Ext form field ComboBox并重写createPicker,将下拉列表替换为树面板或网格面板,实现下拉树与下拉表格。事件绑定、选择模型、值同步与原生ComboBox一致,思路清晰。

简介

Ext JS官方示例中通常仅提供基础的下拉列表控件,但在真实业务场景下,下拉树(ComboTreeBox)与下拉表格(ComboGridBox)才是日常开发中真正高频需要的组件。对于刚接触Ext框架的开发者而言,自定义组合控件往往感觉无从下手。实际上,只要多次研读官方源码,很多看似复杂的实现机制便会豁然开朗。下面直接来看下拉树的完整实现代码:

复制代码 下拉树核心实现代码如下:

Ext.define('ComboTreeBox',{ extend : 'Ext.form.field.ComboBox', multiSelect : true, createPicker : function(){ var me = this; //创建树控件 var picker = Ext.create('Ext.tree.Panel', { store: me.store, rootVisible: false, selModel: { mode: me.multiSelect ? 'SIMPLE' : 'SINGLE' }, floating: true, hidden: true, focusOnToFront: false }); //注册事件用于选择用户选择的值 me.mon(picker, { itemclick: me.onItemClick, refresh: me.onListRefresh, scope: me }); me.mon(picker.getSelectionModel(), { beforeselect: me.onBeforeSelect, beforedeselect: me.onBeforeDeselect, selectionchange: me.onListSelectionChange, scope: me }); this.picker = picker; return picker; }, onItemClick: function(picker, record){ /* * If we're doing single selection, the selection change events won't fire when * clicking on the selected element. Detect it here. */ var me = this, selection = me.picker.getSelectionModel().getSelection(), valueField = me.valueField; if (!me.multiSelect && selection.length) { if (record.get(valueField) === selection[0].get(valueField)) { // Make sure we also update the display value if it's only partial me.displayTplData = [record.data]; me.setRawValue(me.getDisplayValue()); me.collapse(); } } } });

下拉树的实现逻辑相当清晰:核心思路是继承 Ext.form.field.ComboBox,然后重写 createPicker 方法,将默认的下拉列表替换为树面板(Tree Panel)。同理,下拉表格的构建也遵循完全相同的设计模式。

复制代码 下拉表格核心实现代码如下:

Ext.define('ComboGridBox',{ extend : 'Ext.form.field.ComboBox', multiSelect : true, createPicker : function(){ var me = this; var picker = Ext.create('Ext.grid.Panel', { title : '下拉表格', store: me.store, frame : true, resizable : true, columns : [{ text : '#ID', dataIndex : 'id' },{ text : '名称' , dataIndex : 'name' },{ text : '描述' , dataIndex : 'desc' }], selModel: { mode: me.multiSelect ? 'SIMPLE' : 'SINGLE' }, floating: true, hidden: true, width : 300, columnLines : true, focusOnToFront: false }); me.mon(picker, { itemclick: me.onItemClick, refresh: me.onListRefresh, scope: me }); me.mon(picker.getSelectionModel(), { beforeselect: me.onBeforeSelect, beforedeselect: me.onBeforeDeselect, selectionchange: me.onListSelectionChange, scope: me }); this.picker = picker; return picker; }, onItemClick: function(picker, record){ /* * If we're doing single selection, the selection change events won't fire when * clicking on the selected element. Detect it here. */ var me = this, selection = me.picker.getSelectionModel().getSelection(), valueField = me.valueField; if (!me.multiSelect && selection.length) { if (record.get(valueField) === selection[0].get(valueField)) { // Make sure we also update the display value if it's only partial me.displayTplData = [record.data]; me.setRawValue(me.getDisplayValue()); me.collapse(); } } }, matchFieldWidth : false, onListSelectionChange: function(list, selectedRecords) { var me = this, isMulti = me.multiSelect, hasRecords = selectedRecords.length > 0; // Only react to selection if it is not called from setValue, and if our list is // expanded (ignores changes to the selection model triggered elsewhere) if (!me.ignoreSelection && me.isExpanded) { if (!isMulti) { Ext.defer(me.collapse, 1, me); } /* * Only set the value here if we're in multi selection mode or we ha ve * a selection. Otherwise setValue will be called with an empty value * which will cause the change event to fire twice. */ if (isMulti || hasRecords) { me.setValue(selectedRecords, false); } if (hasRecords) { me.fireEvent('select', me, selectedRecords); } me.inputEl.focus(); } console.log(me.getValue()); }, doAutoSelect: function() { var me = this, picker = me.picker, lastSelected, itemNode; if (picker && me.autoSelect && me.store.getCount() > 0) { // Highlight the last selected item and scroll it into view lastSelected = picker.getSelectionModel().lastSelected; itemNode = picker.view.getNode(lastSelected || 0); if (itemNode) { picker.view.highlightItem(itemNode); picker.view.el.scrollChildIntoView(itemNode, false); } } } });

下拉表格同样采用继承 Ext.form.field.ComboBox 并重写 createPicker 方法的方式实现,区别在于创建的组件从树面板替换为网格面板(Grid Panel)。两者的核心逻辑完全一致,均涵盖事件绑定、选择模型处理以及值同步等关键环节。

开发下拉树与下拉表格控件,一旦深入理解Ext JS的组件继承体系与运行机制,实际上就像一层窗户纸——轻轻捅破,便会发现一切如此简单。

控件效果

实例下载

本实例中的资源为MyEclipse项目工程,导入开发环境后即可直接运行。使用时需自行添加Ext JS的JavaScript库及CSS样式文件,实例包中不包含Ext的基础依赖文件。

点击此处获取完整实例下载地址

来源:https://www.jb51.net/article/42127.htm
上一篇IE下ComboBox与DateField消失的解决方案 下一篇列表转JSON失败的原因及排查方法
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
HTML文档版权声明结构与基础脚手架代码质量解析
前端开发 · 2026-07-07

HTML文档版权声明结构与基础脚手架代码质量解析

版权声明需用语义化``标签,©符号使用`©`实体;年份通过服务端、构建或JS分层兜底;`rel= "license "`仅指向真实许可证文件才有效。

基于HTML模板的组件化全栈交互方案
前端开发 · 2026-07-07

基于HTML模板的组件化全栈交互方案

纯HTML模板仅作静态结构,全栈交互需后端注入数据、前端JS激活模板及用户事件触发双向链路。``标签惰性,不执行脚本或加载资源,需通过克隆填充数据并手动绑定事件实现交互,父子传值依赖JS对象与自定义事件。

Bootstrap修改Badge徽章边框为圆点样式的方法
前端开发 · 2026-07-07

Bootstrap修改Badge徽章边框为圆点样式的方法

将BootstrapBadge改为圆点:自定义类设置等宽高、border-radius:50%、padding:0、font-size:0;Bootstrap5 2+需加display:inline-block;注意垂直对齐,避免min-width干扰,背景色用background-color更可控。

Bootstrap响应式多栏Footer社交图标排版实现
前端开发 · 2026-07-07

Bootstrap响应式多栏Footer社交图标排版实现

使用Bootstrap5的grid系统实现响应式多栏Footer,按断点设置列宽;以FontAwesome处理社交图标,避免使用img;利用list-unstyled组织链接列表;借助flex-column容器配合mt-auto使版权行自动贴底,避免fixed-bottom固定定位的弊端。

如何用Shadow DOM隔离组件内外事件分发
前端开发 · 2026-07-07

如何用Shadow DOM隔离组件内外事件分发

ShadowDOM内部事件默认不穿透影子边界,需显式设置composed:true才能被外部监听。此时event target指向宿主元素,真实触发源需通过event composedPath()[0]获取。原生事件手动派发时也必须声明composed:true。应避免在宿主上依赖event target做逻辑分支,建议在shadowroot内绑定事件或使用