HT for Web列表和3D拓扑组件的拖拽应用

很多可视化编辑器都或多或少有一些拖拽功能，比如从一个List列表中拖拽一个节点到拓扑组件上进行建模，并且在拖拽的过程中鼠标位置下会附带一个被拖拽节点的缩略图，那么今天我们就来实现这样的拖拽效果。

首先我们需要创建一个List列表，在列表中加入图片信息，让List列表不那么单调，先来看看效果图。

接下来我们一步一步来是想这个List列表，先来解决下数据，在这里我就列举一两个：

var products = [
    {
        ProductId : 1,
        ProductName : "Chai",
        QuantityPerUnit : "10 boxes x 20 bags",
        UnitPrice : 18.00,
        Description : "Soft drinks, coffees, teas, beers, and ales"
    },
    {
        ProductId : 2,
        ProductName : "Chang",
        QuantityPerUnit : "24 - 12 oz bottles",
        UnitPrice : 19.00,
        Description : "Soft drinks, coffees, teas, beers, and ales"
    },
    ……
];

有了数据，我们就可以来创建List组件了：

var listView = new ht.widget.ListView(),
    view = listView.getView();
 
document.body.appendChild(view);

这时我们创建的是一个空的List组件，在浏览器上看不到任何东西，那么接下来我们就该把我们定义的数据添加到List组件上了：

products.forEach(function(product){
    var data = new ht.Data();
    data.a(product);
    listView.dm().add(data);
});

数据的添加是不是很简单，但是List组件上显示的内容默认是Data的name属性或displayName属性，在创建Data时，并没有对Data设置displayName或者name属性，所以这个时候在页面上看到的还是一个空的List组件，别急，我们可以在不设置displayName或name属性的情况下让组件显示效果图上的文本内容，请看：

listView.getLabel = function(data){
    return data.a('ProductName') + ' - $' + data.a('UnitPrice').toFixed(2);
};

嘿嘿，ListView组件提供了getLabel方法供用户重载来实现自定义显示文本内容，这下应该就可以显示文本内容了吧~

oh no~还是什么都没有，是不是还少了点什么呢~对了，忘记给ListView组件添加铺满浏览器的样式了，将厦门的样式添加到head标签中：

<style>
    html, body {
        padding: 0px;
        margin: 0px;
    }
    .main {
        margin: 0px;
        padding: 0px;
        position: absolute;
        top: 0px;
        bottom: 0px;
        left: 0px;
        right: 0px;
    }
</style>

接下来指定view的className属性：

view.className = 'main';

噢~总算出来了~

行高太小了，背景也太单调了，向效果图看齐：

listView.setRowHeight(50);
listView.drawRowBackground = function(g, data, selected, x, y, width, height){
    if(this.isSelected(data)){
        g.fillStyle = '#87A6CB';
    }
    else if(this.getRowIndex(data) % 2 === 0){
        g.fillStyle = '#F1F4F7';
    }
    else{
        g.fillStyle = '#FAFAFA';
    }
    g.beginPath();
    g.rect(x, y, width, height);
    g.fill();
};

通过setRowHeight()方法设置行高，通过重载drawRowBackground()方法绘制交叉背景。

嘿，有点样子了，和效果图越来越近了~那么就差图标了呢。

ht.Default.setImage('1', 40, 40, 'data:image/jpeg;base64,...');
ht.Default.setImage('2', 40, 40, ‘data:image/jpeg;base64,...');
……
 
listView.setIndent(60);
listView.getIcon = function(data){
    return data.a('ProductId');
};

通过ht.Default.setImage()方法定义ProductId对应的图片资源，以ProductId作为图片的别名，然后接下来定义icon位置大小为60，重载ListView的getIcon方法返回数据中定义的ProductId属性，如此就可以看到图标了。

还没完，效果图上显示的图片是圆形的，这该如何是好呢？别急，我们有万能的矢量，上么样的图形都难不倒我们：

ht.Default.setImage('productIcon', {
    width: 50,
    height: 50,
    clip: function(g, width, height) {
        g.beginPath();
        g.arc(width/2, height/2, Math.min(width, height)/2-3, 0, Math.PI * 2, true);
        g.clip();
    },
    comps: [
        {
            type: 'image',
            stretch: 'uniform',
            rect: [0, 0, 50, 50],
            name: {func: function(data){return data.a('ProductId');}}
        }
    ]
});

在代码中我们定义了一个名称为productIcon的矢量，在矢量中通过clip属性定义裁切区域，效果就是超出该裁切区域外的内容将被隐藏。现在矢量定义好了，我们只需要在ListView的getIcon()方法中返回我们定义的矢量名称就可以实现圆形图标了：

listView.getIcon = function(data){
    return 'productIcon';
};

到这里，和效果图的效果就一模一样了~那么接下来我们就该创建3D拓扑组件了，来看看效果图：

很简单，就在3D拓扑中放两个正方体：

var g3d = new ht.graph3d.Graph3dView();
 
var node = new ht.Node();
node.s3(30, 30, 30);
node.p3(-30, 15, 0);
node.s('all.color', '#87A6CB');
g3d.dm().add(node);
 
node = new ht.Node();
node.s3(30, 30, 30);
node.p3(30, 15, 0);
node.s('all.color', '#87A6CB');
node.setElevation(15);
g3d.dm().add(node);

这是你会发现并没有像效果图中显示的那么会有网格效果，并且视角也不对，没事，待我添加几个属性：

g3d.setEye(-100, 100, 80);
g3d.setGridVisible(true);
g3d.setGridColor(‘#F1F4F7');

如此就和效果图一模一样了~

ListView和3D拓扑是两个独立的组件，我们该如何将这两个组件组合在一起呢？这时候，我想到了BorderPane组件，将List组件放在左边，将3D拓扑组件放在右边：

var borderPane = new ht.widget.BorderPane();
 
borderPane.setLeftView(listView, 350);
borderPane.setCenterView(g3d);

看，成功将两个组件合并在一起了，离成功不远了。接下来就是今天的重头戏了，该如何实现拖拽List上的节点到3D拓扑上，并实现节点的图标吸附到3D拓扑的图元上呢，我给大家细细道来。

首先先来了解下ListView的handleDragAndDrop()方法，draganddrop一共有4个状态：prepare、begin、between和end，可更具这4个不同状态来做不同的业务处理。

第一步，我们来实现鼠标附带图标的效果，在拖拽ListView的节点时，在鼠标下方增加一个该节点的缩略图：

思路是这样的：

1. 在prepare状态时获取当前拖拽节点的ProductId属性，并通过调用ht.Default.toCanvas()方法将当前拖拽节点结合矢量productIcon获得一个canvas对象；

2. 在begin状态时根据鼠标当前位置设置canvas对象的left和top属性，并将其添加到DOM树中；

3. 在between状态时，根据鼠标位置信息，重新设置canvas对象的left和top属性，令canvas对象一直跟着鼠标在移动；

4. 在end状态时，将canvas对象移除DOM树。

var dragImage = null,
    productId = null;
listView.handleDragAndDrop = function(e, state) {
    if (state === 'prepare') {
        var data = listView.getDataAt(e);
        listView.sm().ss(data);
        if (dragImage && dragImage.parentNode) {
            document.body.removeChild(dragImage);
        }
        dragImage = ht.Default.toCanvas('productIcon', 30, 30, 'uniform', data);
        productId = data.a('ProductId');
    }
    else if (state === 'begin') {
        if (dragImage) {
            var pagePoint = ht.Default.getPagePoint(e);
            dragImage.style.left = pagePoint.x - dragImage.width / 2 + 'px';
            dragImage.style.top = pagePoint.y - dragImage.height / 2 + 'px';
            document.body.appendChild(dragImage);
        }
    }
    else if (state === 'between') {
        if (dragImage) {
            var pagePoint = ht.Default.getPagePoint(e);
            dragImage.style.left = pagePoint.x - dragImage.width / 2 + 'px';
            dragImage.style.top = pagePoint.y - dragImage.height / 2 + 'px';
        }
    }
    else {
        if (dragImage) {
            if (dragImage.parentNode) {
                document.body.removeChild(dragImage);
            }
            dragImage = null;
            productId = null;
        }
    }
};

如此在拖拽ListView节点时就能够看到有一个小图标一直跟着鼠标在移动。

OK，接下来该解决图元吸附功能，当鼠标拖拽ListView节点到3D拓扑上的图元是，将该节点的图标设置为图元当前面的贴图。

思路是这样子的：

1. 在between状态时，通过ht.Default.containedInView()方法判断殿前鼠标是否在3D拓扑组件上；

2. 若鼠标在3D拓扑上，则通过g3d.getHitFaceInfo()方法，根据鼠标当前信息获取当前鼠标下的图元表面信息；

3. 若当前鼠标在图元的某个表面上，则先保存该图元表面信息的贴图，然后设置当前图元表面的贴图为拖拽节点对应的图片，最后将当前图元表面信息缓存下来，当鼠标离开该表面时，还原图元的贴图；

4. 在end状态时，如果当前鼠标位置在某个图元表面时，就将当前拖拽节点的对应的图片做为当前图元表面的贴图。

那么接下来就需要对ListView组件的handleDragAndDrop()方法做些微的修改了。

listView.handleDragAndDrop = function(e, state) {
    if (state === 'prepare') {
        var data = listView.getDataAt(e);
        listView.sm().ss(data);
        if (dragImage && dragImage.parentNode) {
            document.body.removeChild(dragImage);
        }
        dragImage = ht.Default.toCanvas('productIcon', 30, 30, 'uniform', data);
        productId = data.a('ProductId');
    }
    else if (state === 'begin') {
        if (dragImage) {
            var pagePoint = ht.Default.getPagePoint(e);
            dragImage.style.left = pagePoint.x - dragImage.width / 2 + 'px';
            dragImage.style.top = pagePoint.y - dragImage.height / 2 + 'px';
            document.body.appendChild(dragImage);
        }
    }
    else if (state === 'between') {
        if (dragImage) {
            var pagePoint = ht.Default.getPagePoint(e);
            dragImage.style.left = pagePoint.x - dragImage.width / 2 + 'px';
            dragImage.style.top = pagePoint.y - dragImage.height / 2 + 'px';
 
            if (ht.Default.containedInView(e, g3d)) {
                if (lastFaceInfo) {
                    lastFaceInfo.data.s(lastFaceInfo.face + '.image', lastFaceInfo.oldValue);
                    lastFaceInfo = null;
                }
                var faceInfo = g3d.getHitFaceInfo(e);
                if (faceInfo) {
                    faceInfo.oldValue = faceInfo.data.s(faceInfo.face + '.image');
                    faceInfo.data.s(faceInfo.face + '.image', productId);
                    lastFaceInfo = faceInfo;
                }
            }
        }
    }
    else {
        if (dragImage) {
            if (lastFaceInfo) {
                lastFaceInfo.data.s(lastFaceInfo.face + '.image', lastFaceInfo.oldValue);
                lastFaceInfo = null;
            }
            if (ht.Default.containedInView(e, g3d)) {
                var faceInfo = g3d.getHitFaceInfo(e);
                if (faceInfo) {
                    faceInfo.data.s(faceInfo.face + '.image', productId);
                }
            }
            if (dragImage.parentNode) {
                document.body.removeChild(dragImage);
            }
            dragImage = null;
            productId = null;
        }
    }
};

在看看最后的效果图吧

今天就到这吧，将的内容有点多，涉及到HT for Web的知识点也比较多，下面附上本次Demo的源代码，感兴趣的朋友可以载下来看看，同时也欢迎大家留言质询。

下载源码