Entwickler-Werkzeugkasten

Developer toolkit (DTK) is an NVDA add-on that helps blind and visually impaired developers independently create visually appealing user interfaces and web content. It provides gestures that enable you to navigate through objects and obtain information about them, such as their size, position, and characteristics. To begin using DTK, place focus on a control, then press ALT+WINDOWS+K. To disable it, press ALT+WINDOWS+K again. When on the web, press NVDA+SPACE to put NVDA in Focus Mode and press NVDA+SHIFT+SPACE to disable Single Letter Navigation.

Tastenbefehle

Die folgenden Tastenbefehle sind verfügbar, wenn DTK aktiviert ist.

  • ALT+WINDOWS+K - Enable or disable DTK features.
  • LEFT ARROW - Move to previous sibling.
  • RIGHT ARROW - Move to next sibling.
  • UP ARROW - Move to parent.
  • DOWN ARROW - Move to first child.
  • CTRL+HOME - Move to top-most parent.
  • HOME - Move to the relative parent if one is assigned.
  • A - In web content, speak HTML attributes. Press twice quickly to copy to the clipboard.
  • B - Speak the position of the object's bottom edge. Press twice quickly to copy to the clipboard.
  • SHIFT+B - Speak the distance between the object's bottom edge and the relative parent's bottom edge. Press twice quickly to copy to the clipboard.
  • C - Speak the number of children contained inside the object. Press twice quickly to copy to the clipboard.
  • control+c - Switch between RGB, Hex, and Name color values.
  • CTRL+D - Enable or disable detailed messages.
  • F - In web content, speaks the object's font and formatting information. Press twice quickly to copy to the clipboard.
  • H - Speak the object's height. Press twice quickly to copy to the clipboard.
  • L - Speak the position of the object's left edge. Press twice quickly to copy to the clipboard.
  • n - Speak the object's name. Press twice quickly to copy to the clipboard.
  • CTRL+P - Set the relative parent for obtaining size/location of objects.
  • P - Speak the relative parent's name. Press twice quickly to copy to the clipboard.
  • R - Speak the position of the object's right edge. Press twice quickly to copy to the clipboard.
  • SHIFT+R - Speak the distance between the object's right edge and the relative parent's right edge. Press twice quickly to copy to the clipboard.
  • ALT+R - Speak the object's Role/control type. Press twice quickly to copy it to the clipboard.
  • S - Speak the number of siblings relative to the object. Press twice quickly to copy to the clipboard.
  • SHIFT+S - Speak the object's control states. Press twice quickly to copy it to the clipboard.
  • T - Speak the position of the object's top edge. Press twice quickly to copy to the clipboard.
  • V - Speak Developer toolkit version. Press twice quickly to copy to the clipboard.
  • W - Speak the object's width. Press twice quickly to copy to the clipboard.

Hinweise

  • When using home or any modified version of the home key, using the numpad home key fails because NVDA will send the numpad7 keypress instead of a numpadHome keypress. Other keyboard add-ons that attempt to reassign numpad7 to the home key will fail in this add-on.
  • When using the relative parent feature, DTK will set the relative parent to the desktop under the following conditions.

    • The focused object and the relative parent are the same.
    • The relative parent is not a direct ancestor of the focused object.
  • DTK cannot access information such as CSS rules, padding, borders, or z-index. Doing so requires accessing them outside of the NVDA context, which presents a security concern for users.

Bekannte Probleme

  • The customizable list of font attributes found in Developer toolkit settings may be cumbersome to use. This is a limitation found in NVDA's user interface library.

Versionsverlauf

20.04

  • Added a gesture (home) that gives the ability to move to the defined relative parent.

20.03

  • Added a gesture (ALT+R) that obtains the currently focused object's control type. Examples include button, listitem, list, checkbox, and section.
  • Added a gesture (SHIFT+S) that obtains the currently focused object's control states. Examples include focused, focusable, selected, checked, pressed, and readonly.
  • Removed support for IAccessible's unique ID because it is not reliable in most contexts.
  • Abbreviated the version number to xx.yy where xx is the last two digits of the current year, and yy is the update number for the current year. Thus 20.03 is the third major update in 2020.

2020.2

  • Starting DTK retains the cursor’s current position in web content. If the object under the caret can’t gain focus, DTK will place focus on the first available ancestor.
  • Removed legacy support for unicode strings.
  • Removed the enable/disable Developer toolkit features setting from Developer toolkit settings dialog found in NVDA menu>preferences>settings. Users can still enable/disable features by pressing alt+windows+k.
  • The formatting attributes obtained by pressing 'f' when Developer toolkit is enabled is now configurable in preferences>settings>Developer toolkit.

    • Add new formatting attributes by pressing the 'new attribute' button. Type in a name of a valid formatting attribute, press tab to put it in the list, then press escape to leave edit mode.
    • Remove an attribute by selecting it in the list, then pressing the 'delete attribute' button.
    • Rename an attribute by pressing the 'Rename attribute' button, typing a new name, pressing tab to put it in the list, then pressing escape to leave edit mode.
    • Move an attribute up in the list by selecting it and pressing the 'Move up' button. Repeat this until it reaches the desired location in the list.
    • Move an attribute down in the list by selecting it and pressing the 'Move down' button. Repeat this until it reaches the desired location in the list.
  • Users now have the ability to change the way color values are displayed while obtaining formatting information. The setting is found in preferences>settings>Developer toolkit, then choosing a color display format. The color display format can also be changed by pressing control+c while Developer toolkit features are enabled.

    • RGB - Red/Green/Blue value. Defines a color through a red, green, blue color combination. Good for graphic art, especially non-web safe colors.
    • Hex - string starting with a '#' and followed by 6 characters consisting of 1-0 and A-F. Usually good for web content.
    • Name - The human readable value for the color. Good for general purpose usage and verifying other color value formats.

2020.1.1

  • Improved unicode support.

2020.1.0

  • Developers now have the ability to focus on smaller areas of their user interfaces by pressing CTRL+p to set a relative parent. Use a relative parent as a reference point when obtaining size and location information. To use this feature, enable DTK features, navigate to the object to use as a relative parent, then press CTRL+p. Then, return to your work as usual.
  • Press the letter p while working in DTK to obtain the relative parent's name. Press twice quickly to copy to the clipboard.
  • Use SHIFT+b to obtain the distance between the focused object's bottom edge and the relative paren'ts bottom edge. DTK features must be enable to use this feature.
  • Use SHIFT+r to obtain the distance between the focused object's right edge and the relative paren'ts right edge. DTK features must be enable to use this feature.
  • DTK now gracefully handles configuration profile switches.
  • Removed '-preview' from the version number to avoid version number problems with add-on updater.

2020.0 preview

  • Changed version number to 2020.0 preview to reflect the impending switch to Python 3.
  • Added Python 3 compatibility.
  • Added a new gesture, "n" that speaks the object's name. If one is not assigned, speaks the word 'None' as the object's name.
  • DTK no longer adds duplicate settings panels in the NVDA settings window when reloading add-ons.

2019.1.2

  • DTK meldet nun Größen- und Positionswerte, auch wenn sie 0 sind.
  • Die Navigation berücksichtigt nun die Einstellung für detaillierte Meldungen.
  • Die Meldungen über Größen-/Positionsinformationen sind nun präziser.
  • Stabilitätsverbesserungen.

2019.1.1

  • DTK wird nicht mehr erneut geladen, wenn die Versionsnummer gemeldet wird.
  • DTK-Funktionen werden bei der Installation deaktiviert. Bisher wurden DTK-Funktionen bei der Installation aktiviert. Dies ist nicht zu verwechseln mit der Aktivierung oder Deaktivierung der Erweiterung im Fenster NVDA Menü / Extras >Erweiterungen verwalten.
  • Meldungen können nun auch nicht-ASCII-Zeichen enthalten.
  • Drücken von Tastenbefehlen wie a, b, c, f, h, l, r, s, t, v und w unterbrechen nicht mehr die NVDA-Stimme beim Kopieren in die Zwischenablage.

2019.1

  • Ein Kompatibilitätsproblem wurde behoben, bei dem das DTK eine minimale NVDA-Version deklarierte, die noch nicht veröffentlicht wurde.

2019.0 (erste stabile Version)

  • Erstes Build mit einfacher Navigation.