自繪製HT For Web ComboBox下拉框組件

傳統的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] = {
            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、拓撲圖組件等幾個關鍵的知識點，在後續的文章中會作具體的闡述，歡迎你們屆時關注。