seedlingattempt/godot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #106660 from bruvzg/ac_node_to_ctl

Browse Source 
Move some accessibility properties from Node to Control
This commit is contained in:
Thaddeus Crews
2025-06-09 12:31:32 -05:00
parent dddaba29ee aff5b413aa
commit 6427343ec8
9 changed files with 289 additions and 226 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
doc/classes/Control.xml
View File

@ -85,6 +85,13 @@
[/codeblocks]
</description>
</method>
<method name="_get_accessibility_container_name" qualifiers="virtual const">
<return type="String" />
<param index="0" name="node" type="Node" />
<description>
Override this method to return a human-readable description of the position of the child [param node] in the custom container, added to the [member accessibility_name].
</description>
</method>
<method name="_get_drag_data" qualifiers="virtual">
<return type="Variant" />
<param index="0" name="at_position" type="Vector2" />
@ -962,6 +969,27 @@
</method>
</methods>
<members>
<member name="accessibility_controls_nodes" type="NodePath[]" setter="set_accessibility_controls_nodes" getter="get_accessibility_controls_nodes" default="[]">
The paths to the nodes which are controlled by this node.
</member>
<member name="accessibility_described_by_nodes" type="NodePath[]" setter="set_accessibility_described_by_nodes" getter="get_accessibility_described_by_nodes" default="[]">
The paths to the nodes which are describing this node.
</member>
<member name="accessibility_description" type="String" setter="set_accessibility_description" getter="get_accessibility_description" default="&quot;&quot;">
The human-readable node description that is reported to assistive apps.
</member>
<member name="accessibility_flow_to_nodes" type="NodePath[]" setter="set_accessibility_flow_to_nodes" getter="get_accessibility_flow_to_nodes" default="[]">
The paths to the nodes which this node flows into.
</member>
<member name="accessibility_labeled_by_nodes" type="NodePath[]" setter="set_accessibility_labeled_by_nodes" getter="get_accessibility_labeled_by_nodes" default="[]">
The paths to the nodes which label this node.
</member>
<member name="accessibility_live" type="int" setter="set_accessibility_live" getter="get_accessibility_live" enum="DisplayServer.AccessibilityLiveMode" default="0">
The mode with which a live region updates. A live region is a [Node] that is updated as a result of an external event when the user's focus may be elsewhere.
</member>
<member name="accessibility_name" type="String" setter="set_accessibility_name" getter="get_accessibility_name" default="&quot;&quot;">
The human-readable node name that is reported to assistive apps.
</member>
<member name="anchor_bottom" type="float" setter="_set_anchor" getter="get_anchor" default="0.0">
Anchors the bottom edge of the node to the origin, the center, or the end of its parent control. It changes how the bottom offset updates when the node moves or changes size. You can use one of the [enum Anchor] constants for convenience.
</member>

28
doc/classes/Node.xml
View File

@ -43,13 +43,6 @@
Returning an empty array produces no warnings.
</description>
</method>
<method name="_get_accessibility_container_name" qualifiers="virtual const">
<return type="String" />
<param index="0" name="node" type="Node" />
<description>
Return a human-readable description of the position of [param node] child in the custom container, added to the node name.
</description>
</method>
<method name="_get_configuration_warnings" qualifiers="virtual const">
<return type="PackedStringArray" />
<description>
@ -1035,27 +1028,6 @@
</method>
</methods>
<members>
<member name="accessibility_controls_nodes" type="NodePath[]" setter="set_accessibility_controls_nodes" getter="get_accessibility_controls_nodes" default="[]">
The list of nodes which are controlled by this node.
</member>
<member name="accessibility_described_by_nodes" type="NodePath[]" setter="set_accessibility_described_by_nodes" getter="get_accessibility_described_by_nodes" default="[]">
The list of nodes which are describing this node.
</member>
<member name="accessibility_description" type="String" setter="set_accessibility_description" getter="get_accessibility_description" default="&quot;&quot;">
The human-readable node description that is reported to assistive apps.
</member>
<member name="accessibility_flow_to_nodes" type="NodePath[]" setter="set_accessibility_flow_to_nodes" getter="get_accessibility_flow_to_nodes" default="[]">
The list of nodes which this node flows into.
</member>
<member name="accessibility_labeled_by_nodes" type="NodePath[]" setter="set_accessibility_labeled_by_nodes" getter="get_accessibility_labeled_by_nodes" default="[]">
The list of nodes which label this node.
</member>
<member name="accessibility_live" type="int" setter="set_accessibility_live" getter="get_accessibility_live" enum="DisplayServer.AccessibilityLiveMode" default="0">
Live region update mode, a live region is [Node] that is updated as a result of an external event when user focus may be elsewhere.
</member>
<member name="accessibility_name" type="String" setter="set_accessibility_name" getter="get_accessibility_name" default="&quot;&quot;">
The human-readable node name that is reported to assistive apps.
</member>
<member name="auto_translate_mode" type="int" setter="set_auto_translate_mode" getter="get_auto_translate_mode" enum="Node.AutoTranslateMode" default="0">
Defines if any text should automatically change to its translated version depending on the current locale (for nodes such as [Label], [RichTextLabel], [Window], etc.). Also decides if the node's strings should be parsed for POT generation.
[b]Note:[/b] For the root node, auto translate mode can also be set via [member ProjectSettings.internationalization/rendering/root_node_auto_translate].

6
doc/classes/Window.xml
View File

@ -578,6 +578,12 @@
</method>
</methods>
<members>
<member name="accessibility_description" type="String" setter="set_accessibility_description" getter="get_accessibility_description" default="&quot;&quot;">
The human-readable node description that is reported to assistive apps.
</member>
<member name="accessibility_name" type="String" setter="set_accessibility_name" getter="get_accessibility_name" default="&quot;&quot;">
The human-readable node name that is reported to assistive apps.
</member>
<member name="always_on_top" type="bool" setter="set_flag" getter="get_flag" default="false">
If [code]true[/code], the window will be on top of all other windows. Does not work if [member transient] is enabled.
</member>