为了账号安全,请及时绑定邮箱和手机立即绑定

zrender基础知识

标签:
Html5

有句成语说:磨刀不误砍柴工。

本节介绍ZRender知识。

为什么选择ZRender

ZRender 是二维绘图引擎,它提供 Canvas、SVG、VML 等多种渲染方式。ZRender 也是 ECharts 的渲染器。

ZRender的优点:

  • 简单
  • 数据驱动
  • 完整的事件封装
  • 高效的分层刷新
  • 丰富的图形选项
  • 强大的动画支持
  • 易于扩展

传送门:zrender官网

熟悉ZRender基本的api

ZRender图形

新建一个html文件,代码:

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>熟悉 ZRender API </title>
  <style>
    html,body{
        height:100%;
        width:100%;
    }
    body{
        padding:0;
        margin:0;
    }
    #main{
        width:100%;
        height:100%;
    }
  </style>
</head>
<body>
 <!-- 容器 -->
 <div id="main"></div>
 <!-- 引入zrender -->
 <script class="lazyload" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAANSURBVBhXYzh8+PB/AAffA0nNPuCLAAAAAElFTkSuQmCC" data-original="https://cdn.bootcss.com/zrender/4.0.7/zrender.min.js"></script>
 <script>
    //初始化一个实例
    var zr = zrender.init(document.getElementById('main'),{
        renderer:'canvas',       //渲染方式 支持'canvas','svg','vml'
        devicePixelRatio:1,      //画布大小与容器大小之比,仅当 renderer 为 'canvas' 时有效
        width:'auto',            //画布宽度
        height:'auto'            //画布高度
    });
    
    //这里练习代码
    
 </script>
</body>
</html>

创建一个矩形

var rect=new zrender.Rect({
    style:{
        fill:'red',      //填充颜色
        stroke:'none'    //描边颜色
    },
    shape:{
        x:100,           //x,y代表坐标
        y:100,
        width:200,
        height:100,
        r:[3]            //圆角
    },
    z:1                   //层次,大的会覆盖小的
});
zr.add(rect);

创建了一个位置(左上角)在[100,100],长200宽100的背景颜色为红色的矩形,如下图:

还可以通过平移设置位置:

var rect=new zrender.Rect({
    position:[100,100],  //平移距离,
    style:{
        fill:'red',      
        stroke:'none'    
    },
    shape:{
        x:0,
        y:0,
        width:200,
        height:100,
        r:[3]           
    },
    z:1               
});

效果和上面一致,实际上矩形位置是属性 position 和 shape 属性(x,y)之和,但要注意的是,使用

rect.getBoundingRect() //获取元素的包围盒

得到的结果是不一样的,获取到的都是shape属性

如何更改矩形属性?
rect.attr({
    style:{
        fill:'yellow'
    },
    shape:{
        width:300,
        height:200
    }
})

使用attr方法,将矩形颜色更改为黄色,宽度更改300,高度更改为200,该方法触发重绘操作

如何给图形添加事件响应?
//点击事件
rect.on('click',function(e){
    console.log('点击了矩形')
});
//或者给zr添加事件绑定
zr.on('click',function(e){
    //可以查看 e 里包含的属性,进行判断
    console.log(e)
});

ZRender支持的事件有: ‘click’、 ‘mousedown’、 ‘mouseup’、 ‘mousewheel’、 ‘dblclick’、 ‘contextmenu’。

给图形添加动画支持

animate函数
animate(path, loop):

  • path 对该对象的哪个元素执行动画
  • loop 是否循环
rect.animate('shape',true)
    .when(1000, {x:100})
    .when(2000,{x:0})
    .when(3000,{y:100})
    .when(4000,{y:0})
    .start();

效果如下:

animateTo 函数

animateTo(target, time, delay, easing, callback, forceAnimate):

  • target 设置动画的对象
  • time 动画
  • delay 动画延迟执行的时长
  • easing 缓动函数名称
  • callback 动画执行完成后的回调函数
  • forceAnimate 对于相同的属性,是否强制执行
rect.animateTo({
    shape: {
        width: 500
    },
    style: {
        fill: 'blue'
    },
    position:[10,10]
}, 1000, 100, 'cubicOut', function () {    
    console.log('done')
});

时长

将矩形宽度缓慢的增加至500,颜色改变为蓝色,如下图:

图形里的文字
//很多属性和css里的属性一致
rect.attr({
    style:{
        text:'图形文字',             //文字
        textFill:'#333',             //文字颜色
        fontSize:12,                 //文字大小
        fontFamily:'',               //字体
        fontStyle:'normal',          //字形
        fontWeight:'normal',         //加粗
        textStroke:'yellow',         //文字描边
        textWidth:1,                 //字体线宽
        textHeight:12,               //字体高度
        textLineWidth:1,             //字体描边线宽
        textLineHeight:14,           //字体行高
        textPosition:'inside',       //字体位置
        textPadding:[0,0,0,0],       //文字内边距
        transformText:true           //字体跟随变换效果
    }
})

这里面要注意字体的大小,行高,内边距,文字位置等属性等,这些属性在后面会影响一个节点的大小。

图形变换
//假如 rect shape属性如下
...
shape:{
    x:200,           //x,y代表坐标
    y:100,
    width:80,
    height:60,
    r:[3]            //圆角
 }
 ...
//旋转
rect.animateTo({
    rotation:Math.PI/3,         //正值代表逆时针旋转,负值代表顺时针旋转
    origin:[200,100]            //设置变换中心
})

//放大,缩小
rect.animateTo({
    scale:[1.5,1.5],      //x,y轴方向放大至1.5倍
    origin:[240,130] 
})

//平移
rect.animateTo({
    position:[100,100]       //x,y轴分别平移10
})

注意将style里的属性transformText设置为true,使得字体跟随变换效果,如下图:


ZRender还支持许多其他图形,例如:

//圆形
var circle=new zrender.Circle({
    style:{
        fill:'red'
    },
    shape:{
        cx:100,        //圆心X坐标
        cy:100,        //圆心Y坐标
        r:80           //半径
    },
    z:2
});
zr.add(circle);
//圆弧
var arc=new zrender.Arc({
    style:{
        stroke:'none',
        fill:'red'
    },
    shape:{
        cx:300,
        cy:300,
        r:40,
        startAngle:0,              //开始角度
        endAngle:Math.PI/3         //结束角度
    }
});
zr.add(arc);
//扇形
var sector=new zrender.Sector({
    style:{
        fill:'red'
    },
    shape:{
        cx:100,
        cy:100,
        r:80,                     //外半径
        r0:60,                    //内半径
        startAngle:0,             //开始角度
        endAngle:Math.PI/3,       //结束角度
        clockwise:true            //顺时针
    }
});
zr.add(sector);
//椭圆
var ellipse=new zrender.Ellipse({
    style:{
        fill:'red'
    },
    shape:{
        cx:100,
        cy:100,
        rx:160,         //横向半径
        ry:80           //纵向半径
    }
})
zr.add(ellipse);
//心型
var heart =new zrender.Heart({
    style:{
        fill:'red'
    },
    shape:{
        cx:200,
        cy:200,
        width:100,
        height:100
    }
});
zr.add(heart);
//多边形
var Polygon=new zrender.Polygon({
    style:{
        fill:'red'
    },
    shape:{
        points:[[100,100],[200,80],[300,160],[150,130]]    //坐标集合
    }
})
zr.add(Polygon)
//等等
组的概念

组。Group 是一个容器,可以插入子节点,Group 的变换也会被应用到子节点上

这是一个很重要的概念,后面思维导图实现的节点都是用[组]组合的。

关注组的几个重要的API:

//getBoundingRect() 获取元素包围盒
var g=new zrender.Group({
    slient:true                   //组内子孙元素是否响应鼠标事件
});
var rect=new zrender.Rect({
    style:{
        fill:'red'
    },
    shape:{
        x:0,
        y:0,
        width:200,
        height:100
    }
});
var circle=new zrender.Circle({
    style:{
        fill:'red'
    },
    shape:{
        cx:200,
        cy:50,
        r:50
    }
});
g.add(rect);
g.add(circle);
zr.add(g);

console.log(rect.getBoundingRect());
//返回{x: 0, y: 0, width: 200, height: 100}

console.log(circle.getBoundingRect());
//返回 {x: 150, y: 0, width: 100, height: 100}

console.log(g.getBoundingRect());
//返回{x: 0, y: 0, width: 250, height: 100}


//遍历组内元素
g.eachChild(function(item){ 
    console.log(item);
})    

//在组内删除元素
g.remove(circle)   //指定删除
g.removeAll()      //清空组内所有元素

//整体变换,如
g.attr({
    position:[100,100]       //x轴,y轴分别平移100
})

效果如下图:

线
//直线
var line =new zrender.Line({
   style:{
       stroke:'red',       //线的颜色
       lineWidth:1,        //线宽
       lineDash:[0]        //虚线样式
   },
   style:{
       x1:10,              //起始点横坐标
       y1:10,              //起始点纵坐标
       x2:100,             //结束点横坐标
       y2:100,             //结束点横坐标
       percent:1
   }
});
//多边形折线段
var polyline=new zrender.Polyline({
    style:{
       stroke:'red',       //线的颜色
       lineWidth:1,        //线宽
       lineDash:[0] 
    },
    shape:{
        points:[[10,10],[100,100],[100,200]]     //点集
    }
})
//贝塞尔曲线
var bezierCurve=new zrender.BezierCurve({
    style:{
        stroke:'red'
    },
    shape:{
        x1:10,            //起始点横坐标
        y1:10,            //起始点纵坐标
        x2:200,           //结束点横坐标
        y2:200,           //结束点横坐标
        cpx1:50,           //控制点横坐标
        cpy1:50            //控制点纵坐标
    }
});

文字

ZRender 对文字的支持很强大。

var text=new zrender.Text({
    style:{
        text:'这是一段文字'+'\n'+'换行'
    }
});
//可以通过getBoundingRect()获取文字所占的空间
console.log(text.getBoundingRect());
//返回{x: 0, y: 0, width: 72, height: 24, lineHeight: 12}

//特别注意的是rect必须设置宽高,才能获取到其所占的空间
//例如
var rect=new zrender.Rect({
    style:{
        text:'这是文字'
    },
    shape:{
      x:10,
      y:10
    }
})
console.log(rect.getBoundingRect())
//返回{x: 10, y: 10, width: 0, height: 0}

//文字包围盒
var text=new zrender.Text({
    style:{
        text:'这是一段文字',
        textBackgroundColor:'red',     //包围盒背景
        textBorderColor:'#ccc',         //包围盒描边颜色
        textBorderWidth:1,             //包围盒描边线宽
        textPadding:[10,20,10,20]      //文字内边距,同css Padding
    }
});

效果图(没使用rect):

总结

Zrender的基本知识就介绍到这里,总之通过本节的介绍,我们要关注的知识点:

  • 创建图形的方法
  • 修改图形属性的方法(使用attr方法,触发重绘操作)
  • 通过getBoundingRect()获取元素包围盒
  • 组的概念
  • 线段的概念
  • 文字以及文字属性的设置,文字包围盒,如何换行
  • 如何添加事件支持
点击查看更多内容
TA 点赞

若觉得本文不错,就分享一下吧!

评论

作者其他优质文章

正在加载中
Web前端工程师
手记
粉丝
4
获赞与收藏
16

关注作者,订阅最新文章

阅读免费教程

  • 推荐
  • 1
  • 收藏
  • 共同学习,写下你的评论
感谢您的支持,我会继续努力的~
扫码打赏,你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫,即可进行扫码打赏哦
今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与 放弃机会
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消