@helga-agency/media

Audio

Audio component that consists of diffferent loosely coupled components that can (but must not) be used together.

Important

Load <audio-component> before all others, as the others will need a valid audio-component to set their models.

Example

All components are independent from one another. It, however, makes sense, to use at least <audio-component> and <media-play-pause-component> to get a working component.

    <audio-component data-source="file_example_MP3_700KB.mp3">
        <media-play-pause-component>
            ⏯
        </media-play-pause-component>
        <media-time-component>0:00</media-time-component>
        <media-timeline-component>
            <!-- Timeline component must include an input[type="range"] -->
            <input type="range" value="0">
        </media-timeline-component>
        <media-time-component data-type="total"> -:-- </media-time-component>
        🔉<media-volume-component>
            <!-- Volume component must include an input[type="range"] -->
            <input type="range" value="100">
        </media-volume-component>
    </audio-component>

<!-- Import all components you use -->
    <script type="module" src="@joinbox/media/AudioComponentElement.js"></script>
    <script type="module" src="@joinbox/media/MediaPlayPauseComponentElement.js"></script>
    <script type="module" src="@joinbox/media/MediaTimeComponentElement.js"></script>
    <script type="module" src="@joinbox/media/MediaTimelineComponentElement.js"></script>
    <script type="module" src="@joinbox/media/MediaVolumeComponentElement.js"></script>

Components

Audio Component

Exposed Element

<audio-component></audio-component>

Attriutes

• data-source: Path to the audio source file. It is only loaded when the user starts to play. Attribute must be set when the element is created as it is consumed by the element's constructor.

Properties

• audio instance of HTMLAudioElement that is used to play the audio.

Styling

• The audio-component element has an attribute data-state that is automatically updated when the state changes. The following values are used to reflect the component's current state:
  • initialized
  • loading
  • playing
  • paused

Media Play Pause Component

Exposed Element

<media-play-pause-component></media-play-pause-component>

Methods

• toggle() toggles between play and pause.

Media Time Component

Exposed Element

<media-time-component></media-time-component>

Attriutes

• data-type: either current to display the current playback time or total to display the audio's total duration. Defaults to current.

Media Volume Component

Exposed Element

<media-volume-component><input type="range"></media-volume-component>

input of type range is needed and the actual UI element.

Media Timeline Component

Exposed Element

<media-timeline-component><input type="range"></media-timeline-component>

input of type range is needed and the actual UI element.