Skip to content

[docs] Talking about accessibility, why do you use the blue color for non-links? #4009

@binarykitchen

Description

@binarykitchen

How can we improve Base UI documentation?

Great documentation and language. Since you promote accessibility, and it's a top-priority, I wonder why you style some words in blue which isn't clickable?

Image

https://base-ui.com/react/utils/merge-props

I don't use a screen reader nor am disabled, although whenever I see a word in blue it makes me believe it's a link, clickable.
Because browser defaults display links in blue.

I've clicked on "mergeProps helps you combine" ... multiple times and wondered why it didn't go to the next page? 😅
My recommendation: when it's not a link, don't use blue but display it differently. Perhaps in bold, or really use links and underline them.

Hope this helps.

Metadata

Metadata

Assignees

No one assigned

    Labels

    accessibilitya11ydocsImprovements or additions to the documentation.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions