@ -1,8 +1,8 @@
//! Tests the accesskit accessibility output of egui.
#![ cfg(feature = " accesskit " ) ]
use accesskit ::Role ;
use egui ::{ Context , RawInput } ;
use accesskit ::{ Role , TreeUpdate } ;
use egui ::{ CentralPanel , C ontext , RawInput } ;
/// Baseline test that asserts there are no spurious nodes in the
/// accesskit output when the ui is empty.
@ -11,86 +11,133 @@ use egui::{Context, RawInput};
/// are put there because of the widgets rendered.
#[ test ]
fn empty_ui_should_return_tree_with_only_root_window ( ) {
let ctx = Context ::default ( ) ;
ctx . enable_accesskit ( ) ;
let output = ctx . run ( RawInput ::default ( ) , | ctx | {
egui ::CentralPanel ::default ( ) . show ( ctx , | _ | { } ) ;
let output = accesskit_output_single_egui_frame ( | ctx | {
CentralPanel ::default ( ) . show ( ctx , | _ | { } ) ;
} ) ;
let tree_update = output
. platform_output
. accesskit_update
. expect ( "Missing accesskit update" ) ;
let tree = tree_update . tree . unwrap ( ) ;
assert_eq ! (
tree_update . nodes . len ( ) ,
output . nodes . len ( ) ,
1 ,
"Empty ui should produce only the root window."
) ;
let ( id , root ) = & tree_update . nodes [ 0 ] ;
let ( id , root ) = & output . nodes [ 0 ] ;
assert_eq ! ( * id , tree . root ) ;
assert_eq ! ( * id , output . tree . unwrap ( ) . root ) ;
assert_eq ! ( root . role ( ) , Role ::Window ) ;
}
#[ test ]
fn button_text ( ) {
fn button_node ( ) {
let button_text = "This is a test button!" ;
let ctx = Context ::default ( ) ;
ctx . enable_accesskit ( ) ;
let output = ctx . run ( RawInput ::default ( ) , | ctx | {
egui ::CentralPanel ::default ( ) . show ( ctx , | ui | ui . button ( button_text ) ) ;
let output = accesskit_output_single_egui_frame ( | ctx | {
CentralPanel ::default ( ) . show ( ctx , | ui | ui . button ( button_text ) ) ;
} ) ;
let nodes = output
. platform_output
. accesskit_update
. expect ( "Missing accesskit update" )
. nodes ;
assert_eq ! (
output . nodes . len ( ) ,
2 ,
"Expected only the root node and the button."
) ;
let ( _ , button ) = output
. nodes
. iter ( )
. find ( | ( _ , node ) | node . role ( ) = = Role ::Button )
. expect ( "Button should exist in the accesskit output" ) ;
assert_eq ! ( button . name ( ) , Some ( button_text ) ) ;
assert ! ( ! button . is_disabled ( ) ) ;
}
#[ test ]
fn disabled_button_node ( ) {
let button_text = "This is a test button!" ;
let output = accesskit_output_single_egui_frame ( | ctx | {
CentralPanel ::default ( ) . show ( ctx , | ui | {
ui . add_enabled ( false , egui ::Button ::new ( button_text ) )
} ) ;
} ) ;
assert_eq ! (
nodes . len ( ) ,
output . nodes . len ( ) ,
2 ,
"Expected only the root node and the button."
) ;
nodes
let ( _ , button ) = output
. nodes
. iter ( )
. find ( | ( _ , node ) | node . role ( ) = = Role ::Button & & node . name ( ) = = Some ( button_text ) )
. find ( | ( _ , node ) | node . role ( ) = = Role ::Button )
. expect ( "Button should exist in the accesskit output" ) ;
assert_eq ! ( button . name ( ) , Some ( button_text ) ) ;
assert ! ( button . is_disabled ( ) ) ;
}
#[ test ]
fn toggle_button_text ( ) {
fn toggle_button_node ( ) {
let button_text = "A toggle button" ;
let ctx = Context ::default ( ) ;
ctx . enable_accesskit ( ) ;
let mut selected = false ;
let output = ctx . run ( RawInput ::default ( ) , | ctx | {
egui ::CentralPanel ::default ( ) . show ( ctx , | ui | ui . toggle_value ( & mut selected , button_text ) ) ;
let output = accesskit_output_single_egui_frame ( | ctx | {
CentralPanel ::default ( ) . show ( ctx , | ui | ui . toggle_value ( & mut selected , button_text ) ) ;
} ) ;
let nodes = output
. platform_output
. accesskit_update
. expect ( "Missing accesskit update" )
. nodes ;
assert_eq ! (
nodes . len ( ) ,
output . nodes . len ( ) ,
2 ,
"Expected only the root node and the button."
) ;
nodes
let ( _ , toggle ) = output
. nodes
. iter ( )
. find ( | ( _ , node ) | node . role ( ) = = Role ::ToggleButton & & node . name ( ) = = Some ( button_text ) )
. find ( | ( _ , node ) | node . role ( ) = = Role ::ToggleButton )
. expect ( "Toggle button should exist in the accesskit output" ) ;
assert_eq ! ( toggle . name ( ) , Some ( button_text ) ) ;
assert ! ( ! toggle . is_disabled ( ) ) ;
}
#[ test ]
fn multiple_disabled_widgets ( ) {
let output = accesskit_output_single_egui_frame ( | ctx | {
CentralPanel ::default ( ) . show ( ctx , | ui | {
ui . add_enabled_ui ( false , | ui | {
let _ = ui . button ( "Button 1" ) ;
let _ = ui . button ( "Button 2" ) ;
let _ = ui . button ( "Button 3" ) ;
} )
} ) ;
} ) ;
assert_eq ! (
output . nodes . len ( ) ,
4 ,
"Expected the root node and all the child widgets."
) ;
assert_eq ! (
output
. nodes
. iter ( )
. filter ( | ( _ , node ) | node . is_disabled ( ) )
. count ( ) ,
3 ,
"All widgets should be disabled."
) ;
}
fn accesskit_output_single_egui_frame ( run_ui : impl FnOnce ( & Context ) ) -> TreeUpdate {
let ctx = Context ::default ( ) ;
ctx . enable_accesskit ( ) ;
let output = ctx . run ( RawInput ::default ( ) , run_ui ) ;
output
. platform_output
. accesskit_update
. expect ( "Missing accesskit update" )
}
Wybe Westra
4 months ago
GitHub