macOS Style | Qt Quick Controls 6.4.0

- Qt 6.4
- Qt Quick Controls
- macOS Style
- Qt 6.4.0 Reference Documentation

# macOS Style

The macOS style is a style that looks native on macOS. More...

Import Statement: | import QtQuick.Controls.macOS
Since: | Qt 6.0

The macOS style is a style that looks native on macOS. The controls are drawn run-time using native frameworks, and is therefore only available for applications running on macOS.

Note: Be aware that the apperance of this style can change from one minor Qt version to the next, to better blend in with native applications on the platform.

The macOS style in light theme | The macOS style in dark theme

To run an application with the macOS style, see Using Styles in Qt Quick Controls.

### Current state

The macOS style is under development, and some controls are not yet supported. Those controls are: BusyIndicator, DelayButton, PageIndicator, RangeSlider, Switch, TabBar and Tumbler. Those will fall back to use the Fusion Style.

### Customization

The goal of the macOS style is to for the controls look and feel as similar as possible to the native controls in UIKit. The style will follow the theme and colors configured globally from System Preferences, and does not come with a separate customization API on top of that.

Note: The macOS style is not suitable for customizing. The main reason is that it sometimes draw both the contents and the background onto a single background item, which will not look good together with a custom contentItem. It also tends to use padding and inset values that are different from the other styles. It is instead recommended to always base a customized control on top of a single style that is available on all platforms, e.g Basic Style, Fusion Style, Imagine Style, Material Style, Universal Style. By doing so, you are guaranteed that it will always look the same, regardless of which style the application is run with. For example:

     import QtQuick.Controls.Basic as Basic

     Basic.SpinBox {
         background: Rectangle { /* ... */ }
     }

See also Styling Qt Quick Controls