public final class

CarTextConstraints

extends java.lang.Object

 java.lang.Object

↳androidx.car.app.model.constraints.CarTextConstraints

Gradle dependencies

compile group: 'androidx.car.app', name: 'app', version: '1.2.0-rc01'

  • groupId: androidx.car.app
  • artifactId: app
  • version: 1.2.0-rc01

Artifact androidx.car.app:app:1.2.0-rc01 it located at Google repository (https://maven.google.com/)

Overview

Encapsulates the constraints to apply when rendering a CarText on a template.

Summary

Fields
public static final CarTextConstraintsCLICKABLE_TEXT_ONLY

Allow clickable text-only CarSpans.

public static final CarTextConstraintsCOLOR_ONLY

Allow color-only CarSpans.

public static final CarTextConstraintsCONSERVATIVE

No CarSpans allowed.

public static final CarTextConstraintsTEXT_AND_ICON

Allow text and icon CarSpans.

public static final CarTextConstraintsTEXT_ONLY

Allow text-only CarSpans.

public static final CarTextConstraintsTEXT_WITH_COLORS

Allow text and color CarSpans.

public static final CarTextConstraintsUNCONSTRAINED

Allow all CarSpans.

Methods
public voidvalidateOrThrow(CarText carText)

Returns true if the CarText meets the constraints' requirement.

from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields

public static final CarTextConstraints CONSERVATIVE

No CarSpans allowed.

public static final CarTextConstraints UNCONSTRAINED

Allow all CarSpans.

public static final CarTextConstraints CLICKABLE_TEXT_ONLY

Allow clickable text-only CarSpans.

public static final CarTextConstraints COLOR_ONLY

Allow color-only CarSpans.

public static final CarTextConstraints TEXT_ONLY

Allow text-only CarSpans.

public static final CarTextConstraints TEXT_AND_ICON

Allow text and icon CarSpans.

public static final CarTextConstraints TEXT_WITH_COLORS

Allow text and color CarSpans.

Methods

public void validateOrThrow(CarText carText)

Returns true if the CarText meets the constraints' requirement.

Source

/*
 * Copyright 2020 The Android Open Source Project
 *
 * 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 androidx.car.app.model.constraints;

import androidx.annotation.NonNull;
import androidx.annotation.RestrictTo;
import androidx.car.app.model.CarIconSpan;
import androidx.car.app.model.CarSpan;
import androidx.car.app.model.CarText;
import androidx.car.app.model.ClickableSpan;
import androidx.car.app.model.DistanceSpan;
import androidx.car.app.model.DurationSpan;
import androidx.car.app.model.ForegroundCarColorSpan;

import java.util.Arrays;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;

/**
 * Encapsulates the constraints to apply when rendering a {@link CarText} on a template.
 *
 * @hide
 */
@RestrictTo(RestrictTo.Scope.LIBRARY)
public final class CarTextConstraints {
    /** No {@link CarSpan}s allowed. */
    @NonNull
    public static final CarTextConstraints CONSERVATIVE =
            new CarTextConstraints(Collections.emptyList());

    /** Allow all {@link CarSpan}s. */
    @NonNull
    public static final CarTextConstraints UNCONSTRAINED =
            new CarTextConstraints(Arrays.asList(
                    CarIconSpan.class,
                    ClickableSpan.class,
                    DistanceSpan.class,
                    DurationSpan.class,
                    ForegroundCarColorSpan.class));

    /** Allow clickable text-only {@link CarSpan}s. */
    @NonNull
    public static final CarTextConstraints CLICKABLE_TEXT_ONLY =
            new CarTextConstraints(Arrays.asList(
                    ClickableSpan.class,
                    DistanceSpan.class,
                    DurationSpan.class));

    /** Allow color-only {@link CarSpan}s. */
    @NonNull
    public static final CarTextConstraints COLOR_ONLY =
            new CarTextConstraints(Arrays.asList(ForegroundCarColorSpan.class));

    /** Allow text-only {@link CarSpan}s. */
    @NonNull
    public static final CarTextConstraints TEXT_ONLY =
            new CarTextConstraints(Arrays.asList(
                    DistanceSpan.class,
                    DurationSpan.class));

    /** Allow text and icon {@link CarSpan}s. */
    @NonNull
    public static final CarTextConstraints TEXT_AND_ICON =
            new CarTextConstraints(Arrays.asList(
                    DistanceSpan.class,
                    DurationSpan.class,
                    CarIconSpan.class));

    /** Allow text and color {@link CarSpan}s. */
    @NonNull
    public static final CarTextConstraints TEXT_WITH_COLORS =
            new CarTextConstraints(Arrays.asList(
                    DistanceSpan.class,
                    DurationSpan.class,
                    ForegroundCarColorSpan.class));

    private final HashSet<Class<? extends CarSpan>> mAllowedTypes;

    /**
     * Returns {@code true} if the {@link CarText} meets the constraints' requirement.
     *
     * @throws IllegalArgumentException if any span types are not allowed
     */
    public void validateOrThrow(@NonNull CarText carText) {
        checkSupportedSpans(carText.getSpans());
        for (List<CarText.SpanWrapper> variantSpans : carText.getSpansForVariants()) {
            checkSupportedSpans(variantSpans);
        }
    }

    private void checkSupportedSpans(List<CarText.SpanWrapper> spans) {
        for (CarText.SpanWrapper span : spans) {
            Class<? extends CarSpan> klass = span.getCarSpan().getClass();
            if (!mAllowedTypes.contains(klass)) {
                throw new IllegalArgumentException(
                        "CarSpan type is not allowed: " + klass.getSimpleName());
            }
        }
    }

    private CarTextConstraints(List<Class<? extends CarSpan>> allowedSpans) {
        mAllowedTypes = new HashSet<>(allowedSpans);
    }
}