This document describes the custom scripts for Dropbox and provides tips for using this application with JAWS. This document can be opened from within the application via a double press of JAWSKey+F1 (or Insert+F1) when the scripts are running.
This document is laid out for easy navigation using JAWS HTML heading navigation commands: H will move through all headings, 2 through major sections, and 3 and 4 through any subsections and subsubsections.
In addition to any system requirements for the application, the following apply for JAWS users:
To install these scripts on a new system:
These scripts provide the following commands beyond those provided by the application itself:
These scripts also provide the following features:
The Share screen can be accessed from within Windows Explorer via the "Share..." option in the Context menu for a folder in the Dropbox folder tree.
In the Share dialog, Tab to the "To:" / "typeAhead input" edit box. To add someone by complete email address, type or paste the address and press Enter. The address will be added to a list of tokens; these will be added to the folder when the Share dialog closes.
The scripts also add support for an autocomplete feature in the "To:" edit box in the Share screen: As you start typing into the box, JAWS will announce the first item that appears when an autocomplete list pops up. Pressing Enter will add this item to the token list and close the autocomplete list. Up and Down arrows will move among the available items in the autocomplete list, and Enter will add the item last announced and close the autoComplete list. JAWS will beep and repeat the current item if an Up or Down arrow attempts to navigate past the top or bottom of the autocomplete list.
Note that this autocomplete support takes advantage of a feature in Dropbox itself whereby Up and Down arrows and Enter select items for addition to the token list, though Dropbox at this writing does not visually indicate this selection until Enter actually adds an item to the token list. Dropbox behavior on this point may change in the future.
To remove an entry from the token list:
Warning: A side effect of the just-described native Dropbox interface for deleting add list items is that pressing Backspace repeatedly in the "To:" edit box, such as to make sure the box is empty, can remove entries from the add list. To help users be aware of what is pending for addition to the folder, the scripts make JAWS announce the number of tokens in the token list after each press of Enter or Backspace while focus is in the "To:" edit box.
Some buttons in the Share screen bring up new controls but do not move focus to them:
The following issues are known and may be encountered during use of the application with these JAWS scripts. These issues may be fixed in a future update to the scripts or to the application itself.
It may be necessary to Alt+Tab out of and back in to the Share dialog once in a while on opening it from within a folder in Windows Explorer in order to get JAWS to announce fields as you Tab through the dialog.
Left and right arrows and the Backspace key do not speak normally in the Share screen's "To:" edit box.
Braille support is not well tested and is likely incomplete.
This is the revision history of these scripts, most recent revision first: