自绘制HT For Web ComboBox下拉框组件

传统的HTML5的下拉框select只能实现简单的文字下拉列表，而​​HT​​​​ for ​​​​W​​​​eb​​​通用组件中​​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] = {
            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;
}

这是背景渐变效果列表的具体构建代码，我来描述下具体的设计思路：

1. 将​​HT ​​​​for Web​​支持的渐变效果组合起来放在一个叫gradient的数组变量中；
2. 通过遍历gradient数组来动态创建gradient对应的矢量图，并将矢量图存放在gradientImages的数组变量中；
3. 将gradient文本值作为​​ComboBox​​​的value，并设置​​ComboBox​​的相关参数；
4. 通过重载​​ComboBox​​的drawValue方法来实现自定义下拉列表；
5. 在drawValue方法中需要传入的参数有：g（画笔），value（对应comboBox中values），selected（是否被选中），x，y（画笔的其实绘制坐标x，y），w，h（画笔绘制的宽高w，h）；
6. 通过ht.Default.drawCenterImage()方法将数量图元绘制到指定位置；
7. 通过ht.Default.drawText()方法将要显示的的值绘制到指定的位置；
8. 最后重载​​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);
    }
}

代码很简单，做的事情也很简单，接下来我们就来分析下代码的具体实现：

1. 方法的入参：dataModel（数据容器）,oldValue（comboBox老值）, newValue（comboBox新值）, style（要改变的样式名称）, scope（方法调用者）；
2. 从dataModel中获取相应的selectionModel sm；
3. 根据sm.size()来判断在GraphView中选取了多少个data，如果一个都没选中，则修改dataModel中的所有data的属性；如果有选中的data，则只修改所选中data的属性。

到此自绘制​​HT ​​​​for Web​​​ ​​ComboBox​​​下拉框组件的介绍就结束了，​​HT for Web​​通用组件的灵活性和易用性还不止如此，在本文中涉及到矢量、ComboBox、拓扑图组件等几个关键的知识点，在后续的文章中会做具体的阐述，欢迎大家届时关注。