使用 Konva 的前端可视化设计器 (8) - 预览框
最编程
2024-05-02 07:56:32
...
请大家动动小手,给我一个免费的 Star 吧~
大家如果发现了明显的 Bug,可以提 Issue 哟~
这一章我们实现一个预览框,实时、可交互定位的。
github源码
gitee源码
示例地址
预览框
定位方法
移动画布,将传入 x,y 作为画布中心:
// 更新中心位置
updateCenter(x = 0, y = 0) {
// stage 状态
const stageState = this.render.getStageState()
// 提取节点
const nodes = this.render.layer.getChildren((node) => {
return !this.render.ignore(node)
})
// 计算节点占用的区域(计算起点即可)
let minX = 0
let minY = 0
for (const node of nodes) {
const x = node.x()
const y = node.y()
if (x < minX) {
minX = x
}
if (y < minY) {
minY = y
}
}
// 居中画布
this.render.stage.setAttrs({
x: stageState.width / 2 - this.render.toBoardValue(minX) - this.render.toBoardValue(x),
y: stageState.height / 2 - this.render.toBoardValue(minY) - this.render.toBoardValue(y)
})
// 更新背景
this.render.draws[Draws.BgDraw.name].draw()
// 更新比例尺
this.render.draws[Draws.RulerDraw.name].draw()
// 更新参考线
this.render.draws[Draws.RefLineDraw.name].draw()
// 更新预览
this.render.draws[Draws.PreviewDraw.name].draw()
}
比较难表达,尝试画个图说明:
为了简化,维持画布初始位置,可以把 minX 和 minY 视为 0。
"前"即是 stage 起始位置 也是可视区域,可视区域是固定的,当点击 x,y 坐标时,为了使移动之前 x,y 相对 stage 的位置,移动到可视区域居中位置,stage 就要如图那样“反向”偏移。
分解步骤,可以分为 3 步,"前"、“中”、“后”,对应计算“居中画布”处。
绘制预览框
下面的代码比较长,添加了必要的注释,会重点解释 move 和“可视区域提示框”两部分逻辑。
override draw() {
if (this.render.config.showPreview) {
this.clear()
// stage 状态
const stageState = this.render.getStageState()
// 预览框的外边距
const previewMargin = 20
// 预览框 group
const group = new Konva.Group({
name: 'preview',
scale: {
x: this.render.toStageValue(this.option.size),
y: this.render.toStageValue(this.option.size)
},
width: stageState.width,
height: stageState.height
})
const main = this.render.stage.find('#main')[0] as Konva.Layer
// 提取节点
const nodes = main.getChildren((node) => {
return !this.render.ignore(node)
})
// 计算节点占用的区域
let minX = 0
let maxX = group.width()
let minY = 0
let maxY = group.height()
for (const node of nodes) {
const x = node.x()
const y = node.y()
const width = node.width()
const height = node.height()
if (x < minX) {
minX = x
}
if (x + width > maxX) {
maxX = x + width
}
if (y < minY) {
minY = y
}
if (y + height > maxY) {
maxY = y + height
}
}
// 根据占用的区域调整预览框的大小
group.setAttrs({
x: this.render.toStageValue(
-stageState.x + stageState.width - maxX * this.option.size - previewMargin
),
y: this.render.toStageValue(
-stageState.y + stageState.height - maxY * this.option.size - previewMargin
),
width: maxX - minX,
height: maxY - minY
})
// 预览框背景
const bg = new Konva.Rect({
name: this.constructor.name,
x: minX,
y: minY,
width: group.width(),
height: group.height(),
stroke: '#666',
strokeWidth: this.render.toStageValue(1),
fill: '#eee'
})
// 根据预览框内部拖动,同步画布的移动
const move = () => {
// 略,下面有单独说明
}
// 预览框内拖动事件处理
bg.on('mousedown', (e) => {
if (e.evt.button === Types.MouseButton.左键) {
move()
}
e.evt.preventDefault()
})
bg.on('mousemove', (e) => {
if (this.state.moving) {
move()
}
e.evt.preventDefault()
})
bg.on('mouseup', () => {
this.state.moving = false
})
group.add(bg)
// 预览框 边框
group.add(
new Konva.Rect({
name: this.constructor.name,
x: 0,
y: 0,
width: stageState.width,
height: stageState.height,
stroke: 'rgba(255,0,0,0.2)',
strokeWidth: 1 / this.option.size,
listening: false
})
)
// 复制提取的节点,用作预览
for (const node of nodes) {
const copy = node.clone()
// 不可交互
copy.listening(false)
// 设置名称用于 ignore
copy.name(this.constructor.name)
group.add(copy)
}
// 放大的时候,显示当前可视区域提示框
if (stageState.scale > 1) {
// 略,下面有单独说明
}
this.group.add(group)
}
}
通过预览框移动画布
上面介绍了“定位方法”,基于它,通过预览框也可以使画布同步移动,前提就是要把“预览框”内部的坐标转换成“画布”的坐标。
// 根据预览框内部拖动,同步画布的移动
const move = () => {
this.state.moving = true
const pos = this.render.stage.getPointerPosition()
if (pos) {
const pWidth = group.width() * this.option.size
const pHeight = group.height() * this.option.size
const pOffsetX = pWidth - (stageState.width - pos.x - previewMargin)
const pOffsetY = pHeight - (stageState.height - pos.y - previewMargin)
const offsetX = pOffsetX / this.option.size
const offsetY = pOffsetY / this.option.size
// 点击预览框,点击位置作为画布中心
this.render.positionTool.updateCenter(offsetX, offsetY)
}
}
上面转换的思路就是:
1、通过 group 和倍数反推计算占用的区域可视大小
2、计算可视居中坐标
3、计算逻辑居中坐标(使用倍数恢复)
4、通过 updateCenter 居中
可视区域提示框
当放大的时候,会显示当前可视区域提示框
// 放大的时候,显示当前可视区域提示框
if (stageState.scale > 1) {
// 画布可视区域起点坐标(左上)
let x1 = this.render.toStageValue(-stageState.x + this.render.rulerSize)
let y1 = this.render.toStageValue(-stageState.y + this.render.rulerSize)
// 限制可视区域提示框不能超出预览区域
x1 = x1 > minX ? x1 : minX
x1 = x1 < maxX ? x1 : maxX
y1 = y1 > minY ? y1 : minY
y1 = y1 < maxY ? y1 : maxY
// 画布可视区域起点坐标(右下)
let x2 =
this.render.toStageValue(-stageState.x + this.render.rulerSize) +
this.render.toStageValue(stageState.width)
let y2 =
this.render.toStageValue(-stageState.y + this.render.rulerSize) +
this.render.toStageValue(stageState.height)
// 限制可视区域提示框不能超出预览区域
x2 = x2 > minX ? x2 : minX
x2 = x2 < maxX ? x2 : maxX
y2 = y2 > minY ? y2 : minY
y2 = y2 < maxY ? y2 : maxY
// 可视区域提示框 连线坐标序列
let points: Array<[x: number, y: number]> = []
// 可视区域提示框“超出”预览区域影响的“边”不做绘制
// "超出"(上面实际处理:把超过的坐标设置为上/下线,判断方式如[以正则表达式表示]:(x|y)(1|2) === (min|max)(X|Y))
//
// 简单直接穷举 9 种情况:
// 不超出
// 上超出 下超出
// 左超出 右超出
// 左上超出 右上超出
// 左下超出 右下超出
// 不超出,绘制完整矩形
if (
x1 > minX &&
x1 < maxX &&
x2 > minX &&
x2 < maxX &&
y1 > minY &&
y1 < maxY &&
y2 > minY &&
y2 < maxY
) {
points = [
[x1, y1],
[x2, y1],
[x2, y2],
[x1, y2],
[x1, y1]
]
}
// 上超出,不绘制“上边”
if (
x1 > minX &&
x1 < maxX &&
x2 > minX &&
x2 < maxX &&
y1 === minY &&
y1 < maxY &&
y2 > minY &&
y2 < maxY
) {
points = [
[x2, y1],
[x2, y2],
[x1, y2],
[x1, y1]
]
}
// 下超出,不绘制“下边”
if (
x1 > minX &&
x1 < maxX &&
x2 > minX &&
x2 < maxX &&
y1 > minY &&
y1 < maxY &&
y2 > minY &&
y2 === maxY
) {
points = [
[x1, y2],
[x1, y1],
[x2, y1],
[x2, y2]
]
}
// 左超出,不绘制“左边”
if (
x1 === minX &&
x1 < maxX &&
x2 > minX &&
x2 < maxX &&
y1 > minY &&
y1 < maxY &&
y2 > minY &&
y2 < maxY
) {
points = [
[x1, y1],
[x2, y1],
[x2, y2],
[x1, y2]
]
}
// 右超出,不绘制“右边”
if (
x1 > minX &&
x1 < maxX &&
x2 > minX &&
x2 === maxX &&
y1 > minY &&
y1 < maxY &&
y2 > minY &&
y2 < maxY
) {
points = [
[x2, y1],
[x1, y1],
[x1, y2],
[x2, y2]
]
}
// 左上超出,不绘制“上边”、“左边”
if (
x1 === minX &&
x1 < maxX &&
x2 > minX &&
x2 < maxX &&
y1 === minY &&
y1 < maxY &&
y2 > minY &&
y2 < maxY
) {
points = [
[x2, y1],
[x2, y2],
[x1, y2]
]
}
// 右上超出,不绘制“上边”、“右边”
if (
x1 > minX &&
x1 < maxX &&
x2 > minX &&
x2 === maxX &&
y1 === minY &&
y1 < maxY &&
y2 > minY &&
y2 < maxY
) {
points = [
[x2, y2],
[x1, y2],
[x1, y1]
]
}
// 左下超出,不绘制“下边”、“左边”
if (
x1 === minX &&
x1 < maxX &&
x2 > minX &&
x2 < maxX &&
y1 > minY &&
y1 < maxY &&
y2 > minY &&
y2 === maxY
) {
points = [
[x1, y1],
[x2, y1],
[x2, y2]
]
}
// 右下超出,不绘制“下边”、“右边”
if (
x1 > minX &&
x1 < maxX &&
x2 > minX &&
x2 === maxX &&
y1 > minY &&
y1 < maxY &&
y2 > minY &&
y2 === maxY
) {
points = [
[x2, y1],
[x1, y1],
[x1, y2]
]
}
// 可视区域提示框
group.add(
new Konva.Line({
name: this.constructor.name,
points: _.flatten(points),
stroke: 'blue',
strokeWidth: 1 / this.option.size,
listening: false
})
)
}
// 复制提取的节点,用作预览
for (const node of nodes) {
const copy = node.clone()
// 不可交互
copy.listening(false)
// 设置名称用于 ignore
copy.name(this.constructor.name)
group.add(copy)
}
this.group.add(group)
}
}
除了上面必要的注释,还是画一张图表示这 9 种情况:
实际上,不希望“提示框”超出“预览框”,于是才有上面“穷举”的处理逻辑。
接下来,计划实现下面这些功能:
- 对齐效果
- 连接线
- 等等。。。
是不是值得更多的 Star 呢?勾勾手指~
源码
gitee源码
示例地址
推荐阅读
-
使用 Konva 的前端可视化设计器 (8) - 预览框
-
前端使用 Konva 实现可视化设计器 (4)
-
Grid++Report 锐浪报表开发常见问题解答集锦-报表设计 问:怎样在设计时打印预览报表? 答:为了及时查看报表的设计效果,Grid++Report 报表设计应用程序提供了四种查看视图:普通视图、页面视图、预览视图与查询视图。通过窗口下边的 Tab 按钮可以在四种视图中任意切换。在预览视图中查看报表的打印预览效果,在查询视图中查看报表的查询显示效果。如果在报表的记录集提供了数据源连接串与查询 SQL,在进入预览视图与查询视图时会利用数据源连接串与查询 SQL 从数据源中自动取数,否则 Grid++Report 将自动生成模拟数据进行模拟打印预览与查询显示。注意:在预览视图与查询视图中看到的报表运行结果有可能与在你程序中的最终运行结果有差异,因为在报表的生成过程中我们可以在程序中对报表的生成行为进行一定的控制。 问:怎样用 Grid++Report 设计交叉表? 答:Grid++Report 没有提供专门实现交叉表的功能,其它的报表构件提供的交叉表功能一般也比较死板和功能有限。利用 Grid++Report 的编程接口可以做出灵活多变,功能丰富的交叉表。示例程序 CrossTab 就是一个实现交叉表的例子程序,认真领会此例子程序,你就可以做出自己想要各种交叉表,并能提取一些共用代码,便于重复使用。 问:怎样设置整个报表的缺省字体? 答:设置报表主对象的字体属性,也就是设置了整个报表的缺省字体。如果改变报表主对象的字体属性,则没有专门的设置字体属性的子对象的字体属性也跟随改变。同样每个报表节与明细网格也有字体属性,他们的字体属性也就是其拥有的子对象的缺省字体。 问:怎样在打印时限制一页的输出行数? 答:设定明细网格的内容行的‘每页行数(RowsPerPage)’属性即可。另外要注意‘调节行高(AdjustRowHeight)’属性值:为真时根据页面的输出高度自动调整行的高度,使整个页面的输出区域充满。为假时按设计时的高度输出行。 问:怎样显示中文大写金额? 答:将对象的“格式(Format)”属性设为 “$$” 及可,可以设置格式的对象有:字段(IGRField)、参数(IGRParameter)、系统变量(IGRSystemVarBox)与综合文字框(IGRMemoBox),其中综合文字框是在报表式上设格式。 问:能否实现自定义纸张与票据打印? 答:Grid++Report 完全支持自定义纸张的打印,只要在报表设定时在页面设置中选定自定义纸张,并指定准确的纸张尺寸。当然要在最终输出时得道合适的打印结果,输出打印机必须支持自定义纸张打印。Windows2000/XP/2003 操作系统上可以在打印机上定义自定义纸张,也可以采用这种方式实现自定义纸张打印。 问:怎样实现 0 值不打印? 答:直接设置格式串就可以,在“数字格式”设置对话框中选定“0 不显示”,就会得到合适的格式串。也可以通过直接录入格式串来指定 0 不显示,但格式串必须符合 Grid++Report 的规定格式。另一种实现办法是在报表获取明细记录数据时,在 BeforePostRecord 事件中将值为零的字段设为空,调用字段的 Clear 方法将字段置为空。 问:怎样实现多栏报表? 答:在明细网格上设‘页栏数(PageColumnCount)’属性值大于 1 即可。通过 Grid++Report 的“页栏输出顺序”还可以指定多栏报表的输出顺序是“先从上到下”还是“先从左到右”。 问:如何实现票据套打? 答:Grid++Report 为实现票据套打做了很多专门的安排:报表设计器提供了页面设计模式,按照设定的纸张尺寸显示设计面板,如果将空白票据的扫描图设为设计背景图,在定位报表内容的输出位置会非常方便。报表部件可以设定打印类别,非套打输出的内容在套打打印模式下就不会输出。 问:Grid++Report 有没有横向分页功能? 答:回答是肯定的,在列的总宽度超过打印页面的输出宽度时,Grid++Report 可以另起新页输出剩余的列,如果左边存在锁定列,锁定列可以在后面的新页中重复输出,这样可以保证关键数据列在每一页都有输出。仔细体会 Grid++Report 提供的多种打印适应策略,选用最合适的方式。Grid++Report 的多种打印适应策略为开发动态报表提供了很好的支持。 问:怎样实现报表本页小计功能? 答:定义一个报表分组,将本分组定义为页分组,在本分组的分组头与分组尾上定义统计。页分组就是在每页产生一个分组项,在每页的上端与下端都会分别显示页分组的分组头与分组尾,页分组不用定义分组依据字段。 报表运行 问:怎样与数据库建立连接? 答:如果在设计报表时指定了数据集的数据源连接串与查询 SQL 语句,Grid++Report 采用拉模式直接从数据源取得报表数据,Grid++Report 利用 OLE DB 从数据源取数,OLE DB 提供了广泛的数据源操作能力。如果 Grid++Report 的数据来源采用推模式,即 Grid++Report 不直接与数据库建立连接,各种编程语言/平台都提供了很好的数据库连接方式,并且易于操作,应用程序在报表主对象(IGridppReport)的 FetchRecord 事件中将数据传入,例子程序提供了各种编程语言填入数据的通用方法,对C++Builder 和 Delphi 还进行了专门的包装,直接关联 TDataSet 对象也可以将 TDataSet 对象中的数据传给报表。 问:打印时能否对打印纸张进行自适应?支持表格的折行打印吗? 答:Grid++Report 在打印时采用多种适应策略,通过设置明细网格(IGRDetailGrid)的‘打印策略(PrintAdaptMethod)’属性指定打印策略。(1)丢弃:按设计时列的宽度输出,超出范围的内容不显示。(2)绕行:按设计时列的宽度输出,如果在当前行不能完整输出,则另起新行进行输出。(3)缩放适应:对所有列的输出宽度进行按比例地缩放,使总宽度等于页面的输出宽度。(4)缩小适应:如果列的总宽度小于页面的输出宽度,对所有列的输出宽度进行按比例地缩小,使总宽度等于页面的输出宽度。(5)横向分页:超范围的列在新页中输出。(6)横向分页并重复锁定列。 问:如何改变缺省打印预览窗口的窗口标题? 答:改变报表主对象的‘标题(Title)’属性即可。 问:利用集合对象的编程接口取子对象的接口引用,但不是自己期望的结果。 答:Grid++Report中所有集合对象的下标索引都是从 1 开始,另按对象的名称查找对象的接口引用时,名称字符是不区分大小写的。 问:怎样在运行时控制报表中各个对象的可见性?即怎样在运行时显示或隐藏对象? 答:在报表主对象(GridppReport)的 SectionFormat 事件中设定相应报表子对象的可见(Visible)属性即可。 问:报表主对象重新载入数据,设计器中为什么没有反映新载入的数据? 答:应调用 IGRDesigner 的 Reload 方法。 问:怎样实现不进入打印预览界面,直接将报表打印出来?