简介 jCanvas：当 jQuery赶上HTML5 Canvas

时间  2019-11-21
标签 简介 jcanvas jquery 赶上 html5 html canvas 栏目 JQuery 繁體版
原文   原文链接

https://github.com/caleb531/jcanvashtml

HTML5 能够直接在你的网页中使用 <canvas> 元素及其相关的 JavaScript API绘制的图形。html5

在这篇文章中，我将向你介绍 jCanvas，一个基于 jQuery的免费且开源的 HTML5的Canvas API。jquery

若是你使用 jQuery 进行开发，jCanvas可以使用 jQuery更简单，更快速的完成一些很是炫酷的 canvas画布及交互效果。git

什么是 jCanvas ？

jCanvas 官网是这样解释的：github

“jCanvas is a JavaScript library, written using jQuery and for jQuery, that wraps around the HTML5 canvas API, adding new features and capabilities, many of which are customizable. Capabilities include layers, events, drag-and-drop, animation, and much more.canvas

The result is a flexible API wrapped up in a sugary, jQuery-esque syntax that brings power and ease to the HTML5 canvas. ”segmentfault

jCanvas 能让你作的一切事情，你均可以用原生的Canvas API来实现，甚至能够作更多的事情。若是你愿意的话，你也能够将原生的Canvas API方法和 jCanvas一块儿使用。draw()方法就能够这样使用。此外，你还能够很是轻松的用本身的方法结合 extend()函数来扩展jCanvas的功能。浏览器

添加jCanvas 到你的项目中

将jCanavs添加在你的项目中，从官方网站或GitHub的页面上下载脚本，而后将脚本文件放在你的项目文件夹中。正如前面说的，jCanvas须要依赖 jQuery才能正常工做，因此还要确保引入了 jQuery文件。app

项目的脚本文件将是这个样子：编辑器

<script src="js/jquery.min.js></script>
<script src="js/jcanvas.min.js></script>
<script src="js/script.js></script>

最后，引入你本身的JavaScript 代码文件。如今，让咱们开始jCanvas之旅吧。

设置 HTML文档

咱们经过为 HTMl5文档添加一个<canvas>标签，来开始咱们的示例。

<canvas id="myCanvas" width="600" height="300">
 <p>This is fallback content 
      for users of assistive technologies 
      or of browsers that don't have 
      full support for the Canvas API.</p>
</canvas>

如下是关于上面的代码片断的几点说明。

  1. 默认状况下，<canvas>的尺寸300px x 150px，你能够在width 和 height 属性里修改默认的大小。

  2. id属性不是必须添加的，可是确是 JavaScript访问该元素的最简单的方法。

  3. 在<canvas>元素中的内容只是位图，这使得它没法被使用辅助技术的用户访问。另外，对不支持 Canvas API的浏览器，将不可以访问其内容或者任何方式的交互。所以，该技术旨在让<canvas>更容易被支持。

若是你想使用原生的Canvas API，你的 JavaScript 代码将会这样的：

var canvas = document.getElementById('myCanvas'),
context = canvas.getContext('2d');

上述代码中的context变量存储了Canvas对象的一个2D上下文属性。正是这种特性，使得你能够访问 HTML5的 Canvas API提供的全部其余属性和方法。

若是你想了解的更多，你能够戳这里HTML5 Canvas 简介。

jCanvas的方法和属性已经包含了2D上下文的引用，所以你能够直接的跳到绘制图片。

用jCanvas绘制一些图形

大多数的 jCanvas方法，接受键值对的形式，所以你能够根据你的须要，或你喜欢的顺序去使用它们。

让咱们从绘制一个矩形开始吧。

矩形

下面是你怎样用 jCanvas对象的 drawRect() 方法绘制出一个矩形的方法。

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

// rectangle shape 
$myCanvas.drawRect({
      fillStyle: 'steelblue',
      strokeStyle: 'blue',
      strokeWidth: 4,
      x: 150, y: 100,
      fromCenter: false,
      width: 200,
     height: 100
});

上面的代码片断表示，存储 Canvas对象到一个名为$myCanvas的变量中。里面的drawRect()方法的属性都是比较简单的，可是咱们在这里简单的阐述一下：

  1. fillStyle 设置矩形的背景色;

  2. strokeStyle 设置它的边框颜色;

  3. strokeWidth 设置矩形的边框宽度;

  4. x 和 y设置对应矩形的坐标的水平和垂直的画布内测的位置。顶点的0值的分别为 x和y，也就是说，（0，0），对应于画布的左上角。x坐标向右增大，y坐标朝向画布的底部增长。默认状况下，jCanvas会以矩形的中心点做为x和y坐标的值;

  5. 要想改变这一点，以便x和y对应矩形的左上角，能够将fromCenter属性的值设置为 false;

  6. 最后，经过宽度和高度属性设置矩形的尺寸。

下面是矩形的示例代码：

HTML：

<h2>jCanvas example: Rectangle</h2>

<canvas id="myCanvas" width="600" height="300">
       <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

// rectangle shape 
$myCanvas.drawRect({
  fillStyle: 'steelblue',
  strokeStyle: 'blue',
  strokeWidth: 4,
  x: 190,
  y: 50,
  fromCenter: false,
  width: 200,
  height: 100
});

Result:

jCanvas example: Rectangle

圆弧和圆

弧是一个圆的边缘部分。对于jCanvas来讲，画一个圆弧仅仅是在 drawArc() 方法里设置几个所需的属性：

$myCanvas.drawArc({
  strokeStyle: 'steelblue',
  strokeStyle: 'blue',
  strokeWidth: 4,
  x: 300, y: 100,
  radius: 50,
  // start and end angles in degrees
  start: 0, end: 200
});

绘制弧形，须要设置半径属性的值，以及开始的角度和结束的角度。若是你但愿弧形是逆时针方向的话，须要添加一个ccw属性，并将其属性值设置为true。

下面是上述代码块演示：

HTML:

<h2>jCanvas example: Arc</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS：

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS：

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawArc({
  strokeStyle: 'steelblue',
  strokeStyle: 'blue',
  strokeWidth: 4,
  x: 300, y: 100,
  radius: 50,
  // start and end angles in degrees
  start: 0, end: 200
});

Result:

jCanvas example: Arc

绘制一个圆形：

举例来讲，下面是如何只使用圆弧形状来绘制出一个简单的笑脸图形：

$myCanvas.drawArc({
  // draw the face
  fillStyle: 'yellow',
  strokeStyle: '#333',
  strokeWidth: 4,
  x: 300, y: 100,
  radius: 80
}).drawArc({
  // draw the left eye
  fillStyle: '#333',
  strokeStyle: '#333',
  x: 250, y: 70,
  radius: 5
}).drawArc({
  // draw the right eye
  fillStyle: '#333',
  strokeStyle: '#333',
  x: 350, y: 70,
  radius: 5
}).drawArc({
  // draw the nose
  strokeStyle: '#333',
  strokeWidth: 4,
  ccw: true,
  x: 300, y: 100,
  radius: 30,
  start: 0,
  end: 200
}).drawArc({
  // draw the smile
  strokeStyle: '#333',
  strokeWidth: 4,
  x: 300, y: 135,
  radius: 30,
  start: 90,
  end: 280
});

请记住，jCanvas是基于jQuery的，所以，你能够像jQuery的链式操做同样，在jCanvas中也可使用链式操做。

下面是以上代码在浏览器中的效果：

HTML:

<h2>jCanvas example: Smiling Face</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawArc({
  // draw the face
  fillStyle: 'yellow',
  strokeStyle: '#333',
  strokeWidth: 4,
  x: 300, y: 100,
  radius: 80
}).drawArc({
  // draw the left eye
  fillStyle: '#333',
  strokeStyle: '#333',
  x: 250, y: 70,
  radius: 5
}).drawArc({
  // draw the right eye
  fillStyle: '#333',
  strokeStyle: '#333',
  x: 350, y: 70,
  radius: 5
}).drawArc({
  // draw the nose
  strokeStyle: '#333',
  strokeWidth: 4,
  ccw: true,
  x: 300, y: 100,
  radius: 30,
  start: 0,
  end: 200
}).drawArc({
  // draw the smile
  strokeStyle: '#333',
  strokeWidth: 4,
  x: 300, y: 135,
  radius: 30,
  start: 90,
  end: 280
});

Result:

jCanvas example: Smiling Face

绘制线条和路径

你能够用drawLine()方法快速的绘制直线，或者定义一系列的线条的链接点。

$myCanvas.drawLine({
  strokeStyle: 'steelblue',
  strokeWidth: 10,
  rounded: true,
  closed: true,
  x1: 100, y1: 28,
  x2: 50, y2: 200,
  x3: 300, y3: 200,
  x4: 200, y4: 109
});

上面代码设置了 rounded和closed属性的值为true，从而所绘制的线和角都是闭合的。

HTML:

<h2>jCanvas example: Connected lines</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawLine({
  strokeStyle: 'steelblue',
  strokeWidth: 10,
  rounded: true,
  closed: true,
  x1: 100,
  y1: 28,
  x2: 50,
  y2: 200,
  x3: 300,
  y3: 200,
  x4: 200,
  y4: 109
});

Result:

jCanvas example: Connected lines

还可使用drawPath()方法绘制路径。

该drawPath()方法设置 x 和 y值，你还须要制定你要绘制的路径的类型，例如直线，圆弧等。

下面教你如何使用 drawPath()方法和drawarrows()方法画出一对水平和垂直方向的箭头，后者是一个很是好用的jCanvas方法，可以使你快速的在画布上绘制一个箭头形状：

$myCanvas.drawPath({
  strokeStyle: '#000',
  strokeWidth: 4,
  x: 10, y: 10,
  p1: {
    type: 'line',
    x1: 100, y1: 100,
    x2: 200, y2: 100
  },
  p2: {
    type: 'line',
    rounded: true,
    endArrow: true,
    arrowRadius: 25,
    arrowAngle: 90,
    x1: 200, y1: 100,
    x2: 290, y2: 100
 },
 p3: {
   type: 'line',
   rounded: true,
   endArrow: true,
   arrowRadius: 25,
   arrowAngle: 90,
   x1: 100, y1: 100,
   x2: 100, y2: 250
  }
});

结果展现：

HTML：

<h2>jCanvas example: Connected Arrows</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS：

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawPath({
  strokeStyle: '#000',
  strokeWidth: 4,
  x: 10, y: 10,
  p1: {
    type: 'line',
    x1: 100, y1: 100,
    x2: 200, y2: 100
  },
  p2: {
    type: 'line',
    rounded: true,
    endArrow: true,
    arrowRadius: 25,
    arrowAngle: 90,
    x1: 200, y1: 100,
    x2: 290, y2: 100
  },
  p3: {
    type: 'line',
    rounded: true,
    endArrow: true,
    arrowRadius: 25,
    arrowAngle: 90,
    x1: 100, y1: 100,
    x2: 100, y2: 250
  }
});

Result:

jCanvas example: Connected Arrows

绘制文本

你可使用drawText()方法快速的绘制出你须要的文字，这个方法的主要的功能：

  1. text：将此属性设置为你想要显示在画布上的文字内容：例如：‘Hello World’

  2. fontsize：此属性的值决定了在画布上的文字的大小。你能够为这个属性设置为一个数字，jCanvas默认为像素。另外，你也可使用pt,可是在这种状况下，你须要用引号将属性值包括起来

  3. fontFamily：容许你指定您的文字图像的字体：'Verdana, sans-serif'。

这里的示例代码：

$myCanvas.drawText({
  text: 'Canvas is fun',
  fontFamily: 'cursive',
  fontSize: 40,
  x: 290, y: 150,
  fillStyle: 'lightblue',
  strokeStyle: 'blue',
  strokeWidth: 1
});

在浏览器中将是这样的效果：

HTML:

<h2>jCanvas example: Drawing text</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawText({
  text: 'jCanvas is fun',
  fontFamily: 'cursive',
  fontSize: 40,
  x: 290, y: 150,
  fillStyle: 'lightblue',
  strokeStyle: 'blue',
  strokeWidth: 1
});

Result:

jCanvas example: Drawing text

绘制图片

你可使用drawImage()方法来导入和处理图片。下面是一个例子：

$myCanvas.drawImage({
  source: 'imgs/cat.jpg',
  x: 250, y: 100,
  fromCenter: false,
  shadowColor: '#222',
  shadowBlur: 3,
  rotate: 40
});

这是上面代码的呈现方式：

HTML:

<h2>jCanvas example: Importing and manipulating an image</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawImage({
  source: 'https://s3-us-west-2.amazonaws.com/s.cdpn.io/123941/cat.jpg',
  x: 250, y: 100,
  fromCenter: false,
  shadowColor: '#222',
  shadowBlur: 3,
  rotate: 40
});

Result:

jCanvas example: Importing and manipulating an image

你能够随便的改变上面示例的代码，戳这里：CodePen demo

Canvas层

若是你曾经使用过，如Photoshop或Gimp图像编辑器类的应用程序，你可能会对图层有所了解，使用图层最爽的地方在于，你能够在画布上控制每一个图像。

jCanvas提供了一个功能强大的API，基于你的画布增长了灵活性。

这里介绍了如何使用jCanvas的层。

添加图层

你只能在每个层上绘制一个对象。在你的jCanvas项目中你有两种添加图层的方式：

  1. 使用 addLayer()方法，其次是drawLayers()方法

  2. 在任何的绘制方法里设置layer属性的值为true

下面是如何运用第一种技术来绘制一个蓝色矩形：

$myCanvas.addLayer({
  type: 'rectangle',
  fillStyle: 'steelblue',
  fromCenter: false,
  name: 'blueRectangle',
  x: 50, y: 50,
  width: 400, height: 200
}).drawLayers();

HTML:

<h2>jCanvas example: Drawing a rectangle with addLayer()</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.addLayer({
  type: 'rectangle',
  fillStyle: 'steelblue',
  fromCenter: false,
  name: 'blueRectangle',
  x: 50, y: 50,
  width: 400, height: 200
}).drawLayers();

Result:

这里是你如何获得一样矩形的第二种方法：

$myCanvas.drawRect({
  fillStyle: 'steelblue',
  layer: true,
  name: 'blueRectangle',
  fromCenter: false,
  x: 50, y: 50,
  width: 400, height: 200
});

HTML:

<h2>jCanvas example: Using drawing method with layer set to "true"</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

$myCanvas.drawRect({
  fillStyle: 'steelblue',
  layer: true,
  name: 'blueRectangle',
  fromCenter: false,
  x: 50, y: 50,
  width: 400, height: 200
});

Result:

正如你所看到的，上面的两种方法，咱们获得了相同的结果。

最重要的一点是在上面两个代码样本中能够发现，上面的层你经过name设置的一个名称。这使得他易于参照本层的代码作出各类炫酷的东西，像改变其索引值，动画，删除等等。

让咱们看看如何可以作到这一点。

动画层

你可使用jCanvas的 animateLayer()方法，快速的在你的基础图层上添加动画，此方法接受如下参数：

  1. 该层的 index 或者 name

  2. 具备键值对的动画对象

  3. 以毫秒为单位的动画时长（duration）。这是个默认的参数，若是不设置，默认为400

  4. 动画的运动方式（easing ）。这也是一个可选的参数，若是不设置，则默认为摇摆

  5. 动画完成以后的回调函数（callback），也是可选的。

让咱们来看一下animateLayer() 方法的效果，咱们将在一个层上绘制一个半透明的橙色圆圈，而后设置动画的位置，颜色以及透明度属性：

// Draw circle
$myCanvas.drawArc({
  name: 'orangeCircle',
  layer: true,
  x: 50, y: 50,
  radius: 100,
  fillStyle: 'orange',
  opacity: 0.5
});

// Animate the circle layer 
$myCanvas.animateLayer('orangeCircle', {
  x: 150, y: 150,
  radius: 50,
}, 1000, function(layer) { // Callback function
  $(this).animateLayer(layer, {
    fillStyle: 'darkred',
    x: 250, y: 100,
    opacity: 1
  }, 'slow', 'ease-in-out');
});

看一下下面例子中的动画：

HTML:

<h2>jCanvas example: Animating Layers</h2>

<canvas id="myCanvas" width="600" height="300">
  <p>This is fallback content for users of assistive technologies or of browsers that don't have full support for the Canvas API.</p>
</canvas>

CSS:

body {
  text-align: center;
}

canvas {
  margin: auto;
  display: block;
}

JS:

// Store the canvas object into a variable
var $myCanvas = $('#myCanvas');

// Draw circle
$myCanvas.drawArc({
  name: 'orangeCircle',
  layer: true,
  x: 50, y: 50,
  radius: 100,
  fillStyle: 'orange',
  opacity: 0.5
});

// Animate the circle layer 
$myCanvas.animateLayer('orangeCircle', {
  x: 150, y: 150,
  radius: 50,
}, 1000, function(layer) { // Callback function
  $(this).animateLayer(layer, {
    fillStyle: 'darkred',
    x: 250, y: 100,
    opacity: 1
  }, 'slow', 'ease-in-out');
});

Result:

jCanvas example: Animating Layers

可拖动图层

我想提醒你注意的是它还有一个很酷的功能，你能够在可拖动层里设置draggable属性和layer 属性的值为true，就能够将一个普通的jCanvas层变成可拖动的层了。

具体方法以下：

$myCanvas.drawRect({
  layer: true,
  draggable: true,
  bringToFront: true,
  name: 'blueSquare',
  fillStyle: 'steelblue',
  x: 250, y: 150,
  width: 100, height: 100,
  rotate: 80,
  shadowX: -1, shadowY: 8,
  shadowBlur: 2,
  shadowColor: 'rgba(0, 0, 0, 0.8)'
})
.drawRect({
  layer: true,
  draggable: true,
  bringToFront: true,
  name: 'redSquare',
  fillStyle: 'red',
  x: 190, y: 100,
  width: 100, height: 100,
  rotate: 130,
  shadowX: -2, shadowY: 5,
  shadowBlur: 3,
  shadowColor: 'rgba(0, 0, 0, 0.5)'
});

在上面的代码段中，经过把属性draggable设置为true，绘制出了两个可拖动的矩形层。此外，请当心使用bringToFront属性，以确保当你拖动层时，他会被自动拖到全部其余现有的图层的前面。

最后，在上述代码段中添加旋转图层的代码而且设置一个盒子阴影，只是为了告诉你如何快速的在你的jCanvas图纸上添加一些特效。

结果会是这样的：

若是你想在在你拖动图层以前，之间或者以后作一些事情的话，jCanvas 能够很容易的利用相关的回调函数来实现这一点：

  1. dragstart：当你开始拖动图层的时候的触发器

  2. drag：当你正在拖动图层时发生

  3. dragstop：当你中止拖动图层时的触发器

  4. dragcancel：当你拖动的图层到了画布表面的边界时发生

比方说，当用户完成拖动层以后，你想在页面上显示一条消息，你能够经过添加一个回调函数dragstop来实现，就像这样：

$myCanvas.drawRect({
  layer: true,

  // Rest of the code as shown above...

  // Callback function
  dragstop: function(layer) {
    var layerName = layer.name;
    el.innerHTML = 'The ' + layerName + ' layer has been dropped.';
  }
})
.drawRect({
  layer: true,

  // Rest of the code...

  // Callback function
  dragstop: function(layer) {
    var layerName = layer.name;
    el.innerHTML = 'The ' + layerName + ' layer has been dropped.';
  }
});

结论

在这篇文章中，我向你介绍了jCanvas，一个新的基于jQuery能与HTML5的 Canvas API一块儿使用的库。我已经简单的介绍了一些jCanvas的属性和方法，可以让你快速的在画布和是哪一个绘制图形，增长视觉效果，动画和拖动图层。

你能够访问jCanvas文档，这里有不少的详细指导和示例。你要能够在 jCanvas网站的 sandbox上进行快速测试。

 

http://www.javashuo.com/article/p-plhoaxns-h.html

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程