开发者工具

作者: 安迪·博尔卡
下载稳定版
下载开发板
NVDA compatibility: 2019.1 to 2020.1

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.

快捷键

启用 DTK 时,可以使用以下手势。

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.

注意

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.

已知问题

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.

版本历史记录

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

如果大小和位置值为 0,DTK 现在将报告大小和位置值。
导航现在遵循详细的消息设置。
朗读的大小/位置信息更加简洁。
稳定性提高。

2019.1.1

在朗读版本号时,DTK 将不再尝试多次加载自身。
安装时将禁用 DTK 功能。以前,DTK 功能在安装时已启用。这与在 NVDA 工具_管理加载项窗口中启用或禁用加载项不同。
现在,向用户显示的消息可以包含非 ascii 字符。
按下复制到剪贴板时的快捷键,如 a、b、c、f、h、l、r、s、t、v 和 w,不再打断NVDA 语音。

2019.1

修复了 DTK 尚未声明最小 NVDA 版本的兼容性问题。

2019.0 (初始稳定版本)

实现了基本的元素导航。