---
name: "Animation.rotate3d"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "Animation.rotate3d - 从固定轴顺时针旋转一个角度"
---

## Animation.rotate3d

> [VERSION] 基础库 >= 2.21.8

### 描述

从固定轴顺时针旋转一个角度

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `x` | `number` | 否 | 旋转轴的 x 坐标 |
| `y` | `number` | 否 | 旋转轴的 y 坐标 |
| `z` | `number` | 否 | 旋转轴的 z 坐标 |
| `angle` | `number` | 否 | 旋转角度，取值范围 -180~180 |

### 返回值

类型: `Animation`

Animation 实例

### 示例代码

#### 绕 Z 轴旋转 90 度

```ts
Page({
  data: {
    animationData: {},
  },
  onReady() {
    const animation = ty.createAnimation({ duration: 500 });
    animation.rotate3d(0, 0, 1, 90).step();
    this.setData({ animationData: animation.export() });
  },
});
```