前言:Android 应用的目标应该是让所有人都可以使用,包括有无障碍功能需求的人士。
有视觉障碍、色盲、视觉障碍、精细动作失能、认知障碍以及很多其他残疾的人员在日常生活中使用 Android 设备来完成各项任务。如果您能够在开发应用时考虑无障碍功能,那么您便可以改善用户体验,尤其是对于具有这些障碍和其他无障碍功能需求的用户来说。
在日常工作来说,对于一些系统性要求的公司,也是作为必须适配项之一。
1.启用焦点导航
Android提供了几个API让开发者决定用户界面控件是否可聚焦,甚至请求给控件赋予焦点:
如果视图不是默认聚焦,可以在布局文件中设置[android:focusable]
(http://developer.android.com/reference/android/view/View.html#attr_android:focusable)属性为true
,或者调用setFocusable()方法让视图可聚焦。
2.基本的Android无障碍适配-contentDescription
- 对于Android的基础组件ImageButton ImageView CheckBox等,只需要简单的在xml中设置 android:
contentDescription
="xx"属性或代码中动态设置view.setContentDescription("xx")即可。 - 对于EditText区域,提供
android:hint
属性代替内容描述,文本区域为空的时候此属性帮助用户理解应该输入什么样的内容。当文本区域填充上内容,TalkBack将会读出输入的文本,而不会读出提示文本。 - TextView或者继承至其的控件,如果contentDescription属性的值为空,无障碍服务会获取text属性的文本信息作为语音提示。
- 一般情况下,如果无障碍服务说明的是 ViewGroup,则会将来自其子 View 的内容标签合并在一起。要抑制此行为,并指明您希望为该项及其不可聚焦的子 View 提供自己的说明,
请在 ViewGroup 上设置 contentDescription。
比如有一个展示型卡片,不做任何设置时,可能实际无障碍自动播报的顺序或播报的内容和预期不符合,可以format需要播报的内容,给最外层view整体设置contentDescritpion。 - 对于一个不想让无障碍播报内容的view 想要移除其焦点,可以设置其
android:importantForAccessibility="no";
默认为yes - 希望一个view获取talkback的焦点,可以使用方法view.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
3.复杂view的无障碍适配
对于基础组件,设置contentDescritpion就可以达到目标,那对于我们自定义的复杂view(比如日历的月盘,chart 柱状图等)来说,又该如何交互与播报呢?
总的来说,通过在自定义view里设置 ViewCompat.setAccessibilityDelegate(this, accessibilityDelegate); 扩展各个无障碍方法,实现自定义的无障碍。
-
一个小小例子 AccessibilityDelegateSupportActivity.java
onPopulateAccessibilityEvent()方法可专门用来为事件添加或修改文本内容,这些信息会被如TalkBack的无障碍服务转化为音频反馈。
onInitializeAccessibilityNodeInfo()方法填充AccessibilityNodeInfo对象,视图层次在接收此事件后生成无障碍事件,无障碍服务使用AccessibilityNodeInfo对象访问该视图层次,获得更多的上下文信息并为用户提供合适的反馈。 -
一个详细讲的demo样例:
图表示例
这是一个 柱状图 横坐标代表的是24小时,纵轴是一些数据的展示,可忽略。现在的需求是在用户无障碍播报时可选中每小时对应的柱子
,播报当前小时以及该小时的具体内容。如果不做任何限制,当前是不会有焦点到这个自定义的柱子上的。
无障碍详情
附上关键代码
public class DayColumnChart extends View {
private MyAccessHelper mAccessHelper;//无障碍代理
private List<DayColumnData> mColumnData;//每小时对应的数据
public DayColumnChart(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
super(context, attrs, defStyleAttr, defStyleRes);
init();
}
....
....
private void init() {
mAccessHelper = new MyAccessHelper(this);
ViewCompat.setAccessibilityDelegate(this, mAccessHelper);
}
....
....
@Override
public boolean dispatchHoverEvent(MotionEvent event) {
return mAccessHelper.dispatchHoverEvent(event) || super.dispatchHoverEvent(event);
}
}
private class MyAccessHelper extends ExploreByTouchHelper {
private Rect mAccessRect;
/**
* Constructs a new helper that can expose a virtual view hierarchy for the specified host
* view.
*
* @param host view whose virtual view hierarchy is exposed by this helper
*/
MyAccessHelper(@NonNull View host) {
super(host);
mAccessRect = new Rect();
}
@Override
protected int getVirtualViewAt(float x, float y) {
checkSelectIndex(x, y);
return mSelectIndex;
}
@Override
protected void getVisibleVirtualViews(List<Integer> virtualViewIds) {
if (!ArrayUtils.isEmpty(mColumnData)) {
for (final DayColumnData columnDatum : mColumnData) {
virtualViewIds.add(columnDatum.getIndex());
}
}
}
@Override
protected void onPopulateNodeForVirtualView(int virtualViewId,
@NonNull AccessibilityNodeInfoCompat node) {
if (ArrayUtils.isEmpty(mColumnData) || getData(mSelectIndex) == null) {
mAccessRect.setEmpty();
node.setBoundsInParent(mAccessRect);
node.setEnabled(false);
node.setContentDescription("");
return;
}
DayColumnData dayColumnData = Objects.requireNonNull(getData(virtualViewId));
int startX = mFirstColumnMarginStart + (virtualViewId - mStartIndex) * (mSpaceWidth
+ mColumnWidth);
int endX = startX + mColumnWidth;
mAccessRect.set(startX, mLineTopY, endX, mLineBottomY);
node.setBoundsInParent(mAccessRect);
int max = dayColumnData.getMax();
int min = dayColumnData.getMin();
node.setClickable(true);
node.addAction(AccessibilityNodeInfoCompat.ACTION_CLICK);
final Resources resources = getResources();
String contentDescription = resources.getString(R.string.tb_blood_pressure_day_chart,
resources.getString(R.string.hour_in_day_format, virtualViewId), max, min);
node.setContentDescription(contentDescription);
}
private DayColumnData getData(int selectIndex) {
for (final DayColumnData data : mColumnData) {
if (data.getIndex() == selectIndex) {
return data;
}
}
return null;
}
@Override
protected boolean onPerformActionForVirtualView(int virtualViewId, int action,
@Nullable Bundle arguments) {
if (action == AccessibilityNodeInfoCompat.ACTION_CLICK
&& mChartHelper != null && mOnColumnClickListener != null) {
mOnColumnClickListener.onClick(mSelectIndex);
}
return false;
}
}
- ViewCompat.setAccessibilityDelegate(this, new MyAccessHelper(this));设置处理无障碍的代理
- 较好实现无障碍的方式是借助
ExploreByTouchHelper。
(主要参考了Android 5.1系统源码中LockPatternView类的无障碍实现)编写相应的ExploreByTouchHelper类,重载必要的方法实现自定义view无障碍。
- int getVirtualViewAt(float x, float y) x.y也就是我们处理onTouchEvent时获取的x,y 当有触摸事件时,根据x,y 返回当前是哪个结点,返回的int值由自己约定(和getVisibleVirtualViews方法对应,约定index)
- getVisibleVirtualViews(List<Integer> virtualViewIds) 添加想要聚焦的index 比如示例里 我只添加了有数据的分时柱子上,比如8,10,22 就代表8点,10点,22点 这三个有数据的位置需要播报无障碍.
- void onPopulateNodeForVirtualView(int virtualViewId, @NonNull AccessibilityNodeInfoCompat node) 给虚拟View设置描述文本和边框。在view刷新时,会遍历getVisibleVirtualViews我们添加的结点index,调用onPopulateNodeForVirtualView将焦点聚集,在node上设置要播报的内容,(还可以为其添加点击事件,添加的事件要在onPerformActionForVirtualView)处理,而setBoundsInParent方法传入一个rect,边框是指无障碍模式下选中的区块边界。
- onPerformActionForVirtualView 提供交互,触发回调重绘控件
- 重写dispatchHoverEvent事件 处理以及发送事件
精选参考文章:
无障碍学习整理(基于talkback)
从源码看Accessibility事件分发流程
无障碍功能概览 让应用无障碍_中文版对应 构建无障碍服务|Android开发
360烽火实验室 Android Accessibility安全性研究报告
网友评论