sancarn / sancarn/stdVBA-examples

[FEATURE] - Accessibility Inspector - Mark nodes and Find key common ancestors

Open
#9 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
34
Forks
10
PR merge metrics
No merged PRs in 30d

Description

Imagine the following accessibility tree:

[Window] Advanced Text Editor - Untitled
|- [Pane] Editor Workspace
|  |- [Custom] Document View
|  |  |- [Text] Line 1: This is some sample text.
|  |  |- [Text] Line 2: It has multiple
|  |  |- [Text] Line 3: levels of indentation.
|  |  |- [Custom] Code Block (collapsed)
|  |     |- [Text] int main() {
|  |     |- [Text]   return 0;
|  |     |- [Text] }
|  |- [ScrollBar] Vertical Scroll Bar
|- [Pane] Side Panel
|  |- [TabControl] Tools
|  |  |- [TabPage] Project Explorer
|  |  |  |- [Tree] Files
|  |  |     |- [TreeItem] Source
|  |  |     |  |- [TreeItem] main.cpp
|  |  |     |  |- [TreeItem] utilities.h
|  |  |     |- [TreeItem] Resources
|  |  |        |- [TreeItem] images
|  |  |        |  |- [TreeItem] icon.png
|  |  |        |- [TreeItem] data.json
|  |  |- [TabPage] Outline View
|  |     |- [Tree] Functions and Classes
|  |        |- [TreeItem] MyClass
|  |        |  |- [TreeItem] MyMethod()
|  |        |- [TreeItem] GlobalFunction()
|  |- [Grouping] Find and Replace
|     |- [TextBox] Find what:
|     |- [TextBox] Replace with:
|     |- [Button] Find Next
|     |- [Button] Replace All
|- [MenuBar] Main Menu
|  |- [MenuItem] File
|  |  |- [MenuItem] New
|  |  |- [MenuItem] Open...
|  |  |- [MenuItem] Save As...
|  |  |- [MenuItem] Recent Files
|  |  |  |- [MenuItem] document1.txt
|  |  |  |- [MenuItem] project_report.md
|  |  |- [MenuItem] Exit
|  |- [MenuItem] Edit
|  |  |- [MenuItem] Undo
|  |  |- [MenuItem] Redo
|  |  |- [MenuItem] Select All
|  |  |- [MenuItem] Advanced
|  |     |- [MenuItem] Go to Line...
|  |     |- [MenuItem] Toggle Comment
|  |- [MenuItem] View
|  |  |- [MenuItem] Toolbars
|  |  |  |- [MenuItem] Standard Toolbar
|  |  |  |- [MenuItem] Formatting Toolbar
|  |  |- [MenuItem] Status Bar
|  |  |- [MenuItem] Zoom
|  |     |- [MenuItem] Zoom In
|  |     |- [MenuItem] Zoom Out
|  |     |- [MenuItem] Reset Zoom
|  |- [MenuItem] Help
|     |- [MenuItem] About Advanced Text Editor
|- [StatusBar] Application Status
   |- [Text] Ln 10, Col 5 | Modified | UTF-8
   |- [ProgressBar] Saving... (if applicable)

Say for instance you need access to all of

[Tree] Files
[TextBox] Find what:
[TextBox] Replace with:
[MenuItem] Reset Zoom
[MenuItem] Go to Line...

It is sometimes difficult top understand what are the key common ancestors, especially for useful for performance.

Image

For instance it would be useful to do:

let panel = Window.findFirst((el)=>el.role == "Pane" && el.name == "Side Panel")
let tree = panel.findFirst((el)=>el.role == "Tree")
let FAndR = panel.findFirst((el)=>el.role == "Grouping" && el.name == ...)
...

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no files, tests, or entry points; start by reading the accessibility-tree example and the proposed JavaScript usage. Before implementation, clarify the ancestor-selection behavior and expected API, then define tests showing the requested nodes can be grouped and located through their common ancestors.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
accessibility, desktop-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.