{ "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json", "name": "@kdcloudjs/shoelace", "version": "1.0.52", "description-markup": "markdown", "contributions": { "html": { "elements": [ { "name": "sl-animated-image", "description": "A component for displaying animated GIFs and WEBPs that play and pause on interaction.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the image loads successfully.\n- **sl-error** - Emitted when the image fails to load.\n\n### **Slots:**\n - **play-icon** - Optional play icon to use instead of the default. Works best with ``.\n- **pause-icon** - Optional pause icon to use instead of the default. Works best with ``.\n\n### **CSS Properties:**\n - **--control-box-size** - The size of the icon box. _(default: undefined)_\n- **--icon-size** - The size of the play/pause icons. _(default: undefined)_\n\n### **CSS Parts:**\n - **control-box** - The container that surrounds the pause/play icons and provides their background.", "doc-url": "", "attributes": [ { "name": "src", "description": "The path to the image to load.", "value": { "type": "string" } }, { "name": "alt", "description": "A description of the image used by assistive devices.", "value": { "type": "string" } }, { "name": "play", "description": "Plays the animation. When this attribute is remove, the animation will pause.", "value": { "type": "boolean" } } ], "slots": [ { "name": "play-icon", "description": "Optional play icon to use instead of the default. Works best with ``." }, { "name": "pause-icon", "description": "Optional pause icon to use instead of the default. Works best with ``." } ], "events": [ { "name": "sl-load", "description": "Emitted when the image loads successfully." }, { "name": "sl-error", "description": "Emitted when the image fails to load." } ], "js": { "properties": [ { "name": "animatedImage", "type": "HTMLImageElement" }, { "name": "frozenFrame", "type": "string" }, { "name": "isLoaded", "type": "boolean" }, { "name": "src", "description": "The path to the image to load.", "type": "string" }, { "name": "alt", "description": "A description of the image used by assistive devices.", "type": "string" }, { "name": "play", "description": "Plays the animation. When this attribute is remove, the animation will pause.", "type": "boolean" } ], "events": [ { "name": "sl-load", "description": "Emitted when the image loads successfully." }, { "name": "sl-error", "description": "Emitted when the image fails to load." } ] } }, { "name": "sl-alert", "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the alert opens.\n- **sl-after-show** - Emitted after the alert opens and all animations are complete.\n- **sl-hide** - Emitted when the alert closes.\n- **sl-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's main content.\n- **icon** - An icon to show in the alert. Works best with ``.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **message** - The container that wraps the alert's main content.\n- **close-button** - The close button, an ``.\n- **close-button__base** - The close button's exported `base` part.", "doc-url": "", "attributes": [ { "name": "open", "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.", "value": { "type": "boolean", "default": "false" } }, { "name": "closable", "description": "Enables a close button that allows the user to dismiss the alert.", "value": { "type": "boolean", "default": "false" } }, { "name": "variant", "description": "The alert's theme variant.", "value": { "type": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'", "default": "'primary'" } }, { "name": "duration", "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.", "value": { "type": "string", "default": "Infinity" } }, { "name": "countdown", "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.", "value": { "type": "'rtl' | 'ltr' | undefined" } } ], "slots": [ { "name": "", "description": "The alert's main content." }, { "name": "icon", "description": "An icon to show in the alert. Works best with ``." } ], "events": [ { "name": "sl-show", "description": "Emitted when the alert opens." }, { "name": "sl-after-show", "description": "Emitted after the alert opens and all animations are complete." }, { "name": "sl-hide", "description": "Emitted when the alert closes." }, { "name": "sl-after-hide", "description": "Emitted after the alert closes and all animations are complete." } ], "js": { "properties": [ { "name": "base", "type": "HTMLElement" }, { "name": "countdownElement", "type": "HTMLElement" }, { "name": "open", "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.", "type": "boolean" }, { "name": "closable", "description": "Enables a close button that allows the user to dismiss the alert.", "type": "boolean" }, { "name": "variant", "description": "The alert's theme variant.", "type": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'" }, { "name": "duration", "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own." }, { "name": "countdown", "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.", "type": "'rtl' | 'ltr' | undefined" } ], "events": [ { "name": "sl-show", "description": "Emitted when the alert opens." }, { "name": "sl-after-show", "description": "Emitted after the alert opens and all animations are complete." }, { "name": "sl-hide", "description": "Emitted when the alert closes." }, { "name": "sl-after-hide", "description": "Emitted after the alert closes and all animations are complete." } ] } }, { "name": "sl-badge", "description": "Badges are used to draw attention and display statuses or counts.\n---\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.", "doc-url": "", "attributes": [ { "name": "variant", "description": "The badge's theme variant.", "value": { "type": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'", "default": "'primary'" } }, { "name": "pill", "description": "Draws a pill-style badge with rounded edges.", "value": { "type": "boolean", "default": "false" } }, { "name": "pulse", "description": "Makes the badge pulsate to draw attention.", "value": { "type": "boolean", "default": "false" } } ], "slots": [{ "name": "", "description": "The badge's content." }], "events": [], "js": { "properties": [ { "name": "variant", "description": "The badge's theme variant.", "type": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'" }, { "name": "pill", "description": "Draws a pill-style badge with rounded edges.", "type": "boolean" }, { "name": "pulse", "description": "Makes the badge pulsate to draw attention.", "type": "boolean" } ], "events": [] } }, { "name": "sl-avatar", "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with ``.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.", "doc-url": "", "attributes": [ { "name": "image", "description": "The image source to use for the avatar.", "value": { "type": "string", "default": "''" } }, { "name": "label", "description": "A label to use to describe the avatar to assistive devices.", "value": { "type": "string", "default": "''" } }, { "name": "initials", "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).", "value": { "type": "string", "default": "''" } }, { "name": "loading", "description": "Indicates how the browser should load the image.", "value": { "type": "'eager' | 'lazy'", "default": "'eager'" } }, { "name": "shape", "description": "The shape of the avatar.", "value": { "type": "'circle' | 'square' | 'rounded'", "default": "'circle'" } } ], "slots": [ { "name": "icon", "description": "The default icon to use when no image or initials are present. Works best with ``." } ], "events": [ { "name": "sl-error", "description": "The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause." } ], "js": { "properties": [ { "name": "image", "description": "The image source to use for the avatar.", "type": "string" }, { "name": "label", "description": "A label to use to describe the avatar to assistive devices.", "type": "string" }, { "name": "initials", "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).", "type": "string" }, { "name": "loading", "description": "Indicates how the browser should load the image.", "type": "'eager' | 'lazy'" }, { "name": "shape", "description": "The shape of the avatar.", "type": "'circle' | 'square' | 'rounded'" } ], "events": [ { "name": "sl-error", "description": "The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause." } ] } }, { "name": "sl-breadcrumb", "description": "Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.\n---\n\n\n### **Slots:**\n - _default_ - One or more breadcrumb items to display.\n- **separator** - The separator to use between breadcrumb items. Works best with ``.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.", "doc-url": "", "attributes": [ { "name": "label", "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.", "value": { "type": "string", "default": "''" } } ], "slots": [ { "name": "", "description": "One or more breadcrumb items to display." }, { "name": "separator", "description": "The separator to use between breadcrumb items. Works best with ``." } ], "events": [], "js": { "properties": [ { "name": "defaultSlot", "type": "HTMLSlotElement" }, { "name": "separatorSlot", "type": "HTMLSlotElement" }, { "name": "label", "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.", "type": "string" } ], "events": [] } }, { "name": "sl-animation", "description": "Animate elements declaratively with nearly 100 baked-in presets, or roll your own with custom keyframes. Powered by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API).\n---\n\n\n### **Events:**\n - **sl-cancel** - Emitted when the animation is canceled.\n- **sl-finish** - Emitted when the animation finishes.\n- **sl-start** - Emitted when the animation starts or restarts.\n\n### **Methods:**\n - **cancel()** - Clears all keyframe effects caused by this animation and aborts its playback.\n- **finish()** - Sets the playback time to the end of the animation corresponding to the current playback direction.\n\n### **Slots:**\n - _default_ - The element to animate. Avoid slotting in more than one element, as subsequent ones will be ignored. To animate multiple elements, either wrap them in a single container or use multiple `` elements.", "doc-url": "", "attributes": [ { "name": "name", "description": "The name of the built-in animation to use. For custom animations, use the `keyframes` prop.", "value": { "type": "string", "default": "'none'" } }, { "name": "play", "description": "Plays the animation. When omitted, the animation will be paused. This attribute will be automatically removed when\nthe animation finishes or gets canceled.", "value": { "type": "boolean", "default": "false" } }, { "name": "delay", "description": "The number of milliseconds to delay the start of the animation.", "value": { "type": "number", "default": "0" } }, { "name": "direction", "description": "Determines the direction of playback as well as the behavior when reaching the end of an iteration.\n[Learn more](https://developer.mozilla.org/en-US/docs/Web/CSS/animation-direction)", "value": { "type": "PlaybackDirection", "default": "'normal'" } }, { "name": "duration", "description": "The number of milliseconds each iteration of the animation takes to complete.", "value": { "type": "number", "default": "1000" } }, { "name": "easing", "description": "The easing function to use for the animation. This can be a Shoelace easing function or a custom easing function\nsuch as `cubic-bezier(0, 1, .76, 1.14)`.", "value": { "type": "string", "default": "'linear'" } }, { "name": "end-delay", "description": "The number of milliseconds to delay after the active period of an animation sequence.", "value": { "type": "number", "default": "0" } }, { "name": "fill", "description": "Sets how the animation applies styles to its target before and after its execution.", "value": { "type": "FillMode", "default": "'auto'" } }, { "name": "iterations", "description": "The number of iterations to run before the animation completes. Defaults to `Infinity`, which loops.", "value": { "type": "string", "default": "Infinity" } }, { "name": "iteration-start", "description": "The offset at which to start the animation, usually between 0 (start) and 1 (end).", "value": { "type": "number", "default": "0" } }, { "name": "playback-rate", "description": "Sets the animation's playback rate. The default is `1`, which plays the animation at a normal speed. Setting this\nto `2`, for example, will double the animation's speed. A negative value can be used to reverse the animation. This\nvalue can be changed without causing the animation to restart.", "value": { "type": "number", "default": "1" } } ], "slots": [ { "name": "", "description": "The element to animate. Avoid slotting in more than one element, as subsequent ones will be ignored. To animate multiple elements, either wrap them in a single container or use multiple `` elements." } ], "events": [ { "name": "sl-cancel", "description": "Emitted when the animation is canceled." }, { "name": "sl-finish", "description": "Emitted when the animation finishes." }, { "name": "sl-start", "description": "Emitted when the animation starts or restarts." } ], "js": { "properties": [ { "name": "defaultSlot", "type": "Promise" }, { "name": "name", "description": "The name of the built-in animation to use. For custom animations, use the `keyframes` prop.", "type": "string" }, { "name": "play", "description": "Plays the animation. When omitted, the animation will be paused. This attribute will be automatically removed when\nthe animation finishes or gets canceled.", "type": "boolean" }, { "name": "delay", "description": "The number of milliseconds to delay the start of the animation.", "type": "number" }, { "name": "direction", "description": "Determines the direction of playback as well as the behavior when reaching the end of an iteration.\n[Learn more](https://developer.mozilla.org/en-US/docs/Web/CSS/animation-direction)", "type": "PlaybackDirection" }, { "name": "duration", "description": "The number of milliseconds each iteration of the animation takes to complete.", "type": "number" }, { "name": "easing", "description": "The easing function to use for the animation. This can be a Shoelace easing function or a custom easing function\nsuch as `cubic-bezier(0, 1, .76, 1.14)`.", "type": "string" }, { "name": "endDelay", "description": "The number of milliseconds to delay after the active period of an animation sequence.", "type": "number" }, { "name": "fill", "description": "Sets how the animation applies styles to its target before and after its execution.", "type": "FillMode" }, { "name": "iterations", "description": "The number of iterations to run before the animation completes. Defaults to `Infinity`, which loops." }, { "name": "iterationStart", "description": "The offset at which to start the animation, usually between 0 (start) and 1 (end).", "type": "number" }, { "name": "keyframes", "description": "The keyframes to use for the animation. If this is set, `name` will be ignored.", "type": "Keyframe[] | undefined" }, { "name": "playbackRate", "description": "Sets the animation's playback rate. The default is `1`, which plays the animation at a normal speed. Setting this\nto `2`, for example, will double the animation's speed. A negative value can be used to reverse the animation. This\nvalue can be changed without causing the animation to restart.", "type": "number" }, { "name": "currentTime", "description": "Gets and sets the current animation time.", "type": "CSSNumberish" } ], "events": [ { "name": "sl-cancel", "description": "Emitted when the animation is canceled." }, { "name": "sl-finish", "description": "Emitted when the animation finishes." }, { "name": "sl-start", "description": "Emitted when the animation starts or restarts." } ] } }, { "name": "sl-breadcrumb-item", "description": "Breadcrumb Items are used inside [breadcrumbs](/components/breadcrumb) to represent different links.\n---\n\n\n### **Slots:**\n - _default_ - The breadcrumb item's label.\n- **prefix** - An optional prefix, usually an icon or icon button.\n- **suffix** - An optional suffix, usually an icon or icon button.\n- **separator** - The separator to use for the breadcrumb item. This will only change the separator for this item. If you want to change it for all items in the group, set the separator on `` instead.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The breadcrumb item's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.\n- **separator** - The container that wraps the separator.", "doc-url": "", "attributes": [ { "name": "href", "description": "Optional URL to direct the user to when the breadcrumb item is activated. When set, a link will be rendered\ninternally. When unset, a button will be rendered instead.", "value": { "type": "string | undefined" } }, { "name": "target", "description": "Tells the browser where to open the link. Only used when `href` is set.", "value": { "type": "'_blank' | '_parent' | '_self' | '_top' | undefined" } }, { "name": "rel", "description": "The `rel` attribute to use on the link. Only used when `href` is set.", "value": { "type": "string", "default": "'noreferrer noopener'" } } ], "slots": [ { "name": "", "description": "The breadcrumb item's label." }, { "name": "prefix", "description": "An optional prefix, usually an icon or icon button." }, { "name": "suffix", "description": "An optional suffix, usually an icon or icon button." }, { "name": "separator", "description": "The separator to use for the breadcrumb item. This will only change the separator for this item. If you want to change it for all items in the group, set the separator on `` instead." } ], "events": [], "js": { "properties": [ { "name": "defaultSlot", "type": "HTMLSlotElement" }, { "name": "href", "description": "Optional URL to direct the user to when the breadcrumb item is activated. When set, a link will be rendered\ninternally. When unset, a button will be rendered instead.", "type": "string | undefined" }, { "name": "target", "description": "Tells the browser where to open the link. Only used when `href` is set.", "type": "'_blank' | '_parent' | '_self' | '_top' | undefined" }, { "name": "rel", "description": "The `rel` attribute to use on the link. Only used when `href` is set.", "type": "string" } ], "events": [] } }, { "name": "sl-bubble", "description": "Bubble is a chat bubble component commonly used in conversational UIs.\n---\n\n\n### **Events:**\n - **sl-typing-complete** - Emitted when the typing animation finishes rendering all content.\n- **sl-edit-confirm** - Emitted when the user confirms an edit. `event.detail.content` contains the edited text.\n- **sl-edit-cancel** - Emitted when the user cancels editing.\n\n### **Slots:**\n - _default_ - The default slot for bubble content. Used when the `content` attribute is not set.\n- **avatar** - An avatar to display beside the bubble. Works well with ``.\n- **header** - Header content displayed above the bubble content area.\n- **footer** - Footer content displayed below the bubble content area.\n- **extra** - Extra content displayed on the opposite side of the avatar.\n- **loading** - Custom loading indicator. Overrides the default loading dots.\n\n### **CSS Properties:**\n - **--sl-bubble-filled-background** - Background color for the `filled` variant (start placement). _(default: undefined)_\n- **--sl-bubble-filled-color** - Text color for the `filled` variant. _(default: undefined)_\n- **--sl-bubble-filled-background-end** - Background color for the `filled` variant when placement is `end`. _(default: undefined)_\n- **--sl-bubble-filled-color-end** - Text color for the `filled` variant when placement is `end`. _(default: undefined)_\n- **--sl-bubble-outlined-background** - Background color for the `outlined` variant. _(default: undefined)_\n- **--sl-bubble-outlined-border-color** - Border color for the `outlined` variant. _(default: undefined)_\n- **--sl-bubble-outlined-color** - Text color for the `outlined` variant. _(default: undefined)_\n- **--sl-bubble-shadow-background** - Background color for the `shadow` variant. _(default: undefined)_\n- **--sl-bubble-shadow-box-shadow** - Box shadow for the `shadow` variant. _(default: undefined)_\n- **--sl-bubble-shadow-color** - Text color for the `shadow` variant. _(default: undefined)_\n- **--sl-bubble-borderless-color** - Text color for the `borderless` variant. _(default: undefined)_\n- **--sl-bubble-loading-dot-color** - Color of the loading indicator dots. _(default: undefined)_\n- **--sl-bubble-cursor-color** - Color of the typing cursor indicator. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's outermost wrapper.\n- **avatar** - The container that wraps the avatar slot.\n- **body** - The body wrapper containing header, content, and footer.\n- **header** - The header container.\n- **content** - The main content bubble area.\n- **footer** - The footer container.\n- **extra** - The extra content container.\n- **loading** - The default loading indicator container.", "doc-url": "", "attributes": [ { "name": "placement", "description": "The position of the bubble. Use `start` for messages from others (left-aligned)\nand `end` for messages from the current user (right-aligned).", "value": { "type": "'start' | 'end'", "default": "'start'" } }, { "name": "content", "description": "The text content to display in the bubble. If omitted, the default slot content is rendered instead.\nWhen `typing` is enabled, the content will be animated character by character.", "value": { "type": "string", "default": "''" } }, { "name": "variant", "description": "The visual style variant of the bubble.\n- `filled`: Solid background (default)\n- `outlined`: Border with transparent background\n- `shadow`: White background with drop shadow\n- `borderless`: No background or border", "value": { "type": "'filled' | 'outlined' | 'shadow' | 'borderless'", "default": "'filled'" } }, { "name": "shape", "description": "The shape of the bubble.\n- `default`: Standard rounded corners\n- `round`: Pill-shaped corners\n- `corner`: Asymmetric corner (chat-style notch)", "value": { "type": "'default' | 'round' | 'corner'", "default": "'default'" } }, { "name": "loading", "description": "When true, shows a loading indicator instead of content.", "value": { "type": "boolean", "default": "false" } }, { "name": "typing", "description": "Enables a character-by-character typing animation for the `content` attribute.\nOnly works with string content set via the `content` attribute.", "value": { "type": "boolean", "default": "false" } }, { "name": "typing-step", "description": "Number of characters to reveal per animation step during typing.", "value": { "type": "number", "default": "2" } }, { "name": "typing-interval", "description": "Interval in milliseconds between each typing animation step.", "value": { "type": "number", "default": "50" } }, { "name": "streaming", "description": "Indicates the content is being streamed. When typing is enabled and streaming is true,\nthe typing animation keeps running as new content arrives. The `sl-typing-complete` event\nis only emitted after streaming ends.", "value": { "type": "boolean", "default": "false" } }, { "name": "footer-placement", "description": "Controls the position of the footer slot relative to the content bubble.\n- `outer-start`: Footer outside the content area, aligned to start (default when placement is `start`)\n- `outer-end`: Footer outside the content area, aligned to end (default when placement is `end`)\n- `inner-start`: Footer inside the content area (shares background), aligned to start\n- `inner-end`: Footer inside the content area (shares background), aligned to end\n\nWhen not set, defaults to `outer-start` if placement is `start`, or `outer-end` if placement is `end`.", "value": { "type": "'outer-start' | 'outer-end' | 'inner-start' | 'inner-end' | undefined" } }, { "name": "editable", "description": "Enables editing mode on the bubble content. When true, the content area becomes\na contentEditable region with OK and Cancel buttons.", "value": { "type": "boolean", "default": "false" } }, { "name": "ok-text", "description": "Custom text for the edit confirm button.", "value": { "type": "string", "default": "'OK'" } }, { "name": "cancel-text", "description": "Custom text for the edit cancel button.", "value": { "type": "string", "default": "'Cancel'" } } ], "slots": [ { "name": "", "description": "The default slot for bubble content. Used when the `content` attribute is not set." }, { "name": "avatar", "description": "An avatar to display beside the bubble. Works well with ``." }, { "name": "header", "description": "Header content displayed above the bubble content area." }, { "name": "footer", "description": "Footer content displayed below the bubble content area." }, { "name": "extra", "description": "Extra content displayed on the opposite side of the avatar." }, { "name": "loading", "description": "Custom loading indicator. Overrides the default loading dots." } ], "events": [ { "name": "sl-typing-complete", "description": "Emitted when the typing animation finishes rendering all content." }, { "name": "sl-edit-confirm", "description": "Emitted when the user confirms an edit. `event.detail.content` contains the edited text." }, { "name": "sl-edit-cancel", "description": "Emitted when the user cancels editing." } ], "js": { "properties": [ { "name": "placement", "description": "The position of the bubble. Use `start` for messages from others (left-aligned)\nand `end` for messages from the current user (right-aligned).", "type": "'start' | 'end'" }, { "name": "content", "description": "The text content to display in the bubble. If omitted, the default slot content is rendered instead.\nWhen `typing` is enabled, the content will be animated character by character.", "type": "string" }, { "name": "variant", "description": "The visual style variant of the bubble.\n- `filled`: Solid background (default)\n- `outlined`: Border with transparent background\n- `shadow`: White background with drop shadow\n- `borderless`: No background or border", "type": "'filled' | 'outlined' | 'shadow' | 'borderless'" }, { "name": "shape", "description": "The shape of the bubble.\n- `default`: Standard rounded corners\n- `round`: Pill-shaped corners\n- `corner`: Asymmetric corner (chat-style notch)", "type": "'default' | 'round' | 'corner'" }, { "name": "loading", "description": "When true, shows a loading indicator instead of content.", "type": "boolean" }, { "name": "typing", "description": "Enables a character-by-character typing animation for the `content` attribute.\nOnly works with string content set via the `content` attribute.", "type": "boolean" }, { "name": "typingStep", "description": "Number of characters to reveal per animation step during typing.", "type": "number" }, { "name": "typingInterval", "description": "Interval in milliseconds between each typing animation step.", "type": "number" }, { "name": "streaming", "description": "Indicates the content is being streamed. When typing is enabled and streaming is true,\nthe typing animation keeps running as new content arrives. The `sl-typing-complete` event\nis only emitted after streaming ends.", "type": "boolean" }, { "name": "footerPlacement", "description": "Controls the position of the footer slot relative to the content bubble.\n- `outer-start`: Footer outside the content area, aligned to start (default when placement is `start`)\n- `outer-end`: Footer outside the content area, aligned to end (default when placement is `end`)\n- `inner-start`: Footer inside the content area (shares background), aligned to start\n- `inner-end`: Footer inside the content area (shares background), aligned to end\n\nWhen not set, defaults to `outer-start` if placement is `start`, or `outer-end` if placement is `end`.", "type": "'outer-start' | 'outer-end' | 'inner-start' | 'inner-end' | undefined" }, { "name": "editable", "description": "Enables editing mode on the bubble content. When true, the content area becomes\na contentEditable region with OK and Cancel buttons.", "type": "boolean" }, { "name": "okText", "description": "Custom text for the edit confirm button.", "type": "string" }, { "name": "cancelText", "description": "Custom text for the edit cancel button.", "type": "string" } ], "events": [ { "name": "sl-typing-complete", "description": "Emitted when the typing animation finishes rendering all content." }, { "name": "sl-edit-confirm", "description": "Emitted when the user confirms an edit. `event.detail.content` contains the edited text." }, { "name": "sl-edit-cancel", "description": "Emitted when the user cancels editing." } ] } }, { "name": "sl-button", "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `` element.\n- **spinner** - The spinner that shows when the button is in the loading state.", "doc-url": "", "attributes": [ { "name": "title", "value": { "type": "string", "default": "''" } }, { "name": "variant", "description": "The button's theme variant.", "value": { "type": "'default' | 'primary' | 'success' | 'neutral' | 'warning' | 'danger' | 'text'", "default": "'default'" } }, { "name": "size", "description": "The button's size.", "value": { "type": "'small' | 'medium' | 'large'", "default": "'medium'" } }, { "name": "caret", "description": "Draws the button with a caret. Used to indicate that the button triggers a dropdown menu or similar behavior.", "value": { "type": "boolean", "default": "false" } }, { "name": "disabled", "description": "Disables the button.", "value": { "type": "boolean", "default": "false" } }, { "name": "loading", "description": "Draws the button in a loading state.", "value": { "type": "boolean", "default": "false" } }, { "name": "outline", "description": "Draws an outlined button.", "value": { "type": "boolean", "default": "false" } }, { "name": "pill", "description": "Draws a pill-style button with rounded edges.", "value": { "type": "boolean", "default": "false" } }, { "name": "circle", "description": "Draws a circular icon button. When this attribute is present, the button expects a single `` in the\ndefault slot.", "value": { "type": "boolean", "default": "false" } }, { "name": "type", "description": "The type of button. Note that the default value is `button` instead of `submit`, which is opposite of how native\n`