#![cfg_attr(not(feature = "accesskit"), allow(dead_code))]
#[cfg(feature = "accesskit")]
mod actions;
#[cfg(all(feature = "accesskit", not(target_arch = "wasm32")))]
pub(crate) mod adapter;
#[cfg(feature = "accesskit")]
mod audit;
mod collect;
#[cfg(feature = "accesskit")]
mod convert;
mod ids;
mod node;
mod role;
#[cfg(feature = "accesskit")]
#[doc(hidden)]
pub mod testing;
pub(crate) mod text;
#[cfg(feature = "accesskit")]
mod tree;
mod widget;
pub use node::AccessNode;
pub use role::{
AccessAction, AccessActionKind, AccessLive, AccessOrientation, AccessRole, AccessToggled,
};
#[cfg(feature = "accesskit")]
#[doc(hidden)]
pub use tree::AccessStats;
pub use widget::Accessible;
use crate::{text::TextLayout, Context, Id, Vec2};
use std::{collections::HashMap, sync::Arc};
pub(crate) const NO_PARENT: u32 = u32::MAX;
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub(crate) enum Geometry {
Derived,
Pending,
Placed,
}
#[derive(Clone, Copy, Debug)]
pub(crate) struct Slot {
pub parent: u32,
pub geometry: Geometry,
pub removed: bool,
}
#[must_use = "an opened accessibility scope must be closed with a11y_end"]
pub(crate) struct Scope(pub(crate) Option<u32>);
impl Scope {
pub(crate) const NONE: Self = Self(None);
}
#[derive(Default)]
pub(crate) struct Announcement {
pub text: String,
pub serial: u64,
}
#[derive(Default)]
pub(crate) struct State {
pub active: bool,
wanted: bool,
pub nodes: Vec<AccessNode>,
pub slots: Vec<Slot>,
pub stack: Vec<u32>,
pub geometry: HashMap<Id, u32>,
pub pending: HashMap<Id, Vec<AccessAction>>,
pub late_clicks: Vec<Id>,
pub clickable: std::collections::HashSet<Id>,
pub announcements: [Announcement; 2],
pub title: Option<String>,
texts: HashMap<usize, (Arc<TextLayout>, text::TextRef, u64)>,
#[cfg(feature = "accesskit")]
pub tree: tree::Snapshot,
}
impl State {
pub(crate) fn begin_pass(&mut self) {
self.active = self.wanted;
self.nodes.clear();
self.slots.clear();
self.stack.clear();
self.geometry.clear();
self.clickable.clear();
}
pub(crate) fn end_pass(&mut self, frame: u64) {
self.pending.clear();
self.texts.retain(|_, entry| entry.2 == frame);
}
pub(crate) fn take_late_clicks(&mut self) -> Vec<Id> {
std::mem::take(&mut self.late_clicks)
}
}
impl Context {
pub fn set_accessibility_active(&mut self, active: bool) {
if self.a11y.wanted == active {
return;
}
self.a11y.wanted = active;
if !active {
self.a11y.pending.clear();
#[cfg(feature = "accesskit")]
self.a11y.tree.reset();
}
self.request_repaint();
}
pub fn accessibility_active(&self) -> bool {
self.a11y.wanted
}
pub fn set_accessibility_title(&mut self, title: impl Into<String>) {
let title = title.into();
let title = (!title.is_empty()).then_some(title);
if self.a11y.title != title {
self.a11y.title = title;
if self.a11y.wanted {
self.request_repaint();
}
}
}
pub fn announce(&mut self, text: impl Into<String>) {
self.push_announcement(0, text.into());
}
pub fn announce_assertive(&mut self, text: impl Into<String>) {
self.push_announcement(1, text.into());
}
pub(crate) fn a11y_text(&mut self, text: &str, layout: &Arc<TextLayout>) -> text::TextRef {
let frame = self.frame;
let entry = self
.a11y
.texts
.entry(Arc::as_ptr(layout) as usize)
.or_insert_with(|| {
let mut model = text::TextModel::default();
model.push_text(text, &layout.lines, Vec2::ZERO);
(Arc::clone(layout), model.into(), frame)
});
entry.2 = frame;
entry.1.clone()
}
fn push_announcement(&mut self, slot: usize, text: String) {
if !self.a11y.wanted || text.is_empty() {
return;
}
let announcement = &mut self.a11y.announcements[slot];
announcement.text = text;
announcement.serial += 1;
self.request_repaint();
}
}