wip

Author: tabatkins

css-animations-2/Overview.bs

@@ -717,13 +717,15 @@ While CSS animations are, by default,
 automatically run as soon as the appropriate 'animation' values have been set on an element,
 the 'animation-trigger' property allows the animation's start to be delayed
 until an appropriate trigger occurs,
-and even paused, restarted, or reset by triggers.
+and even paused, restarted, or reset by triggers
+(making it a <dfn export>triggered animation</dfn>).
+
 This is a simplified and streamlined version
 of what can be achieved with the Web Animations API in Javascript,
 allowing simple, common interaction patterns
 to be created and managed purely in CSS.
 
-Currently, two types of triggers are defined:
+Currently, two types of <dfn>triggers</dfn> are defined:
 
 * [=timeline triggers=], managed by the 'timeline-trigger' properties,
     which allow animations to be triggered by entering or leaving certain timeline ranges.
@@ -735,21 +737,71 @@ Currently, two types of triggers are defined:
     which allow animations to be triggered by certain user-interaction events,
     such as clicking an element or pressing certain keys.
 
-<h3 id="">
+<h3 id="animation-trigger-prop">
 Attaching A Trigger: the 'animation-trigger' property</h3>
 
 <pre class=propdef>
 Name: animation-trigger
-Value: none | ...
+Value: [ none | [ <<dashed-ident>> <<animation-action>>+ ]+ ]#
 Initial: none
 Applies to: all elements
 Inherited: no
 Percentages: N/A
-Computed value: ...
+Computed value: as specified
 Animation type: not animatable
 Canonical order: per grammar
 </pre>
 
+The 'animation-trigger' property is another member
+of the 'animation-name' [=coordinating list property group=]:
+each comma-separated item specifies
+whether the matching animation on the element
+is triggered or not,
+and if it is,
+what trigger it responds to
+and what actions it takes in response.
+
+'animation-trigger' is a [=reset-only subproperty=] of the 'animation' shorthand.
+Its values are:
+
+<dl dfn-type=value dfn-for=animation-trigger>
+    : <dfn>none</dfn>
+    ::
+        The corresponding animation is not triggered.
+
+    : <dfn>[ <<dashed-ident>> <<animation-action>>+ ]+</dfn>
+    ::
+        The corresponding animation is a [=triggered animation=],
+        responding to the triggers named by each <<dashed-ident>>,
+        and responding by taking the action named by the corresponding <<animation-action>>.
+        (See [[#trigger-scope]] for how <<dashed-ident>>s are resolved to [=triggers=].)
+
+        How many <<animation-action>>s a trigger accepts,
+        and what exactly activates them,
+        is determined by the type of the trigger.
+        <span class=note>([=Event triggers=] only take a single <<animation-trigger>>,
+        while [=timeline triggers=] can take one or two.)</span>
+        Specifying the wrong number of actions
+        (too many or too few)
+        is valid syntactically,
+        but causes the trigger to have no effect.
+
+        If multiple triggers occur simultaneously,
+        they take effect in the order specified.
+
+        If the same <<dashed-ident>> is specified multiple times,
+        all but the last have no effect.
+</dl>
+
+The possible <dfn><<animation-action>></dfn> values are:
+
+<table dfn-type=value dfn-for="<animation-action>">
+</table>
+
+
+
+
+
 
     Animation Triggers are defined using the 'animation-trigger-*' properties.
     These list-valued properties,