w3c/core-aam

aria-describedby should not map to UIA_DescribedBy on UIA

benbeaudry opened this issue · 2 comments

While they share the same name, the definition of the UIA_DescribedBy property actually matches the definition of aria-details.

The UIA expectations for the aria-describedby attribute should be only:

Property: FullDescription:
See also: Name Computation

It seems like the UIAutomation docs call out that aria-describedby maps to UIA DescribedBy, although it's possible that table is a little outdated since aria-channel is apparently still an entry on there ~16 years after its removal.

Would it be possible to ask one of the contributors on that article to fix that mapping to map to FullDescription instead? Otherwise, I think this could possibly be a point of confusion.

Good catch, I've reached out to folks at Microsoft to bring a much-needed update to this doc.