use std::cell::Cell;
#[cfg(feature = "a11y-live")]
use std::cell::RefCell;
#[cfg(feature = "a11y")]
pub use accesskit::Role as AriaRole;
#[cfg(not(feature = "a11y"))]
pub use fallback::AriaRole;
#[cfg(feature = "a11y")]
pub use accesskit::NodeId;
#[cfg(not(feature = "a11y"))]
pub use fallback::NodeId;
#[cfg(feature = "a11y")]
pub mod actions;
#[cfg(feature = "a11y")]
pub mod focus;
#[cfg(all(feature = "a11y", feature = "a11y-keyboard"))]
pub mod keyboard;
#[cfg(feature = "a11y")]
pub mod roles;
#[cfg(feature = "a11y")]
pub mod tree;
#[cfg(not(feature = "a11y"))]
pub mod fallback {
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct NodeId(pub u64);
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
#[non_exhaustive]
pub enum AriaRole {
#[default]
Unknown,
}
}
pub fn parse_bool(value: &str) -> Option<bool> {
match value.trim().to_ascii_lowercase().as_str() {
"" | "true" | "1" | "yes" => Some(true),
"false" | "0" | "no" => Some(false),
_ => None,
}
}
pub fn is_disabled(element: &crate::vdom::VElement) -> bool {
use crate::vdom::NodeKind;
if element.attr("aria-disabled").and_then(parse_bool) == Some(true) {
return true;
}
match &element.kind {
NodeKind::Button { disabled, .. } | NodeKind::TextField { disabled, .. } => *disabled,
#[cfg(feature = "elements-checkbox")]
NodeKind::Checkbox { disabled, .. } => *disabled,
#[cfg(feature = "elements-radio")]
NodeKind::Radio { disabled, .. } => *disabled,
#[cfg(feature = "elements-select")]
NodeKind::Select { disabled, .. } => *disabled,
_ => false,
}
}
#[cfg(feature = "a11y-live")]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum Politeness {
Off,
#[default]
Polite,
Assertive,
}
#[cfg(all(feature = "a11y", feature = "a11y-live"))]
impl Politeness {
pub fn to_live(self) -> accesskit::Live {
match self {
Politeness::Off => accesskit::Live::Off,
Politeness::Polite => accesskit::Live::Polite,
Politeness::Assertive => accesskit::Live::Assertive,
}
}
pub fn parse(value: &str) -> Option<Self> {
match value.trim().to_ascii_lowercase().as_str() {
"off" => Some(Politeness::Off),
"polite" => Some(Politeness::Polite),
"assertive" => Some(Politeness::Assertive),
_ => None,
}
}
}
#[cfg(feature = "a11y-live")]
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Announcement {
pub message: String,
pub politeness: Politeness,
}
thread_local! {
static ENABLED: Cell<bool> = Cell::new(env_default());
static FOCUSED: Cell<Option<NodeId>> = const { Cell::new(None) };
}
#[cfg(feature = "a11y-live")]
thread_local! {
static ANNOUNCEMENTS: RefCell<Vec<Announcement>> = const { RefCell::new(Vec::new()) };
}
fn env_default() -> bool {
std::env::var("LIGHT_A11Y")
.map(|value| value.trim() != "0")
.unwrap_or(true)
}
pub fn set_enabled(enabled: bool) {
ENABLED.with(|flag| flag.set(enabled));
}
pub fn is_enabled() -> bool {
ENABLED.with(Cell::get)
}
#[cfg(feature = "a11y-live")]
pub fn announce(message: impl Into<String>, politeness: Politeness) {
if !is_enabled() {
return;
}
let announcement = Announcement {
message: message.into(),
politeness,
};
ANNOUNCEMENTS.with(|queue| queue.borrow_mut().push(announcement));
}
#[cfg(feature = "a11y-live")]
pub fn take_announcements() -> Vec<Announcement> {
ANNOUNCEMENTS.with(|queue| std::mem::take(&mut *queue.borrow_mut()))
}
pub fn focused_node() -> Option<NodeId> {
FOCUSED.with(Cell::get)
}
pub fn set_focused_node(node: Option<NodeId>) {
FOCUSED.with(|cell| cell.set(node));
}
pub fn focus(node_id: NodeId) {
set_focused_node(Some(node_id));
}
pub fn blur() {
set_focused_node(None);
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct WindowHandle {
token: crate::control::WindowToken,
}
impl WindowHandle {
pub fn token(self) -> crate::control::WindowToken {
self.token
}
pub fn focus(self, node_id: NodeId) {
focus(node_id);
}
}
pub fn active_window() -> Option<WindowHandle> {
if !is_enabled() {
return None;
}
Some(WindowHandle {
token: crate::control::active_window(),
})
}
#[cfg(all(test, feature = "a11y"))]
mod tests {
use super::*;
#[cfg(feature = "a11y-live")]
#[test]
fn announcements_are_queued_and_drained() {
set_enabled(true);
let _ = take_announcements();
announce("saved", Politeness::Assertive);
announce("updated", Politeness::Polite);
let drained = take_announcements();
assert_eq!(drained.len(), 2);
assert_eq!(drained[0].message, "saved");
assert_eq!(drained[0].politeness, Politeness::Assertive);
assert_eq!(drained[1].politeness, Politeness::Polite);
assert!(take_announcements().is_empty());
}
#[cfg(feature = "a11y-live")]
#[test]
fn disabling_suppresses_announcements_and_window() {
set_enabled(false);
announce("ignored", Politeness::Polite);
assert!(take_announcements().is_empty());
assert_eq!(active_window(), None);
set_enabled(true);
}
#[test]
fn focus_roundtrip() {
set_enabled(true);
focus(NodeId(42));
assert_eq!(focused_node(), Some(NodeId(42)));
blur();
assert_eq!(focused_node(), None);
}
#[cfg(feature = "a11y-live")]
#[test]
fn politeness_parses_case_insensitively() {
assert_eq!(Politeness::parse("POLITE"), Some(Politeness::Polite));
assert_eq!(
Politeness::parse(" assertive "),
Some(Politeness::Assertive)
);
assert_eq!(Politeness::parse("off"), Some(Politeness::Off));
assert_eq!(Politeness::parse("loud"), None);
}
}