Esta sección proporciona estilos de salida para cada papel accesible relevante . POR HACER: este es un trabajo en progreso y será completado a través de un proceso prototipo iterativo que incluye un feedback de los usuarios finales.
Para el braille, hay dos modos de verbosidad. El primero es el nivel más verboso para utilizar con las líneas braille y por aquellos usuarios que no sean expertos con el ambiente de escritorio Gnome. El segundo nivel más breve es para aquellos que están utilizando una línea más pequeña o que son expertos con el ambiente Gnome. Con braille, Orca siempre debería hacer un esfuerzo para mostrar tantos elementos actuales con el foco como le sea possible, y el usuario nunca debería estar a la izquierda con un espacio completamente en blanco al menos que esté en una línea vacía en el editor de texto.
Un estilo general para mostrar braille es como sigue: la línea será creada con varias regiones y una tentativa sería hacer iniciar la mayoría de las regiones significativas por una "posición de inicio" dada". La idea detrás de la posición inicial es que será la celda braille de la elección del usuario (ej., la primera celda de la línea braille, la mitad de la línea braille, etc.) que el usuario puede navegar cíclicamente. En el caso que la línea sea demasiado larga para el display físico, la posición inicial se aplicará y la línea será cortada por la izquierda y/o derecha como sea preciso; el usuario puede utilizar las acciones de deslizamiento para ver la información cortada. Las regiones de la línea siguen un patrón general:
Verboso: etiqueta contexto [valor] rolename
Breve: etiqueta contexto [valor]
Dónde:
contexto es información a cerca del contenedor del foco. Ejemplos incluye "calculator window," "escritorio," "diálogo guardar como," "alerta de poco espacio en disco," etc. POR HACER: El contexto puede ser compuesto de contextos anidados (ej., una page pestaña en un diálogo); Necesitamos decidir qué contexto es (ej., ¿agrupación lógica visual de objetos?)
etiqueta es la etiqueta del objeto, normalmente obtenido por el nombre del objeto o el texto de la etiqueta que etiqueta al objeto . Ejemplos incluye "Fichero," "aceptar," "Primer Nombre:," "Volumen:," etc. La etiqueta es normalmente vista como la región más significativa.
[valor] (opcional) es el valor del objeto, y varía dependiendo del tipo de objeto. Por ejemplo, "<x>" para una casilla de verificación , "70%" para una barra de desplazamiento, y "Mike Pedersen" para un campo de texto.
rolename es una cadena localizada representando el nombre del papel del objeto. El usuario puede seleccionar entre todos los rolenames (ej., "casilla de verificación," "elemento de menú," "botón") o rolenames abreviados (ej., "chk," "mit," "pbt"). Nota que el rolename podría también aparecer en modo breve si el papel del objeto no está claro desde la etiqueta y el contexto es circundante.
El cursor braille (ej., puntos 7 y 8 en la línea braille) será utilizado para indicar información relevante como tal. Por ejemplo, el cursor indicará la posición en las áreas de texto, y el cursor también será utilizado para indicar el elemento de menú con el foco.
Finalmente, los sensores de cursor en las líneas braille "harán la cosa adecuada." cuando se esté en modo seguimiento del foco, pulsando cualquier sensor de cursor asociado con la mayoría de los objetos llevará a cabo la acción predeterminada para ese objeto; La excepción obvia son las áreas de texto, donde el sensor de cursor moverá el cursor de texto a ese objeto. POR HACER: define qué sucede en revisión plana - esto podría mover el foco del teclado al objeto, llevando a cabo un clic, etc.
Para la voz, hay dos niveles de verbosidad. El primero es un nivel más verboso para utilizar por aquellos usuarios que no son expertos con el ambiente de escritorio Gnome o aquellos que gustan de escuchar más información. El segundo, modo más breve, es para aquellos que son expertos con el ambiente Gnome.
POR HACER: discute el Estilo general.
Una etiqueta aceleradora es una cadena corta que aparece al final del texto para un elemento de menú (ej, "CTRL+Z"), y define las combinaciones que llamarán a las acciones asociadas con un elemento de menú.
EJEMPLO: gnome-terminal: el elemento de menú "Pegar" en el menú "Edición" tiene una tecla rápida.
PROBLEMA CONOCIDO: debería ser bueno para poder obtener información de límites de texto para la aceleradora de texto, pero esto no parece ser possible con las implementaciones existentes.
Cuando se presenta, la aceleradora siempre será presentada después del elemento y antes del marcador que separa los elementos de menú . El texto braille para la aceleradora aparecerá entre paréntesis sin espacio antes de la apertura de paréntesis. Las etiquetas aceleradoras solamente serán presentadas en modo verboso, y solamente aparecerán para el elemento de menú con el foco. En el caso que haya otras cosas para mostrar (ej., botones de verificación o rolenames), la aceleradora aparecerá por la extrema derecha.
Ejemplo verboso: el menú ver muestra mumble <x>(CTRL+M) _ zoom in _ ...
Ejemplo breve: el menú ver muestra mumble <x> _ zoom in _ ...
Ejemplo verboso: mumble menu item control m
Ejemplo breve: mumble
EJEMPLO: gtk-demo: "Cuadros de Diálogo y Mensaje" demo; hacer clic sobre el botón "Message Dialog". La ventana "Información" que aparece es una alerta.
PROBLEMA CONOCIDO: El AT-SPI hace una distinción entre alertas y diálogos. pero, aparece según el role "alerta" sea aplicado sólo acerca de cualquier diálogo.
Cualquier ventana, sobre todo si es una alerta, diálogo,marco, o ventana, aparecerá como la región de contexto en la línea braille. La cadena de contexto consistirá en el título de la ventana segudi de su role. El resto de la línea braille consistirá en información describiendo el objeto con el foco en la ventana. La información seguirá las reglas de presentación para el tipo de role dado.
En el caso de la "alerta", el role del contexto será "alerta."
Ejemplo verboso: alerta de poco espacio en disco
Ejemplo breve: alerta poco espacio en disco
Cuando se muestra un diálogo, su título será verbalizado seguido por el exto estático relevante seguido por el objeto activo.
Ejemplo verboso: "diálogo poco espacio en disco. Sólo tienes 10mb de espacio restante en disco. Por favor elimina algunos archivos. Aceptar Botón.
Ejemplo breve: "Diálogo poco espacio en disco. Solo tienes 10mb de espacio restante en disco. Por favor elimina algunos archivos. Aceptar Botón.
Una animación contiene una imagen dinámica o en movimiento.
EJEMPLO: Desconocido.
POR HACER: Esto debería seguir un patrón de "etiqueta descripción role" para ser más consistente con el estilo generalizado?
Ejemplo verboso: animación: bici siendo montada.
Ejemplo breve: animación: bici siendo montada.
Orca dirá el rollo seguido de cualquier información descriptiva.
Ejemplo verboso: animación: bici siendo montada.
Ejemplo breve: animación: bici siendo montada.
Una flecha es un indicador direccional en 2D.
EJEMPLO: desconocido.
PROBLEMA CONOCIDO: AT-SPI no parece tener un modo para determinar qué dirección apunta la flecha.
PROBLEMA CONOCIDO: gail/gail/gailarrow.c ajusta el role to ATK_ROLE_ICON.
Una flecha será representada por la dirección a la que está apuntando la flecha seguido por "flecha." Cualquier sensor de cursor asociado con el texto hará clic la flecha. POR HACER: debería aparecer el nombre del role "flecha" en modo breve?
Ejemplo verboso: flecha a la izquierda
Ejemplo breve: flecha arriba
Orca verbalizará la dirección junto con "flecha."
Ejemplo verboso: flecha izquierda
Ejemplo breve: flecha arriba
Una casilla de verificación representa una elección que puede ser verificada o desverificada y proporciona un indicador para el estado actual.
EJEMPLO: gnome-terminal: "Editar" -> "Perfil Actual..."; la pestaña "General" tiene un número de casillas de verificación.
EJEMPLO: gtk-demo: "Tree Store" demo. La mayoría de las celdas de la tabla son casillas de verificación. PROBLEMA CONOCIDO: AT-SPI nos dice que estas son celdas de tabla, no casillas de verificación.
El estado de una casilla de verificación será representado por "< >" si está desverificada y "<x>" si está verificada. Cualuqier sensor de cursor asociado hará clic en la casilla de verificación.
Ejemplo verboso: guardar contraseña: casilla de verificación < >
Ejemplo breve: guardar contraseña: <x>
Orca reunió la etiqueta seguida por las palabras "casilla de verificación" seguido por su estado.
Ejemplo verboso: guardar contraseña casílla de verificación verificado
Ejemplo Breve: guardar contraseña verificado
Un menú verificable representa un elemento de menú que puede ser verificado o desverificado y proporciona un indicador para el estado actual.
EJEMPLO: gnome-terminal: el menú "Ver" contiene elementos de menú verificables.
PROBLEMA CONOCIDO: Aparece sinembargo como algunos juegos de herramientas permiten elementos de menú tener hijos (mirar la demo de 'Menús' de la aplicación gtk-demo - los elementos del menú radio tienen submenús). Esto necesita ser tomado en cuenta.
Todos los elementos de menús desde un menú sencillo serán mostrados al mismo tiempo (mira ROLE_MENU). El estado de un menú elemento verificable será representado por "< >" si está desverificado y "<x>" si está verificado. (Mira también ROLE_ACCEL_LABEL). Los pulsadores de cursor resultarán la activación del elemento.
Ejemplo verboso: mostrar barra de estado < >(CTRL+B) checkmenu
Ejemplo breve: mostrar barra de estado <x>
Como una casilla de verificación, Orca dirá el elemento seguido por la palabra "checkmenu" seguida por su estado.
Ejemplo verboso: mostrar barra de estado checkmenu verificado
Ejemplo Breve: mostrar barra de estado verificado
Un encabezado de columna es un encabezado para una columna de datos.
EJEMPLO: gtk-demo: "List Store" demo. Los encabezados son encabezados de columna de tabla.
Un encabezado de columna será tratado como un botón (los encabezados de columna son normalmente clickeables, típicamente recurriendo a las filas de la tabla asociada ), excepto que será seguido por "column heading" en modo verboso .
Ejemplo verboso: encabezado de columna ingresos mensuales
Ejemplo Breve: ingresos mensuales
Un encabezado de columna será tratado como un botón (los encabezados de columna son Habitualmente cliqueables, típicamente recurriendo a las filas de la tabla asociada ), excepto serán seguidas por "encabezado de columna" en modo verboso.
Ejemplo Verboso: encabezado de columna ingresos mensuales
Ejemplo Breve: ingresos mensuales
Un cuadro combinado es un elemento de línea simple que contiene una lista de elecciones de las que el usuario puede seleccionar, y también puede contener texto editable .
EJEMPLO: gedit: "Archivo" -> "Abrir...". Ambos cuadros combinados son simples menús cuadros combinados.
EJEMPLO: gnome-terminal: "Editar" -> "Perfil actual..." -> "Efectos". El cuadro combinado "Image file" tiene una lista en un panel deslizable y un área de texto de línea simple editable como hija.
EJEMPLO: gtk-demo: "Size Groups" demo. Esto crea un diálogo "GtkSizeGroup" . Cada objeto cuadro combinado en este diálogo tiene un menú como su hijo.
Los modos verboso y abreviado mostrarán la etiqueta seguida por el elemento seguido por la palabra "combo"." Si el elemento está seleccionado, será completamente subrayado con los puntos 7 y 8 para indicar la selección. POR HACER: ¿que hacer si el elemento es texto editable?
Ejemplo verboso: zona horaria: GMT-8 pacific combo
Ejemplo breve: zona horaria: GMT-8 pacific combo
Los modos verboso y breve hablarán la etiqueta seguida por el elemento seguido por la palabra "combo." Si el elemento está seleccionado, la palabra seleccionado será verbalizada. POR HACER: ¿wQué hacemos si el elemento es texto editable? Cuando un cuadro combinado tiene el foco y su selección cambia, la nueva selección será verbalizada.
Ejemplo verboso: zona horaria: GMT-8 pacific combo seleccionado
Ejemplo Breve: zona horaria: GMT-8 pacific seleccionado
Un icono del escritorio es un marco interno iconizado dentro de un panel del escritorio .
EJEMPLO: Desconocido.
Ejemplo verboso: file.txt icono
Ejemplo Breve: file.txt icono
Ejemplo verboso: file.txt icono
Ejemplo Breve: file.txt icono
A dial is a rotatable valuator.
EJEMPLO: Unknown.
Verbose Example: temperature 50 dial
Brief Example: temperature 50 dial
Verbose Example: temperature 50 dial
Brief Example: temperature 50 dial
Un diálogo es una ventana de nivel superior con un título y borde. POR HACER: AT-SPI hace una distinción entre las alertas y los diálogos. Pero, aunque aparece como el role "alerta" es aplicado sólo sobre cualquier diálogo.
EJEMPLO: gtk-demo: demo de "Diálogo y cuadros de m,mensaje"; haz clic sobre el botón "Interactive Dialog". La ventana del "Diálogo" es un diálogo.
EJEMPLO: gtk-demo: "Expander" demo; la ventana "GtkExpander" es un diálogo.
Cualquier ventana, a pesar de que si es una alerta, diálogo, marco, o ventana, aparecerá como la región de contexto en la línea braille. La cadena de contesto consistirá en el título de la ventana seguido por su role. El resto de la lín línea braille consistirá en información describiendo el objeto con el foco en la ventana. La información seguirá la presentación de las reglas para el tipo de role dado.
En el caso del "diálogo", el role del contexto será "dialog."
Ejemplo Verboso: diálogo Editando Perfil "foo"
Ejemplo Breve: Diálogo Editando Perfil "foo"
Cuando un diálogo obtiene el foco, Orca verbalizará el título del diálogo seguido por "diálogo" seguido por el objeto activo.
Verbose Example: Editing profile "foo" dialog. OK button.
Brief Example: Editing profile "foo" dialog. OK.
A directory pane is a pane that allows the user to navigate through and select the contents of a directory.
EJEMPLO: Unknown.
When in a directory pane, it will be treated like a part of a context.
Verbose Example: Open file dialog select file directory pane filename: text
Brief Example: Open file dialog select file filename:
POR HACER: add speech
An icon is a small fixed-sized picture typically used to decorate components.
EJEMPLO: desktop: Press Ctrl+Alt+Tab to select the "Desktop." This will give the icons on the desktop focus and you can move between them using the arrow keys.
EJEMPLO: gtk-demo: "Application Main Window" demo. This creates an "Application Window" frame. Click on File->New. This brings up an alert as a child of the gtk-demo application. The name of the alert is "Information." Buried in the widget hierarchy is an icon named "dialog information."
EJEMPLO: gtk-demo: "Dialog and Message Boxes" demo; click on the "Interactive Dialog" button. This brings up a dialog as a child of the gtk-demo app. There is a an icon named "dialog question" in the dialog's hierarchy.
EJEMPLO: gtk-demo: "Stock Item and Icon Browser". This is a big table with four table column header objects and sets of table cell objects. The "Selected Item" panel has the named icon in its hierarchy. NOTE: the first table cell has the icon and text as children table cell objects.
The label of the icon (or the component for the icon) will be displayed.
Verbose Example: unread icon
Brief Example: unread
Verbose Example: unread icon
Brief Example: unread
An image is a picture, typically static.
PROBLEMA CONOCIDO: Most push buttons objects appear to implement the Image interface whether they show an image or not. So...the consumer needs to be careful to determine if an image is actually showing or not.
The label of the icon (or the component for the icon) will be displayed. POR HACER: perhaps show accessible name and/or description of the image?
Verbose Example: new england in the fall image
Brief Example: new england in the fall
Verbose Example: new england in the fall image
Brief Example: new england in the fall
EJEMPLO: mozilla.
PROBLEMA CONOCIDO: The HTML container is a hierarchy of test objects. Non-links do not get focus, but links do. This presents some difficulties. For example, the first time a container is displayed, focus might be given to a link that is off the screen.
POR HACER: considerable thought needs to be done here. An idea for links, however, is that their text should be followed by the type of link: "[mailto,ftp,...] link." In addition, it may actually be more beneficial to use sound effects here so as to not interrupt the natural flow of text. That is, it would be better to speak "press [boop] here to send e-mail to Mike" vs. "press here mailto link to send e-mail to Mike."
Verbose Example:
Brief Example:
POR HACER: add speech
A label is a short string. It typically labels another object (e.g., a text area), but may be standalone. When it is standalone, it will be considered "static text." Special handling of labels will only be done in the case where they are static text. In these cases, the user will discover the text through review mode.
EJEMPLO: gtk-demo: Bring "Color Selector" demo. This creates a "Color Selection" frame as a child of the gtk-demo app. Click on "Change to above color". This creates a "Changing color" color chooser dialog. The numerical entry fields are spin button objects, each which is LABELED_BY a label.
Labels will be presented as "raw" text on the display.
Verbose Example: you are low on disk space
Brief Example: you are low on disk space
Verbose Example: you are low on disk space
Brief Example: you are low on disk space
A list is an object that presents a list of objects to the user and allows them to select one or more of them.
EJEMPLO: mozilla: "Tools" -> "Switch Profile..."
Orca will display the label for the list followed by the focused item followed by "list" followed by the position in the list if in verbose mode. If the item is selected, Orca will completely underline the item using dots 7 and 8. The touch cursors will toggle the selection of the associated item.
Verbose Example: state: california list 5 of 50
Brief Example: state: california list
Verbose Example: state: california list 5 of 50
Brief Example: state: california list
A menu contains menu items and lives in a menu bar.
Orca will show the menu name followed by the menu items. The menu item with focus (if there is one) will be the most meaningful object and it will also have the braille cursor. The touch cursors will activate the associated item.
EJEMPLO: Menus abound everywhere.
PROBLEMA CONOCIDO: A flurry of events seem to be delivered when going to/from a submenu item in the same menu. One of these events appears to give focus to the containing menu, which causes a dilemna for determining the object that will actually end up with focus (i.e., speech output needs to ignore intermediate objects with focus).
Verbose Example: file menu new _ save _ quit _ ...
Brief Example: file menu new _ save _ quit _ ...
When a menu is entered, its name will be spoken. If the menu selection changes, only the new selection will be spoken.
Verbose Example: file menu new control n
Brief Example: file menu new
A menu bar contains a set of menus.
EJEMPLO: Menu bars abound.
Orca will show the "menubar" followed by names of the menu items separated with "_". %todo; for this and maybe all other objects with mnenonics, how does one determine what the mnemonic is?
Verbose Example: menubar file _ edit _ view _...
Brief Example: menubar file _ edit _ view _ ...
Will speak "menubar" followed by name of menu with focus.
Verbose Example: menubar file
Brief Example: menubar file
A menu item lives in a menu.
EJEMPLO: Menu items abound.
PROBLEMA CONOCIDO: It appears as though some toolkits allow menu items to have children (see the 'Menus' demo of the gtk-demo application - the radio menu items have sub menus). This needs to be taken into account.
All menus items from a single menu will be shown at the same time (see ROLE_MENU). The menu item with focus (if there is one) will be the most meaningful object and it will also have the braille cursor. The touch cursors will activate the associated item. If the menu item is a menu (i.e., a submenu), then it will be followed by the word "sub" to indicate it is a submenu.
Verbose Example: file menu new _ save _ quit _ ...
Brief Example: file menu new _ save _ quit _ ...
Speak the item followed by any sub menu information followed by its accelerator.
Verbose Example: new submenu control n
Brief Example: new submenu
An option pane is a specialized pane whose primary used is inside a dialog.
EJEMPLO: Unknown.
Verbose Example:
Brief Example:
Verbose Example:
Brief Example:
A page tab is a child of a page tab list.
EJEMPLO: gtk-demo: The panel on the right hand side of the main window is a page tab list. Selecting the children causes the associated page tab to appear.
EJEMPLO:: gnome-terminal: Each child of the gnome-terminal app is frame. Each frame has a menu bar and a page tab list. Each page tab list has a page tab.
EJEMPLO: gnome-terminal: "Edit" -> "Current Profile..." is a dialog containing a page tab list.
A page tab will be viewed as a form of context. If only the page tab is selected (i.e., the focus is on the name of tab), then the page tab will be presented in the context of the page tab list. If an object in the tab has focus, however, then the following will be the context and the object will also be displayed. The object will also be the most meaningful information.
Verbose Example: preferences dialog effects tab
Brief Example: preferences dialog effects tab
Verbose Example: preferences dialog effects tab. OK button.
Brief Example: preferences dialog effects tab. OK.
A page tab is an object that presents a series of panels (page tabs), one at a time.
EJEMPLO: See ROLE_PAGE_TAB.
Orca will display "tab list" followed by the list of tabs separated by "_". The selected tab will get the cursor and will also be the most meaningful information. The touch cursors will select the associated page tab.
Verbose Example: tab list general _ advanced _ effects _ ...
Brief Example: tab list general _ advanced _ effects _ ...
When the tab changes, just speak the new tab name.
Verbose Example: tab list general tab
Brief Example: tab list general
Password text objects are used for passwords or other places where the visible text should not be visibly shown.
EJEMPLO: "Launch" -> "Preferences" -> "System Preferences" -> "Network Settings" -> "NFS." Brings up a "Query" alert requesting the root password.
Orca will treat the password text just like a text object, but will display *'s instead of characters.
Verbose Example: password: ****** text
Brief Example: password: ******
Verbose Example: password: text 5 characters
Brief Example: password: 5 characters
A progress bar indicates how much of a task has been completed.
EJEMPLO: Unknown.
Orca will show the label followed by the value followed by "progress."
Verbose Example: uploading: 57% progress
Brief Example: uploading: 57%
Verbose Example: uploading: 57% progress
Brief Example: uploading: 57%
An object the user can manipulate to tell the application to do something.
EJEMPLO: gtk-demo: "Button Boxes" demo. Many pushbuttons here. The buttons have images and accelerators.
EJEMPLO: gnome-terminal: "Edit" -> "Current Profile..." The "General" page tab has a push button labeled "Font." The text of this push button is represented by two child labels.
PROBLEMA CONOCIDO: It is important to remember that push buttons can optionally have children, which is the case when they have more than one label.
Orca will show the name of the button followed by the state of the button.
Verbose Example: OK pushbutton
Brief Example: OK
Verbose Example: OK pushbutton
Brief Example: OK
A specialized check box that will cause other radio buttons in the same group to become unchecked when it is checked.
EJEMPLO: gnome-terminal: "Edit" -> "Current Profile..." "Effects" tab. Radio buttons live here.
PROBLEMA CONOCIDO: The accessible relation interface was design for things like radio buttons, but it appears to be ignored or sporadically supported. As such, depending upon the relation interface appears to be a poor choice.
PROBLEMA CONOCIDO: In Swing, when a radio button gets focus, it is not automatically checked. In GTK+, however, a radio button automatically is checked when it gets focus.
The state of a radio button will be represented by "& y" if it is unselected and "&=y" if it is selected. All buttons from the same radio group will be displayed at once, with the button with focus being the most meaningful information. Any touch cursor associated with the text will click the radio button. Furthermore, the name of the radio button group will be used as part of the context.
Verbose Example: Color: Red &=y _ Blue & y _ Green & y
Verbose Example: Color: Red &=y _ Blue & y _ Green & y
Will speak radio button group name upon entry into group, and then just each radio button as it is selected.
Verbose Example: Color button group: red button
Verbose Example: Color: red
A radio menu represents a menu item that behaves like a radio button.
EJEMPLO: gnome-terminal: The "Tabs" menu has radio menu items for each tab.
All menus items from a single menu will be shown at the same time (see ROLE_MENU). The state of a radio menu item will be represented by "& y" if it is unchecked and "&=y" if it is checked. (See also ROLE_ACCEL_LABEL). The touch cursors will result in activating the item.
Verbose Example: Red & y(CTRL+R) radiomenu
Brief Example: Red &=y
Verbose Example: Red radiomenu selected
Brief Example: Red selected
A row header is a header for a row of data.
EJEMPLO: Unknown.
Like a column header, a row header will be treated like a button, except it will be followed by "row heading" in verbose mode.
Verbose Example: January row heading
Brief Example: January
Verbose Example: January row heading
Brief Example: January
A scroll bar allows a user to incrementally view a large amount of information.
EJEMPLO: gtk-demo: "Application Main Window" demo. The text area is in a scroll pane. Type enough and a scroll bar appears. One cannot seem to give it keyboard focus; instead normal keyboard navigation applies to the text area.
Orca will show the value (in %) followed by the orientation followed by "scrollbar". NOTE: it is rare that users will use scrollbars. They will tend to use the page up/down and other navigation keys to move around large areas of text.
Verbose Example: 57% vertical scrollbar
Brief Example: 57% vertical scrollbar
Verbose Example: 57% vertical scrollbar
Brief Example: 57% vertical scrollbar
A slider allows a user to select a value from a bounded range.
EJEMPLO: gnome-terminal: "Edit" -> "Current Profile..." The "Shade transparent or image background" object is a slider.
Orca will show the label, then the value (in %) followed by "slider".
Verbose Example: volume: 57% slider
Brief Example: volume: 57%
Verbose Example: volume: 57% slider
Brief Example: volume: 57%
A spin button is a single line item that contains a list of choices the user can select from.
EJEMPLO: gtk-demo: "Color Selector" demo. This creates a "Color Selection" frame as a child of the gtk-demo app. Click on "Change the above color". This creates a "Changing color" color chooser dialog. The numerical entry fields are spin button objects, each which is LABELED_BY a label and also implements the EditableText interface. These also have the CONTROLLER_FOR relation for the color wheel. These implement the AccessibleValue interface as well. (NOTE: use the arrow keys to change the value.)
The verbose and brief modes will show the label followed by the item followed by the word "spin."
Verbose Example: Red: 57 spin
Brief Example: Red: 57 spin
Verbose Example: Red: 57 spin
Brief Example: Red: 57 spin
A split pane is a specialized panel that presents two panels at once. It has a divider than can be dragged.
EJEMPLO: gtk-demo: "Paned Widgets" demo. This brings up a "Panes" frame. The top split pane is a child of the big split pane.
EJEMPLO: gedit: "File" -> "Open" brings up a split pane.
The words "split pane" will become part of the context and the focused object will be the object of interest. In the event the focus is on the split pane divider, braille will display the percentage of the top or left pane that is shown followed by "split pane divider".
Verbose Example: open file dialog directory split pane /usr list 5 of 10
Brief Example: open file dialog directory split pane /usr list 5 of 10
Verbose Example: open file dialog directory split pane /usr list 5 of 10
Brief Example: open file dialog directory split pane /usr list 5 of 10
Tables are a container of data organized in rows and columns. The interesting aspects of a table include: the row/column headers, the contents of the various cells, and selection.
EJEMPLO: gtk-demo: "Editable Cells" demo brings up a "Shopping list" frame that has a table with cells that have editable text (press the space key to initiate the edit).
A table will generally be viewed as a context, with focused table component (e.g., header or cell) being the most important information. In verbose mode, Orca will show the title of a table followed by "table" followed by row and column information followed by the cell data. Brief mode will simply show row and column information followed by cell data. The cell data will displayed using the given role styles in this style guide followed by "cell." In brief mode, "cell" will not be shown.
Verbose Example: home runs table row header Mike c4 0 cell
Brief Example: c4 0
Verbose Example: home runs table row header Mike c4 0 cell
Brief Example: c4 0
A tear off menu item allows a menu to be removed from a menu bar and shown in its own window.
EJEMPLO: gtk-demo: "Menus" demo has many tear off menu items. Keyboard navigation skips the tear off menu item at first. To get to it, you need to press the up arrow key after selecting the first "real" menu item.
All menus items from a single menu will be shown at the same time (see ROLE_MENU). The menu item with focus (if there is one) will be the most meaningful object and it will also have the braille cursor. The touch cursors will activate the associated item. Tear off menu items will be shown with "---" as their label.
Verbose Example: file menu --- _ new _ save _ quit _ ...
Brief Example: file menu --- _ new _ save _ quit _ ...
POR HACER: maybe say "dash dash dash"?
Verbose Example: tear off menu item
Brief Example: tear off
A text object presents text to the user such that the text typically has a caret position, can be single line or multiline, and can be editable.
EJEMPLO: gtk-demo: (MULTI_LINE) "Application Main Window" demo. This creates an "Application Window" frame. The text is a child of scroll pane which is a child of the panel of this frame. This text object implements the EditableText interface.
EJEMPLO: gtk-demo: (LABELED_BY and SINGLE_LINE) "Color Selector" demo. This creates a "Color Selection" frame as a child of the gtk-demo app. Click on "Change the above color". This creates a "Changing color" color chooser dialog. The "Color Name" text area is a SINGLE_LINE text area that is LABELED_BY the "Color Name" label.
EJEMPLO: gtk-demo: (LABELED_BY and SINGLE_LINE) Bring up the "Dialog and Message Boxes" demo. "Entry 1" and "Entry 2" are SINGLE_LINE text area that are LABELED_BY.
EJEMPLO: gtk-demo: the "Info" and "Source" tabs contain uneditable text.
Document text will be displayed optionally with the following enhancements. It can optionally be displayed with proper spacing shown, with a certain attribute underlined, style information displayed in status cells. If status cells exist it should be possible to toggle them between the font, the point size and the attribute. Multiline text will be followed by the current line and total lines.
Verbose Example: first name: willie edit (the cursor is shown and moves with the caret position)
Verbose Example: address: 1024 washington way multiline 1 of 2 (the cursor is shown and moves with the caret position)
Brief Example: first name: willie
POR HACER: add speech
A toggle button is a specialized push button that can be checked or unchecked, but does not provide a separate indicator for the current state.
gtk-demo: "Expander" demo. The "Details" object is a toggle button. PROBLEMA CONOCIDO: in at-poke, clicking on "Details" doesn't seem to result in the new label appearing in at-poke's display.
The state of a toggle button will be represented by "& y" if it is unselected and "&=y" if it is selected.
Verbose Example: Run &=y toggle
Verbose Example: Run & y
Only speaks new state if object has focus and state changes.
Verbose Example: Run toggle pressed
Verbose Example: Run not pressed
A tool bar is a bar or palette usually composed of push buttons or toggle buttons, but may also contain other items such as editable text.
EJEMPLO: gtk-demo: "Application Main Window" demo. This creates an "Application Window" frame. The tool bar is a child of the panel, which, in turn, is a child of this frame. This toolbar is composed of multiple panels, each with its own push button. The vertical separator is just a panel (it's not a separator).
Verbose mode should show the tool bar followed by "toolbar" Brief mode should simply show the tool bar. Each item will be separated with "_". Same verbosity rules apply to each item. POR HACER: perhaps toolbar should be treated like a context?
Verbose Example: new button _ save button _ cut button toolbar
Brief Example: new _ save _ cut
Verbose Example: toolbar
Brief Example: toolbar
A tree presents hierarchical information to the user, allowing them to expand/collapse nodes to limit what it seen.
EJEMPLO: gtk-demo: "Tree Store" demo brings up a tree table.
Orca should show the label for the tree followed by the current item followed by its state followed by the level followed by tree.
Verbose Example: directory myfolder expanded level 4 tree
Brief Example: directory myfolder leaf level 4 tree
Verbose Example: directory myfolder expanded level 4 tree
Brief Example: directory myfolder leaf level 4 tree
A window is a top level window with no title or border.
On Alt+Tab, the task switcher will appear. As it is on the screen, it will be presented. The text that appears (i.e., the window name) will be shown in braille. When the window gets focus, it will be the context, and the object with focus in the window will be the most meaningful information.
Verbose Example:
Brief Example:
POR HACER: add speech