Icons add visual value to apps and actions. They help users instantly recognize user interface elements. Icons also add familiarity when used consistently across Magnolia.
Magnolia icon font
Icons used in Magnolia come from the pictographic MagnoliaIcons
font. Each icon is a character. The character is a vector format rather than a bitmap, which means you can style the icons with CSS and display them in various sizes without repeating the asset itself.
Icon sizes
Icons are displayed in the following sizes in the user interface.
Section |
---|
Column |
---|
|
|
Section |
---|
Column |
---|
|
|
Section |
---|
Column |
---|
|
|
Choosing an icon
When choosing an icon for your own app or action:
- Look through the icons provided in the
MagnoliaIcons
font. Find an icon that represents your app or action well. - Avoid icons that are already used. Using the same icon for two different purposes confuses users and leads to errors.
- If you create your own icons, adhere to the Magnolia design language.
Default icons
icon-notification-badge-plus
icon-content-translation-app
icon-configuration-files-app
icon-rft-configuration-file
icon-dt-generic-definition
icon-dt-subapp-definition
icon-dt-template-definition
icon-dt-dialog-definition
icon-dt-form-field-definition
Using a custom icon font
To use a custom icon font:
- Create an icon font.
- Create a CSS file which references your custom font.
- In the CSS file, specify classes for your icons. Use a namespace that will prevent collision with Magnolia's native classes. For example
icon-mycompanyname-shop-app
instead of icon-shop-app
. - Configure a custom Vaadin theme that is different from the default
admincentral
theme. Your Vaadin theme should include admincentral
theme and it needs to compile it. See Using custom styles in your Magnolia app.