Error: What prevents the Layers panel from announcing layer names to macOS VoiceOver?

The Cause of Silent Layer Navigation

The failure of macOS VoiceOver to announce layer names in the Layers panel is typically caused by a disconnect between the application's custom UI rendering and the NSAccessibility protocol. When the Layers panel fails to map the visual text of a layer to the AXLabel or AXDescription attributes, VoiceOver perceives the element as an unlabeled object, resulting in silence or a generic "group" announcement.

Accessibility API Gaps

For VoiceOver to announce a layer, the individual item must possess three critical properties in the accessibility tree:

• Role: The item must be defined as an AXRow or AXStaticText. If the panel is treated as a single custom-drawn canvas, the system cannot distinguish individual layers.
• Name/Label: The layer's name must be explicitly passed to the AXLabel attribute.
• Value/State: Visibility (the "eye" icon) must be mapped to a state attribute (e.g., AXValue or a custom toggle state) to be announced alongside the name.

Focus Order and Visibility Issues

Unexpected focus order occurs when the accessibility hierarchy is not linear. If the Layers panel uses a virtualized list (loading only visible items), scrolling can cause the accessibility focus to jump or lose its anchor. If the visibility state is a separate child element without a proper label, VoiceOver may skip it entirely or announce it as an "unlabeled button," separating the visibility status from the layer name.

Risk Factors and Environmental Conditions

This issue is most pronounced under the following conditions:

• Custom Workspaces: Non-standard panel docking or floating windows can occasionally disrupt the focus path in older versions of the Accessibility API.
• Version Mismatches: Updates to macOS that change how NSAccessibility handles custom-drawn components can break existing mappings in Photoshop CC versions that have not been patched.

Verification Steps

To determine if the attributes are missing, use the Accessibility Inspector (included with Xcode):

1. Launch the Accessibility Inspector.
2. Hover over a specific layer in the Photoshop Layers panel.
3. Check the Label and Role fields. If these are empty or listed as "Unknown," the application is not exposing the necessary data to macOS.

Diagnostic Detail Needed: Are you using a floating Layers panel or one docked into a standard workspace? This determines if the issue is a hierarchy nesting error or a missing attribute error.