前端使用 Konva 实现可视化设计器（23）- 绘制曲线、属性面板

来源：网络更新时间：2024-09-27 09:33:23

本章分享一下如何使用 Konva 绘制基础图形：曲线，以及属性面板的基本实现思路，希望大家继续关注和支持哈（多求 5 个 Stars 谢谢）！

请大家动动小手，给我一个免费的 Star 吧~

大家如果发现了 Bug，欢迎来提 Issue 哟~

github源码

gitee源码

示例地址

绘制曲线

先上效果！

这里其实取巧了哈，基本就是在绘制折线的基础上，给 Konva.Line 添加一个关键的属性 tension 即可，参照官方示例：

未来，在属性面板中，可以调节 tension 的值，基本可以实现绘制一些简单的曲线。

属性面板

早些时候，已经有小伙伴问，外部如何动态调整 Konva 内部各对象的一些特性，这里以页面的背景色、全局线条和填充颜色，及其素材各自的线条和填充颜色为例，分享一个基本可行实现思路是如何的。

这里以 svg 素材为例，可以调整 svg 素材的线条、填充颜色。

基本交互

UI

这里简单粗暴一些，使用 naive-ui 的组件组装一下就可以了：

魔改一下组件样式：

/* src/App.vue */

      :deep(.n-tabs-nav-scroll-content) {
        box-shadow: 0 -1px 0 0 rgb(230, 230, 230) inset;
        border-bottom-color: rgb(230, 230, 230) !important;
      }

      :deep(.n-tabs-tab-pad) {
        width: 16px;
      }

组件和表单的控制：

// src/App.vue

// 略

function init() {
  if (boardElement.value && stageElement.value) {
    resizer.init(boardElement.value, {
      resize: async (x, y, width, height) => {
        if (render === null) {
          // 初始化渲染
          render = new Render(stageElement.value!, {
            width,
            height,
            //
            showBg: true,
            showRuler: true,
            showRefLine: true,
            attractResize: true,
            attractBg: true,
            showPreview: true,
            attractNode: true,
          })

          // 同步页面设置
          pageSettingsModel.value = render.getPageSettings()

          await nextTick()

          ready.value = true
        }
        render.resize(width, height)

        // 同步页面设置
        render.on('page-settings-change', (settings: Types.PageSettings) => {
          pageSettingsModelInnerChange.value = true
          pageSettingsModel.value = settings
        })

        render.on('selection-change', (nodes: Konva.Node[]) => {
          if (nodes.length === 0) {
            // 清空选择
            assetCurrent.value = undefined
            assetSettingsModel.value = undefined

            tabCurrent.value = 'page'
          } else if (nodes.length === 1) {
            // 单选
            assetCurrent.value = nodes[0]
            assetSettingsModel.value = render!.getAssetSettings(nodes[0])

            tabCurrent.value = 'asset'
          } else {
            // 多选
            assetCurrent.value = undefined
            assetSettingsModel.value = undefined

            tabCurrent.value = 'page'
          }
        })
      }
    })
  }
}

// 略

// 当前 tab
const tabCurrent = ref('page')

// 页面设置
const pageSettingsModel: Ref = ref()
const pageSettingsModelInnerChange = ref(false)

const pageSettingsModelBackground = ref('')
const pageSettingsModelStroke = ref('')
const pageSettingsModelFill = ref('')

// 当前素材
const assetCurrent: Ref = ref()

// 素材设置
const assetSettingsModel: Ref = ref()
const assetSettingsModelInnerChange = ref(false)

const assetSettingsModelStorke = ref('')
const assetSettingsModelFill = ref('')

watch(() => pageSettingsModel.value, () => {
  if (pageSettingsModel.value) {
    pageSettingsModelBackground.value = pageSettingsModel.value.background
    pageSettingsModelStroke.value = pageSettingsModel.value.stroke
    pageSettingsModelFill.value = pageSettingsModel.value.fill

    if (ready.value && !pageSettingsModelInnerChange.value) {
      render?.setPageSettings(pageSettingsModel.value)
    }
  }

  pageSettingsModelInnerChange.value = false
}, {
  deep: true
})

watch(() => assetSettingsModel.value, () => {
  if (assetSettingsModel.value && assetCurrent.value) {
    assetSettingsModelStorke.value = assetSettingsModel.value.stroke
    assetSettingsModelFill.value = assetSettingsModel.value.fill

    if (ready.value && !assetSettingsModelInnerChange.value) {
      render?.setAssetSettings(assetCurrent.value, assetSettingsModel.value)
    }
  }

  assetSettingsModelInnerChange.value = false
}, {
  deep: true
})

这里有几个小细节：

颜色选择器 confirm 确认

没有直接用 v-model 绑定表单的颜色值，而定义了一些类似 xxxSettingsModelYyy 变量，原因是约束修改颜色必须通过 confirm 按钮才能使其颜色生效，需要一些变量作为缓存。

因此也多了一些初始化和同步赋值逻辑，看起来凌乱一些。

Tab自动切换

默认显示页面属性面板，选择单个素材（暂时只实现 svg 素材），切换至素材属性面板，清空选择则回到页面属性面板。

watch 逻辑锁

在监听 pageSettingsModel 的时候，需要判断 pageSettingsModelInnerChange 的状态，解决了因为 Render 的上一步、下一步、导入等操作，触发 page-settings-change 事件（自定义事件，后面细说），会改变 pageSettingsModel 的值，以此防止重复的 setPageSettings（后面细说）逻辑。

类型、事件定义

属性面板与 Render 属性同步，主要靠的是自定义事件，原有的 selection-change 事件，可以解决判断当前应该处理页面属性还是素材属性；需要新增一个 page-settings-change 事件，获知因为 Render 的上一步、下一步、导入等操作，需要更新 pageSettingsModel 到值。

// src/Render/types.ts

// 略

export type RenderEvents = {
  ['history-change']: { records: string[]; index: number }
  ['selection-change']: Konva.Node[]
  ['debug-change']: boolean
  ['link-type-change']: LinkType
  ['scale-change']: number
  ['loading']: boolean
  ['graph-type-change']: GraphType | undefined
  // 新增
  ['page-settings-change']: PageSettings
}

// 略

/**
 * 页面设置
 */
export interface PageSettings {
  background: string
  stroke: string
  fill: string
}

/**
 * 素材设置
 */
export interface AssetSettings {
  stroke: string
  fill: string
}

属性默认值、获取属性值、设置属性值

这里是通过把页面属性、素材属性分别存放在 stage 和素材group 的 attrs 中，pageSettings 和 assetSettings。

// src/Render/index.ts

// 略

// 页面设置 默认值
  static PageSettingsDefault: Types.PageSettings = {
    background: 'transparent',
    stroke: 'rgb(0,0,0)',
    fill: 'rgb(0,0,0)'
  }

  // 获取页面设置
  getPageSettings(): Types.PageSettings {
    return this.stage.attrs.pageSettings ?? { ...Render.PageSettingsDefault }
  }

  // 更新页面设置
  setPageSettings(settings: Types.PageSettings) {
    this.stage.setAttr('pageSettings', settings)

    // 更新背景
    this.updateBackground()

    // 更新历史
    this.updateHistory()

    // console.log(this.stage.attrs)
  }

  // 获取背景
  getBackground() {
    return this.draws[Draws.BgDraw.name].layer.findOne(
      `.${Draws.BgDraw.name}__background`
    ) as Konva.Rect
  }

  // 更新背景
  updateBackground() {
    const background = this.getBackground()

    if (background) {
      background.fill(this.getPageSettings().background ?? 'transparent')
    }

    this.draws[Draws.BgDraw.name].draw()
    this.draws[Draws.PreviewDraw.name].draw()
  }

  // 素材设置 默认值
  static AssetSettingsDefault: Types.AssetSettings = {
    stroke: '',
    fill: ''
  }

  // 获取素材设置
  getAssetSettings(asset?: Konva.Node): Types.AssetSettings {
    const base = asset?.attrs.assetSettings ?? { ...Render.AssetSettingsDefault }
    return {
      // 特定
      ...base,
      // 继承全局
      stroke: base.stroke || this.getPageSettings().stroke,
      fill: base.fill || this.getPageSettings().fill
    }
  }

  // 设置 svgXML 样式（部分）
  setSvgXMLSettings(xml: string, settings: Types.AssetSettings) {
    const reg = /<(circle|ellipse|line|path|polygon|rect|text|textPath|tref|tspan)[^>/]*\/?>/g

    const shapes = xml.match(reg)

    const regStroke = / stroke="([^"]*)"/
    const regFill = / fill="([^"]*)"/

    for (const shape of shapes ?? []) {
      let result = shape

      if (settings.stroke) {
        if (regStroke.test(shape)) {
          result = result.replace(regStroke, ` stroke="${settings.stroke}"`)
        } else {
          result = result.replace(/(<[^>/]*)(\/?>)/, `$1 stroke="${settings.stroke}" $2`)
        }
      }

      if (settings.fill) {
        if (regFill.test(shape)) {
          result = result.replace(regFill, ` fill="${settings.fill}"`)
        } else {
          result = result.replace(/(<[^>/]*)(\/?>)/, `$1 fill="${settings.fill}" $2`)
        }
      }

      xml = xml.replace(shape, result)
    }

    return xml
  }

  // 更新素材设置
  async setAssetSettings(asset: Konva.Node, settings: Types.AssetSettings) {
    asset.setAttr('assetSettings', settings)
    if (asset instanceof Konva.Group) {
      const node = asset.children[0] as Konva.Shape
      if (node instanceof Konva.Image) {
        if (node.attrs.svgXML) {
          const n = await this.assetTool.loadSvgXML(
            this.setSvgXMLSettings(node.attrs.svgXML, settings)
          )
          node.parent?.add(n)
          node.remove()
          node.destroy()
          n.zIndex(0)
        }
      }
    }

    this.draws[Draws.BgDraw.name].draw()
    this.draws[Draws.GraphDraw.name].draw()
    this.draws[Draws.LinkDraw.name].draw()
    this.draws[Draws.PreviewDraw.name].draw()
  }

这里素材的线条、填充默认值，是会继承页面的线条、填充值的，就是说，拖入的素材线条、填充值，会按当前页面的值初始化。

getBackground

这里获取的背景是一个放在网格线同 Layer 的 Rect，用于模拟页面背景的：

// src/Render/draws/BgDraw.ts

// 略

      group.add(
        new Konva.Rect({
          name: `${this.constructor.name}__background`,
          x: this.render.toStageValue(-stageState.x + this.render.rulerSize),
          y: this.render.toStageValue(-stageState.y + this.render.rulerSize),
          width: this.render.toStageValue(stageState.width),
          height: this.render.toStageValue(stageState.height),
          listening: false,
          fill: this.render.getPageSettings().background
        })
      )

// 略

这里说“模拟”的意思是，背景最后是在导入、导出的时候才真正的处理：

// 恢复
  async restore(json: string, silent = false) {
    try {
      // 略

      // 往 main layer 插入新节点
      this.render.layer.add(...nodes)

      // 同步页面设置
      this.render.stage.setAttr('pageSettings', stage.attrs.pageSettings)
      this.render.emit('page-settings-change', this.render.getPageSettings())

      // 更新背景
      this.render.updateBackground()

      // 略
    } catch (e) {
      console.error(e)
    } finally {
      // 略
    }
  }

  // 略

  // 获取元素图片
  getAssetImage(pixelRatio = 1, bgColor?: string) {
    // 略
    
    bg.setAttrs({
      x: -copy.x(),
      y: -copy.y(),
      width: copy.width(),
      height: copy.height(),
      fill: bgColor ?? this.render.getPageSettings().background
    })

    // 略
  }

  // 略

  // 获取Svg
  async getSvg() {
      // 略

      // 获得 svg
      let rawSvg = c2s.getSerializedSvg()
      console.log(rawSvg)

      // 添加背景
      rawSvg = rawSvg.replace(
        /(


 
  分别说说处理的思路：
 
 
  
   导出图片
  
 
 
  
   在 toDataURL 之前在添加背景 Rect。
  
 
 
  
   导出 svg
  
 
 
  
   这里的思路是，通过正则表达式替换 svg xml 内容，修改上面提到的 背景 Rect 对应的 svg xml rect 结构。
  
 
 
  
   导出素材 json
  
 
 
  
   虽然这里也是添加背景 Rect，不同之处是，该层与其他素材同级，像似一个内部素材。
  
 
 
  
   导入 json
  
 
 
  
   通过 stage 的 attrs 中 pageSettings 属性记录，通过事件 page-settings-change 恢复外部表单 model 的值。并同时更新 背景 Rect 的颜色。
  
 
 
  setAssetSettings、setSvgXMLSettings
 
 
  可以看到这里看起来明显有点复杂，由于素材 svg 最终是以 Konva.Image 的方式加载的，所以唯一可以影响显示的线条、填充颜色，只能在加载之前，通过替换 svg xml 实现。
 
 
  替换 svg xml 分4步：
  

  1、通过 attrs 取出 svgXml 的值；
  

  2、通过正则表达式替换/插入线条、填充颜色值；
  

  3、生成新的 Image 替换原来的 Image；
  

  4、恢复新的 Image 的 zIndex（置顶）；
 
 
  
   替换 svg xml 思路比较简单粗暴，就是把可能的节点 circle|ellipse|line|path|polygon|rect|text|textPath|tref|tspan，识别提取出来，进行 stroke、fill 的替换/插入。
  
 
 
  恢复加载 svg 素材的时候，也处理一遍：
 
 // src/Render/tools/AssetTool.ts

// 略

  // 加载 svg
  async loadSvg(src: string) {
    const svgXML = await (await fetch(src)).text()
    return this.loadSvgXML(this.render.setSvgXMLSettings(svgXML, this.render.getAssetSettings()))
  }

// 略

 
  上面说到，拖入的 svg 素材，会基于 页面的线条、填充值，所以拖入的时候也要处理一下：
 
 // src/Render/handlers/DragOutsideHandlers.ts

// 略

drop: (e: GlobalEventHandlersEventMap['drop']) => {
        // 略
              let group = null
              // 默认连接点
              let points: Types.AssetInfoPoint[] = []

              // 图片素材
              if (target instanceof Konva.Image) {
                group = new Konva.Group({
                  id: nanoid(),
                  width: target.width(),
                  height: target.height(),
                  name: 'asset',
                  assetType: Types.AssetType.Image,
                  draggable: true,
                  imageType:
                    type !== 'json'
                      ? type === Types.ImageType.svg
                        ? Types.ImageType.svg
                        : type === Types.ImageType.gif
                          ? Types.ImageType.gif
                          : Types.ImageType.other
                      : undefined
                })

                this.render.setAssetSettings(group, this.render.getAssetSettings())

                // 略
              } else {
                // json 素材
                
                // 略
              }

              // 略
            })
          }
        }
      }

// 略

 
  说到这里，基本实现了页面属性、素材属性及其继承关系的实现（还有很多优化空间）啦！
 
 
  Thanks watching~
 
 
  
   More Stars please！勾勾手指~
  
  
   源码
  
  
   gitee源码
  
  
   示例地址


      
      
      
        
          相关资讯
        
          
            淘宝双12津贴领取教程
            11-13
            
            Spring AI 再更新：如何借助全局参数实现智能数据库操作与个性化待办管理
            11-13
            
            如何在OpenAI Gym中创建自定义环境
            11-12
            
            功能权限和数据权限在系统中的作用
            11-11
            
            在 Github Action 管道内集成 Code Coverage Report
            11-11
            
            Nuxt.js 应用中的 listen 事件钩子详解
            11-10
            
            将Apache Samza作业迁移到Apache Flink作业的方法
            11-10
            
            好未来：多云环境下基于 JuiceFS 建设低运维模型仓库
            11-09
            
            我的博客网站为什么又回归Blazor了
            11-08
            
            dotnet core微服务框架Jimu ~ 会员注册微服务
            11-08


    
      
        
          热门攻略
        
                      
            独奏第1季评论
          
                     
               火之谜评论 03-23 
             
                     
               MLB节目24评论 03-23 
             
                     
               部落3：竞争对手最终审查 03-20 
             
                     
               Palm Royale评论 03-20 
             
                     
               大盗窃小村庄评论 03-20 
             
                  
      
      
        
          热门资讯
        
                 
            
              Spring AI 再更新：如何借助全局参数实现智能数据库操作与个性化待办管理11-13
            
           

                 
            
              功能权限和数据权限在系统中的作用11-11
            
           

                 
            
              在 Github Action 管道内集成 Code Coverage Report11-11
            
           

                 
            
              好未来：多云环境下基于 JuiceFS 建设低运维模型仓库11-09
            
           

                 
            
              如何进行问题复盘11-07
            
           

              
      
        
          热门游戏
        
        
          
                          
                
                  黑神话悟空像素版 第二章
                  角色扮演|32.26MB
                    
                
                
               
                          
                
                  狐姬零 安卓版
                  角色扮演|473.86MB
                    
                
                
               
                          
                
                  猛鬼宿舍 2025最新版
                  冒险解谜|27.78MB
                    
                
                
               
                          
                
                  波比的游戏时间第三章 2025最新版
                  冒险解谜|4.37MB

前端使用 Konva 实现可视化设计器（23）- 绘制曲线、属性面板

绘制曲线

属性面板

基本交互

UI

类型、事件定义

属性默认值、获取属性值、设置属性值

getBackground

setAssetSettings、setSvgXMLSettings

淘宝双12津贴领取教程

Spring AI 再更新：如何借助全局参数实现智能数据库操作与个性化待办管理

如何在OpenAI Gym中创建自定义环境

功能权限和数据权限在系统中的作用

在 Github Action 管道内集成 Code Coverage Report

Nuxt.js 应用中的 listen 事件钩子详解

将Apache Samza作业迁移到Apache Flink作业的方法

好未来：多云环境下基于 JuiceFS 建设低运维模型仓库

我的博客网站为什么又回归Blazor了

dotnet core微服务框架Jimu ~ 会员注册微服务

黑神话悟空像素版第二章

狐姬零安卓版

猛鬼宿舍 2025最新版

波比的游戏时间第三章 2025最新版

前端使用 Konva 实现可视化设计器（23）- 绘制曲线、属性面板

绘制曲线

属性面板

基本交互

UI

类型、事件定义

属性默认值、获取属性值、设置属性值

getBackground

setAssetSettings、setSvgXMLSettings

淘宝双12津贴领取教程

Spring AI 再更新：如何借助全局参数实现智能数据库操作与个性化待办管理

如何在OpenAI Gym中创建自定义环境

功能权限和数据权限在系统中的作用

在 Github Action 管道内集成 Code Coverage Report

Nuxt.js 应用中的 listen 事件钩子详解

将Apache Samza作业迁移到Apache Flink作业的方法

好未来：多云环境下基于 JuiceFS 建设低运维模型仓库

我的博客网站为什么又回归Blazor了

dotnet core微服务框架Jimu ~ 会员注册微服务

黑神话悟空像素版 第二章

狐姬零 安卓版

猛鬼宿舍 2025最新版

波比的游戏时间第三章 2025最新版

黑神话悟空像素版第二章

狐姬零安卓版