1.8.2. Typical Browser Regions¶
This document details a list of common regions required for a new WebBrowser instance. In many cases, using these names for the described purpose will let the new class inherit the right functionality.
The regions should typically be stored with the following directory
structure under the images/ directory and in the directory for the
right image type (most often qemu/). These should then be in the
browser/ directory and use a set of sub directories corresponding to
the browser type (e.g., chrome/), version (e.g., 63), platform
(e.g., win10), and desktop theme (e.g., default).
Region Name |
Description |
|---|---|
back |
The Back button |
closeButton |
Button to close the download progress area |
closePasswordBox |
Button to close the Remember Password box |
closeTabsButton |
Button to confirm closing multiple tabs |
confirmLeave |
Confirm leaving the page even if there is unsubmitted data |
desktopIcon |
The icon on the desktop that launches this app |
desktopIconSelected |
The icon on the desktop that launches this app when it is selected (highlighted) |
downloadBarClose |
Button to close any download bar/status area |
downloadCompleteDialog |
Region that indicates a dialog opened after a download competed |
downloadDialog |
Indicates there is a Download dialog window |
downloadDone |
Region that indicates the download is complete |
downloadGoing |
Region that indicates a download is ongoing |
forward |
The Forward button |
needsConfig |
Indicates that the application needs to be configured, usually on first use |
noBack |
Region showing that there is no Back available |
reloadButton |
Button to reload the current page |
rememberPasswordBox |
Region indicating the browser is offering to remember login information |
splashScreen |
Indicates the splash screen is being shown while the application is opening |
startMenuFolder |
The folder in the start menu to click to find the icon to launch the app |
startMenuSmallItem |
The icon within the folder to click to launch the app |
startMenuBigItem |
The large image for this app that shows up in the start menu. Some versions of Windows have large images for favorite/frequent apps |
stopButton |
Button to stop the current page from continuing to load |
taskbarFocused |
The icon in the “taskbar” when this application is open and has focus |
taskbarUnfocused |
The icon in the “taskbar” when this application is open and does not have focus |
Of course, most browsers will require some deviation for this list, either for additional common buttons or for alternate versions of some of these that do not have alternates on other systems.