3 files changed, 106 insertions, 0 deletions
diff --git a/src/quick/doc/snippets/qml/safearea/additional.qml b/src/quick/doc/snippets/qml/safearea/additional.qml
new file mode 100644
index 0000000000..900be5819b
--- /dev/null
+++ b/src/quick/doc/snippets/qml/safearea/additional.qml
@@ -0,0 +1,46 @@
+// Copyright (C) 2024 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+import QtQuick
+
+Window {
+    flags: Qt.ExpandedClientAreaHint | Qt.NoTitleBarBackgroundHint
+    visible: true
+
+//![0]
+Rectangle {
+    id: parentItem
+    gradient: Gradient.SunnyMorning
+    anchors.fill: parent
+
+    Rectangle {
+        id: headerItem
+        width: parent.width
+        height: 80 + parent.SafeArea.margins.top
+        gradient: Gradient.WinterNeva
+        z: 1
+    }
+
+    Item {
+        id: contentItem
+        anchors.fill: parent
+        z: 0
+
+        SafeArea.additionalMargins.top: headerItem.height
+
+        Rectangle {
+            id: childItem
+            gradient: Gradient.DustyGrass
+            anchors {
+                fill: parent
+
+                topMargin: parent.SafeArea.margins.top
+                leftMargin: parent.SafeArea.margins.left
+                rightMargin: parent.SafeArea.margins.right
+                bottomMargin: parent.SafeArea.margins.bottom
+            }
+        }
+    }
+}
+//![0]
+}
diff --git a/src/quick/doc/snippets/qml/safearea/basic.qml b/src/quick/doc/snippets/qml/safearea/basic.qml
new file mode 100644
index 0000000000..7b0620706e
--- /dev/null
+++ b/src/quick/doc/snippets/qml/safearea/basic.qml
@@ -0,0 +1,31 @@
+// Copyright (C) 2024 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+import QtQuick
+
+Window {
+    flags: Qt.ExpandedClientAreaHint | Qt.NoTitleBarBackgroundHint
+    visible: true
+
+//![0]
+Rectangle {
+    id: parentItem
+    gradient: Gradient.SunnyMorning
+    anchors.fill: parent
+
+    Rectangle {
+        id: childItem
+        gradient: Gradient.DustyGrass
+
+        anchors {
+            fill: parent
+
+            topMargin: parent.SafeArea.margins.top
+            leftMargin: parent.SafeArea.margins.left
+            rightMargin: parent.SafeArea.margins.right
+            bottomMargin: parent.SafeArea.margins.bottom
+        }
+    }
+}
+//![0]
+}
diff --git a/src/quick/doc/snippets/qml/safearea/controls.qml b/src/quick/doc/snippets/qml/safearea/controls.qml
new file mode 100644
index 0000000000..67bbb13a8f
--- /dev/null
+++ b/src/quick/doc/snippets/qml/safearea/controls.qml
@@ -0,0 +1,29 @@
+// Copyright (C) 2024 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+import QtQuick
+import QtQuick.Controls
+
+Window {
+    flags: Qt.ExpandedClientAreaHint | Qt.NoTitleBarBackgroundHint
+    visible: true
+
+//![0]
+Control {
+    anchors.fill: parent
+
+    background: Rectangle {
+        gradient: Gradient.SunnyMorning
+    }
+
+    topPadding: SafeArea.margins.top
+    leftPadding: SafeArea.margins.left
+    rightPadding: SafeArea.margins.right
+    bottomPadding: SafeArea.margins.bottom
+
+    contentItem: Rectangle {
+        gradient: Gradient.DustyGrass
+    }
+}
+//![0]
+}