传统HTML5的下拉框select仅仅能实现简单的文字下拉列表,而HT for Web通用组件中ComboBox不仅可以实现传统HTML5下拉框效果,并且可以在文本框和下拉列表中加入自己定义的小图标,让整个组件看起来更直观。今天我就怎样制定ComboBox自己定义下拉框做一番探讨。
首先我们先来目睹下效果:
看起来跟普通的ComboBox好像也没什么特殊的,是的,依照规范的ComboBox设计,全然能够实现相同的效果,可是今天的主要任务并非讨论有多少实现方案,今天的首要任务是介绍HT for Web的ComboBox自己定义下拉列表的使用方法。
那么接下来就開始详细的方案介绍,废话不多说,上代码:
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] = { 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的创建我就不在这多说了。直接上事件处理的详细实现代码:
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); } }
代码非常easy,做的事情也非常easy。接下来我们就来分析下代码的详细实现:
- 方法的入參: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、几个关键知识点的拓扑结构部件等。在可能的文章会做详细,欢迎大家关注。