Skip to content

Document ARIA mappings for usize properties - #757

Merged
DataTriny merged 3 commits into
AccessKit:mainfrom
blinding-pixels:Docs-usize-properties
Aug 4, 2026
Merged

Document ARIA mappings for usize properties#757
DataTriny merged 3 commits into
AccessKit:mainfrom
blinding-pixels:Docs-usize-properties

Conversation

@blinding-pixels

Copy link
Copy Markdown
Contributor

This continues the documentation work from #753 by covering the usize properties discussed in #749, using the same format established in #753.

A couple of points I would particularly appreciate confirmation on:

  • AccessKit uses zero-based indexes, whereas the corresponding ARIA properties use one-based indexes. This also led me to correct the PositionInSet documentation: its value must be less than SizeOfSet, rather than less than or equal to it.
  • AccessKit places SizeOfSet on the container, whereas ARIA places aria-setsize on each item.

I ran:

  • cargo fmt --all -- --check
  • RUSTDOCFLAGS="-D warnings" cargo doc -p accesskit --no-deps
  • cargo test -p accesskit

@DataTriny DataTriny left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just one comment.

Comment thread accesskit/src/lib.rs Outdated
/// equivalent: [`aria-rowindex`].
///
/// **Difference with ARIA:** `aria-rowindex` is one-based, while this
/// AccessKit property is zero-based.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the word AccessKit here is unnecessary. Can you remove it to the other zero-based properties below?

@DataTriny DataTriny left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Forgot about another one.

Comment thread accesskit/src/lib.rs Outdated
/// ARIA equivalent: [`aria-setsize`].
///
/// **Difference with ARIA:** `aria-setsize` is set on each item, while this
/// AccessKit property is set on the container.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// AccessKit property is set on the container.
/// property is set on the container.

@DataTriny DataTriny left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks again for this one.

@DataTriny
DataTriny merged commit f0f4723 into AccessKit:main Aug 4, 2026
26 checks passed
@blinding-pixels

Copy link
Copy Markdown
Contributor Author

My Pleasure. Working on the next one already should have that iopened in a bit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants