Skip to content

Summary chip

Summary chips are compact components designed to quickly and concisely summarize data. They are often used to provide a condensed overview, summarize states, and allow for filtering of information in a visually appealing manner.

Usage

Summary chip

There are basically two main use cases for the summary chip component:

  • State indication: To show values of different categories, such as Override, Success, Issue, Not tested, etc.
  • Filtering: To filter datasets or information based on the specific categories.

When to use

Arrange one or more Summary Chips in a horizontal layout above or near the related content. Chips can be combined with other supporting elements, such as badges, buttons, or links, to enhance functionality. Place them within a container that can use a background of None, background-0, or background-1, depending on the visual requirements.

Summary chip example

Design

Elements

Summary chip construction

  1. Category icon or composite icon (optional), 2. Label (optional), 3. Value (optional)

The summary chip can hold an icon or a composite icon representing a state. The icon must be self-explanatory since there is no label.

States

Summary chip states

Variants

The component is very flexible, hence allowing the following variants:

Summary chip variants

Code

SiSummaryChipComponent API Documentation

selector
si-summary-chip

Input Properties

Name Type Default Description
color
string Color class, see https://element.siemens.io/typography/#color-variants-classes .
disabled
boolean false Disabled state.
hideLabel
boolean false Whether to hide the label. Only takes effect when both icon and value are provided. The label will still be used for screen-readers.
icon
string Icon token, see https://element.siemens.io/icons/element .
label
Required
TranslatableString The label.
selected
boolean false Selected state, will change when clicked.
stackedColor
string Color class, see https://element.siemens.io/fundamentals/icons/ .
stackedIcon
string Icon token, see https://element.siemens.io/fundamentals/icons/ .
status
ExtendedStatusType Status. Alternatively, use icon and color .
value
TranslatableString Value to display.

Output Properties

Name Type Description
selectedChange
boolean Selected state, will change when clicked.

Types Documentation

Represents a translatable string. This can either be a translation key, e.g. ACTIONS.EDIT that will be automatically translated when displayed on the UI or a pre-translated string, e.g. Edit . Equivalent to a normal string in usage and functionality.
("success" | "info" | "warning" | "danger" | "caution" | "critical")
Properties
ariaLabel?: TranslatableString
background: string
color: string
icon: string
severity: number
stacked: string
stackedColor: string

Except where otherwise noted, content on this site is licensed under MIT License.