---
name: "Canvas.requestAnimationFrame"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "Canvas.requestAnimationFrame - 请求动画帧"
---

## Canvas.requestAnimationFrame

> [VERSION] 基础库 >= 2.21.8

### 描述

创建一个请求动画帧回调，在下次重绘之前调用指定的回调函数

### 参数

`(callback: Function)`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `callback` | `(time: number) => void` | 是 | 下次重绘之前执行的回调函数 |

### 返回值

无


### 示例代码

#### 使用 requestAnimationFrame 绘制动画

```ts
const canvas = res.node;
const ctx = canvas.getContext('2d');
let x = 0;
function render() {
  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.fillRect(x++, 0, 50, 50);
  canvas.requestAnimationFrame(render);
}
canvas.requestAnimationFrame(render);
```