传统的HTML5的下拉框select只能实现简单的文字下拉列表,而HT for Web通用组件中ComboBox不仅能够实现传统HTML5下拉框效果,而且可以在文本框和下拉列表中添加自定义的小图标,让整个组件看起来更直观,今天我就如何制定ComboBox自定义下拉框做一番探讨。
首先我们先来目睹下效果:
看起来跟普通的ComboBox好像也没什么特殊的,是的,按照规范的ComboBox设计,完全可以实现同样的效果,但是今天的主要任务并不是讨论有多少实现方案,今天的首要任务是介绍HT for Web的ComboBox自定义下拉列表的用法。
那么接下来就开始具体的方案介绍,废话不多说,上代码:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | function createGradientComboBox(dataModel){ var sm = dataModel.sm(), gradientComboBox = new ht.widget.ComboBox(), gradients = [ 'linear.southwest' , 'linear.southeast' , 'linear.northwest' , 'linear.northeast' , 'linear.north' , 'linear.south' , 'linear.west' , 'linear.east' , 'radial.center' , 'radial.southwest' , 'radial.southeast' , 'radial.northwest' , 'radial.northeast' , 'radial.north' , 'radial.south' , 'radial.west' , 'radial.east' , 'spread.horizontal' , 'spread.vertical' , 'spread.diagonal' , 'spread.antidiagonal' , 'spread.north' , 'spread.south' , 'spread.west' , 'spread.east' ], gradientImages = [], indent = gradientComboBox.getIndent(), height = 18, padding = 2; gradients.forEach( function (gradient) { gradientImages[gradient] = { width: indent, height: height, comps: [ { type: 'rect' , rect: [padding, padding, indent - 2 * padding, height - 2 * padding], background: 'red' , gradient: gradient, gradientColor: 'white' } ] }; }); gradientComboBox.setValues(gradients); gradientComboBox.setValue( 'linear.southwest' ); gradientComboBox.setWidth(90); gradientComboBox.setDropDownWidth(140); gradientComboBox.drawValue = function (g, value, selected, x, y, w, h){ var self = this , indent = self.getIndent(), label = self.toLabel(value), icon = gradientImages[value]; if (icon){ ht.Default.drawCenterImage(g, icon, x+indent/2, y+h/2); x += indent; } if (label){ ht.Default.drawText(g, label, self.getLabelFont(value, selected), self.getLabelColor(value, selected), x, y, 0, h); } }; gradientComboBox.onValueChanged = function (oldValue, newValue){ onComboBoxValueChanged(dataModel, oldValue, newValue, 'shape.gradient' , this ); }; return gradientComboBox; } |
这是背景渐变效果列表的具体构建代码,我来描述下具体的设计思路:
- 将HT for Web支持的渐变效果组合起来放在一个叫gradient的数组变量中;
- 通过遍历gradient数组来动态创建gradient对应的矢量图,并将矢量图存放在gradientImages的数组变量中;
- 将gradient文本值作为ComboBox的value,并设置ComboBox的相关参数;
- 通过重载ComboBox的drawValue方法来实现自定义下拉列表;
- 在drawValue方法中需要传入的参数有:g(画笔),value(对应comboBox中values),selected(是否被选中),x,y(画笔的其实绘制坐标x,y),w,h(画笔绘制的宽高w,h);
- 通过ht.Default.drawCenterImage()方法将数量图元绘制到指定位置;
- 通过ht.Default.drawText()方法将要显示的的值绘制到指定的位置;
- 最后重载ComboBox的onValueChanged()方法来监听ComboBox的属性变化,并按照要求做对应的业务处理。
整体思路就是这样子的,相应的图形ComboBox组件也是如此的设计思路,接下来我们来了解下ComboBox和HT for Web网络拓扑图组件GraphView的联动效果实现吧。
通过两张图的对比,我相信大家都能够感受到变化吧。前一张是GraphView的初始状态,后一张是通过选中图元后修改gradient渐变选择框后的效果,我们来看看具体的代码实现,GraphView和Node的创建我就不在这多说了,直接上事件处理的具体实现代码:
1 2 3 4 5 6 7 8 9 10 11 12 | function onComboBoxValueChanged(dataModel, oldValue, newValue, style, scope){ var sm = dataModel.sm(); if (sm.size() === 0){ dataModel.each( function (data){ data.setStyle(style, newValue); }, scope); } else { sm.each( function (data){ data.setStyle(style, newValue); }, scope); } } |
代码很简单,做的事情也很简单,接下来我们就来分析下代码的具体实现:
- 方法的入参:dataModel(数据容器),oldValue(comboBox老值), newValue(comboBox新值), style(要改变的样式名称), scope(方法调用者);
- 从dataModel中获取相应的selectionModel sm;
- 根据sm.size()来判断在GraphView中选取了多少个data,如果一个都没选中,则修改dataModel中的所有data的属性;如果有选中的data,则只修改所选中data的属性。
到此自绘制HT for Web ComboBox下拉框组件的介绍就结束了,HT for Web通用组件的灵活性和易用性还不止如此,在本文中涉及到矢量、ComboBox、拓扑图组件等几个关键的知识点,在后续的文章中会做具体的阐述,欢迎大家届时关注。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步