traversalParentIdentifier property

Object? traversalParentIdentifier
final

Provides an identifier for establishing parent-child relationships in the semantics traversal tree.

This property is used to create a logical parent-child relationship between semantics nodes that may not be directly connected in the widget tree. It's primarily used with OverlayPortal to ensure proper accessibility traversal order when overlay content needs to be semantically connected to its parent widget.

When a semantics node has a traversalParentIdentifier, it indicates that this node can act as a parent for other nodes that reference this identifier in their traversalChildIdentifier. This allows assistive technologies to navigate the UI in the correct logical order.

The traversalParentIdentifier must be unique in the semantics. No two semantics node can have the same traversalParentIdentifier. This unique identifier serves as the only reference for its traversal children. To graft other nodes as the traversal children of this node, assign this same value to their traversalChildIdentifier.

Implementation

final Object? traversalParentIdentifier;