嵌入式 Javascript/jQuery 插件 SVG SketchPad
背景
对于我的一个项目,我需要实现一个草图垫。浏览谷歌的想法,很快我想出了一个基于画布的画板。但是它缺少几个功能,我不确定它们是否容易在 canvas 平台上实现:
- 将绘图另存为图像,以便外部工具可以使用它,而无需特殊渲染器
- 存储注意事项 - 即使是 PNG 图像也会很大
- 能够在未来修改图像。
- 选择现有对象进行微调。
因此,在下一次迭代中,我决定在 SVG 技术 ( svg.html) 的基础上绘制草图。它似乎解决了我在画布上遇到的所有问题。
使用代码
要使用代码,只需包含editor.js
文件并初始化为常规 jQuery
插件。
下面的示例代码创建了(#content
) 一个具有所需尺寸区域的简单<div/>
。然后在 jQuerydocument.ready
函数中创建一个 jQuery 对象并附加 change
事件处理程序。在此处理程序中,它使用 Scribble
的对象toText
函数将绘图作为 svg 文本字符串,并将预览 #res
元素的值设置为该 svg。
此外,它还获取绘图的 PNG 值并将预览图像设置为该值。由于图像加载不是在浏览器中的即时操作,因此当图像准备好时,将调用作为函数参数提供的事件处理程序。
<div id="content"
style='position:absolute; width:600px; height:400px; left:100px; border:solid;'></div>
<script src="Editor.js"></script>
<script>
$(document).ready(function() {
$('#content').Scribble().change(function() {
$('#res').html($(this).Scribble('toText', 'svg'));
$(this).Scribble('toText', 'png', function(img) {
$('#img').attr('src', img);
});
});
});
</script>
<img id='img' style='border:solid;position:absolute; top:450px; left:5px; width:200px; height:130px;'>
<div id='res' style='border:solid;position:absolute; top:450px; left:210px;'></div>
这里有三种有趣的方法:
-
onchange
事件 - 每次更改图像时生成 -
toText(type, onLoad)
方法 - 一种将当前 SVG 值作为不同格式的字符串返回的方法。可能的格式:
○ svg
- 返回值作为 SVG 字符串
○ base64
- SVG base64 编码的值
○ mix
- 如果 SVG 包含 unicode 字符 (emojii),则使用 base64 编码,否则返回非编码值
○ png
、jpeg
或任何其他没有“imamge/”部分的图像 mime 类型。调用时,返回值是 base64 编码值。图像将在 OnLoad 方法中返回(此处需要)
-
fromText(val)
- 使用toText上面的() 函数生成的提供的 SVG 字符串加载编辑器的值。如果容器元素将 <textarea/> 作为子元素隐藏,则此 textarea 的值将用作编辑器的初始值。如果未找到此文本区域,则会创建空的隐藏文本区域。文本区域将在任何更改时使用 SVG 内容进行更新。这是我用来在浏览器和后端 ASP.NET WebForms 应用程序之间传递值的技巧。
支持的工具
- 线 - 允许创建线
- 矩形 - 允许创建矩形
- Arrow - 允许创建箭头
- 铅笔 - 自由形式绘图。最初的实现是记住所有的鼠标移动点。然而,这会导致弯曲的线条和很多点。所以如果没有按下shift,最终版本会画直线。您可以按 shift 键或暂停半秒以放下锚点或在绘制时按住 shift 以跟随 mosemove 事件。
- 文本 - 允许文本/表情符号输入。
- 图像 - 要求插入图像。图像也可以拖/放或粘贴到绘图区域的顶部
- 移动 - 从对象创建切换到移动/调整大小模式。
- 颜色 - 更改选定/创建对象的颜色
- 宽度 - 更改选定/创建对象的笔画宽度
- 旋转 - 为简单起见,我只允许 90 度旋转一次
兴趣点
Base64 编码
在某些时候对最终产品进行故障排除,我遇到了 emojii 无法正确重新加载的问题。我花了一段时间才意识到我的数据库列是 varchar(max) 并且不存储 unicode。由于其他项目使用相同的数据库,因此我决定将SVG编码为base 64,而不是更改列类型。不幸的是,浏览器中的btoa函数有问题,因此需要一些时间才能找到解决方案。
SVG 加载/兼容性
SVG 是一种完整的语言。我从来没有打算能够支持 SVG 规范中定义的所有功能,只是为了能够加载我之前创建的文档。请不要仅使用随机的 SVG 文档来尝试它 - 它很可能不起作用。