<media-volume-range>
The <media-volume-range>
component is used to indicate the current volume level of the media and provide a control to change the volume level.
The component will be updated automatically based on the volume level and volume availability.
Default usage
Section titled Default usageStyling with attributes
Section titled Styling with attributesThe <media-volume-range>
doesn’t expose any configuration attributes.
However, it will be updated with Media UI Attributes any time the volume changes or volume availability is updated.
You can use these attributes to style the button. For example, if volume is unavailable, perhaps on an iPhone, hide the volume range:
media-volume-range[mediavolumeunavailable] {
display: none;
}
Or, set the background color to red if the media is muted:
media-volume-range[mediamuted] {
--media-control-background: red;
}
Reference
Section titled ReferenceAttributes
Section titled AttributesName | Type | Description |
---|---|---|
disabled |
boolean |
The Boolean disabled attribute makes the element not mutable or focusable. |
aria-disabled |
||
mediacontroller |
string |
The element `id` of the media controller to connect to (if not nested within). |
Media UI Attributes
Section titled Media UI Attributes
The media UI attributes will be set automatically by the controller if they are
connected via nesting or the mediacontroller
attribute.
Only set these attributes manually if you know what you're doing.
Name | Type | Description |
---|---|---|
mediavolume |
string |
Set to the media volume. |
mediamuted |
boolean |
Set to the media muted state. |
mediavolumeunavailable |
string |
Set if changing volume is unavailable. |
CSS Variables
Section titled CSS VariablesName | Default | Description |
---|---|---|
--media-volume-range-display |
inline-block |
`display` property of range. |
--media-primary-color |
rgb(238 238 238) |
Default color of range track. |
--media-secondary-color |
rgb(20 20 30 / .7) |
Default color of range background. |
--media-control-display |
inline-block |
`display` property of control. |
--media-control-padding |
10px |
`padding` of control. |
--media-control-background |
var(--media-secondary-color, rgb(20 20 30 / .7)) |
`background` of control. |
--media-control-hover-background |
rgb(50 50 70 / .7) |
`background` of control hover state. |
--media-control-height |
24px |
`height` of control. |
--media-range-padding |
var(--media-control-padding, 10px) |
`padding` of range. |
--media-range-padding-left |
var(--_media-range-padding) |
`padding-left` of range. |
--media-range-padding-right |
var(--_media-range-padding) |
`padding-right` of range. |
--media-range-thumb-width |
10px |
`width` of range thumb. |
--media-range-thumb-height |
10px |
`height` of range thumb. |
--media-range-thumb-border |
none |
`border` of range thumb. |
--media-range-thumb-border-radius |
10px |
`border-radius` of range thumb. |
--media-range-thumb-background |
var(--media-primary-color, rgb(238 238 238)) |
`background` of range thumb. |
--media-range-thumb-box-shadow |
1px 1px 1px transparent |
`box-shadow` of range thumb. |
--media-range-thumb-transition |
none |
`transition` of range thumb. |
--media-range-thumb-transform |
none |
`transform` of range thumb. |
--media-range-thumb-opacity |
1 |
`opacity` of range thumb. |
--media-range-track-background |
rgb(255 255 255 / .2) |
`background` of range track. |
--media-range-track-width |
100% |
`width` of range track. |
--media-range-track-height |
4px |
`height` of range track. |
--media-range-track-border |
none |
`border` of range track. |
--media-range-track-outline |
`outline` of range track. | |
--media-range-track-outline-offset |
`outline-offset` of range track. | |
--media-range-track-border-radius |
1px |
`border-radius` of range track. |
--media-range-track-box-shadow |
none |
`box-shadow` of range track. |
--media-range-track-transition |
none |
`transition` of range track. |
--media-range-track-translate-x |
0px |
`translate` x-coordinate of range track. |
--media-range-track-translate-y |
0px |
`translate` y-coordinate of range track. |
--media-time-range-hover-display |
none |
`display` of range hover zone. |
--media-time-range-hover-bottom |
-5px |
`bottom` of range hover zone. |
--media-time-range-hover-height |
max(calc(100% + 5px), 20px) |
`height` of range hover zone. |
--media-range-track-pointer-background |
`background` of range track pointer. | |
--media-range-track-pointer-border-right |
`border-right` of range track pointer. |