W3cubDocs

/Web APIs

VTTCue: positionAlign property

The positionAlign property of the VTTCue interface is used to determine what VTTCue.position is anchored to.

Value

A string containing one of the following values:

"line-left"

Line-left alignment.

"center"

Center alignment.

"line-right"

Line-right alignment.

"auto"

Automatic alignment, which depends on the text alignment of the cue, interpreted as follows:

  • line-left: if the text alignment is left, the cue is using a LTR language and the text alignment is start, or the cue is using a RTL language and the text alignment is end.
  • line-right: if the text alignment is right, the cue is using a RTL language and the text alignment is start, or the cue is using a LTR language and the text-alignment is end.
  • center: if there is no text alignment position set.

Examples

In the following example a new VTTCue is created, then the value of positionAlign is set to "line-right". The value is then printed to the console.

js

let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";

let cue1 = new VTTCue(0, 0.9, "Hildy!");
cue1.positionAlign = "line-right";
console.log(cue1.positionAlign);

track.addCue(cue1);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
positionAlign No No 31 No No 14.1 No No 31 No 14.5 No

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VTTCue/positionAlign