Audio"
Line 28: | Line 28: | ||
<source lang="xml" > | <source lang="xml" > | ||
<audio src="music.wav, music.mp3, music.ogg" controls="true"></audio> | <audio src="music.wav, music.mp3, music.ogg" controls="true"></audio> | ||
+ | </source> | ||
+ | |||
+ | = StateChangeEvent = | ||
+ | {{versionSince| 9.6.0}} | ||
+ | |||
+ | When you call <tt>play(), stop(), pause()</tt> or the audio is played to the end StateChangeEvent will be triggered. You can check the current state by calling event.getState(). Video has 4 states, and you can access them by using <tt>Audio.PLAY, Audio.STOP, Audio.PAUSE and Audio.END</tt>. | ||
+ | |||
+ | For example: | ||
+ | |||
+ | If you want to do something after the audio starts to play, you can write codes as shown below (MVVM style). | ||
+ | |||
+ | <source language="xml"> | ||
+ | <audio onStateChange="@command('stateChange', event=event)" /> | ||
+ | </source> | ||
+ | <source language="java"> | ||
+ | @Command | ||
+ | public void stateChange(@BindingParam("event") StateChangeEvent event) { | ||
+ | if (event.getState() == Audio.PLAY) { | ||
+ | // do something... | ||
+ | } | ||
+ | } | ||
</source> | </source> | ||
Line 36: | Line 57: | ||
! <center>Event Type</center> | ! <center>Event Type</center> | ||
|- | |- | ||
− | | | + | | <center><tt>onStateChange</tt></center> |
− | | | + | | '''Event:''' <javadoc>org.zkoss.zk.ui.event.StateChangeEvent</javadoc> |
+ | Notifies when invoking play(), stop(), pause() or the audio is played to the end. | ||
|} | |} | ||
*Inherited Supported Events: [[ZK_Component_Reference/Base_Components/XulElement#Supported_Events | XulElement]] | *Inherited Supported Events: [[ZK_Component_Reference/Base_Components/XulElement#Supported_Events | XulElement]] | ||
Line 68: | Line 90: | ||
| September 2020 | | September 2020 | ||
| [https://tracker.zkoss.org/browse/ZK-4648 ZK-4648]: Audio supports to add tracks | | [https://tracker.zkoss.org/browse/ZK-4648 ZK-4648]: Audio supports to add tracks | ||
+ | |- | ||
+ | | 9.6.0 | ||
+ | | May 2021 | ||
+ | | [https://tracker.zkoss.org/browse/ZK-4779 ZK-4779]: audio supports to fire an event upon its playing state | ||
|} | |} | ||
{{ZKComponentReferencePageFooter}} | {{ZKComponentReferencePageFooter}} |
Revision as of 07:19, 27 May 2021
Audio
Employment/Purpose
An audio component is used to play the audio at the browser. Like image, you could use the src property to specify an URL of an audio resource, or the setContent method to specify a dynamically generated audio. Developers might be able to control the play of an audio by the play, stop and pause methods.
Example
<audio src="music.wav" controls="true"></audio>
The audio supports controls property since 7.0.0
Supports HTML5
Since 7.0.0
The audio component has now been enhanced to support HTML 5, it includes the properties like autoplay, controls, loop, muted and preload.
Multiple Sources
Since 7.0.0 Most browsers do not support all the audio formats,so we could specify multiple source files in different formats for different browsers. For examples:
<audio src="music.wav, music.mp3, music.ogg" controls="true"></audio>
StateChangeEvent
Since 9.6.0
When you call play(), stop(), pause() or the audio is played to the end StateChangeEvent will be triggered. You can check the current state by calling event.getState(). Video has 4 states, and you can access them by using Audio.PLAY, Audio.STOP, Audio.PAUSE and Audio.END.
For example:
If you want to do something after the audio starts to play, you can write codes as shown below (MVVM style).
<audio onStateChange="@command('stateChange', event=event)" />
@Command
public void stateChange(@BindingParam("event") StateChangeEvent event) {
if (event.getState() == Audio.PLAY) {
// do something...
}
}
Supported Events
Event: StateChangeEvent
Notifies when invoking play(), stop(), pause() or the audio is played to the end. |
- Inherited Supported Events: XulElement
Supported Children
* Track
Use Cases
Version | Description | Example Location |
---|---|---|
Version History
Version | Date | Content |
---|---|---|
7.0.0 | August, 2013 | Audio now supports HTML 5 |
9.5.0 | September 2020 | ZK-4648: Audio supports to add tracks |
9.6.0 | May 2021 | ZK-4779: audio supports to fire an event upon its playing state |