RowsFragment.java revision 32ba8fc7b148485db84aee7e37c0c1bca8260006
1/* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except 5 * in compliance with the License. You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software distributed under the License 10 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express 11 * or implied. See the License for the specific language governing permissions and limitations under 12 * the License. 13 */ 14package android.support.v17.leanback.app; 15 16import android.animation.TimeAnimator; 17import android.animation.TimeAnimator.TimeListener; 18import android.graphics.Canvas; 19import android.os.Bundle; 20import android.support.v17.leanback.R; 21import android.support.v17.leanback.graphics.ColorOverlayDimmer; 22import android.support.v17.leanback.widget.ItemBridgeAdapter; 23import android.support.v17.leanback.widget.VerticalGridView; 24import android.support.v17.leanback.widget.OnItemSelectedListener; 25import android.support.v17.leanback.widget.OnItemClickedListener; 26import android.support.v17.leanback.widget.RowPresenter; 27import android.support.v17.leanback.widget.Presenter; 28import android.support.v7.widget.RecyclerView; 29import android.util.Log; 30import android.view.View; 31import android.view.ViewGroup; 32import android.view.animation.DecelerateInterpolator; 33import android.view.animation.Interpolator; 34 35/** 36 * An ordered set of rows of leanback widgets. 37 */ 38public class RowsFragment extends BaseRowFragment { 39 40 /** 41 * Internal helper class that manages row select animation and apply a default 42 * dim to each row. 43 */ 44 final class RowViewHolderExtra implements TimeListener { 45 final RowPresenter mRowPresenter; 46 final Presenter.ViewHolder mRowViewHolder; 47 48 final TimeAnimator mSelectAnimator = new TimeAnimator(); 49 final ColorOverlayDimmer mColorDimmer; 50 int mSelectAnimatorDurationInUse; 51 Interpolator mSelectAnimatorInterpolatorInUse; 52 float mSelectLevelAnimStart; 53 float mSelectLevelAnimDelta; 54 55 RowViewHolderExtra(ItemBridgeAdapter.ViewHolder ibvh) { 56 mRowPresenter = (RowPresenter) ibvh.getPresenter(); 57 mRowViewHolder = ibvh.getViewHolder(); 58 mSelectAnimator.setTimeListener(this); 59 if (mRowPresenter.getSelectEffectEnabled() 60 && mRowPresenter.isUsingDefaultSelectEffect()) { 61 mColorDimmer = ColorOverlayDimmer.createDefault(ibvh.itemView.getContext()); 62 } else { 63 mColorDimmer = null; 64 } 65 } 66 67 @Override 68 public void onTimeUpdate(TimeAnimator animation, long totalTime, long deltaTime) { 69 float fraction; 70 if (totalTime >= mSelectAnimatorDurationInUse) { 71 fraction = 1; 72 mSelectAnimator.end(); 73 } else { 74 fraction = (float) (totalTime / (double) mSelectAnimatorDurationInUse); 75 } 76 if (mSelectAnimatorInterpolatorInUse != null) { 77 fraction = mSelectAnimatorInterpolatorInUse.getInterpolation(fraction); 78 } 79 float level = mSelectLevelAnimStart + fraction * mSelectLevelAnimDelta; 80 if (mColorDimmer != null) { 81 mColorDimmer.setActiveLevel(level); 82 } 83 mRowPresenter.setSelectLevel(mRowViewHolder, level); 84 } 85 86 void animateSelect(boolean select, boolean immediate) { 87 endAnimation(); 88 final float end = select ? 1 : 0; 89 if (immediate) { 90 mRowPresenter.setSelectLevel(mRowViewHolder, end); 91 if (mColorDimmer != null) { 92 mColorDimmer.setActiveLevel(end); 93 } 94 } else if (mRowPresenter.getSelectLevel(mRowViewHolder) != end) { 95 mSelectAnimatorDurationInUse = mSelectAnimatorDuration; 96 mSelectAnimatorInterpolatorInUse = mSelectAnimatorInterpolator; 97 mSelectLevelAnimStart = mRowPresenter.getSelectLevel(mRowViewHolder); 98 mSelectLevelAnimDelta = end - mSelectLevelAnimStart; 99 mSelectAnimator.start(); 100 } 101 } 102 103 void endAnimation() { 104 mSelectAnimator.end(); 105 } 106 107 void drawDimForSelection(Canvas c) { 108 if (mColorDimmer != null) { 109 mColorDimmer.drawColorOverlay(c, mRowViewHolder.view, false); 110 } 111 } 112 } 113 114 private static final String TAG = "RowsFragment"; 115 private static final boolean DEBUG = false; 116 117 private ItemBridgeAdapter.ViewHolder mSelectedViewHolder; 118 private boolean mExpand = true; 119 private boolean mViewsCreated; 120 121 private OnItemSelectedListener mOnItemSelectedListener; 122 private OnItemClickedListener mOnItemClickedListener; 123 124 // Select animation and interpolator are not intended to exposed at this moment. 125 // They might be synced with vertical scroll animation later. 126 int mSelectAnimatorDuration; 127 Interpolator mSelectAnimatorInterpolator = new DecelerateInterpolator(2); 128 129 /** 130 * Sets an item clicked listener on the fragment. 131 * OnItemClickedListener will override {@link View.OnClickListener} that 132 * item presenter sets during {@link Presenter#onCreateViewHolder(ViewGroup)}. 133 * So in general, developer should choose one of the listeners but not both. 134 */ 135 public void setOnItemClickedListener(OnItemClickedListener listener) { 136 mOnItemClickedListener = listener; 137 if (mViewsCreated) { 138 throw new IllegalStateException( 139 "Item clicked listener must be set before views are created"); 140 } 141 } 142 143 /** 144 * Returns the item clicked listener. 145 */ 146 public OnItemClickedListener getOnItemClickedListener() { 147 return mOnItemClickedListener; 148 } 149 150 /** 151 * Set the visibility of titles/hovercard of browse rows. 152 */ 153 public void setExpand(boolean expand) { 154 mExpand = expand; 155 VerticalGridView listView = getVerticalGridView(); 156 if (listView != null) { 157 listView.setActivated(expand); 158 final int count = listView.getChildCount(); 159 if (DEBUG) Log.v(TAG, "setExpand " + expand + " count " + count); 160 for (int i = 0; i < count; i++) { 161 View view = listView.getChildAt(i); 162 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) listView.getChildViewHolder(view); 163 setRowViewExpanded(vh, mExpand); 164 } 165 } 166 } 167 168 /** 169 * Sets an item selection listener. 170 */ 171 public void setOnItemSelectedListener(OnItemSelectedListener listener) { 172 mOnItemSelectedListener = listener; 173 VerticalGridView listView = getVerticalGridView(); 174 if (listView != null) { 175 final int count = listView.getChildCount(); 176 for (int i = 0; i < count; i++) { 177 View view = listView.getChildAt(i); 178 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) 179 listView.getChildViewHolder(view); 180 setOnItemSelectedListener(vh, mOnItemSelectedListener); 181 } 182 } 183 } 184 185 @Override 186 protected void onRowSelected(ViewGroup parent, View view, int position, long id) { 187 ItemBridgeAdapter.ViewHolder vh = (view == null) ? null : 188 (ItemBridgeAdapter.ViewHolder) getVerticalGridView().getChildViewHolder(view); 189 190 if (mSelectedViewHolder != vh) { 191 if (DEBUG) Log.v(TAG, "new row selected position " + position + " view " + view); 192 193 if (mSelectedViewHolder != null) { 194 setRowViewSelected(mSelectedViewHolder, false, false); 195 } 196 mSelectedViewHolder = vh; 197 if (mSelectedViewHolder != null) { 198 setRowViewSelected(mSelectedViewHolder, true, false); 199 } 200 } 201 } 202 203 @Override 204 protected int getLayoutResourceId() { 205 return R.layout.lb_rows_fragment; 206 } 207 208 @Override 209 public void onCreate(Bundle savedInstanceState) { 210 super.onCreate(savedInstanceState); 211 mSelectAnimatorDuration = getResources().getInteger(R.integer.lb_browse_rows_anim_duration); 212 } 213 214 @Override 215 public void onViewCreated(View view, Bundle savedInstanceState) { 216 if (DEBUG) Log.v(TAG, "onViewCreated"); 217 super.onViewCreated(view, savedInstanceState); 218 getVerticalGridView().setItemAlignmentViewId(R.id.row_content); 219 getVerticalGridView().addItemDecoration(mItemDecoration); 220 } 221 222 private RecyclerView.ItemDecoration mItemDecoration = new RecyclerView.ItemDecoration() { 223 @Override 224 public void onDrawOver(Canvas c, RecyclerView parent) { 225 final int count = parent.getChildCount(); 226 for (int i = 0; i < count; i++) { 227 ItemBridgeAdapter.ViewHolder ibvh = (ItemBridgeAdapter.ViewHolder) 228 parent.getViewHolderForChildAt(i); 229 RowViewHolderExtra extra = (RowViewHolderExtra) ibvh.getExtraObject(); 230 extra.drawDimForSelection(c); 231 } 232 } 233 }; 234 235 private static void setRowViewExpanded(ItemBridgeAdapter.ViewHolder vh, boolean expanded) { 236 ((RowPresenter) vh.getPresenter()).setRowViewExpanded(vh.getViewHolder(), expanded); 237 } 238 239 private static void setRowViewSelected(ItemBridgeAdapter.ViewHolder vh, boolean selected, 240 boolean immediate) { 241 RowViewHolderExtra extra = (RowViewHolderExtra) vh.getExtraObject(); 242 extra.animateSelect(selected, immediate); 243 ((RowPresenter) vh.getPresenter()).setRowViewSelected(vh.getViewHolder(), selected); 244 } 245 246 private static void setOnItemSelectedListener(ItemBridgeAdapter.ViewHolder vh, 247 OnItemSelectedListener listener) { 248 ((RowPresenter) vh.getPresenter()).setOnItemSelectedListener(listener); 249 } 250 251 private final ItemBridgeAdapter.AdapterListener mBridgeAdapterListener = 252 new ItemBridgeAdapter.AdapterListener() { 253 @Override 254 public void onAddPresenter(Presenter presenter) { 255 ((RowPresenter) presenter).setOnItemClickedListener(mOnItemClickedListener); 256 } 257 @Override 258 public void onCreate(ItemBridgeAdapter.ViewHolder vh) { 259 Presenter rowPresenter = vh.getPresenter(); 260 if (((RowPresenter) vh.getPresenter()).canDrawOutOfBounds()) { 261 getVerticalGridView().setClipChildren(false); 262 } 263 mViewsCreated = true; 264 vh.setExtraObject(new RowViewHolderExtra(vh)); 265 // selected state is initialized to false, then driven by grid view onChildSelected 266 // events. When there is rebind, grid view fires onChildSelected event properly. 267 // So we don't need do anything special later in onBind or onAttachedToWindow. 268 setRowViewSelected(vh, false, true); 269 } 270 @Override 271 public void onAttachedToWindow(ItemBridgeAdapter.ViewHolder vh) { 272 if (DEBUG) Log.v(TAG, "onAttachToWindow"); 273 // All views share the same mExpand value. When we attach a view to grid view, 274 // we should make sure it pick up the latest mExpand value we set early on other 275 // attached views. For no-structure-change update, the view is rebound to new data, 276 // but again it should use the unchanged mExpand value, so we don't need do any 277 // thing in onBind. 278 setRowViewExpanded(vh, mExpand); 279 setOnItemSelectedListener(vh, mOnItemSelectedListener); 280 } 281 @Override 282 public void onUnbind(ItemBridgeAdapter.ViewHolder vh) { 283 RowViewHolderExtra extra = (RowViewHolderExtra) vh.getExtraObject(); 284 extra.endAnimation(); 285 } 286 }; 287 288 @Override 289 protected void updateAdapter() { 290 super.updateAdapter(); 291 mSelectedViewHolder = null; 292 mViewsCreated = false; 293 294 ItemBridgeAdapter adapter = getBridgeAdapter(); 295 if (adapter != null) { 296 adapter.setAdapterListener(mBridgeAdapterListener); 297 } 298 } 299}