Video
Video
[ ZK EE ] [ since 8.5.2 ]
Employment/Purpose
An video component is used to play the video at the browser. Like audio, you could use the src property to specify an URL of an video resource, or the setContent method to specify a dynamically generated video. Developers might be able to control the play of an video by the play, stop and pause methods.
Example
<video src="zk.mp4" controls="true" autoplay="true" loop="true" />
Supports HTML5
The video component support HTML 5, like <video>, it includes the properties like autoplay, controls, loop, muted and preload.
Multiple Sources
Most browsers do not support all the video formats,so we could specify multiple source files in different formats for different browsers. For examples:
<video src="zk.mp4, zk.webm, zk.ogg" />
enableFullScreen
Because security issue, fullScreen API can only be initiated by a user gesture, so the video component only can provide a client-side method enableFullScreen() to use full screen mode.
<video id="player" src="zk.mp4" />
<button xmlns:w="client" w:onClick="zk.$('$player').enableFullScreen()" />
dimBackground
The video component provides theater mode, If dimBackground="true", the whole page will be covered by translucent black except the Video.
When theater mode is enabled, user can click anywhere on the page except the Video to disable theater mode.
<video src="zk.mp4" dimBackground="true" />
currentTime
The video provieds setCurrentTime(double) to decide which part of video to play, the value is seconds.
<video src="zk.mp4" currentTime="60" />
playing
The video provieds setPlaying(boolean) to play or pause the video.
playing="false" is same as invoking play(), playing="true" is same as invoking pause().
<video src="zk.mp4" playing="true" />
volume
The video component provides setVolume(double) to change the volume, the valid value is between 0.0 to 1.0.
<video src="zk.mp4" volume="0.5" />
muted
The video component provides setMuted(boolean) to mute the video.
<video src="zk.mp4" muted="true" />
= StateChangeEvent
Supported Events
| None | None |
- Inherited Supported Events: XulElement
Supported Children
*NONE
Use Cases
| Version | Description | Example Location |
|---|---|---|