Skip to content

Commit

Permalink
For mozilla-mobile#10285: Add a custom TextView for links with a11y i…
Browse files Browse the repository at this point in the history
…mprovements.
  • Loading branch information
mcarare committed May 6, 2020
1 parent 18bd93c commit f19ead0
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 0 deletions.
43 changes: 43 additions & 0 deletions app/src/main/java/org/mozilla/fenix/utils/LinkTextView.kt
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */

package org.mozilla.fenix.utils

import android.content.Context
import android.util.AttributeSet
import android.view.accessibility.AccessibilityNodeInfo
import android.view.accessibility.AccessibilityNodeInfo.AccessibilityAction.ACTION_LONG_CLICK
import androidx.appcompat.widget.AppCompatTextView
import androidx.core.view.accessibility.AccessibilityNodeInfoCompat
import org.mozilla.fenix.R

/**
* An [AppCompatTextView] that announces as link in screen readers for a11y purposes
*/
class LinkTextView @JvmOverloads constructor(
context: Context,
attrs: AttributeSet? = null,
defStyleAttr: Int = 0
) : AppCompatTextView(context, attrs, defStyleAttr) {

override fun onInitializeAccessibilityNodeInfo(info: AccessibilityNodeInfo?) {
super.onInitializeAccessibilityNodeInfo(info)
val extras = info?.extras
extras?.putCharSequence(
"AccessibilityNodeInfo.roleDescription",
context.resources.getString(R.string.link_text_view_type_announcement)
)

val customClick =
AccessibilityNodeInfo.AccessibilityAction(
AccessibilityNodeInfo.ACTION_CLICK,
context.resources.getString(R.string.link_text_view_action_click_announcement)
)

info?.addAction(customClick)
// disable long click announcement, as there is no action to be performed on long click
info?.isLongClickable = false
info?.removeAction(ACTION_LONG_CLICK)
}
}
5 changes: 5 additions & 0 deletions app/src/main/res/values/strings.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1324,4 +1324,9 @@
<string name="login_deletion_confirmation">Are you sure you want to delete this login?</string>
<!-- Positive action of a dialog asking to delete -->
<string name="dialog_delete_positive">Delete</string>

<!-- Content description (not visible, for screen readers etc.) used to announce [LinkTextView]. -->
<string name="link_text_view_type_announcement">Link</string>
<!-- Action description for click (not visible, for screen readers etc.) for [LinkTextView]. -->
<string name="link_text_view_action_click_announcement">Follow link</string>
</resources>

0 comments on commit f19ead0

Please sign in to comment.