canvas.md 1.5 KB
Newer Older
D
DCloud_LXH 已提交
1 2 3 4
## canvas

<!-- UTSCOMJSON.canvas.description -->

D
DCloud_LXH 已提交
5 6
<!-- UTSCOMJSON.canvas.compatibility -->

7
<!-- UTSCOMJSON.canvas.attribute -->
D
DCloud_LXH 已提交
8 9 10

<!-- UTSCOMJSON.canvas.event -->

11 12
<!-- UTSCOMJSON.canvas.component_type-->

D
DCloud_LXH 已提交
13 14
<!-- UTSCOMJSON.canvas.children -->

15 16
<!-- UTSCOMJSON.canvas.example -->

D
DCloud_LXH 已提交
17
<!-- UTSCOMJSON.canvas.reference -->
18 19 20 21 22

## API

和 W3C 规范保持一致 [https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/canvas](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/canvas)

H
hdx 已提交
23
## 注意事项@tips
24

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
25
老版 uni-app 的 canvas 使用了微信小程序的的旧版规范,和 W3C 规范有差异。微信小程序新版的 canvas 规范已经与 W3C 规范拉齐。
H
hdx 已提交
26

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
27
uni-app x 中废弃了老版方案,使用了 W3C 规范和微信小程序的新版规范。
H
hdx 已提交
28

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
29 30 31
注意:在uni-app x 4.21版以前,开发者写的老版canvas是可以运行的。但从 4.21+ 支持新版规范起,不再支持老版规范。开发者需调整代码。

注意:新版规范需要开发者根据自己的场景手动处理高清屏问题。
32 33

```html
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
34 35
<template>
  <canvas id="canvas"></canvas>
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50
</template>
<script setup>
// 获取 canvas element
const canvas = uni.getElementById("canvas") as UniCanvasElement
const context = canvas.getContext("2d")!;

// 处理高清屏逻辑
const dpr = uni.getSystemInfoSync().pixelRatio;
canvas.width = canvas.offsetWidth * dpr;
canvas.height = canvas.offsetHeight * dpr;
context.scale(dpr, dpr); // 仅需调用一次,当调用 reset 方法后需要再次 scale

// 省略绘制代码,和 w3c 规范保持一致
</script>
```