Skip to content
Navius WPF

VisuallyHidden

Overview

Section titled “Overview”

VisuallyHidden hides content visually while keeping it in the accessibility tree, via the spec’s exact sr-only CSS technique (absolute-positioned, 1x1px, clipped, non-overflowing), rather than display:none or aria-hidden, either of which would remove the content from the accessibility tree entirely.

Status on WPF

Section titled “Status on WPF”

Retired per ADR-0003. WPF’s AutomationPeer/AutomationProperties.Name model exposes accessible names independently of visual rendering, so there is no DOM-text-vs-CSS-visibility split for a clip-rect trick to solve. Consumers set AutomationProperties.Name (or override AutomationPeer.GetNameCore()) directly on the control that needs an accessible name. NaviusAccessibleIcon (see the AccessibleIcon manifest) is the concrete example of this replacement pattern in the shipped code: it applies AutomationProperties.SetName directly to its content instead of wrapping a hidden text node.

Web deltas

Section titled “Web deltas”
  • No NaviusVisuallyHidden control ships; there is no hidden-span element to wrap content in.
  • The underlying problem it solves in HTML, native assistive technology reading DOM text regardless of CSS visibility unless explicitly hidden, does not have a matching problem in WPF, where AutomationProperties.Name is the idiomatic way to supply AT-only text in the first place.