Firefox Perk User Guide

Version 0.5.3

Hotkeys

Mode Changing

CapsLock-Space

change navigation mode

Basic Document Navigation

Down

review next item, convenience for Alt-Shift-O

Up

review previous item, convenience for Alt-Shift-U

Ctrl-Right

review next word, convenience for Alt-Shift-L

Ctrl-Left

review previous word, convenience for Alt-Shift-J

Right

review next character, convenience for Alt-Shift-.

Left

review previous character convenience for Alt-Shift-M

Home

go to start of line or first item

End

go to end of line or last item

Ctrl-Home

go to active doc frame

Ctrl-End

go to last item in document

CapsLock-Home

go to saved por location or active doc frame.

Navigation by element

Note: Use Shift + hotkey to go to the previous element.

A

go to anchor

D

go to embed, includes objects, embeds, iframes, and ARIA

B

go to button

X

go to check box

C

go to combo box

E

go to entry

F

go to form

G

go to form control

I

go to image

H

go to heading

L

go to list

;

go to list item

W (coming soon)

go to live region

S

go to section

R

go to radio button

T

go to table

U

go to unvisited link

V

go to visited link

Container navigation

CapsLock-Up

go to container

CapsLock-Right

skip container

Navigation by Relation

Note: Use Shift + hotkey to go to the previous element.

J

go to different accessible, skips dummy accessibles that contain only one piece of similar content.

K

go to similar accessible. First in cycle, matches on role only. Second in cycle, matches more loosely.

Navigation by Landmark

Note: Use Shift + hotkey to go to the previous element.

[

go to banner

'

go to content info

.

go to definition

M

go to main

N

go to navigation

O

go to note

,

go to search

Y

go to secondary

P

go to see also

Navigation by Size (coming soon)

Note: Use Shift + hotkey to go to the previous element.

Q

go to contiguous text

Z

go to visual footprint

Orientation

Alt-Shift-1

Where am I?, extends the function of the same name provided by the more basic Perks packaged with LSR.

CapsLock-Y

first in cycle reads page title, second in cycle reads URL, third in cycle reads page summary.

CapsLock-K

read link preview gives information about a given hyperlink including protocol, domain relationship of current page to the target, and possibly download size.

Settings

AutoMode

Enables automatic transitioning from one mode to another

BoundReview

Holds the POR inside a region so that the mode cannot change

TextBlock (coming soon)

Minimum threshold for 'go to contiguous text' navigation

SearchDepth

Number of accessibles visited before a search or go to operation is cancelled

Usage

LSR provides a series of hotkeys, in addition to those native to Firefox, that give the user a Rich Document Browsing experience. LSR provides multiple reading modes for dealing with the diverse types of content in a Web document, navigation hotkeys for quickly moving past and through sets of elements, and context queries for quickly learning about the structure and content of a document. Together, these tools help the user tackle complex documents available on the Web today.

Navigation

Navigation hotkeys jump the point of regard to an accessible representing a particular kind of document content, an accessible related in some way to the current point of regard, or an accessible having some special relation with the rest of the page. Some navigation hotkeys exist to move a user to a particular location while others are defined to skip over large sections.

Basic Document Navigation

Basic document navigation supports navigation by character, word, and item. Navigation follows an in-order traversal scheme according to the accessibility hierarchy exposed by the Web browser. The starting boundary of the traversal falls on the first item in the document frame, including the document frame itself. The ending boundary is the last item, of the last child accessible, of the last branch of the document structure under the document frame.

Navigation by Element

Element hotkeys move the point of regard in a document to the next or previous accessible representing an element of a given type. The type of an element may be indicated by the role, object attributes, states, or any combination of these.

Container Navigation

Container hotkeys move the point of regard to and past container accessibles. The purpose of these key commands is to support navigation out of and over large sections of a document such as tables, lists, forms, embedded frames, ARIA applications, textboxes, etc.

Navigation by Relation

Relative hotkeys move the point of regard in a document to the next or previous accessible having a given relationship to the accessible at the current POR. The relationship may be indicated by an explicit relation or one that must be inferred.

Navigation by Landmark

Landmark hotkeys move the point of regard in a document to the next or previous accessible having an explicit ARIA landmark role. The landmark navigation commands do not try to infer the role of content, and only function if the appropriate markup has been provided in the content and exposed by the browser.

Navigation by Size (coming soon)

Size hotkeys move the point of regard in a document to an accessible of larger or smaller length or size. The purpose of these functions are to speed navigation to blocks of potential interest, such as visually large containers and long bodies of text. Traversal for visual size starts at the largest accessible and ends and the smallest descendant under that accessible.

Context Queries

LSR provides hotkeys to help a user orient themselves to a webpage by providing information about where they are currently browsing in relation to the document as a whole. Other hotkeys provide a glimpse to the overall structure and content of the document. Together, the functions where am i?, read page title, read page url, read page summary, and read link preview give the user a better understanding of the layout and content of the webpage.

Modes

Modes define what hotkeys are enabled and the behavior of certain keys. LSR provides three distinct reading modes: document, table (coming soon) or widget mode. The following table outlines which hotkeys are available for each mode:

By default, LSR automatically switches to the most specific reading mode when the point of regard changes. The user can turn automatic mode switching on and off by toggling the AutoMode setting. Automatic mode changes adhere to the rules outlined in the following table:

The user may also manually toggle between reading modes at any time using the change mode hotkey. When in document mode, pressing this hotkey changes the mode to table or widget mode depending on the content at the current POR. If none of these other modes is applicable to the POR, the mode remains unchanged. When in any other mode, pressing this hotkey changes mode to document mode. LSR makes an appropriate announcement of mode changes or when the mode cannot change.

Usage Examples

User switches tabs

The user presses Ctrl-Tab to switch tabs to a previous viewed page. The point of regard is restored to the point at which the user previously left. The reading mode changes to the best reading mode if AutoMode is set and focus will be placed in the accessible if AutoManipulable is set and focus is needed.

Navigating out of container

The user is inputting information into a form and wants to quickly navigate past the form. Pressing CapsLock-Up moves the point of regard to the container root and CapsLock-Right moves the point of regard to the next item past the container, in this case the form.

Navigating Google Homepage

The user is on the Google homepage and wants to perform a search. Pressing e brings the point of regard to the entry box. The reading mode changes to widget mode if AutoMode is set and focus will be placed in the box if AutoManipulable is set. The user types their query and presses enter to begin search.

Navigating to top of document

The user is in the chrome (Firefox controls) and wants to begin reviewing a webpage. Pressing CapsLock-Home brings them to the top of the document. The reading mode changes to document mode if AutoMode is set.

Lost user needing orientation

The user has become lost in the page. Pressing Alt-Shift-1 announces the current point of regard followed by it's index within the number of similar items in the page, plus the percentage of page that has been read. Pressing Alt-Shift-1 again announces all accessibles up the accessible tree.

Navigating out of single line textboxes

The user is filling out a single line textbox and wants to navigate out. Pressing CapsLock-Right Arrow skips the container and moves the point of regard to the next item.