/* * Copyright (C) 2019 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 com.google.android.material.badge; import com.google.android.material.R; import static com.google.android.material.badge.BadgeUtils.updateBadgeBounds; import android.content.Context; import android.content.res.ColorStateList; import android.content.res.Resources; import android.content.res.TypedArray; import android.graphics.Canvas; import android.graphics.ColorFilter; import android.graphics.Paint; import android.graphics.PixelFormat; import android.graphics.Rect; import android.graphics.drawable.Drawable; import android.os.Parcel; import android.os.Parcelable; import androidx.annotation.AttrRes; import androidx.annotation.ColorInt; import androidx.annotation.NonNull; import androidx.annotation.Nullable; import androidx.annotation.PluralsRes; import androidx.annotation.StringRes; import androidx.annotation.StyleRes; import androidx.annotation.StyleableRes; import com.google.android.material.internal.TextDrawableHelper; import com.google.android.material.internal.TextDrawableHelper.TextDrawableDelegate; import com.google.android.material.internal.ThemeEnforcement; import com.google.android.material.resources.MaterialResources; import com.google.android.material.resources.TextAppearance; import com.google.android.material.shape.MaterialShapeDrawable; import androidx.core.view.ViewCompat; import android.util.AttributeSet; import android.view.View; import android.view.ViewGroup; import android.widget.FrameLayout; /** * BadgeDrawable contains all the layout and draw logic for a badge. * *
You can use {@code BadgeDrawable} to display dynamic information such as a number of pending * requests in a {@link com.google.android.material.bottomnavigation.BottomNavigationView}. To create an * instance of {@code BadgeDrawable}, use {@link #create(Context)} or {@link * #createFromAttributes(Context, AttributeSet, int, int)}. How to add and display a {@code * BadgeDrawable} on top of its anchor view depends on the API level: * *
For API 18+ (APIs supported by {@link android.view.ViewOverlay}) * *
* BadgeDrawable badgeDrawable = BadgeDrawable.create(context); * BadgeUtils.attachBadgeDrawable(badgeDrawable, anchor, null); ** *
For Pre API-18 * *
* BadgeDrawable badgeDrawable = BadgeDrawable.create(context); * BadgeUtils.attachBadgeDrawable(badgeDrawable, anchor, anchorFrameLayoutParent); ** * Note: This is still under development and may not support the full range of customization * Material Android components generally support (e.g. themed attributes). */ public class BadgeDrawable extends Drawable implements TextDrawableDelegate { /** * Maximum number of characters a badge supports displaying by default. It could be changed using * BadgeDrawable#setMaxBadgeCount. */ private static final int DEFAULT_MAX_BADGE_CHARACTER_COUNT = 4; /** Value of -1 denotes a numberless badge. */ private static final int BADGE_NUMBER_NONE = -1; /** Maximum value of number that can be displayed in a circular badge. */ private static final int MAX_CIRCULAR_BADGE_NUMBER_COUNT = 99; /** * If the badge number exceeds the maximum allowed number, append this suffix to the max badge * number and display is as the badge text instead. */ static final String DEFAULT_EXCEED_MAX_BADGE_NUMBER_SUFFIX = "+"; private final Context context; private final MaterialShapeDrawable shapeDrawable; private final TextDrawableHelper textDrawableHelper; private final Rect badgeBounds; private final float badgeRadius; private final float badgeWithTextRadius; private final float badgeWidePadding; private final Rect tmpRect; private final SavedState savedState; private float badgeCenterX; private float badgeCenterY; private int maxBadgeNumber; /** A {@link Parcelable} implementation used to ensure the state of BadgeDrawable is saved. */ public static final class SavedState implements Parcelable { @ColorInt private int backgroundColor; @ColorInt private int badgeTextColor; private int alpha = 255; private int number = BADGE_NUMBER_NONE; private int maxCharacterCount; private CharSequence contentDescriptionNumberless; @PluralsRes private int contentDescriptionQuantityStrings; public SavedState(Context context) { // If the badge text color attribute was not explicitly set, use the text color specified in // the TextAppearance. TextAppearance textAppearance = new TextAppearance(context, R.style.TextAppearance_MaterialComponents_Badge); badgeTextColor = textAppearance.textColor.getDefaultColor(); contentDescriptionNumberless = context.getString(R.string.mtrl_badge_numberless_content_description); contentDescriptionQuantityStrings = R.plurals.mtrl_badge_content_description; } protected SavedState(Parcel in) { backgroundColor = in.readInt(); badgeTextColor = in.readInt(); alpha = in.readInt(); number = in.readInt(); maxCharacterCount = in.readInt(); contentDescriptionNumberless = in.readString(); contentDescriptionQuantityStrings = in.readInt(); } public static final Creator
WARNING: Do not call this method if you are planning to compare to BADGE_NUMBER_NONE * * @see #setNumber(int) * @attr ref com.google.android.material.R.styleable#Badge_number */ public int getNumber() { if (!hasNumber()) { return 0; } return savedState.number; } /** * Sets this badge's number. Only non-negative integer numbers are supported. If the number is * negative, it will be clamped to 0. The specified value will be displayed, unless its number of * digits exceeds {@code maxCharacterCount} in which case a truncated version will be shown. * * @param number This badge's number. * @attr ref com.google.android.material.R.styleable#Badge_number */ public void setNumber(int number) { number = Math.max(0, number); if (this.savedState.number != number) { this.savedState.number = number; textDrawableHelper.setTextWidthDirty(true); updateBounds(); invalidateSelf(); } } /** Resets any badge number so that a numberless badge will be displayed. */ public void clearBadgeNumber() { savedState.number = BADGE_NUMBER_NONE; invalidateSelf(); } /** * Returns this badge's max character count. * * @see #setMaxCharacterCount(int) * @attr ref com.google.android.material.R.styleable#Badge_maxCharacterCount */ public int getMaxCharacterCount() { return savedState.maxCharacterCount; } /** * Sets this badge's max character count. * * @param maxCharacterCount This badge's max character count. * @attr ref com.google.android.material.R.styleable#Badge_maxCharacterCount */ public void setMaxCharacterCount(int maxCharacterCount) { if (this.savedState.maxCharacterCount != maxCharacterCount) { this.savedState.maxCharacterCount = maxCharacterCount; updateMaxBadgeNumber(); textDrawableHelper.setTextWidthDirty(true); updateBounds(); invalidateSelf(); } } @Override public boolean isStateful() { return false; } @Override public void setColorFilter(ColorFilter colorFilter) { // Intentionally empty. } @Override public int getAlpha() { return savedState.alpha; } @Override public void setAlpha(int alpha) { this.savedState.alpha = alpha; textDrawableHelper.getTextPaint().setAlpha(alpha); invalidateSelf(); } @Override public int getOpacity() { return PixelFormat.TRANSLUCENT; } /** Returns the height at which the badge would like to be laid out. */ @Override public int getIntrinsicHeight() { return badgeBounds.height(); } /** Returns the width at which the badge would like to be laid out. */ @Override public int getIntrinsicWidth() { return badgeBounds.width(); } @Override public void draw(Canvas canvas) { Rect bounds = getBounds(); if (bounds.isEmpty() || getAlpha() == 0 || !isVisible()) { return; } shapeDrawable.draw(canvas); if (hasNumber()) { drawText(canvas); } } // Implements the TextDrawableHelper.TextDrawableDelegate interface. @Override public void onTextSizeChange() { invalidateSelf(); } @Override public boolean onStateChange(int[] state) { return super.onStateChange(state); } public void setContentDescriptionNumberless(CharSequence charSequence) { savedState.contentDescriptionNumberless = charSequence; } public void setContentDescriptionQuantityStringsResource(@StringRes int stringsResource) { savedState.contentDescriptionQuantityStrings = stringsResource; } @Nullable public CharSequence getContentDescription(Context context) { if (!isVisible()) { return null; } if (hasNumber()) { if (savedState.contentDescriptionQuantityStrings > 0) { return context .getResources() .getQuantityString( savedState.contentDescriptionQuantityStrings, getNumber(), getNumber()); } else { return null; } } else { return savedState.contentDescriptionNumberless; } } private void setTextAppearanceResource(@StyleRes int id) { setTextAppearance(new TextAppearance(context, id)); } private void setTextAppearance(@Nullable TextAppearance textAppearance) { if (textDrawableHelper.getTextAppearance() == textAppearance) { return; } textDrawableHelper.setTextAppearance(textAppearance, context); updateBounds(); } private void updateBounds() { float cornerRadius; tmpRect.set(badgeBounds); if (getNumber() <= MAX_CIRCULAR_BADGE_NUMBER_COUNT) { cornerRadius = !hasNumber() ? badgeRadius : badgeWithTextRadius; updateBadgeBounds(badgeBounds, badgeCenterX, badgeCenterY, cornerRadius, cornerRadius); } else { cornerRadius = badgeWithTextRadius; float halfBadgeWidth = textDrawableHelper.getTextWidth(getBadgeText()) / 2f + badgeWidePadding; updateBadgeBounds(badgeBounds, badgeCenterX, badgeCenterY, halfBadgeWidth, cornerRadius); } shapeDrawable.setCornerRadius(cornerRadius); if (!tmpRect.equals(badgeBounds)) { shapeDrawable.setBounds(badgeBounds); } } private void drawText(Canvas canvas) { Rect textBounds = new Rect(); String countText = getBadgeText(); textDrawableHelper.getTextPaint().getTextBounds(countText, 0, countText.length(), textBounds); canvas.drawText( countText, badgeCenterX, badgeCenterY + textBounds.height() / 2, textDrawableHelper.getTextPaint()); } private String getBadgeText() { // If number exceeds max count, show badgeMaxCount+ instead of the number. if (getNumber() <= maxBadgeNumber) { return Integer.toString(getNumber()); } else { return context.getString( R.string.mtrl_exceed_max_badge_number_suffix, maxBadgeNumber, DEFAULT_EXCEED_MAX_BADGE_NUMBER_SUFFIX); } } private void updateMaxBadgeNumber() { maxBadgeNumber = (int) Math.pow(10.0d, (double) getMaxCharacterCount() - 1) - 1; } private void calculateBadgeCenterCoordinates( @NonNull View anchorView, @Nullable ViewGroup customBadgeParent) { Resources res = context.getResources(); Rect anchorRect = new Rect(); // Returns the visible bounds of the anchor view. anchorView.getDrawingRect(anchorRect); anchorRect.top += res.getDimensionPixelSize(R.dimen.mtrl_badge_vertical_offset); if (customBadgeParent != null || BadgeUtils.USE_COMPAT_PARENT) { // Calculates coordinates relative to the parent. ViewGroup viewGroup = customBadgeParent == null ? (ViewGroup) anchorView.getParent() : customBadgeParent; viewGroup.offsetDescendantRectToMyCoords(anchorView, anchorRect); } badgeCenterX = ViewCompat.getLayoutDirection(anchorView) == View.LAYOUT_DIRECTION_LTR ? anchorRect.right : anchorRect.left; badgeCenterY = anchorRect.top; } }