import ShoelaceElement from '../../internal/shoelace-element.js'; import SlIcon from '../icon/icon.component.js'; import SlSpinner from '../spinner/spinner.component.js'; import type { CSSResultGroup } from 'lit'; import type { ShoelaceFormControl } from '../../internal/shoelace-element.js'; /** * @summary Buttons represent actions that are available to the user. * @documentation https://shoelace.style/components/button * @status stable * @since 2.0 * * @dependency sl-icon * @dependency sl-spinner * * @event sl-blur - Emitted when the button loses focus. * @event sl-focus - Emitted when the button gains focus. * @event sl-invalid - Emitted when the form control has been checked for validity and its constraints aren't satisfied. * * @slot - The button's label. * @slot prefix - A presentational prefix icon or similar element. * @slot suffix - A presentational suffix icon or similar element. * * @csspart base - The component's base wrapper. * @csspart prefix - The container that wraps the prefix. * @csspart label - The button's label. * @csspart suffix - The container that wraps the suffix. * @csspart caret - The button's caret icon, an `` element. * @csspart spinner - The spinner that shows when the button is in the loading state. */ export default class SlButton extends ShoelaceElement implements ShoelaceFormControl { static styles: CSSResultGroup; static dependencies: { 'sl-icon': typeof SlIcon; 'sl-spinner': typeof SlSpinner; }; private readonly formControlController; private readonly hasSlotController; private readonly localize; button: HTMLButtonElement | HTMLLinkElement; private hasFocus; invalid: boolean; title: string; /** The button's theme variant. */ variant: 'default' | 'primary' | 'success' | 'neutral' | 'warning' | 'danger' | 'text'; /** The button's size. */ size: 'small' | 'medium' | 'large'; /** Draws the button with a caret. Used to indicate that the button triggers a dropdown menu or similar behavior. */ caret: boolean; /** Disables the button. */ disabled: boolean; /** Draws the button in a loading state. */ loading: boolean; /** Draws an outlined button. */ outline: boolean; /** Draws a pill-style button with rounded edges. */ pill: boolean; /** * Draws a circular icon button. When this attribute is present, the button expects a single `` in the * default slot. */ circle: boolean; /** * The type of button. Note that the default value is `button` instead of `submit`, which is opposite of how native * `