scanner-core/com.composea11yscanner.core.model/A11yNode

A11yNode

data class A11yNode(val nodeId: String, val composableName: String, val bounds: Rect, val contentDescription: String?, val isTouchTarget: Boolean, val textColor: Color?, val backgroundColors: List<Color>, val isFocusable: Boolean, val isMergedDescendant: Boolean, val depth: Int, val role: A11yRole? = null, val effectiveTouchBounds: Rect? = null, val parentNodeId: String? = null, val isEnabled: Boolean = true, val isCollectionContainer: Boolean = false, val textLabel: String? = null, val hasExplicitContentDescription: Boolean = false, val isTraversalGroup: Boolean = false, val unclippedBounds: Rect? = null, val isVisibleToUser: Boolean = true)

Normalized representation of one UI semantics node scanned by the accessibility rules.

Constructors

A11yNode

constructor(nodeId: String, composableName: String, bounds: Rect, contentDescription: String?, isTouchTarget: Boolean, textColor: Color?, backgroundColors: List<Color>, isFocusable: Boolean, isMergedDescendant: Boolean, depth: Int, role: A11yRole? = null, effectiveTouchBounds: Rect? = null, parentNodeId: String? = null, isEnabled: Boolean = true, isCollectionContainer: Boolean = false, textLabel: String? = null, hasExplicitContentDescription: Boolean = false, isTraversalGroup: Boolean = false, unclippedBounds: Rect? = null, isVisibleToUser: Boolean = true)

Properties

backgroundColors

val backgroundColors: List<Color>

Candidate background colors sampled behind the node.

bounds

val bounds: Rect

Pixel bounds relative to the scanned root.

composableName

val composableName: String

Best-effort composable or role name used in reports.

contentDescription

val contentDescription: String?

Accessible label exposed by the node, if any.

depth

val depth: Int

Depth in the semantics tree.

effectiveTouchBounds

val effectiveTouchBounds: Rect?

Effective pointer target bounds in root pixels for clickable nodes.

hasExplicitContentDescription

val hasExplicitContentDescription: Boolean

True when contentDescription came from Compose's ContentDescription semantics rather than falling back to textLabel.

isCollectionContainer

val isCollectionContainer: Boolean

True when the node exposes semantic collection information.

isEnabled

val isEnabled: Boolean

False when the node or one of its semantic ancestors is disabled.

isFocusable

val isFocusable: Boolean

True when the node can participate in focus traversal.

isMergedDescendant

val isMergedDescendant: Boolean

True when the node is inside a parent that merges semantics.

isTouchTarget

val isTouchTarget: Boolean

True when the node exposes a click action.

isTraversalGroup

val isTraversalGroup: Boolean

Whether this node establishes a separate accessibility traversal scope.

isVisibleToUser

val isVisibleToUser: Boolean

False for context-only nodes that must not receive an issue highlight.

nodeId

val nodeId: String

Stable id for grouping issues that belong to the same semantics node.

parentNodeId

val parentNodeId: String?

Id of the immediate parent in the unmerged semantics tree, or null for the root. Rules use this to distinguish true siblings from unrelated nodes at the same depth.

role

val role: A11yRole?

Accessibility role mapped from the platform semantics role, if any.

textColor

val textColor: Color?

Foreground text color when it can be extracted.

textLabel

val textLabel: String?

Visible semantic text TalkBack can append to contentDescription. Keeping this separate lets rules reason about the complete spoken label instead of treating a shared prefix, such as "Book cover image", as the whole accessible name.

unclippedBounds

val unclippedBounds: Rect?

Full layout bounds, including content clipped by a scrolling viewport.