html_compose.attributes.audio_attrs

  1from . import BaseAttribute
  2from typing import Literal
  3
  4
  5class AudioAttrs:
  6    """
  7    This module contains functions for attributes in the 'audio' element.
  8    Which is inherited by a class so we can generate type hints
  9    """
 10
 11    @staticmethod
 12    def autoplay(value: bool) -> BaseAttribute:
 13        """
 14        "audio" attribute: autoplay
 15        Hint that the media resource can be started automatically when the page is loaded
 16
 17        Args:
 18            value:
 19                Boolean attribute
 20
 21        Returns:
 22            An autoplay attribute to be added to your element
 23
 24        """
 25
 26        return BaseAttribute("autoplay", value)
 27
 28    @staticmethod
 29    def controls(value: bool) -> BaseAttribute:
 30        """
 31        "audio" attribute: controls
 32        Show user agent controls
 33
 34        Args:
 35            value:
 36                Boolean attribute
 37
 38        Returns:
 39            An controls attribute to be added to your element
 40
 41        """
 42
 43        return BaseAttribute("controls", value)
 44
 45    @staticmethod
 46    def crossorigin(
 47        value: Literal["anonymous", "use-credentials"],
 48    ) -> BaseAttribute:
 49        """
 50        "audio" attribute: crossorigin
 51        How the element handles crossorigin requests
 52
 53        Args:
 54            value:
 55                ['anonymous', 'use-credentials']
 56
 57        Returns:
 58            An crossorigin attribute to be added to your element
 59
 60        """
 61
 62        return BaseAttribute("crossorigin", value)
 63
 64    @staticmethod
 65    def loop(value: bool) -> BaseAttribute:
 66        """
 67        "audio" attribute: loop
 68        Whether to loop the media resource
 69
 70        Args:
 71            value:
 72                Boolean attribute
 73
 74        Returns:
 75            An loop attribute to be added to your element
 76
 77        """
 78
 79        return BaseAttribute("loop", value)
 80
 81    @staticmethod
 82    def muted(value: bool) -> BaseAttribute:
 83        """
 84        "audio" attribute: muted
 85        Whether to mute the media resource by default
 86
 87        Args:
 88            value:
 89                Boolean attribute
 90
 91        Returns:
 92            An muted attribute to be added to your element
 93
 94        """
 95
 96        return BaseAttribute("muted", value)
 97
 98    @staticmethod
 99    def preload(value: Literal["none", "metadata", "auto"]) -> BaseAttribute:
100        """
101        "audio" attribute: preload
102        Hints how much buffering the media resource will likely need
103
104        Args:
105            value:
106                ['none', 'metadata', 'auto']
107
108        Returns:
109            An preload attribute to be added to your element
110
111        """
112
113        return BaseAttribute("preload", value)
114
115    @staticmethod
116    def src(value) -> BaseAttribute:
117        """
118        "audio" attribute: src
119        Address of the resource
120
121        Args:
122            value:
123                Valid non-empty URL potentially surrounded by spaces
124
125        Returns:
126            An src attribute to be added to your element
127
128        """
129
130        return BaseAttribute("src", value)