<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/AccessibilityChildBehavior/contain",
  "metadataVersion" : "0.1.0",
  "role" : "Type Property",
  "symbol" : {
    "kind" : "Type Property",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI26AccessibilityChildBehaviorV7containACvpZ"
  },
  "title" : "contain"
}
-->

# contain

Any child accessibility elements become children of the new
accessibility element.

```
static let contain: AccessibilityChildBehavior
```

## Discussion

Use this behavior when you want a view to be an accessibility
container. An accessibility container groups child accessibility
elements which improves navigation. For example, all children
of an accessibility container are navigated in order before
navigating through the next accessibility container.

```
var body: some View {
    ScrollView {
        VStack {
            HStack {
                ForEach(users) { user in
                    UserCell(user)
                }
            }
            .accessibilityElement(children: .contain)
            .accessibilityLabel("Users")

            VStack {
                ForEach(messages) { message in
                    MessageCell(message)
                }
            }
            .accessibilityElement(children: .contain)
            .accessibilityLabel("Messages")
        }
    }
}
```

A new accessibility element is created when:

- The view contains multiple or zero accessibility elements.
- The view contains a single accessibility element with no children.

> Note: If an accessibility element is not created, the
> ``doc://com.apple.SwiftUI/documentation/SwiftUI/AccessibilityChildBehavior`` of the existing
> accessibility element is modified.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)