KeyframeEffectReadOnly.target

The target property of a KeyframeEffectReadOnly or a KeyframeEffect interface represents the element or pseudo-element being animated. It may be null for animations that do not target a specific element. It performs as both a getter and a setter, except with animations and transitions generated by CSS.

Syntax

var targetElement = document.getElementById("elementToAnimate");

var keyframes = new KeyframeEffect( targetElement, keyframeBlock, timingOptions );

// returns #elementToAnimate
keyframes.target;

// assigns keyframes a new target
keyframes.target = newTargetElement;

Value

An Element or null.

Examples

In the Follow the White Rabbit example, whiteRabbit sets the target element to be animated:

var whiteRabbit = document.getElementById("rabbit");

var rabbitDownKeyframes = new KeyframeEffect(
  whiteRabbit,
  [
    { transform: 'translateY(0%)' }, 
    { transform: 'translateY(100%)' }
  ],
  { duration: 3000, fill: 'forwards' }
);

// returns <div id=​"rabbit">​Click the rabbit's ears!​</div>​
rabbitDownKeyframes.target;

Specifications

Specification	Status	Comment
Web Animations The definition of 'keyframeEffect' in that specification.	Working Draft	Editor's draft.

Browser compatibility

See also

• Web Animations API
• Property of both KeyframeEffectReadOnly and KeyframeEffect objects. Only the latter is mutable.