《从零开始, 开发一个 Web Office 套件》系列博客目录
这是一个系列博客, 最终目的是要做一个基于HTML Canvas 的, 类似于微软 Office 的 Web Office 套件, 包括: 文档, 表格, 幻灯片... 等等.
对应的Github repo 地址: https://github.com/zhaokang555/canvas-text-editor
2. 富文本编辑器(MVP)
2.13 z-index
2.13.1 新的问题
上一篇博客中, 我们实现了mouse hover over SizeControlPoint的feature. 现在, 问题来了: SizeControlPoint和editor border会有重叠的部分, 当鼠标hover到这个位置时, 应该怎么处理?
我暂时想到了一种解决方案: 引入z-index的概念, 为SizeControlPoint和editor border分配不同的z-index. 当鼠标hover到元素重叠的部分时, 寻找最大的z-index对应的元素.
2.13.2 实现
修改src/core/ResponsiveToMouseHover.ts:
- 添加属性
zIndex - constructor添加形参
options, 用来设置zIndex - 添加两个静态属性
topLayerZIndex和topLayerCursorType, 用来记录最上层图层对应的zIndex值和鼠标样式 - 修改render函数, 记录
topLayerZIndex和topLayerCursorType
同时, 修改src/core/SizeControlPoint.ts, 让它支持设置zIndex:
最后, 修改src/coreCanvasTextEditor.ts:
- 修改
render函数, 在所有的sizeControlPointsrender结束之后, 再设置canvas.style.cursor - 修改
clearCanvas函数, 重置ResponsiveToMouseHover.topLayerZIndex和ResponsiveToMouseHover.topLayerCursorType
2.14 Mouse hover over editor border
处理完z-index的问题, 我们就可以实现这个feature了: 当鼠标hover到编辑器边缘的虚线边框上时, 鼠标形状随之变化
2.14.1 重构: Extract component: CanvasTextEditorBorder
新建文件src/core/CanvasTextEditorBorder.ts:
其中, Victor是一个开源数学库: http://victorjs.org/, 可以做一些二维向量计算, 可以通过npm安装:
npm install victor --save
npm install @types/victor --save-dev
然后重构文件src/core/CanvasTextEditor.ts:
- 修改
constructor, 抽出initParagraphs和initSizeControlPoints函数 - 添加
initBorder函数, 并在constructor中调用 - 删除
renderBorder函数 - 修改
render函数
同时，修改CanvasTextEditor.destructor, 在其中调用每个border实例的destructor:
2.14.2 实现
实现这个feature之前, 我们需要思考如何拓展border的响应范围(responsive zone). 为什么要这样呢? 因为border是一条很细的线, 要让鼠标精确地hover上去非常困难, 所以要扩大它的responsive zone. 如下图所示, 我们把border横向拓展, 灰色的范围就是拓展后的responsive zone.
然后, 我们动手来实现. 修改src/core/CanvasTextEditorBorder.ts:
- 继承
ResponsiveToMouseHover - 添加常量
borderResponsiveWidth, 用来表示拓展后的responsive box的宽度 - 添加常量
defaultCanvasTextEditorBorderZIndex, 用来表示border默认的zIndex - 在
constructor中:- 计算border的法向量
normalVector - 然后计算
responsive zone的四角坐标, 存入points中 - 然后利用四角坐标, 计算
responsive zone的left, top, width, height, 传入super()中
- 计算border的法向量
上图中，我们使用了Victor（http://victorjs.org）这个二位向量运算库的若干API:
.clone(): 克隆一个二维向量，并返回.substract(vector): 用自己减去另一个二维向量，并将结果赋值给自己.add(vector): 用自己加上另一个二维向量，并将结果赋值给自己.rotate(angle): 将自己沿原点旋转若干弧度，并将结果赋值给自己.normalize(): 将自己标准化，并将结果赋值给自己.multiplyScalar(scalar): 将自己乘以一个数量，并将结果赋值给自己
同时, 在src/core/CursorType.ts中, 添加十字鼠标样式(see: https://developer.mozilla.org/en-US/docs/Web/CSS/cursor) :
2.14.3 效果
给responsive zone加上灰色背景, 看一下它的范围是否合适:
(未完待续)