Ein Mini-Button ist ein interaktives Element, das eine Aktion auslöst, wenn er angeklickt wird.
Nummer | Typ | Beschreibung | Optional | Hinweis |
---|---|---|---|---|
1 | Komponente | sbb-icon | Nein |
The sbb-mini-button
component provides the same functionality as a native icon-only <button>
enhanced with the SBB Design.
It's mainly designed to be used within the sbb-form-field
in the prefix
or suffix
slot.
<sbb-mini-button icon-name="pen-small"></sbb-mini-button>
<sbb-form-field>
<input />
<sbb-mini-button slot="prefix" icon-name="pen-small"></sbb-mini-button>
</sbb-form-field>
The component can display a sbb-icon
using the iconName
property or via custom content using the icon
slot.
<sbb-mini-button icon-name="info" aria-label="Click for more information."></sbb-mini-button>
<sbb-mini-button aria-label="Click for more information.">
<sbb-icon slot="icon" name="info"></sbb-icon>
</sbb-mini-button>
The component is internally rendered as a button,
accepting its associated properties (type
, name
, value
and form
).
<sbb-form-field>
<label>Tickets</label>
<input placeholder="Insert the number of tickets you want to purchase." />
<sbb-mini-button
slot="suffix"
icon-name="coins-small"
type="button"
name="tickets"
form="buy"
value="tickets"
></sbb-mini-button>
</sbb-form-field>
The component has a negative variant which can be set using the negative
property.
The component can be displayed in disabled
state using the self-named property.
<sbb-mini-button icon-name="pie-small" negative></sbb-mini-button>
<sbb-mini-button icon-name="pie-small" disabled></sbb-mini-button>
Please make sure that the focus outline appears in the correct color if the component is used on a dark background.
You can set it by re-defining the css var on sbb-mini-button
or any parent element:
sbb-mini-button {
--sbb-focus-outline-color: var(--sbb-focus-outline-color-dark);
}
Use the accessibility properties to describe the purpose of the sbb-mini-button
for screen-reader users.
Name | Attribute | Privacy | Type | Default | Description |
---|---|---|---|---|---|
disabled | disabled | public | boolean | false | Whether the component is disabled. |
form | form | public | string | undefined | The | |
iconName | icon-name | public | string | undefined | The icon name we want to use, choose from the small icon variants from the ui-icons category from here https://icons.app.sbb.ch. | |
name | name | public | string | The name of the button element. | |
negative | negative | public | boolean | false | Negative coloring variant flag. |
type | type | public | SbbButtonType | 'button' | The type attribute to use for the button. |
value | value | public | string | The value of the button element. |
Name | Description |
---|---|
icon | Slot used to display the icon, if one is set |