# Helvetia Design System — Full Reference > Generated reference combining each component's Stencil-derived API (props, events, methods, slots, parts, CSS custom properties) with its written usage guidance. See llms.txt for a shorter index. # Actions ## ds-button Docs: https://helvetia-design.vercel.app/?path=/docs/components-actions-button-button--button Button provides a clickable element for triggering actions, submitting forms, or navigating — supporting text, icons, or both. ### Props | Attribute | Type | Default | Description | | --- | --- | --- | --- | | a-1-1y-controls | string | '' | A11y attributes for the native button element. | | a-1-1y-current | string | '' | A11y attributes for the native button element. Maps to `aria-current`, e.g. `page` for the current navigation entry. | | a-1-1y-haspopup | string | '' | A11y attributes for the native button element. | | a-1-1y-label | string | '' | A11y attributes for the native button element. | | a-1-1y-title | string | '' | A11y attributes for the native button element. | | brand-icon | string | '' | A brand icon shown above the label instead of the regular leading/trailing icons. Accepts either a URL to an SVG file or raw `` markup. When set, `icon` and `iconRight` are ignored. | | brand-size | "lg" \| "sm" \| undefined | | Size of the brand icon. | | color | "brand-green" \| "brand-purple" \| "brand-red" \| "brand-yellow" \| "danger" \| "ghost" \| "info" \| "link" \| "primary" \| "secondary" \| "success" \| "tertiary" \| "warning" | 'primary' | The color to use from your application's color palette. | | disabled | boolean | false | If `true`, the user cannot interact with the button. | | download | string \| undefined | | This attribute instructs browsers to download a URL instead of navigating to it, so the user will be prompted to save it as a local file. If the attribute has a value, it is used as the pre-filled file name in the Save prompt (the user can still change the file name if they want). | | element-type | "button" \| "reset" \| "submit" | 'button' | The type of button. | | flat | boolean | false | If `true` the button has no padding and a reduced height | | href | string | '' | Specifies the URL of the page the link goes to | | icon | string | '' | Name of the left button icon | | icon-right | string | '' | Name of the right button icon | | icon-turn | boolean | false | If `true` the icon turns | | inverted | boolean | false | If `true` the button is inverted | | loading | boolean | false | If `true` the label is hidden and a loading spinner is shown instead. | | name | string | '' | The name of the button, which is submitted with the form data. | | no-wrap | boolean | false | The label of the button will not break | | rel | string | '' | Specifies the relationship of the target object to the link object. The value is a space-separated list of [link types](https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types). | | shadow | boolean | false | If `true` adds a box shadow to improve readability on image background | | size | "lg" \| "sm" \| undefined | | Size of the button | | square | boolean | false | If `true` the width of the buttons is limited | | target | "_blank" \| "_parent" \| "_self" \| "_top" | '_self' | Specifies where to display the linked URL. Only applies when an `href` is provided. | | tooltip-placement | "bottom" \| "left" \| "right" \| "top" | 'bottom' | Placement of the tooltip that shows the `a11yTitle` on hover and focus. | | value | string | '' | The value of the button, which is submitted with the form data. | | wide | boolean | false | If `true` the button has a full width | ### Events | Event | Detail | Description | | --- | --- | --- | | dsBlur | ButtonBlurDetail | Emitted when the button loses focus. | | dsClick | ButtonClickDetail | Emitted when the link element has clicked. | | dsDidRender | ButtonDidRenderDetail | Emitted when the button has been rendered. | | dsFocus | ButtonFocusDetail | Emitted when the button has focus. | | dsNavigate | ButtonNavigateDetail | Emitted when the link element has clicked. | ### Slots | Name | Description | | --- | --- | | default | Button label text and/or icon children. Rendered inside a `` wrapper. | ### Parts | Name | Description | | --- | --- | | icon | The leading icon wrapper (or the brand icon wrapper when `brandIcon` is set). | | icon-right | The trailing icon wrapper. | | label | The text label wrapper (``). | | native | The native `