Android accessibility identify heading

Question

I have the latest version of Talkback and its announcing "My Top level Text Heading". Android native behaviour is adding "Heading" for my top level elements. I could not find a way to switch ON/OFF heading announcement. Is there an API to control its behaviour. In the previous version of Talkback versions it was not announcing "Heading" by itself.

What kind of control are you using to get it to read this? I have the opposite problem, I WANT it to read heading and have been having to put it in manually on the content description. — Mr_E, Mar 14 '17 at 14:29

score 8 · Answer 1 · edited Mar 18 '22 at 02:27

8

You can enable or disable the "heading" accessibility property of any View on API 19+:

ViewCompat.setAccessibilityDelegate(headingView, new AccessibilityDelegateCompat() {
  @Override
  public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfoCompat info) {
    super.onInitializeAccessibilityNodeInfo(host, info);
    info.setHeading(true); // false to mark a view as not a heading
  }
});

If you have minSdk 28, you can simply set this directly in your XML:

android:accessibilityHeading="false"

edited Mar 18 '22 at 02:27

Community

1
1

answered Jan 07 '19 at 21:51

Adam S

16,144
6
54
81

1

in which API this method added? `AccessibilityNodeInfoCompat#setHeading(boolean)` – MilapTank Feb 12 '19 at 11:46
2

Hi @Adam S , this does not appear to work for me. The textview is not announcing that it is a heading when you do `setHeading(true)`. – h_k Nov 04 '19 at 15:17
Yup, it's added in 28 https://developer.android.com/reference/android/view/accessibility/AccessibilityNodeInfo#setHeading(boolean) – Kornilov Ruslan Oct 09 '20 at 15:54

nbystndr · Answer 2 · 2023-08-04T07:59:41.743

5

Here is a simpler method:

ViewCompat.setAccessibilityHeading(headingView, false);

https://developer.android.com/reference/androidx/core/view/ViewCompat#setAccessibilityHeading(android.view.View,%20boolean)

edited Aug 04 '23 at 07:59

answered Jul 16 '20 at 07:40

nbystndr

521
1
6
15

It's for 19 and lower. – Kornilov Ruslan Oct 09 '20 at 15:48
@KornilovRuslan The doc says that this is a no-op on API < 19 – Dan Ahlquist Oct 12 '21 at 21:13

score 1 · Answer 3 · answered Sep 13 '17 at 21:11

If you're only supporting API level 23 and above, you can simply do the following.

textView.setAccessibilityDelegate(new View.AccessibilityDelegate() {
  @Override
  public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
    super.onInitializeAccessibilityNodeInfo(host, info);
    //blanked to prevent talkback from announcing class/type
    info.setClassName("");
  }
});

score 1 · Answer 4 · edited Sep 19 '17 at 19:37

1

I solved this by passing heading as false in

AccessibilityNodeInfoCompat.CollectionItemInfoCompat.obtain method.

        // set the heading attribute to false so that heading is not announced in label  

info.setCollectionItemInfo(
    AccessibilityNodeInfoCompat.CollectionItemInfoCompat.obtain(glp.getSpanIndex(),
 glp.getSpanSize(), spanGroupIndex, 1, false, false));

public static CollectionItemInfoCompat obtain(int rowIndex, 
int rowSpan, int columnIndex, int columnSpan,
boolean heading, boolean selected)

edited Sep 19 '17 at 19:37

moxi

1,390
20
21

answered Sep 14 '17 at 06:19

Shivam

123
1
1
5

2

how do you get glp, Or what's glp? – moxi Sep 19 '17 at 18:15

Android accessibility identify heading

4 Answers4