Skip to content

Various accessibility API updates. #9989

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 6 commits into from
Oct 2, 2023
Merged

Various accessibility API updates. #9989

merged 6 commits into from
Oct 2, 2023

Conversation

@ndarilek
Copy link
Contributor

@ndarilek ndarilek commented Oct 1, 2023 •
edited
Loading

Objective

bevy_a11y was impossible to integrate into some third-party projects in part because it insisted on managing the accessibility tree on its own.

Solution

The changes in this PR were necessary to get bevy_egui working with Bevy's AccessKit integration. They were tested on a fork of 0.11, developed against bevy_egui, then ported to main and tested against the ui example.

Changelog

Changed

  • Add bevy_a11y::ManageAccessibilityUpdates to indicate whether the ECS should manage accessibility tree updates.
  • Add getter/setter to bevy_a11y::AccessibilityRequested.
  • Add bevy_a11y::AccessibilitySystem SystemSet for ordering relative to accessibility tree updates.
  • Upgrade accesskit to v0.12.0.

Fixed

  • Correctly set initial accessibility focus to new windows on creation.

Migration Guide

Change direct accesses of AccessibilityRequested to use AccessibilityRequested.::get()/AccessibilityRequested::set()

Before

use std::sync::atomic::Ordering;

// To access
accessibility_requested.load(Ordering::SeqCst)
// To update
accessibility_requested.store(true, Ordering::SeqCst);

After

// To access
accessibility_requested.get()
// To update
accessibility_requested.set(true);

@ndarilek
Various accessibility API updates.
facf9c0 
* Add `bevy_a11y::ManageAccessibilityUpdates` to indicate whether the ECS should manage tree updates.
* Add getter/setter to `bevy_a11y::AccessibilityRequested`.
* Add `bevy_a11y::AccessibilitySystem` `SystemSet` for ordering relative to accessibility tree updates.
* Correctly set initial focus to new windows on creation.
@alice-i-cecile alice-i-cecile added A-Accessibility A problem that prevents users with disabilities from using Bevy A-UI Graphical user interfaces, styles, layouts, and widgets P-High This is particularly urgent, and deserves immediate attention labels Oct 2, 2023
@alice-i-cecile alice-i-cecile added this to the 0.12 milestone Oct 2, 2023
@viridia
Copy link
Contributor

viridia commented Oct 2, 2023

One of the checks failed, looks like a problem with the Cargo.lock file, has a duplicate entry. Since the PR doesn't include Cargo.lock you be able to re-run the tests or rebase.

@ndarilek
Copy link
Contributor Author

ndarilek commented Oct 2, 2023

Interesting, thanks, any idea how a duplicate entry got in there? Didn't even know that was possible.

Dimchikkk
Dimchikkk reviewed Oct 2, 2023
View reviewed changes
alice-i-cecile
alice-i-cecile reviewed Oct 2, 2023
View reviewed changes
alice-i-cecile
alice-i-cecile approved these changes Oct 2, 2023
View reviewed changes
Copy link
Member

@alice-i-cecile alice-i-cecile left a comment

Choose a reason for hiding this comment

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

Seems fine :) Suggestions are non-blocking.

@ndarilek
Copy link
Contributor Author

ndarilek commented Oct 2, 2023

I'm not clear where the conflict is, I merged main and everything went fine. Is this a github bug or am I genuinely missing something?

@ndarilek
Copy link
Contributor Author

ndarilek commented Oct 2, 2023

OK, maybe that got it, just spotted the link to resolve.

@alice-i-cecile alice-i-cecile added the S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it label Oct 2, 2023
@alice-i-cecile alice-i-cecile added this pull request to the merge queue Oct 2, 2023
Merged via the queue into bevyengine:main with commit 73e0ac2 Oct 2, 2023
ameknite pushed a commit to ameknite/bevy that referenced this pull request Oct 3, 2023
@ndarilek @Dimchikkk @ameknite
Various accessibility API updates. (bevyengine#9989)
e0e6895 
# Objective

`bevy_a11y` was impossible to integrate into some third-party projects
in part because it insisted on managing the accessibility tree on its
own.

## Solution

The changes in this PR were necessary to get `bevy_egui` working with
Bevy's AccessKit integration. They were tested on a fork of 0.11,
developed against `bevy_egui`, then ported to main and tested against
the `ui` example.

## Changelog

### Changed

* Add `bevy_a11y::ManageAccessibilityUpdates` to indicate whether the
ECS should manage accessibility tree updates.
* Add getter/setter to `bevy_a11y::AccessibilityRequested`.
* Add `bevy_a11y::AccessibilitySystem` `SystemSet` for ordering relative
to accessibility tree updates.
* Upgrade `accesskit` to v0.12.0.

### Fixed

* Correctly set initial accessibility focus to new windows on creation.

## Migration Guide

### Change direct accesses of `AccessibilityRequested` to use
`AccessibilityRequested.::get()`/`AccessibilityRequested::set()`

#### Before

```
use std::sync::atomic::Ordering;

// To access
accessibility_requested.load(Ordering::SeqCst)
// To update
accessibility_requested.store(true, Ordering::SeqCst);
```

#### After

```
// To access
accessibility_requested.get()
// To update
accessibility_requested.set(true);
```

---------

Co-authored-by: StaffEngineer <[email protected]>
@cart cart mentioned this pull request Oct 13, 2023
Merged
43 tasks
regnarock pushed a commit to regnarock/bevy that referenced this pull request Oct 13, 2023
@ndarilek @Dimchikkk
Various accessibility API updates. (bevyengine#9989)
43e3e0f 
# Objective

`bevy_a11y` was impossible to integrate into some third-party projects
in part because it insisted on managing the accessibility tree on its
own.

## Solution

The changes in this PR were necessary to get `bevy_egui` working with
Bevy's AccessKit integration. They were tested on a fork of 0.11,
developed against `bevy_egui`, then ported to main and tested against
the `ui` example.

## Changelog

### Changed

* Add `bevy_a11y::ManageAccessibilityUpdates` to indicate whether the
ECS should manage accessibility tree updates.
* Add getter/setter to `bevy_a11y::AccessibilityRequested`.
* Add `bevy_a11y::AccessibilitySystem` `SystemSet` for ordering relative
to accessibility tree updates.
* Upgrade `accesskit` to v0.12.0.

### Fixed

* Correctly set initial accessibility focus to new windows on creation.

## Migration Guide

### Change direct accesses of `AccessibilityRequested` to use
`AccessibilityRequested.::get()`/`AccessibilityRequested::set()`

#### Before

```
use std::sync::atomic::Ordering;

// To access
accessibility_requested.load(Ordering::SeqCst)
// To update
accessibility_requested.store(true, Ordering::SeqCst);
```

#### After

```
// To access
accessibility_requested.get()
// To update
accessibility_requested.set(true);
```

---------

Co-authored-by: StaffEngineer <[email protected]>
@ndarilek ndarilek mentioned this pull request Oct 23, 2023
Closed
rdrpenguin04 pushed a commit to rdrpenguin04/bevy that referenced this pull request Jan 9, 2024
@ndarilek @Dimchikkk
Various accessibility API updates. (bevyengine#9989)
ee09f2b 
# Objective

`bevy_a11y` was impossible to integrate into some third-party projects
in part because it insisted on managing the accessibility tree on its
own.

## Solution

The changes in this PR were necessary to get `bevy_egui` working with
Bevy's AccessKit integration. They were tested on a fork of 0.11,
developed against `bevy_egui`, then ported to main and tested against
the `ui` example.

## Changelog

### Changed

* Add `bevy_a11y::ManageAccessibilityUpdates` to indicate whether the
ECS should manage accessibility tree updates.
* Add getter/setter to `bevy_a11y::AccessibilityRequested`.
* Add `bevy_a11y::AccessibilitySystem` `SystemSet` for ordering relative
to accessibility tree updates.
* Upgrade `accesskit` to v0.12.0.

### Fixed

* Correctly set initial accessibility focus to new windows on creation.

## Migration Guide

### Change direct accesses of `AccessibilityRequested` to use
`AccessibilityRequested.::get()`/`AccessibilityRequested::set()`

#### Before

```
use std::sync::atomic::Ordering;

// To access
accessibility_requested.load(Ordering::SeqCst)
// To update
accessibility_requested.store(true, Ordering::SeqCst);
```

#### After

```
// To access
accessibility_requested.get()
// To update
accessibility_requested.set(true);
```

---------

Co-authored-by: StaffEngineer <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@alice-i-cecile alice-i-cecile alice-i-cecile approved these changes

@nicoburns nicoburns Awaiting requested review from nicoburns

@viridia viridia Awaiting requested review from viridia

+2 more reviewers

@geom3trik geom3trik geom3trik approved these changes

@Dimchikkk Dimchikkk Dimchikkk approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

A-Accessibility A problem that prevents users with disabilities from using Bevy A-UI Graphical user interfaces, styles, layouts, and widgets P-High This is particularly urgent, and deserves immediate attention S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it

Projects

None yet

Milestone

0.12

Development

Successfully merging this pull request may close these issues.

5 participants

@ndarilek @viridia @alice-i-cecile @geom3trik @Dimchikkk