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.


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: If you want to style a control, you should set both the background and the contentItem, rather than just one of them. This is because the macOS style will in some cases draw both the contents and the background into the default background item, which will not look good if the application combines this with a custom contentItem. By setting them both, you are guaranteed that the control will look the same on all platforms, for all styles.

See also Styling Qt Quick Controls

© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.