Creates a basic button.
By default, the button renders the contents of its direct children (i.e. it has a single unnamed <slot>).
Subclasses can override this by overriding render.
Optionaloptions: ButtonOptionsWhether the button is disabled.
When disabled, the button cannot be clicked.
Protected Readonly_Protected Readonly_ProtectedhandleHandle a button click.
By default, this does nothing. Subclasses can override this method to add behavior to the button.
Invoked when the component is added to the document's DOM.
In connectedCallback() you should setup tasks that should only occur when
the element is connected to the document. The most common of these is
adding event listeners to nodes external to the element, like a keydown
event handler added to the window.
connectedCallback() {
super.connectedCallback();
addEventListener('keydown', this._handleKeydown);
}
Typically, anything done in connectedCallback() should be undone when the
element is disconnected, in disconnectedCallback().
Invoked when the component is removed from the document's DOM.
This callback is the main signal to the element that it may no longer be
used. disconnectedCallback() should ensure that nothing is holding a
reference to the element (such as event listeners added to nodes external
to the element), so that it is free to be garbage collected.
disconnectedCallback() {
super.disconnectedCallback();
window.removeEventListener('keydown', this._handleKeydown);
}
An element may be re-connected after being disconnected.
ProtectedrenderInvoked on each update to perform rendering tasks. This method may return
any value renderable by lit-html's ChildPart - typically a
TemplateResult. Setting properties inside this method will not trigger
the element to update.
StaticstylesArray of styles to apply to the element. The styles should be defined
using the css tag function, via constructible stylesheets, or
imported from native CSS module scripts.
Note on Content Security Policy:
Element styles are implemented with <style> tags when the browser doesn't
support adopted StyleSheets. To use such <style> tags with the style-src
CSP directive, the style-src value must either include 'unsafe-inline' or
nonce-<base64-value> with <base64-value> replaced be a server-generated
nonce.
To provide a nonce to use on generated <style> elements, set
window.litNonce to a server-generated nonce in your page's HTML, before
loading application code:
<script>
// Generated and unique per request:
window.litNonce = 'a1b2c3d4';
</script>
A basic button.
Custom Element
<theoplayer-button>Attribute
disabled- Whether the button is disabled. When disabled, the button cannot be clicked.CSS Custom Properties
--theoplayer-control-heightThe height of the button's control area (and default icon size). Defaults to
24px.--theoplayer-control-paddingThe padding around the button's content. Defaults to
10px.--theoplayer-control-backgroundThe background of the button. Defaults to
transparent.--theoplayer-control-hover-backgroundThe background of the button when hovered. Defaults to
--theoplayer-control-background.--theoplayer-text-colorThe text color of the button. Defaults to
#fff.--theoplayer-text-font-sizeThe font size of the button's text. Defaults to
14px.--theoplayer-text-content-heightThe line-height of the button's text. Defaults to
--theoplayer-control-height.--theoplayer-icon-colorThe color of the button's icon. Defaults to
#fff.--theoplayer-focus-ring-colorThe color of the focus ring around focused buttons. Defaults to
rgba(27, 127, 204, 0.9).--theoplayer-button-text-colorThe text color of the button. Defaults to
--theoplayer-text-color.--theoplayer-button-icon-widthThe width of the button's icon. Defaults to
--theoplayer-control-height.--theoplayer-button-icon-heightThe height of the button's icon. Defaults to
--theoplayer-control-height.--theoplayer-button-icon-transitionThe CSS transition applied to the button's icon. Defaults to
none.--theoplayer-button-icon-shadowA drop-shadow applied to the icon. Defaults to
none.--theoplayer-button-hover-icon-shadowA drop-shadow applied to the icon on hover. Defaults to
0 0 4px rgba(255, 255, 255, 0.5).--theoplayer-button-checked-backgroundThe background of a toggled-on button (e.g. mute, fullscreen). Defaults to
#fff.--theoplayer-button-checked-colorThe color of a toggled-on button. Defaults to
#000.--theoplayer-button-disabled-text-colorThe text color of a disabled button. Defaults to
#ccc.--theoplayer-before-first-play-displayThe CSS
displayof the button before first play. The<theoplayer-ui>will set this tononeto hide all buttons until playback begins, after which this becomesunsetand the button reverts back to its initial CSSdisplay.