View source for Web Animations/Requirements/Repetition

<span style="color:red">'''JUST AN EXAMPLE.'''</span> This is one way we might start to sketch out the specifics of the requirements.

== API ==

 <nowiki>
interface Animation {
  attribute float iterationCount;
};</nowiki>

* Blurb goes here about how iterationCount functions (basically pull in and edit relevant bits from CSS Animations and SMIL)
* Talk about range of values, i.e. iterationCount >= 0.0 or "infinite"
** Not sure how to represent that best in WebIDL yet. Can we use define a sentinel value that equals -1.0
* Talk about initial value, i.e. 1.0
* What happens if we set it in correctly? Throw an exception? Stay at previous value? Go to initial value?
* What happens when it is changed? Is it readonly? e.g.
** If it is set to such a value that the interval should have ended what happens, what events get dispatched, and what timestamp gets associated with those events
** If it is set to an invalid value while the animation is in play do we still send events and if so, what timestamp gets set in such a case

== SVG ==

=== iteration-count ===

 iteration-count = float | "infinite"

Set by the <code>iteration-count</code> attribute on animation elements. The attribute sets the <code>iterationCount</code> for new Animation objects generated by this element. Existing Animation objects are not modified.

Also set by <code>repeatCount</code> attribute which is now deprecated. If both are set the <code>iteration-count</code> attribute is used and the <code>repeatCount</code> attribute is ignored.

The value "indefinite" is handled as with "infinite" but is now deprecated.

=== iteration-duration ===

SVG also provides the <code>iteration-duration</code> attribute.

 iteration-duration = clock-value | "infinite"

This sets the <code>iterationCount</code> as follows:

 iterationCount = iteration-duration / dur

The <code>repeatDur</code> is identical but is now deprecated. If both are set the <code>iteration-duration</code> attribute is used and the <code>repeatDur</code> attribute is ignored.

The value "indefinite" is handled as with "infinite" but is now deprecated.

If both <code>iteration-count</code> and <code>iteration-duration</code> are specified, the active duration is defined as the minimum of the specified <code>iteration-duration</code> and the simple duration multiplied by <code>iteration-count</code>. (Just reference SMIL here?)

'''ISSUE:''' If we introduce <code>dur="auto"</code> or something of that sort, then converting <code>iteration-duration</code> into an <code>iterationCount</code>  might become more difficult and it might make more sense to make this part of the API.

== CSS ==

The <code>animation-iteration-count</code> property sets the <code>iterationCount</code> attribute.