RowsFragment.java revision 9de682083d3da5b1127969ee1fd7b74561aa9acd
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 java.util.ArrayList; 17 18import android.animation.TimeAnimator; 19import android.animation.TimeAnimator.TimeListener; 20import android.graphics.Canvas; 21import android.os.Bundle; 22import android.support.v17.leanback.R; 23import android.support.v17.leanback.graphics.ColorOverlayDimmer; 24import android.support.v17.leanback.widget.ItemBridgeAdapter; 25import android.support.v17.leanback.widget.RowPresenter.ViewHolder; 26import android.support.v17.leanback.widget.VerticalGridView; 27import android.support.v17.leanback.widget.HorizontalGridView; 28import android.support.v17.leanback.widget.OnItemSelectedListener; 29import android.support.v17.leanback.widget.OnItemClickedListener; 30import android.support.v17.leanback.widget.RowPresenter; 31import android.support.v17.leanback.widget.ListRowPresenter; 32import android.support.v17.leanback.widget.Presenter; 33import android.support.v7.widget.RecyclerView; 34import android.util.Log; 35import android.view.View; 36import android.view.ViewGroup; 37import android.view.animation.DecelerateInterpolator; 38import android.view.animation.Interpolator; 39 40/** 41 * An ordered set of rows of leanback widgets. 42 */ 43public class RowsFragment extends BaseRowFragment { 44 45 /** 46 * Internal helper class that manages row select animation and apply a default 47 * dim to each row. 48 */ 49 final class RowViewHolderExtra implements TimeListener { 50 final RowPresenter mRowPresenter; 51 final Presenter.ViewHolder mRowViewHolder; 52 53 final TimeAnimator mSelectAnimator = new TimeAnimator(); 54 final ColorOverlayDimmer mColorDimmer; 55 56 int mSelectAnimatorDurationInUse; 57 Interpolator mSelectAnimatorInterpolatorInUse; 58 float mSelectLevelAnimStart; 59 float mSelectLevelAnimDelta; 60 61 RowViewHolderExtra(ItemBridgeAdapter.ViewHolder ibvh) { 62 mRowPresenter = (RowPresenter) ibvh.getPresenter(); 63 mRowViewHolder = ibvh.getViewHolder(); 64 mSelectAnimator.setTimeListener(this); 65 if (mRowPresenter.getSelectEffectEnabled() 66 && mRowPresenter.isUsingDefaultSelectEffect()) { 67 mColorDimmer = ColorOverlayDimmer.createDefault(ibvh.itemView.getContext()); 68 } else { 69 mColorDimmer = null; 70 } 71 } 72 73 @Override 74 public void onTimeUpdate(TimeAnimator animation, long totalTime, long deltaTime) { 75 if (mSelectAnimator.isRunning()) { 76 updateSelect(totalTime, deltaTime); 77 } 78 } 79 80 void updateSelect(long totalTime, long deltaTime) { 81 float fraction; 82 if (totalTime >= mSelectAnimatorDurationInUse) { 83 fraction = 1; 84 mSelectAnimator.end(); 85 } else { 86 fraction = (float) (totalTime / (double) mSelectAnimatorDurationInUse); 87 } 88 if (mSelectAnimatorInterpolatorInUse != null) { 89 fraction = mSelectAnimatorInterpolatorInUse.getInterpolation(fraction); 90 } 91 float level = mSelectLevelAnimStart + fraction * mSelectLevelAnimDelta; 92 if (mColorDimmer != null) { 93 mColorDimmer.setActiveLevel(level); 94 } 95 mRowPresenter.setSelectLevel(mRowViewHolder, level); 96 } 97 98 void animateSelect(boolean select, boolean immediate) { 99 endSelectAnimation(); 100 final float end = select ? 1 : 0; 101 if (immediate) { 102 mRowPresenter.setSelectLevel(mRowViewHolder, end); 103 if (mColorDimmer != null) { 104 mColorDimmer.setActiveLevel(end); 105 } 106 } else if (mRowPresenter.getSelectLevel(mRowViewHolder) != end) { 107 mSelectAnimatorDurationInUse = mSelectAnimatorDuration; 108 mSelectAnimatorInterpolatorInUse = mSelectAnimatorInterpolator; 109 mSelectLevelAnimStart = mRowPresenter.getSelectLevel(mRowViewHolder); 110 mSelectLevelAnimDelta = end - mSelectLevelAnimStart; 111 mSelectAnimator.start(); 112 } 113 } 114 115 void endAnimations() { 116 endSelectAnimation(); 117 } 118 119 void endSelectAnimation() { 120 mSelectAnimator.end(); 121 } 122 123 void drawDimForSelection(Canvas c) { 124 if (mColorDimmer != null) { 125 mColorDimmer.drawColorOverlay(c, mRowViewHolder.view, false); 126 } 127 } 128 } 129 130 private static final String TAG = "RowsFragment"; 131 private static final boolean DEBUG = false; 132 133 private ItemBridgeAdapter.ViewHolder mSelectedViewHolder; 134 private boolean mExpand = true; 135 private boolean mViewsCreated; 136 137 private OnItemSelectedListener mOnItemSelectedListener; 138 private OnItemClickedListener mOnItemClickedListener; 139 140 // Select animation and interpolator are not intended to be 141 // exposed at this moment. They might be synced with vertical scroll 142 // animation later. 143 int mSelectAnimatorDuration; 144 Interpolator mSelectAnimatorInterpolator = new DecelerateInterpolator(2); 145 146 private RecyclerView.RecycledViewPool mRecycledViewPool; 147 private ArrayList<Presenter> mPresenterMapper; 148 149 /** 150 * Sets an item clicked listener on the fragment. 151 * OnItemClickedListener will override {@link View.OnClickListener} that 152 * item presenter sets during {@link Presenter#onCreateViewHolder(ViewGroup)}. 153 * So in general, developer should choose one of the listeners but not both. 154 */ 155 public void setOnItemClickedListener(OnItemClickedListener listener) { 156 mOnItemClickedListener = listener; 157 if (mViewsCreated) { 158 throw new IllegalStateException( 159 "Item clicked listener must be set before views are created"); 160 } 161 } 162 163 /** 164 * Returns the item clicked listener. 165 */ 166 public OnItemClickedListener getOnItemClickedListener() { 167 return mOnItemClickedListener; 168 } 169 170 /** 171 * Set the visibility of titles/hovercard of browse rows. 172 */ 173 public void setExpand(boolean expand) { 174 mExpand = expand; 175 VerticalGridView listView = getVerticalGridView(); 176 if (listView != null) { 177 final int count = listView.getChildCount(); 178 if (DEBUG) Log.v(TAG, "setExpand " + expand + " count " + count); 179 for (int i = 0; i < count; i++) { 180 View view = listView.getChildAt(i); 181 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) listView.getChildViewHolder(view); 182 setRowViewExpanded(vh, mExpand); 183 } 184 } 185 } 186 187 /** 188 * Sets an item selection listener. 189 */ 190 public void setOnItemSelectedListener(OnItemSelectedListener listener) { 191 mOnItemSelectedListener = listener; 192 VerticalGridView listView = getVerticalGridView(); 193 if (listView != null) { 194 final int count = listView.getChildCount(); 195 for (int i = 0; i < count; i++) { 196 View view = listView.getChildAt(i); 197 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) 198 listView.getChildViewHolder(view); 199 setOnItemSelectedListener(vh, mOnItemSelectedListener); 200 } 201 } 202 } 203 204 @Override 205 protected void onRowSelected(ViewGroup parent, View view, int position, long id) { 206 VerticalGridView listView = getVerticalGridView(); 207 if (listView == null) { 208 return; 209 } 210 ItemBridgeAdapter.ViewHolder vh = (view == null) ? null : 211 (ItemBridgeAdapter.ViewHolder) listView.getChildViewHolder(view); 212 213 if (mSelectedViewHolder != vh) { 214 if (DEBUG) Log.v(TAG, "new row selected position " + position + " view " + view); 215 216 if (mSelectedViewHolder != null) { 217 setRowViewSelected(mSelectedViewHolder, false, false); 218 } 219 mSelectedViewHolder = vh; 220 if (mSelectedViewHolder != null) { 221 setRowViewSelected(mSelectedViewHolder, true, false); 222 } 223 } 224 } 225 226 @Override 227 protected int getLayoutResourceId() { 228 return R.layout.lb_rows_fragment; 229 } 230 231 @Override 232 public void onCreate(Bundle savedInstanceState) { 233 super.onCreate(savedInstanceState); 234 mSelectAnimatorDuration = getResources().getInteger(R.integer.lb_browse_rows_anim_duration); 235 } 236 237 @Override 238 public void onViewCreated(View view, Bundle savedInstanceState) { 239 if (DEBUG) Log.v(TAG, "onViewCreated"); 240 super.onViewCreated(view, savedInstanceState); 241 // Align the top edge of child with id row_content. 242 // Need set this for directly using RowsFragment. 243 getVerticalGridView().setItemAlignmentViewId(R.id.row_content); 244 getVerticalGridView().addItemDecoration(mItemDecoration); 245 246 mRecycledViewPool = null; 247 mPresenterMapper = null; 248 } 249 250 @Override 251 void setItemAlignment() { 252 super.setItemAlignment(); 253 if (getVerticalGridView() != null) { 254 getVerticalGridView().setItemAlignmentOffsetWithPadding(true); 255 } 256 } 257 258 private RecyclerView.ItemDecoration mItemDecoration = new RecyclerView.ItemDecoration() { 259 @Override 260 public void onDrawOver(Canvas c, RecyclerView parent) { 261 final int count = parent.getChildCount(); 262 for (int i = 0; i < count; i++) { 263 ItemBridgeAdapter.ViewHolder ibvh = (ItemBridgeAdapter.ViewHolder) 264 parent.getChildViewHolder(parent.getChildAt(i)); 265 RowViewHolderExtra extra = (RowViewHolderExtra) ibvh.getExtraObject(); 266 extra.drawDimForSelection(c); 267 } 268 } 269 }; 270 271 private static void setRowViewExpanded(ItemBridgeAdapter.ViewHolder vh, boolean expanded) { 272 ((RowPresenter) vh.getPresenter()).setRowViewExpanded(vh.getViewHolder(), expanded); 273 } 274 275 private static void setRowViewSelected(ItemBridgeAdapter.ViewHolder vh, boolean selected, 276 boolean immediate) { 277 RowViewHolderExtra extra = (RowViewHolderExtra) vh.getExtraObject(); 278 extra.animateSelect(selected, immediate); 279 ((RowPresenter) vh.getPresenter()).setRowViewSelected(vh.getViewHolder(), selected); 280 } 281 282 private static void setOnItemSelectedListener(ItemBridgeAdapter.ViewHolder vh, 283 OnItemSelectedListener listener) { 284 ((RowPresenter) vh.getPresenter()).setOnItemSelectedListener(listener); 285 } 286 287 private final ItemBridgeAdapter.AdapterListener mBridgeAdapterListener = 288 new ItemBridgeAdapter.AdapterListener() { 289 @Override 290 public void onAddPresenter(Presenter presenter, int type) { 291 ((RowPresenter) presenter).setOnItemClickedListener(mOnItemClickedListener); 292 } 293 @Override 294 public void onCreate(ItemBridgeAdapter.ViewHolder vh) { 295 VerticalGridView listView = getVerticalGridView(); 296 if (listView != null && ((RowPresenter) vh.getPresenter()).canDrawOutOfBounds()) { 297 listView.setClipChildren(false); 298 } 299 setupSharedViewPool(vh.getViewHolder()); 300 mViewsCreated = true; 301 vh.setExtraObject(new RowViewHolderExtra(vh)); 302 // selected state is initialized to false, then driven by grid view onChildSelected 303 // events. When there is rebind, grid view fires onChildSelected event properly. 304 // So we don't need do anything special later in onBind or onAttachedToWindow. 305 setRowViewSelected(vh, false, true); 306 } 307 @Override 308 public void onAttachedToWindow(ItemBridgeAdapter.ViewHolder vh) { 309 if (DEBUG) Log.v(TAG, "onAttachToWindow"); 310 // All views share the same mExpand value. When we attach a view to grid view, 311 // we should make sure it pick up the latest mExpand value we set early on other 312 // attached views. For no-structure-change update, the view is rebound to new data, 313 // but again it should use the unchanged mExpand value, so we don't need do any 314 // thing in onBind. 315 setRowViewExpanded(vh, mExpand); 316 setOnItemSelectedListener(vh, mOnItemSelectedListener); 317 } 318 @Override 319 public void onUnbind(ItemBridgeAdapter.ViewHolder vh) { 320 RowViewHolderExtra extra = (RowViewHolderExtra) vh.getExtraObject(); 321 extra.endAnimations(); 322 } 323 }; 324 325 private void setupSharedViewPool(Presenter.ViewHolder viewHolder) { 326 if (viewHolder instanceof ListRowPresenter.ViewHolder) { 327 HorizontalGridView view = ((ListRowPresenter.ViewHolder) viewHolder).getGridView(); 328 // Recycled view pool is shared between all list rows 329 if (mRecycledViewPool == null) { 330 mRecycledViewPool = view.getRecycledViewPool(); 331 } else { 332 view.setRecycledViewPool(mRecycledViewPool); 333 } 334 335 ItemBridgeAdapter bridgeAdapter = 336 ((ListRowPresenter.ViewHolder) viewHolder).getBridgeAdapter(); 337 if (mPresenterMapper == null) { 338 mPresenterMapper = bridgeAdapter.getPresenterMapper(); 339 } else { 340 bridgeAdapter.setPresenterMapper(mPresenterMapper); 341 } 342 } 343 } 344 345 @Override 346 protected void updateAdapter() { 347 super.updateAdapter(); 348 mSelectedViewHolder = null; 349 mViewsCreated = false; 350 351 ItemBridgeAdapter adapter = getBridgeAdapter(); 352 if (adapter != null) { 353 adapter.setAdapterListener(mBridgeAdapterListener); 354 } 355 } 356 357} 358