-
Notifications
You must be signed in to change notification settings - Fork 22.4k
/
index.md
101 lines (86 loc) · 2.12 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
---
title: restart
slug: Web/SVG/Attribute/restart
page-type: svg-attribute
spec-urls: https://svgwg.org/specs/animations/#RestartAttribute
---
{{SVGRef}}
The **`restart`** attribute specifies whether or not an animation can restart.
You can use this attribute with the following SVG elements:
- {{SVGElement("animate")}}
- {{SVGElement("animateMotion")}}
- {{SVGElement("animateTransform")}}
- {{SVGElement("set")}}
## Example
```css hidden
html,
body,
svg {
height: 100%;
}
a {
fill: blue;
text-decoration: underline;
cursor: pointer;
}
```
```html
<svg viewBox="0 0 220 200" xmlns="http://www.w3.org/2000/svg">
<rect y="30" width="100" height="100">
<animate
attributeType="XML"
attributeName="y"
from="30"
to="100"
dur="5s"
repeatCount="1"
restart="always" />
</rect>
<rect x="120" y="30" width="100" height="100">
<animate
attributeType="XML"
attributeName="y"
from="30"
to="100"
dur="5s"
repeatCount="1"
restart="whenNotActive" />
</rect>
<a id="restart"><text y="20">Restart animation</text></a>
</svg>
```
```js
document.getElementById("restart").addEventListener("click", (evt) => {
document.querySelectorAll("animate").forEach((element) => {
element.beginElement();
});
});
```
{{EmbedLiveSample("Example", "220", "150")}}
## Usage notes
<table class="properties">
<tbody>
<tr>
<th scope="row">Value</th>
<td>
<code>always</code> | <code>whenNotActive</code> | <code>never</code>
</td>
</tr>
<tr>
<th scope="row">Default value</th>
<td><code>always</code></td>
</tr>
<tr>
<th scope="row">Animatable</th>
<td>No</td>
</tr>
</tbody>
</table>
- `always`
- : This value indicates that the animation can be restarted at any time.
- `whenNotActive`
- : This value indicates that the animation can only be restarted when it is not active (i.e. after the active end). Attempts to restart the animation during its active duration are ignored.
- `never`
- : This value indicates that the animation cannot be restarted.
## Specifications
{{Specifications}}