/* * Copyright (C) 2018 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.android.settings.widget; import static com.android.settings.SettingsActivity.EXTRA_FRAGMENT_ARG_KEY; import android.animation.Animator; import android.animation.AnimatorListenerAdapter; import android.animation.ArgbEvaluator; import android.animation.ValueAnimator; import android.content.Context; import android.graphics.Color; import android.os.Bundle; import android.support.annotation.VisibleForTesting; import android.support.v7.preference.PreferenceGroup; import android.support.v7.preference.PreferenceGroupAdapter; import android.support.v7.preference.PreferenceScreen; import android.support.v7.preference.PreferenceViewHolder; import android.support.v7.widget.RecyclerView; import android.text.TextUtils; import android.util.Log; import android.util.TypedValue; import android.view.View; import com.android.settings.R; import com.android.settings.SettingsPreferenceFragment; public class HighlightablePreferenceGroupAdapter extends PreferenceGroupAdapter { private static final String TAG = "HighlightableAdapter"; @VisibleForTesting static final long DELAY_HIGHLIGHT_DURATION_MILLIS = 600L; private static final long HIGHLIGHT_DURATION = 15000L; private static final long HIGHLIGHT_FADE_OUT_DURATION = 500L; private static final long HIGHLIGHT_FADE_IN_DURATION = 200L; @VisibleForTesting final int mHighlightColor; @VisibleForTesting boolean mFadeInAnimated; private final int mNormalBackgroundRes; private final String mHighlightKey; private boolean mHighlightRequested; private int mHighlightPosition = RecyclerView.NO_POSITION; /** * Tries to override initial expanded child count. * <p/> * Initial expanded child count will be ignored if: * 1. fragment contains request to highlight a particular row. * 2. count value is invalid. */ public static void adjustInitialExpandedChildCount(SettingsPreferenceFragment host) { if (host == null) { return; } final PreferenceScreen screen = host.getPreferenceScreen(); if (screen == null) { return; } final Bundle arguments = host.getArguments(); if (arguments != null) { final String highlightKey = arguments.getString(EXTRA_FRAGMENT_ARG_KEY); if (!TextUtils.isEmpty(highlightKey)) { // Has highlight row - expand everything screen.setInitialExpandedChildrenCount(Integer.MAX_VALUE); return; } } final int initialCount = host.getInitialExpandedChildCount(); if (initialCount <= 0) { return; } screen.setInitialExpandedChildrenCount(initialCount); } public HighlightablePreferenceGroupAdapter(PreferenceGroup preferenceGroup, String key, boolean highlightRequested) { super(preferenceGroup); mHighlightKey = key; mHighlightRequested = highlightRequested; final Context context = preferenceGroup.getContext(); final TypedValue outValue = new TypedValue(); context.getTheme().resolveAttribute(android.R.attr.selectableItemBackground, outValue, true /* resolveRefs */); mNormalBackgroundRes = outValue.resourceId; mHighlightColor = context.getColor(R.color.preference_highligh_color); } @Override public void onBindViewHolder(PreferenceViewHolder holder, int position) { super.onBindViewHolder(holder, position); updateBackground(holder, position); } @VisibleForTesting void updateBackground(PreferenceViewHolder holder, int position) { View v = holder.itemView; if (position == mHighlightPosition) { // This position should be highlighted. If it's highlighted before - skip animation. addHighlightBackground(v, !mFadeInAnimated); } else if (Boolean.TRUE.equals(v.getTag(R.id.preference_highlighted))) { // View with highlight is reused for a view that should not have highlight removeHighlightBackground(v, false /* animate */); } } public void requestHighlight(View root, RecyclerView recyclerView) { if (mHighlightRequested || recyclerView == null || TextUtils.isEmpty(mHighlightKey)) { return; } root.postDelayed(() -> { final int position = getPreferenceAdapterPosition(mHighlightKey); if (position < 0) { return; } mHighlightRequested = true; recyclerView.smoothScrollToPosition(position); mHighlightPosition = position; notifyItemChanged(position); }, DELAY_HIGHLIGHT_DURATION_MILLIS); } public boolean isHighlightRequested() { return mHighlightRequested; } @VisibleForTesting void requestRemoveHighlightDelayed(View v) { v.postDelayed(() -> { mHighlightPosition = RecyclerView.NO_POSITION; removeHighlightBackground(v, true /* animate */); }, HIGHLIGHT_DURATION); } private void addHighlightBackground(View v, boolean animate) { v.setTag(R.id.preference_highlighted, true); if (!animate) { v.setBackgroundColor(mHighlightColor); Log.d(TAG, "AddHighlight: Not animation requested - setting highlight background"); requestRemoveHighlightDelayed(v); return; } mFadeInAnimated = true; final int colorFrom = Color.WHITE; final int colorTo = mHighlightColor; final ValueAnimator fadeInLoop = ValueAnimator.ofObject( new ArgbEvaluator(), colorFrom, colorTo); fadeInLoop.setDuration(HIGHLIGHT_FADE_IN_DURATION); fadeInLoop.addUpdateListener( animator -> v.setBackgroundColor((int) animator.getAnimatedValue())); fadeInLoop.setRepeatMode(ValueAnimator.REVERSE); fadeInLoop.setRepeatCount(4); fadeInLoop.start(); Log.d(TAG, "AddHighlight: starting fade in animation"); requestRemoveHighlightDelayed(v); } private void removeHighlightBackground(View v, boolean animate) { if (!animate) { v.setTag(R.id.preference_highlighted, false); v.setBackgroundResource(mNormalBackgroundRes); Log.d(TAG, "RemoveHighlight: No animation requested - setting normal background"); return; } if (!Boolean.TRUE.equals(v.getTag(R.id.preference_highlighted))) { // Not highlighted, no-op Log.d(TAG, "RemoveHighlight: Not highlighted - skipping"); return; } int colorFrom = mHighlightColor; int colorTo = Color.WHITE; v.setTag(R.id.preference_highlighted, false); final ValueAnimator colorAnimation = ValueAnimator.ofObject( new ArgbEvaluator(), colorFrom, colorTo); colorAnimation.setDuration(HIGHLIGHT_FADE_OUT_DURATION); colorAnimation.addUpdateListener( animator -> v.setBackgroundColor((int) animator.getAnimatedValue())); colorAnimation.addListener(new AnimatorListenerAdapter() { @Override public void onAnimationEnd(Animator animation) { // Animation complete - the background is now white. Change to mNormalBackgroundRes // so it is white and has ripple on touch. v.setBackgroundResource(mNormalBackgroundRes); } }); colorAnimation.start(); Log.d(TAG, "Starting fade out animation"); } }