# Icon QML Type

The Icon component displays an icon from the icon theme. More...

Import Statement: | import Lomiri.Components 1.3
Inherits: | Item
Inherited By: | ProgressionSlot

- List of all members, including inherited members

## Properties

- asynchronous : bool
- color : color
- keyColor : color
- name : string
- source : url
- status : enumeration

## Detailed Description

The icon theme contains a set of standard icons referred to by their name. Using icons whenever possible enhances consistency across applications. Each icon has a name and can have different visual representations depending on the size requested.

Icons can also be colorized. Setting the color property will make all pixels with the keyColor (by default #808080) colored.

Example:

    Icon {
        width: 64
        height: 64
        name: "toolkit_input-search"
    }

Example of colorization:

    Icon {
        width: 64
        height: 64
        name: "toolkit_input-search"
        color: LomiriColors.warmGrey
    }

Icon themes are created following the Freedesktop Icon Theme Specification.

## Property Documentation

asynchronous : bool

The property drives the image loading of the icon. Defaults to false.

color : color

The color that all pixels that originally are of color keyColor should take.

keyColor : color

The color of the pixels that should be colorized. By default it is set to #808080.

name : string

The name of the icon to display.

If both name and source are set, name will be ignored.

Note: The complete list of icons available in Lomiri is not published yet. For now please refer to the folders where the icon themes are installed:

- Lomiri Touch: /usr/share/icons/suru
- Lomiri Desktop: /usr/share/icons/lomiri-mono-dark

These 2 separate icon themes will be merged soon.

source : url

The source url of the icon to display. It has precedence over name.

If both name and source are set, name will be ignored.

This property was introduced in Lomiri.Components 1.1.

[read-only] status : enumeration

Holds the loading status of the icon.

The value is one of:

- Image.Null
- Image.Ready
- Image.Loading
- Image.Error