com.android.talkback.speechrules.RuleSwitch.java Source code

Introduction

Here is the source code for com.android.talkback.speechrules.RuleSwitch.java

Source

/*
 * 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;
    }
}