Add docs on soreau's panel-focus plugin

roundabout,
created on Tuesday, 12 August 2025, 20:52:37 (1755031957), received on Tuesday, 12 August 2025, 20:52:40 (1755031960)
Author identity: Vlad <vlad.muntoiu@gmail.com>

                                
                                
                                
                            
                                
                                    
                                        1 +
                                        Accessibility support
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        2 +
                                        =====================
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        3 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        4 +
                                        The Panorama panel is not yet tested for accessibility, however it is considered
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        5 +
                                        in the design.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        6 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        7 +
                                        Keyboard usage
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        8 +
                                        --------------
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        9 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        10 +
                                        Get a plugin like
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        11 +
                                        [wf-panel-focus by Scott Moreau (for Wayfire)](https://github.com/soreau/wf-panel-focus)
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        12 +
                                        which will add a keybinding to cycle between displayed panels (default:
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        13 +
                                        Control-Alt-Tab) and one to return to the working area (Control-Alt-Esc). Enable
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        14 +
                                        `can_capture_keyboard` on your panels so it will be able to be focused.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        15 +
                                        Then you can use normal GTK widget navigation in the panel.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        16 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        17 +
                                        If you enable that option without a suitable plugin, panels can be focused in
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        18 +
                                        Wayfire by clicking them, which is not the expected UX, so don't enable it
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        19 +
                                        without an appropriate setup.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                            
                                

                                
                                
                                
                            
                                
                                    
                                        
                                            14  
                                            * `autohide`: whether the panel automatically hides leaving only 1px
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            15  
                                            * `hide_time`: the duration in ms of the sliding animation (not applicable
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            16  
                                              if `autohide` is `false`)
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        17 +
                                        * `can_capture_keyboard`: whether the panel can receive keyboard focus
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        18 +
                                          (works best with special compositor setup; check
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        19 +
                                          [accessibility.md](accessibility.md) for details)
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            20  
                                            * `applets`: a dictionary with keys `left`, `centre`, `right`; they are actually
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            21  
                                              named wrong and are start/centre/end areas, each key has a list of applets,
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            22  
                                              each applet is described by a dictionary with a single key being the class