Merge 32691bd into ba9215c

Danstiv · web-flow · commit 1f55146aadf9 · 2023-08-31T22:16:26.000+10:00
diff --git a/source/UIAHandler/browseMode.py b/source/UIAHandler/browseMode.py
@@ -486,6 +486,9 @@ def _iterNodesByType(self,nodeType,direction="next",pos=None):
 				)
 			])
 			return UIAControlQuicknavIterator(nodeType, self, pos, condition, direction)
+		elif nodeType == "tab":
+			condition = UIAHandler.handler.clientObject.createPropertyCondition(UIAHandler.UIA_ControlTypePropertyId, UIAHandler.UIA_TabItemControlTypeId)
+			return UIAControlQuicknavIterator(nodeType, self, pos, condition, direction)
 		elif nodeType=="nonTextContainer":
 			condition=createUIAMultiPropertyCondition({UIAHandler.UIA_ControlTypePropertyId:UIAHandler.UIA_ListControlTypeId,UIAHandler.UIA_IsKeyboardFocusablePropertyId:True},{UIAHandler.UIA_ControlTypePropertyId:UIAHandler.UIA_ComboBoxControlTypeId})
 			return UIAControlQuicknavIterator(nodeType,self,pos,condition,direction)
diff --git a/source/browseMode.py b/source/browseMode.py
@@ -920,6 +920,17 @@ def _get_disableAutoPassThrough(self):
 	# Translators: Message presented when the browse mode element is not found.
 	prevError=_("no previous grouping")
 )
+qn(
+	"tab", key=None,
+	# Translators: Input help message for a quick navigation command in browse mode.
+	nextDoc=_("moves to the next tab"),
+	# Translators: Message presented when the browse mode element is not found.
+	nextError=_("no next tab"),
+	# Translators: Input help message for a quick navigation command in browse mode.
+	prevDoc=_("moves to the previous tab"),
+	# Translators: Message presented when the browse mode element is not found.
+	prevError=_("no previous tab")
+)
 del qn
 
 
diff --git a/source/virtualBuffers/MSHTML.py b/source/virtualBuffers/MSHTML.py
@@ -401,6 +401,12 @@ def _searchableAttribsForNodeType(self,nodeType):
 					"name": [VBufStorage_findMatch_notEmpty]
 				},
 			]
+		elif nodeType == "tab":
+			attrs = [
+				{
+					"IAccessible::role": [oleacc.ROLE_SYSTEM_PAGETAB],
+				},
+			]
 		elif nodeType == "embeddedObject":
 			attrs = [
 				{"IHTMLDOMNode::nodeName": ["OBJECT", "EMBED", "APPLET", "AUDIO", "VIDEO", "FIGURE"]},
diff --git a/source/virtualBuffers/gecko_ia2.py b/source/virtualBuffers/gecko_ia2.py
@@ -543,6 +543,10 @@ def _searchableAttribsForNodeType(self,nodeType):
 				},
 				{"IAccessible::role":[oleacc.ROLE_SYSTEM_APPLICATION,oleacc.ROLE_SYSTEM_DIALOG]},
 			]
+		elif nodeType == "tab":
+			attrs = [
+				{"IAccessible::role": [oleacc.ROLE_SYSTEM_PAGETAB]}
+			]
 		else:
 			return None
 		return attrs
diff --git a/user_docs/en/userGuide.t2t b/user_docs/en/userGuide.t2t
@@ -814,6 +814,26 @@ If you want to use these while still being able to use your cursor keys to read
 To toggle single letter navigation on and off for the current document, press NVDA+shift+space.
 %kc:endInclude
 
++++ Other navigation commands +++[OtherNavigationCommands]
+
+In addition to the quick navigation commands listed above, NVDA has commands that have no default keys assigned.
+To use these commands, you first need to assign gestures to them using the [Input Gestures dialog #InputGestures].
+Here is a list of available commands
+- Article
+- Grouping
+- Tab
+-
+Keep in mind that there are two commands for each type of element, for moving forward in the document and backward in the document, and you must assign gestures to both commands in order to be able to quickly navigate in both directions.
+
+For example, if you want to use the ``y`` / ``shift+y`` keys to quickly navigate through tabs, you would do the following
+
++ Open gestures dialog from browse mode.
++ Find "moves to the next tab" item in the Browse mode section.
++ Assign ``y`` key for found gesture.
++ Find "moves to the previous tab" item.
++ Assign ``shift+y`` for found gesture.
++
+
 ++ The Elements List ++[ElementsList]
 The elements list provides access to a list of various types of elements in the document as appropriate for the application.
 For example, in web browsers, the elements list can list links, headings, form fields, buttons or landmarks.
