You need to enable JavaScript to run this app. Blazor集成JavaScript实现HTML5 Canvas鼠标绘画的可运行方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

Blazor集成JavaScript实现HTML5 Canvas鼠标绘画的可运行方案咨询

Blazor 集成原生Canvas绘图功能的稳定实现方案

核心适配逻辑(解决原有运行异常问题)

原代码运行失败的核心原因是两个关键适配偏差:

  • 调用JS初始化的时机不对:OnInitializedAsync执行时组件DOM尚未渲染完成,JS无法获取到canvas节点完成事件绑定
  • 脚本逻辑没有适配Blazor的组件生命周期:缺少组件卸载时的事件清理逻辑,容易出现事件残留、内存泄漏、重复绑定问题

分步可运行实现

1. 编写wwwroot下的library.js脚本

将所有绘图逻辑封装为全局可调用的模块,不使用硬编码DOM选择器,接收组件传递的元素引用完成绑定:

window.canvasDrawer = {
  drawing: false,
  ctx: null,
  canvasEl: null,
  eraserCheckbox: null,
  colorPicker: null,
  previewImg: null,

  // 初始化绑定
  init(canvasRef, eraserRef, colorRef, previewRef) {
    this.canvasEl = canvasRef;
    this.ctx = canvasRef.getContext('2d');
    this.eraserCheckbox = eraserRef;
    this.colorPicker = colorRef;
    this.previewImg = previewRef;

    // 绑定鼠标事件
    canvasRef.addEventListener('mousedown', (e) => this.startDraw(e));
    canvasRef.addEventListener('mousemove', (e) => this.draw(e));
    canvasRef.addEventListener('mouseup', () => this.stopDraw());
    canvasRef.addEventListener('mouseout', () => this.stopDraw());

    // 初始化画布底色为白色
    this.ctx.fillStyle = '#ffffff';
    this.ctx.fillRect(0, 0, canvasRef.width, canvasRef.height);
  },

  startDraw(e) {
    this.drawing = true;
    const rect = this.canvasEl.getBoundingClientRect();
    this.ctx.beginPath();
    this.ctx.moveTo(e.clientX - rect.left, e.clientY - rect.top);
  },

  draw(e) {
    if (!this.drawing) return;
    const rect = this.canvasEl.getBoundingClientRect();
    // 橡皮擦逻辑
    this.ctx.lineWidth = this.eraserCheckbox.checked ? 20 : 2;
    this.ctx.lineCap = 'round';
    this.ctx.strokeStyle = this.eraserCheckbox.checked ? '#ffffff' : this.colorPicker.value;
    this.ctx.lineTo(e.clientX - rect.left, e.clientY - rect.top);
    this.ctx.stroke();
  },

  stopDraw() {
    this.drawing = false;
  },

  // 清除画布
  clearCanvas() {
    this.ctx.fillStyle = '#ffffff';
    this.ctx.fillRect(0, 0, this.canvasEl.width, this.canvasEl.height);
  },

  // 保存并生成预览
  saveCanvas() {
    const dataUrl = this.canvasEl.toDataURL('image/png');
    this.previewImg.src = dataUrl;
  },

  // 组件卸载时清理事件
  dispose() {
    this.canvasEl.replaceWith(this.canvasEl.cloneNode(true));
    this.canvasEl = null;
    this.ctx = null;
  }
}

2. 配置_Host.cshtml脚本引入

将脚本引用放在Blazor框架脚本的后方,保证加载顺序正确:

<!-- 原有Blazor框架脚本 -->
<script src="_framework/blazor.web.js"></script>
<!-- 自定义脚本 -->
<script src="~/library.js"></script>

3. 编写Canvas.razor组件

严格遵循Blazor生命周期规则,用元素引用绑定DOM,避免硬编码ID的冲突问题:

@inject IJSRuntime JS
@implements IAsyncDisposable

<canvas @ref="canvasRef" width="800" height="500" style="border:1px solid #ccc;cursor:crosshair"></canvas>
<div class="mt-3">
  <label>画笔颜色:</label>
  <input type="color" @ref="colorRef" value="#000000" />
  <label class="ms-3">
    <input type="checkbox" @ref="eraserRef" /> 橡皮擦模式
  </label>
  <button class="btn btn-secondary ms-3" @onclick="ClearCanvas">清除画布</button>
  <button class="btn btn-primary ms-2" @onclick="SaveCanvas">保存并预览</button>
</div>
<div class="mt-3">
  <h5>预览效果:</h5>
  <img @ref="previewRef" style="max-width:400px;border:1px solid #eee" />
</div>

@code {
  private ElementReference canvasRef;
  private ElementReference eraserRef;
  private ElementReference colorRef;
  private ElementReference previewRef;

  // 仅在首次渲染完成后初始化JS绑定,此时DOM已完全生成
  protected override async Task OnAfterRenderAsync(bool firstRender)
  {
    if (firstRender)
    {
      await JS.InvokeVoidAsync("canvasDrawer.init", canvasRef, eraserRef, colorRef, previewRef);
    }
  }

  private async Task ClearCanvas()
  {
    await JS.InvokeVoidAsync("canvasDrawer.clearCanvas");
  }

  private async Task SaveCanvas()
  {
    await JS.InvokeVoidAsync("canvasDrawer.saveCanvas");
  }

  // 组件卸载时调用JS清理逻辑,避免内存泄漏
  public async ValueTask DisposeAsync()
  {
    await JS.InvokeVoidAsync("canvasDrawer.dispose");
  }
}

落地稳定性校验细节

  • 禁止将JS初始化逻辑放在OnInitializedAsync这类DOM未生成的生命周期中调用
  • 禁止使用全局DOMContentLoaded事件绑定初始化逻辑,SPA路由切换时该事件不会重新触发,会导致二次进入组件时初始化失效
  • 禁止使用硬编码的DOM ID选择器绑定元素,Blazor组件的实例复用机制可能导致ID冲突
  • 脚本引用必须放在Blazor框架脚本之后,否则会出现JS互操作对象未定义的错误

按上述逻辑实现的代码,可在Blazor Server/WebAssembly项目中无异常运行,覆盖鼠标绘制、颜色选择、橡皮擦、画布清除、保存预览的全部需求。


内容的提问来源于stack exchange,提问作者Gabriel

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 13:57:01