These properties hold standard button widths:

• Theme.buttonWidthTiny - Default icon button width.
• Theme.buttonWidthExtraSmall - Extra small button size. Three extra small buttons fit across a portrait screen.
• Theme.buttonWidthSmall - (default) small button size. Two small buttons will fit across a portrait screen.
• Theme.buttonWidthMedium - medium button size.
• Theme.buttonWidthLarge - large button size. Generally only one large button will fit across a portrait screen.

See also Button::preferredWidth.

These properties hold standard button widths:

• Theme.buttonWidthTiny - Default icon button width.
• Theme.buttonWidthExtraSmall - Extra small button size. Three extra small buttons fit across a portrait screen.
• Theme.buttonWidthSmall - (default) small button size. Two small buttons will fit across a portrait screen.
• Theme.buttonWidthMedium - medium button size.
• Theme.buttonWidthLarge - large button size. Generally only one large button will fit across a portrait screen.

See also Button::preferredWidth.

These properties hold standard button widths:

• Theme.buttonWidthTiny - Default icon button width.
• Theme.buttonWidthExtraSmall - Extra small button size. Three extra small buttons fit across a portrait screen.
• Theme.buttonWidthSmall - (default) small button size. Two small buttons will fit across a portrait screen.
• Theme.buttonWidthMedium - medium button size.
• Theme.buttonWidthLarge - large button size. Generally only one large button will fit across a portrait screen.

See also Button::preferredWidth.

These properties hold standard button widths:

• Theme.buttonWidthTiny - Default icon button width.
• Theme.buttonWidthExtraSmall - Extra small button size. Three extra small buttons fit across a portrait screen.
• Theme.buttonWidthSmall - (default) small button size. Two small buttons will fit across a portrait screen.
• Theme.buttonWidthMedium - medium button size.
• Theme.buttonWidthLarge - large button size. Generally only one large button will fit across a portrait screen.

See also Button::preferredWidth.

These properties hold standard button widths:

• Theme.buttonWidthTiny - Default icon button width.
• Theme.buttonWidthExtraSmall - Extra small button size. Three extra small buttons fit across a portrait screen.
• Theme.buttonWidthSmall - (default) small button size. Two small buttons will fit across a portrait screen.
• Theme.buttonWidthMedium - medium button size.
• Theme.buttonWidthLarge - large button size. Generally only one large button will fit across a portrait screen.

See also Button::preferredWidth.

Defined by the currently active Sailfish ambience. In the DarkOnLight color scheme the platform text and icons are painted in dark color on light background compared to the LightOnDark scheme with normal light content on top of the dark background.

Apps that use platform colors and icons don't need to worry about the color scheme, the explicit property is exposed so that any custom UI elements defined by the app can adapt to the underlying theme changes.

• Theme.LightOnDark - original ambience style with dark wallpaper and light app content
• Theme.DarkOnLight - new style introduced in Sailfish 3 with light wallpaper and dark app content

These properties hold application cover standard sizes:

• Theme.coverSizeSmall - small application cover size
• Theme.coverSizeLarge - large application cover size

These properties hold application cover standard sizes:

• Theme.coverSizeSmall - small application cover size
• Theme.coverSizeLarge - large application cover size

Primary and secondary color are defined by the active ambience, and have been optimized to work with the respective ambience wallpaper. Using the default Theme.primaryColor and Theme.secondaryColor may not be appropriate if the app view uses custom background. If the app uses light background (e.g. text document) Theme.darkPrimaryColor and Theme.darkSecondaryColor are recommended instead. If the app uses dark background (e.g. video player) Theme.lightPrimaryColor and Theme.lightSecondaryColor are recommended.

Primary and secondary color are defined by the active ambience, and have been optimized to work with the respective ambience wallpaper. Using the default Theme.primaryColor and Theme.secondaryColor may not be appropriate if the app view uses custom background. If the app uses light background (e.g. text document) Theme.darkPrimaryColor and Theme.darkSecondaryColor are recommended instead. If the app uses dark background (e.g. video player) Theme.lightPrimaryColor and Theme.lightSecondaryColor are recommended.

Used to indicate errors in components.

These properties hold resolution-independent platform-style flicking parameters. You don't need to access these directly if your application uses Silica's own flickable types — that is, SilicaFlickable, SilicaListView, and SilicaGridView.

• Theme.flickDeceleration - Flick deceleration of Sailfish-style flickables.
• Theme.maximumFlickVelocity - Maximum flick velocity of Sailfish-style flickables.

Two standard fonts are used in the Sailfish UI:

• Theme.fontFamily - the default font
• Theme.fontFamilyHeading - used to display heading text

Two standard fonts are used in the Sailfish UI:

• Theme.fontFamily - the default font
• Theme.fontFamilyHeading - used to display heading text

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard font sizes:

• Theme.fontSizeTiny - the smallest recommended font size; for use where space is severely restricted
• Theme.fontSizeExtraSmall - for smaller secondary text, such as the description text in TextSwitch and ValueButton
• Theme.fontSizeSmall - for general secondary text or paragraphs of non-interactive text
• Theme.fontSizeMedium - the most common text size; this is the default font size of Label and most UI controls
• Theme.fontSizeLarge - for large heading text, such as those of PageHeader and ViewPlaceholder
• Theme.fontSizeExtraLarge - for larger heading text
• Theme.fontSizeHuge - for very large headings or UI components where the text dominates, such as in a keypad button

These properties hold base values of standard font size, which are unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

These properties hold standard colors for rendering a highlighted background according to the current Sailfish ambience:

• Theme.highlightBackgroundColor - used to paint the background behind highlighted text
• Theme.highlightBackgroundOpacity - used to apply an appropriate opacity when painting the highlightBackgroundColor

The opacity is typically applied to the color using rgba():

 MouseArea {
     id: mouseArea
     anchors.fill: parent

     Rectangle {
         anchors.fill: parent
         color: mouseArea.pressed && mouseArea.containsMouse
                ? Theme.rgba(Theme.highlightBackgroundColor, Theme.highlightBackgroundOpacity)
                : "transparent"
     }
 }

(This avoids having to set the rectangle's opacity separately, which would additionally be problematic if the rectangle had children that should not have the opacity applied.)

These properties hold standard colors for rendering a highlighted background according to the current Sailfish ambience:

• Theme.highlightBackgroundColor - used to paint the background behind highlighted text
• Theme.highlightBackgroundOpacity - used to apply an appropriate opacity when painting the highlightBackgroundColor

The opacity is typically applied to the color using rgba():

 MouseArea {
     id: mouseArea
     anchors.fill: parent

     Rectangle {
         anchors.fill: parent
         color: mouseArea.pressed && mouseArea.containsMouse
                ? Theme.rgba(Theme.highlightBackgroundColor, Theme.highlightBackgroundOpacity)
                : "transparent"
     }
 }

(This avoids having to set the rectangle's opacity separately, which would additionally be problematic if the rectangle had children that should not have the opacity applied.)

These properties hold standard colors according to the current Sailfish ambience:

• Theme.primaryColor - adds emphasis to active areas of the UI
• Theme.secondaryColor - used to paint less prominent parts of the UI
• Theme.highlightColor - main color for non-interactive text and press highlights
• Theme.secondaryHighlightColor - used to paint less prominent parts of the UI in a highlighted manner
• Theme.highlightDimmerColor - used to paint the highlight color with a darker shade (for example, when dimming a region to bring attention to other areas of the UI)

"Secondary" information can refer to any text or icons that gives optional or additional information and as such do not need to receive the primary user attention. For example, the TextField placeholder text is colored with Theme.secondaryColor (and its highlighted counterpart when the field receives focus).

These properties hold standard colors according to the current Sailfish ambience:

• Theme.primaryColor - adds emphasis to active areas of the UI
• Theme.secondaryColor - used to paint less prominent parts of the UI
• Theme.highlightColor - main color for non-interactive text and press highlights
• Theme.secondaryHighlightColor - used to paint less prominent parts of the UI in a highlighted manner
• Theme.highlightDimmerColor - used to paint the highlight color with a darker shade (for example, when dimming a region to bring attention to other areas of the UI)

"Secondary" information can refer to any text or icons that gives optional or additional information and as such do not need to receive the primary user attention. For example, the TextField placeholder text is colored with Theme.secondaryColor (and its highlighted counterpart when the field receives focus).

These properties hold standard margins:

• Theme.paddingSmall - commonly used to separate UI components by a slight margin, particularly in space-restricted areas
• Theme.paddingMedium - commonly used to separate related UI components without visually disassocating them
• Theme.paddingLarge - commonly used to divide UI components, particularly as the vertical spacing between components in a Column
• Theme.horizontalPageMargin - used between the page content and the left and right side of the display. This value is typically Theme.paddingLarge on smaller displays, e.g. phones, and can be wider on larger displays, e.g. tablets.

Margins on the left and right sides of the display should be set to Theme.horizontalPageMargin.

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard icon sizes:

• Theme.iconSizeExtraSmall - suits the smallest icons, such as those in the Home status area
• Theme.iconSizeSmall - suits small icons, such as CoverAction icons and icons on the Events screen
• Theme.iconSizeSmallPlus - a larger variant of iconSizeSmall, used for notification icons
• Theme.iconSizeMedium - the most common icon size; suits icons in small to medium-sized list items
• Theme.iconSizeLarge - suits larger icon displays and buttons
• Theme.iconSizeExtraLarge - suits very large icon displays
• Theme.iconSizeLauncher - for icons in the Home app grid

Platform icons accessed with the syntax "image://theme/icon-[s/m/l]-iconname" also follow these icon sizes. Small icons start with prefix "icon-s-", medium icons with prefix "icon-m-" and large icons with prefix "icon-l-".

All monochromatic icons should be colored appropriately, with the same coloring styles for text described in Applying Sailfish-style coloring. To color monochromatic platform icons, add "?<color>" to the end of the URI:

 ListItem {
     id: listItem
     width: parent.width
     height: Theme.itemSizeSmall

     Image {
         source: "image://theme/icon-s-iconname"
             + (listItem.highlighted ? "?" + Theme.highlightColor : "")
     }
 }

These properties hold standard item sizes:

• Theme.itemSizeExtraSmall - suits the smallest UI controls; used as the height of buttons and pulley menu entries
• Theme.itemSizeSmall - suits small UI controls; used as the height of list items with one line of text
• Theme.itemSizeMedium - suits average-sized UI controls; used as the height of list items with two lines of text
• Theme.itemSizeLarge - suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation
• Theme.itemSizeExtraLarge - suits larger items such as list delegates with an image thumbnail and associated image details
• Theme.itemSizeHuge - suits larger items such as images in a fullscreen grid of thumbnail images

These properties hold standard item sizes:

• Theme.itemSizeExtraSmall - suits the smallest UI controls; used as the height of buttons and pulley menu entries
• Theme.itemSizeSmall - suits small UI controls; used as the height of list items with one line of text
• Theme.itemSizeMedium - suits average-sized UI controls; used as the height of list items with two lines of text
• Theme.itemSizeLarge - suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation
• Theme.itemSizeExtraLarge - suits larger items such as list delegates with an image thumbnail and associated image details
• Theme.itemSizeHuge - suits larger items such as images in a fullscreen grid of thumbnail images

These properties hold standard item sizes:

• Theme.itemSizeExtraSmall - suits the smallest UI controls; used as the height of buttons and pulley menu entries
• Theme.itemSizeSmall - suits small UI controls; used as the height of list items with one line of text
• Theme.itemSizeMedium - suits average-sized UI controls; used as the height of list items with two lines of text
• Theme.itemSizeLarge - suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation
• Theme.itemSizeExtraLarge - suits larger items such as list delegates with an image thumbnail and associated image details
• Theme.itemSizeHuge - suits larger items such as images in a fullscreen grid of thumbnail images

These properties hold standard item sizes:

• Theme.itemSizeExtraSmall - suits the smallest UI controls; used as the height of buttons and pulley menu entries
• Theme.itemSizeSmall - suits small UI controls; used as the height of list items with one line of text
• Theme.itemSizeMedium - suits average-sized UI controls; used as the height of list items with two lines of text
• Theme.itemSizeLarge - suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation
• Theme.itemSizeExtraLarge - suits larger items such as list delegates with an image thumbnail and associated image details
• Theme.itemSizeHuge - suits larger items such as images in a fullscreen grid of thumbnail images

These properties hold standard item sizes:

• Theme.itemSizeExtraSmall - suits the smallest UI controls; used as the height of buttons and pulley menu entries
• Theme.itemSizeSmall - suits small UI controls; used as the height of list items with one line of text
• Theme.itemSizeMedium - suits average-sized UI controls; used as the height of list items with two lines of text
• Theme.itemSizeLarge - suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation
• Theme.itemSizeExtraLarge - suits larger items such as list delegates with an image thumbnail and associated image details
• Theme.itemSizeHuge - suits larger items such as images in a fullscreen grid of thumbnail images

These properties hold standard item sizes:

• Theme.itemSizeExtraSmall - suits the smallest UI controls; used as the height of buttons and pulley menu entries
• Theme.itemSizeSmall - suits small UI controls; used as the height of list items with one line of text
• Theme.itemSizeMedium - suits average-sized UI controls; used as the height of list items with two lines of text
• Theme.itemSizeLarge - suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation
• Theme.itemSizeExtraLarge - suits larger items such as list delegates with an image thumbnail and associated image details
• Theme.itemSizeHuge - suits larger items such as images in a fullscreen grid of thumbnail images

Primary and secondary color are defined by the active ambience, and have been optimized to work with the respective ambience wallpaper. Using the default Theme.primaryColor and Theme.secondaryColor may not be appropriate if the app view uses custom background. If the app uses light background (e.g. text document) Theme.darkPrimaryColor and Theme.darkSecondaryColor are recommended instead. If the app uses dark background (e.g. video player) Theme.lightPrimaryColor and Theme.lightSecondaryColor are recommended.

Primary and secondary color are defined by the active ambience, and have been optimized to work with the respective ambience wallpaper. Using the default Theme.primaryColor and Theme.secondaryColor may not be appropriate if the app view uses custom background. If the app uses light background (e.g. text document) Theme.darkPrimaryColor and Theme.darkSecondaryColor are recommended instead. If the app uses dark background (e.g. video player) Theme.lightPrimaryColor and Theme.lightSecondaryColor are recommended.

These properties hold resolution-independent platform-style flicking parameters. You don't need to access these directly if your application uses Silica's own flickable types — that is, SilicaFlickable, SilicaListView, and SilicaGridView.

• Theme.flickDeceleration - Flick deceleration of Sailfish-style flickables.
• Theme.maximumFlickVelocity - Maximum flick velocity of Sailfish-style flickables.

These properties hold standard opacity values for rendering unavailable, disabled or de-emphasized content:

• Theme.opacityFaint - opacity used to render unavailable content, e.g. requiring installation.
• Theme.opacityLow - opacity used to render disabled content.
• Theme.opacityHigh - opacity used to render de-emphasized content.
• Theme.opacityOverlay - opacity used to render overlay content.

When disabling items by setting the enabled flag to false, the appropriate opacity will ordinarily be applied automatically, so there is no need for the developer to set this explicitly. However, in a few edge cases, or when creating custom components, the developer may need to use the Theme.opacityLow constant to apply opacity to disabled items.

In the cases where this is needed, the opacity is typically applied to the color using rgba() or explicitly as an opacity value:

 Column {
     property bool allowSelection: true

     width: parent.width
     enabled: allowSelection
     opacity: allowSelection ? 1.0 : Theme.opacityLow

     ComboBox {
         width: parent.width
         //% "Size"
         label: qsTrId("example_app-label-size")
         menu: ContextMenu {
             MenuItem {
                 //% "Small"
                 text: qsTrId("example_app-menu-small")
             }
             MenuItem {
                 //% "Medium"
                 text: qsTrId("example_app-menu-medium")
             }
             MenuItem {
                 //% "Large"
                 text: qsTrId("example_app-menu-large")
             }
         }
     }
 }

In the example above the Column's enabled property is being overriden on inheritance by an internal MouseArea.enabled flag. Disabling the Column will prevent interaction with its child components (in this case a ComboBox), but the child components will be rendered at full opacity, potentially causing confusion for the user. Explicity setting the opacity of the Column when it's disabled addresses this.

These properties hold standard opacity values for rendering unavailable, disabled or de-emphasized content:

• Theme.opacityFaint - opacity used to render unavailable content, e.g. requiring installation.
• Theme.opacityLow - opacity used to render disabled content.
• Theme.opacityHigh - opacity used to render de-emphasized content.
• Theme.opacityOverlay - opacity used to render overlay content.

When disabling items by setting the enabled flag to false, the appropriate opacity will ordinarily be applied automatically, so there is no need for the developer to set this explicitly. However, in a few edge cases, or when creating custom components, the developer may need to use the Theme.opacityLow constant to apply opacity to disabled items.

In the cases where this is needed, the opacity is typically applied to the color using rgba() or explicitly as an opacity value:

 Column {
     property bool allowSelection: true

     width: parent.width
     enabled: allowSelection
     opacity: allowSelection ? 1.0 : Theme.opacityLow

     ComboBox {
         width: parent.width
         //% "Size"
         label: qsTrId("example_app-label-size")
         menu: ContextMenu {
             MenuItem {
                 //% "Small"
                 text: qsTrId("example_app-menu-small")
             }
             MenuItem {
                 //% "Medium"
                 text: qsTrId("example_app-menu-medium")
             }
             MenuItem {
                 //% "Large"
                 text: qsTrId("example_app-menu-large")
             }
         }
     }
 }

In the example above the Column's enabled property is being overriden on inheritance by an internal MouseArea.enabled flag. Disabling the Column will prevent interaction with its child components (in this case a ComboBox), but the child components will be rendered at full opacity, potentially causing confusion for the user. Explicity setting the opacity of the Column when it's disabled addresses this.

These properties hold standard opacity values for rendering unavailable, disabled or de-emphasized content:

• Theme.opacityFaint - opacity used to render unavailable content, e.g. requiring installation.
• Theme.opacityLow - opacity used to render disabled content.
• Theme.opacityHigh - opacity used to render de-emphasized content.
• Theme.opacityOverlay - opacity used to render overlay content.

When disabling items by setting the enabled flag to false, the appropriate opacity will ordinarily be applied automatically, so there is no need for the developer to set this explicitly. However, in a few edge cases, or when creating custom components, the developer may need to use the Theme.opacityLow constant to apply opacity to disabled items.

In the cases where this is needed, the opacity is typically applied to the color using rgba() or explicitly as an opacity value:

 Column {
     property bool allowSelection: true

     width: parent.width
     enabled: allowSelection
     opacity: allowSelection ? 1.0 : Theme.opacityLow

     ComboBox {
         width: parent.width
         //% "Size"
         label: qsTrId("example_app-label-size")
         menu: ContextMenu {
             MenuItem {
                 //% "Small"
                 text: qsTrId("example_app-menu-small")
             }
             MenuItem {
                 //% "Medium"
                 text: qsTrId("example_app-menu-medium")
             }
             MenuItem {
                 //% "Large"
                 text: qsTrId("example_app-menu-large")
             }
         }
     }
 }

In the example above the Column's enabled property is being overriden on inheritance by an internal MouseArea.enabled flag. Disabling the Column will prevent interaction with its child components (in this case a ComboBox), but the child components will be rendered at full opacity, potentially causing confusion for the user. Explicity setting the opacity of the Column when it's disabled addresses this.

These properties hold standard opacity values for rendering unavailable, disabled or de-emphasized content:

• Theme.opacityFaint - opacity used to render unavailable content, e.g. requiring installation.
• Theme.opacityLow - opacity used to render disabled content.
• Theme.opacityHigh - opacity used to render de-emphasized content.
• Theme.opacityOverlay - opacity used to render overlay content.

When disabling items by setting the enabled flag to false, the appropriate opacity will ordinarily be applied automatically, so there is no need for the developer to set this explicitly. However, in a few edge cases, or when creating custom components, the developer may need to use the Theme.opacityLow constant to apply opacity to disabled items.

In the cases where this is needed, the opacity is typically applied to the color using rgba() or explicitly as an opacity value:

 Column {
     property bool allowSelection: true

     width: parent.width
     enabled: allowSelection
     opacity: allowSelection ? 1.0 : Theme.opacityLow

     ComboBox {
         width: parent.width
         //% "Size"
         label: qsTrId("example_app-label-size")
         menu: ContextMenu {
             MenuItem {
                 //% "Small"
                 text: qsTrId("example_app-menu-small")
             }
             MenuItem {
                 //% "Medium"
                 text: qsTrId("example_app-menu-medium")
             }
             MenuItem {
                 //% "Large"
                 text: qsTrId("example_app-menu-large")
             }
         }
     }
 }

In the example above the Column's enabled property is being overriden on inheritance by an internal MouseArea.enabled flag. Disabling the Column will prevent interaction with its child components (in this case a ComboBox), but the child components will be rendered at full opacity, potentially causing confusion for the user. Explicity setting the opacity of the Column when it's disabled addresses this.

Background color of system dialogs opened on top of the application.

These properties hold standard margins:

• Theme.paddingSmall - commonly used to separate UI components by a slight margin, particularly in space-restricted areas
• Theme.paddingMedium - commonly used to separate related UI components without visually disassocating them
• Theme.paddingLarge - commonly used to divide UI components, particularly as the vertical spacing between components in a Column
• Theme.horizontalPageMargin - used between the page content and the left and right side of the display. This value is typically Theme.paddingLarge on smaller displays, e.g. phones, and can be wider on larger displays, e.g. tablets.

Margins on the left and right sides of the display should be set to Theme.horizontalPageMargin.

These properties hold standard margins:

• Theme.paddingSmall - commonly used to separate UI components by a slight margin, particularly in space-restricted areas
• Theme.paddingMedium - commonly used to separate related UI components without visually disassocating them
• Theme.paddingLarge - commonly used to divide UI components, particularly as the vertical spacing between components in a Column
• Theme.horizontalPageMargin - used between the page content and the left and right side of the display. This value is typically Theme.paddingLarge on smaller displays, e.g. phones, and can be wider on larger displays, e.g. tablets.

Margins on the left and right sides of the display should be set to Theme.horizontalPageMargin.

These properties hold standard margins:

• Theme.paddingSmall - commonly used to separate UI components by a slight margin, particularly in space-restricted areas
• Theme.paddingMedium - commonly used to separate related UI components without visually disassocating them
• Theme.paddingLarge - commonly used to divide UI components, particularly as the vertical spacing between components in a Column
• Theme.horizontalPageMargin - used between the page content and the left and right side of the display. This value is typically Theme.paddingLarge on smaller displays, e.g. phones, and can be wider on larger displays, e.g. tablets.

Margins on the left and right sides of the display should be set to Theme.horizontalPageMargin.

Can be used to scale custom layout parameters to the target resolution. In most cases custom layout parameters should be avoided; instead, base your application layouts on the platform size and padding parameters exposed through the Theme object.

These properties hold standard colors according to the current Sailfish ambience:

• Theme.primaryColor - adds emphasis to active areas of the UI
• Theme.secondaryColor - used to paint less prominent parts of the UI
• Theme.highlightColor - main color for non-interactive text and press highlights
• Theme.secondaryHighlightColor - used to paint less prominent parts of the UI in a highlighted manner
• Theme.highlightDimmerColor - used to paint the highlight color with a darker shade (for example, when dimming a region to bring attention to other areas of the UI)

"Secondary" information can refer to any text or icons that gives optional or additional information and as such do not need to receive the primary user attention. For example, the TextField placeholder text is colored with Theme.secondaryColor (and its highlighted counterpart when the field receives focus).

These properties hold standard colors according to the current Sailfish ambience:

• Theme.primaryColor - adds emphasis to active areas of the UI
• Theme.secondaryColor - used to paint less prominent parts of the UI
• Theme.highlightColor - main color for non-interactive text and press highlights
• Theme.secondaryHighlightColor - used to paint less prominent parts of the UI in a highlighted manner
• Theme.highlightDimmerColor - used to paint the highlight color with a darker shade (for example, when dimming a region to bring attention to other areas of the UI)

"Secondary" information can refer to any text or icons that gives optional or additional information and as such do not need to receive the primary user attention. For example, the TextField placeholder text is colored with Theme.secondaryColor (and its highlighted counterpart when the field receives focus).

These properties hold standard colors according to the current Sailfish ambience:

• Theme.primaryColor - adds emphasis to active areas of the UI
• Theme.secondaryColor - used to paint less prominent parts of the UI
• Theme.highlightColor - main color for non-interactive text and press highlights
• Theme.secondaryHighlightColor - used to paint less prominent parts of the UI in a highlighted manner
• Theme.highlightDimmerColor - used to paint the highlight color with a darker shade (for example, when dimming a region to bring attention to other areas of the UI)

"Secondary" information can refer to any text or icons that gives optional or additional information and as such do not need to receive the primary user attention. For example, the TextField placeholder text is colored with Theme.secondaryColor (and its highlighted counterpart when the field receives focus).

This property holds the distance a touch must move before the action will be considered a move.

Takes device-independent pixel value and returns it in respective display-specific pixels. Equivalent of multiplying the input value with Theme.pixelRatio.

Returns a highlight background color derived from a reference color and color scheme.

Returns a highlight dimmer color derived from a reference color and color scheme.

Returns a highlight color derived from a reference color and color scheme.

Searches for pattern in text and sets the color of the text.

Returns a styled text string with highlighted matches and original text escaped.

Returns an icon representing the mimeType.

 Image {
     source: Theme.iconForMimeType("text/vcard")
 }

The icon is one of image://theme/icon-m-file-

• apk
• audio
• formatted
• image
• note
• pdf
• other
• presentation
• rpm
• spreadsheet
• vcard
• video
• folder

If no suitable icon is found "image://theme/icon-m-file-other" is returned.

Returns the presence color of the given presenceMode.

The presenceMode parameter may be one of:

• Theme.PresenceAvailable - color of the available presence status
• Theme.PresenceAway - color of the away presence status
• Theme.PresenceBusy - color of the busy presence status
• Theme.PresenceOffline - color of the offline presence status

Returns RGBA color with given color and alpha channel opacity. The opacity can have values between 0.0 and 1.0.

Returns a secondary highlight color derived from a reference color and color scheme.