/*
* Copyright (C) 2013 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package com.android.talkback.speechrules;
import android.content.Context;
import android.support.v4.view.accessibility.AccessibilityNodeInfoCompat;
import android.text.SpannableStringBuilder;
import android.text.TextUtils;
import android.view.accessibility.AccessibilityEvent;
import com.android.talkback.R;
import com.android.utils.AccessibilityEventUtils;
import com.android.utils.Role;
import com.android.utils.StringBuilderUtils;
/**
* Formats speech for CompoundButton widgets.
*/
public class RuleSwitch extends RuleDefault {
@Override
public boolean accept(AccessibilityNodeInfoCompat node, AccessibilityEvent event) {
int role = Role.getRole(node);
return role == Role.ROLE_SWITCH || role == Role.ROLE_TOGGLE_BUTTON;
}
@Override
public CharSequence
format(Context context, AccessibilityNodeInfoCompat node, AccessibilityEvent event) {
final SpannableStringBuilder output = new SpannableStringBuilder();
final CharSequence text = (!TextUtils.isEmpty(node.getText())) ? node.getText()
: AccessibilityEventUtils.getEventAggregateText(event);
final CharSequence contentDescription = node.getContentDescription();
final CharSequence roleText = Role.getRoleDescriptionOrDefault(context, node);
// Prepend any contentDescription, if present
StringBuilderUtils.appendWithSeparator(output, contentDescription);
// Append node or event text
StringBuilderUtils.append(output, text, roleText);
// The text should contain the current state. Explicitly speak state for ToggleButtons.
if (TextUtils.isEmpty(text) || Role.getRole(node) == Role.ROLE_TOGGLE_BUTTON) {
final CharSequence state = context.getString(
node.isChecked() ? R.string.value_checked : R.string.value_not_checked);
StringBuilderUtils.appendWithSeparator(output, state);
}
return output;
}
}