Skip to main content

Styling

The article describes general patterns to style the UI5 Web Components.

One of the core principles of Web Components is the encapsulation. The HTML and styles are encapsulated in the Shadow DOM. This avoids clashes with any CSS brought by the rest of the application, but also makes customization harder. However, there are quite some options to apply custom styling.

Styles on Tag Level​

We designed some components such as Title, Label, Tag, Button, Input, and a few more in such a way that it is possible to set styles/classes on the custom elements that will take effect.

For example: 
  ui5-input {
    width: 150px;
    color: yellow;
    background: purple;
  }

You can try this yourself on the Input test page.

Unfortunately, this can't be done for all components because it depends on the complexity of the DOM structure.

Usage of CSS Shadow Parts​

For more complex components, the styling on the tag level is not possible, therefore we introduced shadow parts on specific elements in the components’ Shadow DOM that the user can restyle, using standard CSS syntax for shadow parts.

For example: You can change the appearance of the CardHeader status with the CSS shadow parts syntax:

<ui5-card>
	<ui5-card-header
        title-text="Quick Links"
		status="4 of 10"
		slot="header">
	</ui5-card-header>
</ui5-card>
ui5-card-header::part(status) {
  color: red;
}

Note: All available shadow parts are described in the API reference as part of the "Overview" section of each component.

Changing CSS Variables​

The UI5 WebComponents leverage CSS variables, so if you inspect the elements inside the Shadow DOM, you will probably find which variable you need to change. Check the list of all Global CSS Variables that we use in the component. Altering them will change the component appearance.

For example: You can change the button text color by overriding the --sapButton_TextColor CSS variable as follows.

<ui5-button>Press</ui5-button>
ui5-button {
  --sapButton_TextColor: purple;
}

Custom Theme Schema​

To change the entire colour scheme, users can create a custom theme. For more information, see the next article.