1# animate
2
3
4>  **说明:**
5> 该组件从API version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
6
7设置svg组件的属性动画。
8
9## 权限列表
10
1112
13
14## 子组件
15
16不支持。
17
18
19## 属性
20
21| 名称 | 类型 | 默认值 | 必填 | 描述 |
22| -------- | -------- | -------- | -------- | -------- |
23| id | string | - | 否 | 组件的唯一标识。 |
24| attributeName | string | - | 否 | 设置需要进行动效的属性名。 |
25| begin | &lt;time&gt; | 0 | 否 | 设置动效的延迟时间。<br/>支持输入ms(毫秒)、s(秒)、m(分),默认为s(秒),其他格式不支持 |
26| dur | &lt;time&gt; | 0 | 否 | 设置动效持续时间,如果dur没设置,按照end-begin的结果作为持续时间,小于等于0时,动效不触发。<br/>支持输入ms(毫秒)、s(秒)、m(分),默认为s(秒),其他格式不支持 |
27| end | &lt;time&gt; | 0 | 否 | 设置动效多久时间后结束。支持输入ms(毫秒)、s(秒)、m(分),默认为s(秒),其他格式不支持 |
28| repeatCount | &lt;number&nbsp;\|&nbsp;indefinite&gt; | 1 | 否 | 设置动画播放的次数,默认无限次播放(indefinite),可通过设置为数值1仅播放一次。 |
29| fill | &lt;freeze&nbsp;\|&nbsp;remove&gt; | remove | 否 | 设置动画结束时的状态。 |
30| calcMode | &lt;discrete&nbsp;\|&nbsp;linear&nbsp;\|&nbsp;paced&nbsp;\|&nbsp;spline&gt; | linear | 否 | 设置动画的插值模式。<br/>discrete:阶跃,from值直接跳转到to的值;<br/>linear:线性;<br/>paced:线性,设置此项后keyTimes和keyPoints值无效<br/>spline:自定义贝塞尔曲线,spline点定义在keyTimes属性中,每个时间间隔控制点由keySplines定义 |
31| keyTimes | string | - | 否 | 设置关键帧动画的开始时间,值为0~1之间的数值用分号隔开,比如0;0.3;0.8;1。keyTimes、keySplines、values组合设置关键帧动画。keyTimes和values的个数保持一致。keySplines个数为keyTimes个数减一 |
32| keySplines | string | - | 否 | 与keyTimes相关联的一组贝塞尔控制点。定义每个关键帧的贝塞尔曲线,曲线之间用分号隔开。曲线内的两个控制掉格式为x1&nbsp;y1&nbsp;x2&nbsp;y2。比如0.5&nbsp;0&nbsp;0.5&nbsp;1;&nbsp;0.5&nbsp;0&nbsp;0.5&nbsp;1;0.5&nbsp;0&nbsp;0.5&nbsp;1 |
33| by | number | - | 否 | 在动画中对某一指定属性,添加相对偏移值,from默认为原属性值。 |
34| from | string | - | 否 | 设置需要进行动画的属性的开始值。<br/>如果已经设置了values属性,则from失效。 |
35| to | string | - | 否 | 设置需要进行动画的属性的结束值。<br/>如果已经设置了values属性,则to都失效。 |
36| values | string | - | 否 | 设置一组动画的变化值。格式为value1;value2;value3。 |
37
38
39## 示例
40
41```html
42<!-- xxx.hml -->
43<div class="container">
44  <svg width="400" height="400">
45    <rect x="20" y="20" width="100" height="100" fill="red" rx="0" ry="20">
46      <animate attributeName="rx" values="0;10;30;0" keyTimes="0;0.25;0.75;1" keySplines="0.5 0 0.5 1; 0.5 0 0.5 1; 0.5 0 0.5 1" dur="1000" repeatCount="indefinite">
47      </animate>
48    </rect>
49  </svg>
50</div>
51```
52
53
54![zh-cn_image_0000001173324703](figures/zh-cn_image_0000001173324703.gif)
55
56
57```html
58<!-- xxx.hml -->
59<div class="container">
60  <svg width="400" height="400">
61    <rect x="20" y="20" width="100" height="100" fill="red" rx="0" ry="20">
62      <animate attributeName="fill" from="red" to="blue" dur="1000" repeatCount="indefinite"></animate>
63      <animate attributeName="height" from="50" to="150" begin="500" end="1000" repeatCount="indefinite">  </animate>
64    </rect>
65  </svg>
66</div>
67```
68
69
70![zh-cn_image_0000001167662852](figures/zh-cn_image_0000001167662852.gif)
71
72
73```html
74<!-- xxx.hml -->
75<div class="container">
76  <svg width="400" height="400">
77    <rect x="20" y="20" width="100" height="100" fill="red" rx="0" ry="20">
78      <animate attributeName="rx" values="0;30" dur="1000" repeatCount="indefinite" fill="freeze" calcMode="linear"></animate>
79    </rect>
80  </svg>
81</div>
82```
83
84
85![zh-cn_image_0000001127284938](figures/zh-cn_image_0000001127284938.gif)
86
87
88```html
89<!-- xxx.hml -->
90<div class="container">
91  <svg fill="white" width="600" height="600">
92    <circle cx="60" cy="70" r="50" stroke-width="4" fill="white" stroke="blue">
93      <animate attributeName="r" from="0" to="50" dur="2000" repeatCount="indefinite"></animate>
94      <animate attributeName="cx" from="60" to="200" dur="2000" repeatCount="indefinite"></animate>
95    </circle>
96    <circle cx="60" cy="200" r="50" stroke-width="4" fill="white" stroke="blue">
97      <animate attributeName="stroke-width" from="4" to="10" calcMode="discrete" dur="2000" repeatCount="indefinite"></animate>
98      <animate attributeName="stroke" values="red;blue" dur="2000" repeatCount="indefinite"></animate>
99    </circle>
100    <circle cx="180" cy="200" r="50" stroke-width="10" stroke="red" stroke-dasharray="60 10" stroke-dashoffset="3">
101      <animate attributeName="stroke-opacity" from="1.0" to="0.5" dur="2000" repeatCount="indefinite"></animate>
102      <animate attributeName="stroke-dashoffset" values="30;0;30" dur="500" repeatCount="indefinite"></animate>
103     <animate attributeName="cx" from="180" to="400" dur="2000" repeatCount="indefinite"></animate>
104    </circle>
105    <circle cx="180" cy="200" r="5" fill="blue">
106      <animate attributeName="cx" from="180" to="400" dur="2000" repeatCount="indefinite"></animate>
107    </circle>
108    <circle cx="60" cy="380" r="50"  fill="blue">
109      <animate attributeName="fill" values="red;blue" dur="2000" repeatCount="indefinite"></animate>
110    </circle>
111    <circle cx="180" cy="380" r="50"  fill="blue">
112      <animate attributeName="fill-opacity" from="1.0" to="0.5" dur="2000" repeatCount="indefinite"></animate>
113    </circle>
114    </svg>
115</div>
116```
117
118
119![zh-cn_image_0000001127125126](figures/zh-cn_image_0000001127125126.gif)
120