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.

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: 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