Document `Role::ColorWell`

Open Beginner friendly
#748 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Domain
documentation

Research direction

Search the repository for Role::ColorWell, then read the Apple Human Interface Guidelines color-wells documentation linked in the issue. Update the relevant documentation to explain that a color well is the button that opens a color picker, distinguish it from the picker itself, and include the Apple link.

Written by the indexing model from the issue text.

Description

Role::ColorWell is copied verbatim from chromium's API.

As far as I can tell, it refers to a button that opens a color picker when clicked; it refers specifically to the button, and not the color-picking widget associated to the button.

https://developer.apple.com/design/human-interface-guidelines/color-wells

I don't know how well-known the concept is; it's described in the Apple AppKit documentation and a few other frameworks, but it seems niche overall. Googling "color well" gives unhelpful results.

It's probably worth spending a few lines explaining the concept, maybe with a link to the Apple doc.

Dominant language
Rust
Stars
1.5k
Forks
114
Avg merge
8h 25m
Merged PRs (30d)
28

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from AccessKit/accesskit

All issues in AccessKit/accesskit

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.