注
- 本人使用的html2canvas是从github上下载的,版本为0.5.0-beta3。
本文会继续更新,以后html2canvas库发现的所有问题都会更新在本文中。- html2canvas问题太多,不再使用了,使用phantomjs替代。(2017-10-19)
1.1 文本设置text-shadow截图后却没有文本阴影(2017-09-28)
bug原因
查看了源码,html2canvas确实处理了text-shadow,但是没有正确的处理小数,导致最后文本阴影没有显示出来。
具体的代码为第1762行
NodeContainer.prototype.TEXT_SHADOW_PROPERTY = /((rgba|rgb)\([^\)]+\)(\s-?\d+px){0,})/g;
NodeContainer.prototype.TEXT_SHADOW_VALUES = /(-?\d+px)|(#.+)|(rgb\(.+\))|(rgba\(.+\))/g;
解决方案
针对这两行的正则表达式,我添加了针对小数的判断,修改后的代码如下:
NodeContainer.prototype.TEXT_SHADOW_PROPERTY = /((rgba|rgb)\([^\)]+\)(\s-?\d+(?:\.\d+)?px){0,})/g;
NodeContainer.prototype.TEXT_SHADOW_VALUES = /(-?\d+(?:\.\d+)?px)|(#.+)|(rgb\(.+\))|(rgba\(.+\))/g;
测试
// html2canvas正则匹配
'rgb(102, 102, 102) 11.924px 11.924px 0px'.match(/((rgba|rgb)\([^\)]+\)(\s-?\d+px){0,})/g); // ["rgb(102, 102, 102)"]
"rgb(102, 102, 102) 11.924px 11.924px 0px".match(/(-?\d+px)|(#.+)|(rgb\(.+\))|(rgba\(.+\))/g); // ["rgb(102, 102, 102)", "924px", "924px", "0px"]
// 修改后的正则匹配
'rgb(102, 102, 102) 11.924px 11.924px 0px'.match(/((rgba|rgb)\([^\)]+\)(\s-?\d+(?:\.\d+)?px){0,})/g); // ["rgb(102, 102, 102) 11.924px 11.924px 0px"]
"rgb(102, 102, 102) 11.924px 11.924px 0px".match(/(-?\d+(?:\.\d+)?px)|(#.+)|(rgb\(.+\))|(rgba\(.+\))/g); // ["rgb(102, 102, 102)", "11.924px", "11.924px", "0px"]
1.2. 文本阴影效果没有显示(2017-10-18)
现象及原因
现象:
部分文本设置了阴影效果,但是截图后并没有显示出来。
原因:
html2canvas库确实解析了阴影样式,但是并没有绘制,只是当做变量存起来了。
第2245行,解析的值是正确的:
this.renderer.fontShadow(shadows[0].color, shadows[0].offsetX, shadows[0].offsetY, shadows[0].blur);
第3044行可以看出,只是存起来了,并没有绘制:
this.setVariable("shadowColor", color.toString())
.setVariable("shadowOffsetY", offsetX)
.setVariable("shadowOffsetX", offsetY)
.setVariable("shadowBlur", blur);
解决方案
使用canvas context提供的阴影方法绘制阴影:
第3044行,将fontShadow 函数改为如下所示:
CanvasRenderer.prototype.fontShadow = function(color, offsetX, offsetY, blur) {
this.ctx.shadowOffsetX = offsetX;
this.ctx.shadowOffsetY = offsetY;
this.ctx.shadowColor = color;
this.ctx.shadowBlur = blur;
};
CanvasRenderer.prototype.clearShadow = function() {
this.ctx.shadowOffsetX = 0;
this.ctx.shadowOffsetY = 0;
this.ctx.shadowBlur = 0;
};
2. 没有跨域,ios上的图片截图却无法显示(2017-09-28)
现象及原因
现象:
编写微信公众号页面,页面上有一张LOGO图片和一张二维码图片,在Android和iOS上这两张图片都能够正常显示。截图的时候Android能够正常截图,iOS上截的图却没有LOGO图片,只有二维码图片。
原因:
经过比较,发现LOGO图片的样式如下:
width: auto;
height: 100%;
二维码图片的样式如下所示:
width: 100%;
height: 100%;
解决方案
在用户点击保存图片的时候,给LOGO图片设置固定的宽度和高度。
经过实验,iOS上的截图也能够正常显示LOGO图片了。
因为时间紧张,今天就不查html2canvas究竟是那部分代码出了bug,有时间再查。
3. 竖版文本显示不全(2017-10-17)
现象及原因
现象:
页面用到了竖版文本,使用的是宽度固定(宽度仅能容纳一个汉字),然后每个文字后面加上**< br />**换行,Android上保存图片没问题,但是iOS上保存之后文本显示不全,文本仍然是按照横向渲染的。
原因:
没调查具体的原因,渲染过程中文本是按照横向渲染的,导致文本显示不全。
解决方案
不再使用**< br />**换行,使用css样式
-webkit-writing-mode: vertical-lr;
writing-mode: vertical-lr;
因为在微信中使用,场景为mobile,兼容性应该没问题。
资料扩展
- MDNwriting-mode解释的挺详细,国内好多博客都是抄的这篇文章。
- 张鑫旭大神对writing-mode有深入的解析改变CSS世界纵横规则的writing-mode属性
4.1. 下划线没有显示(2017-10-17)
现象及原因
现象:
给文本设置了下划线,但是截图中没有显示。
原因:
查看源码2255行(因为文件被我修改了,不一定精确地是这一行),发现了如下代码
this.renderTextDecoration(container.parent, bounds, this.fontMetrics.getMetrics(family, size));
调用的是第2262行:
NodeParser.prototype.renderTextDecoration = function(container, bounds, metrics) {
switch(container.css("textDecoration").split(" ")[0]) {
case "underline":
// Draws a line at the baseline of the font
// TODO As some browsers display the line as more than 1px if the font-size is big, need to take that into account both in position and size
this.renderer.rectangle(bounds.left, Math.round(bounds.top + metrics.baseline + metrics.lineWidth), bounds.width, 1, container.color("color"));
break;
case "overline":
this.renderer.rectangle(bounds.left, Math.round(bounds.top), bounds.width, 1, container.color("color"));
break;
case "line-through":
// TODO try and find exact position for line-through
this.renderer.rectangle(bounds.left, Math.ceil(bounds.top + metrics.middle + metrics.lineWidth), bounds.width, 1, container.color("color"));
break;
}
};
html2canvas查找的文本节点的父节点上的样式,而项目中设置的下划线却是在某个固定的祖先元素上,对代码调整一下就好了。
解决方案
调整后的代码如下所示:
NodeParser.prototype.renderTextDecoration = function(container, bounds, metrics) {
switch(container.parent.parent.css("textDecoration").split(" ")[0]) {
case "underline":
...
}
}
其实就是找到有这个属性的节点,然后从这个节点上获取属性。
也可以修改HTML结构,将这个属性放到包裹文本节点的那一层,这样就不用修改源码了。
4.2. underline太细(2017-10-19)
现象及原因
现象:
下划线截图后比较细。
原因:
查阅代码发现,html2canvas使用的是固定值,而不是跟随文本样式变化而变化。
NodeParser.prototype.renderTextDecoration = function(container, bounds, metrics) {
switch(container.parent.parent.css("textDecoration").split(" ")[0]) {
case "underline":
// Draws a line at the baseline of the font
// TODO As some browsers display the line as more than 1px if the font-size is big, need to take that into account both in position and size
this.renderer.rectangle(bounds.left, Math.round(bounds.top + metrics.baseline + metrics.lineWidth), bounds.width, 2, container.color("color"));
break;
case "overline":
CanvasRenderer.prototype.rectangle = function(left, top, width, height, color) {
this.setFillStyle(color).fillRect(left, top, width, height);
};
可以看出,第三个参数就是宽度,html2canvas设定的是固定值1,。
解决方案
添加了lineWidth变量,设置为文本的1/10,大小基本合适,可以按照现实显示的情况进行调整。
NodeParser.prototype.renderTextDecoration = function(container, bounds, metrics) {
var fontSize = container.parent.parent.css('fontSize');
var lineWidth = parseFloat(fontSize) / 10;
lineWidth = lineWidth > 2 ? lineWidth : 2;
switch(container.parent.parent.css("textDecoration").split(" ")[0]) {
case "underline":
// Draws a line at the baseline of the font
// TODO As some browsers display the line as more than 1px if the font-size is big, need to take that into account both in position and size
this.renderer.rectangle(bounds.left, Math.round(bounds.top + metrics.baseline + metrics.lineWidth), bounds.width, lineWidth, container.color("color"));
break;
case "overline":
this.renderer.rectangle(bounds.left, Math.round(bounds.top), bounds.width, lineWidth, container.color("color"));
break;
case "line-through":
// TODO try and find exact position for line-through
this.renderer.rectangle(bounds.left, Math.ceil((bounds.top + bounds.bottom) / 2 + metrics.lineWidth), bounds.width, lineWidth, container.color("color"));
break;
}
};
4.3. line-through部分文本效果偏下(2017-10-19)
现象及原因
现象:
给文本设置line-through,部分文本删除线偏下。
原因:
经查阅代码
this.renderer.rectangle(bounds.left, Math.ceil(bounds.top + metrics.middle + metrics.lineWidth), bounds.width, 2, container.color("color"));
可以发现,html2canvas使用Math.ceil(bounds.top + metrics.middle + metrics.lineWidth)来计算top值,但是打印log发现,metrics.middle值并不在是文本的一半。
解决方案
使用(bounds.top + bounds.bottom) / 2来计算中间值,效果还可以。
case "line-through":
// TODO try and find exact position for line-through
// this.renderer.rectangle(bounds.left, Math.ceil(bounds.top + metrics.middle + metrics.lineWidth), bounds.width, 2, container.color("color"));
this.renderer.rectangle(bounds.left, Math.ceil((bounds.top + bounds.bottom) / 2 + metrics.lineWidth), bounds.width, 2, container.color("color"));
break;
5.1. 文本描边效果没有显示(2017-10-18)
现象及原因
现象:
一些文本做了文本描边效果,但是截图后发现该效果并没有显示出来。
原因:
经查阅源代码,发现html2canvas库并没有处理文本描边效果的代码
解决方案
仿照其他的代码,自己写响应的代码:
首先在第2251行添加处理文本描边效果的代码
this.renderer.clip(container.parent.clip, function() {
textList.map(this.parseTextBounds(container), this).forEach(function(bounds, index) {
if (bounds) {
this.renderer.text(textList[index], bounds.left, bounds.bottom);
this.renderTextDecoration(container.parent, bounds, this.fontMetrics.getMetrics(family, size));
this.renderTextStroke(textList[index], container.parent, bounds, this.fontMetrics.getMetrics(family, size)); // 这一行是新添加的
}
}, this);
}, this);
完成renderTextStroke函数(仿照renderTextDecoration函数写的)(我写在了2079行,renderTextDecoration函数的后面):
NodeParser.prototype.renderTextStroke = function(text, container, bounds, metrics) {
var width = container.parent.parent.css("-webkit-text-stroke-width");
width = parseFloat(width);
var color = container.parent.parent.css('-webkit-text-stroke-color');
if (width !== 0) {
this.renderer.textStroke(text, bounds.left, bounds.bottom, width, color);
}
};
里面使用了新的函数textStroke,仿照text函数完成该函数(我写在了3078行,text函数的后面):
CanvasRenderer.prototype.textStroke = function(text, left, bottom, width, color) {
this.ctx.lineWidth = width;
this.ctx.strokeStyle = color;
this.ctx.strokeText(text, left, bottom);
};
5.2. 文本描边和阴影同时显示时显示不正常(2017-10-18)
现象及原因
现象:
阴影特别严重,甚至看起来有点模糊。
原因:
和canvas context何时调用strokeText方法有关。具体原因在解决方案中描述。
解决方案(2017-10-19修改)
第2251行第2242行改为如下所示代码:
this.renderer.font(container.parent.color('color'), container.parent.css('fontStyle'), container.parent.css('fontVariant'), weight, size, family);
// if (shadows.length) {
// // TODO: support multiple text shadows
// this.renderer.fontShadow(shadows[0].color, shadows[0].offsetX, shadows[0].offsetY, shadows[0].blur);
// } else {
// this.renderer.clearShadow();
// }
this.renderer.clip(container.parent.clip, function() {
textList.map(this.parseTextBounds(container), this).forEach(function(bounds, index) {
if (bounds) {
if (shadows.length) {
this.renderer.fontShadow(shadows[0].color, shadows[0].offsetX, shadows[0].offsetY, shadows[0].blur);
this.renderer.text(textList[index], bounds.left, bounds.bottom);
this.renderer.clearShadow();
this.renderTextStroke(textList[index], container.parent, bounds, this.fontMetrics.getMetrics(family, size));
this.renderTextDecoration(container.parent, bounds, this.fontMetrics.getMetrics(family, size));
} else {
this.renderer.text(textList[index], bounds.left, bounds.bottom);
this.renderTextStroke(textList[index], container.parent, bounds, this.fontMetrics.getMetrics(family, size));
this.renderTextDecoration(container.parent, bounds, this.fontMetrics.getMetrics(family, size));
}
}
}, this);
}, this);
如果有阴影,一开始就渲染stroke,之后的内容会覆盖一部分stroke的内容;如果没有阴影,最后渲染stroke,stroke会覆盖filltext函数渲染的内容。
先渲染text,如果有阴影,同时渲染阴影,然后将阴影效果去掉;如果有描边,渲染描边效果。经确认,这种写法比之前的写法要好。(2017-10-19)