RowsFragment.java revision 1102fc6fafe721522f2b67f86d89feda87096265
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.os.Bundle; 21import android.support.v17.leanback.R; 22import android.support.v17.leanback.widget.ItemBridgeAdapter; 23import android.support.v17.leanback.widget.OnItemViewClickedListener; 24import android.support.v17.leanback.widget.OnItemViewSelectedListener; 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 55 int mSelectAnimatorDurationInUse; 56 Interpolator mSelectAnimatorInterpolatorInUse; 57 float mSelectLevelAnimStart; 58 float mSelectLevelAnimDelta; 59 60 RowViewHolderExtra(ItemBridgeAdapter.ViewHolder ibvh) { 61 mRowPresenter = (RowPresenter) ibvh.getPresenter(); 62 mRowViewHolder = ibvh.getViewHolder(); 63 mSelectAnimator.setTimeListener(this); 64 } 65 66 @Override 67 public void onTimeUpdate(TimeAnimator animation, long totalTime, long deltaTime) { 68 if (mSelectAnimator.isRunning()) { 69 updateSelect(totalTime, deltaTime); 70 } 71 } 72 73 void updateSelect(long totalTime, long deltaTime) { 74 float fraction; 75 if (totalTime >= mSelectAnimatorDurationInUse) { 76 fraction = 1; 77 mSelectAnimator.end(); 78 } else { 79 fraction = (float) (totalTime / (double) mSelectAnimatorDurationInUse); 80 } 81 if (mSelectAnimatorInterpolatorInUse != null) { 82 fraction = mSelectAnimatorInterpolatorInUse.getInterpolation(fraction); 83 } 84 float level = mSelectLevelAnimStart + fraction * mSelectLevelAnimDelta; 85 mRowPresenter.setSelectLevel(mRowViewHolder, level); 86 } 87 88 void animateSelect(boolean select, boolean immediate) { 89 endSelectAnimation(); 90 final float end = select ? 1 : 0; 91 if (immediate) { 92 mRowPresenter.setSelectLevel(mRowViewHolder, end); 93 } else if (mRowPresenter.getSelectLevel(mRowViewHolder) != end) { 94 mSelectAnimatorDurationInUse = mSelectAnimatorDuration; 95 mSelectAnimatorInterpolatorInUse = mSelectAnimatorInterpolator; 96 mSelectLevelAnimStart = mRowPresenter.getSelectLevel(mRowViewHolder); 97 mSelectLevelAnimDelta = end - mSelectLevelAnimStart; 98 mSelectAnimator.start(); 99 } 100 } 101 102 void endAnimations() { 103 endSelectAnimation(); 104 } 105 106 void endSelectAnimation() { 107 mSelectAnimator.end(); 108 } 109 110 } 111 112 private static final String TAG = "RowsFragment"; 113 private static final boolean DEBUG = false; 114 115 private ItemBridgeAdapter.ViewHolder mSelectedViewHolder; 116 private boolean mExpand = true; 117 private boolean mViewsCreated; 118 119 private OnItemSelectedListener mOnItemSelectedListener; 120 private OnItemViewSelectedListener mOnItemViewSelectedListener; 121 private OnItemClickedListener mOnItemClickedListener; 122 private OnItemViewClickedListener mOnItemViewClickedListener; 123 124 // Select animation and interpolator are not intended to be 125 // exposed at this moment. They might be synced with vertical scroll 126 // animation later. 127 int mSelectAnimatorDuration; 128 Interpolator mSelectAnimatorInterpolator = new DecelerateInterpolator(2); 129 130 private RecyclerView.RecycledViewPool mRecycledViewPool; 131 private ArrayList<Presenter> mPresenterMapper; 132 133 private ItemBridgeAdapter.AdapterListener mExternalAdapterListener; 134 135 /** 136 * Sets an item clicked listener on the fragment. 137 * OnItemClickedListener will override {@link View.OnClickListener} that 138 * item presenter sets during {@link Presenter#onCreateViewHolder(ViewGroup)}. 139 * So in general, developer should choose one of the listeners but not both. 140 * @deprecated Use {@link #setOnItemViewClickedListener(OnItemViewClickedListener)} 141 */ 142 public void setOnItemClickedListener(OnItemClickedListener listener) { 143 mOnItemClickedListener = listener; 144 if (mViewsCreated) { 145 throw new IllegalStateException( 146 "Item clicked listener must be set before views are created"); 147 } 148 } 149 150 /** 151 * Returns the item clicked listener. 152 * @deprecated Use {@link #getOnItemClickedListener()} 153 */ 154 public OnItemClickedListener getOnItemClickedListener() { 155 return mOnItemClickedListener; 156 } 157 158 /** 159 * Sets an item clicked listener on the fragment. 160 * OnItemViewClickedListener will override {@link View.OnClickListener} that 161 * item presenter sets during {@link Presenter#onCreateViewHolder(ViewGroup)}. 162 * So in general, developer should choose one of the listeners but not both. 163 */ 164 public void setOnItemViewClickedListener(OnItemViewClickedListener listener) { 165 mOnItemViewClickedListener = listener; 166 if (mViewsCreated) { 167 throw new IllegalStateException( 168 "Item clicked listener must be set before views are created"); 169 } 170 } 171 172 /** 173 * Returns the item clicked listener. 174 */ 175 public OnItemViewClickedListener getOnItemViewClickedListener() { 176 return mOnItemViewClickedListener; 177 } 178 179 /** 180 * Set the visibility of titles/hovercard of browse rows. 181 */ 182 public void setExpand(boolean expand) { 183 mExpand = expand; 184 VerticalGridView listView = getVerticalGridView(); 185 if (listView != null) { 186 final int count = listView.getChildCount(); 187 if (DEBUG) Log.v(TAG, "setExpand " + expand + " count " + count); 188 for (int i = 0; i < count; i++) { 189 View view = listView.getChildAt(i); 190 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) listView.getChildViewHolder(view); 191 setRowViewExpanded(vh, mExpand); 192 } 193 } 194 } 195 196 /** 197 * Sets an item selection listener. 198 * @deprecated Use {@link #setOnItemViewSelectedListener(OnItemViewSelectedListener)} 199 */ 200 public void setOnItemSelectedListener(OnItemSelectedListener listener) { 201 mOnItemSelectedListener = listener; 202 VerticalGridView listView = getVerticalGridView(); 203 if (listView != null) { 204 final int count = listView.getChildCount(); 205 for (int i = 0; i < count; i++) { 206 View view = listView.getChildAt(i); 207 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) 208 listView.getChildViewHolder(view); 209 setOnItemSelectedListener(vh, mOnItemSelectedListener); 210 } 211 } 212 } 213 214 /** 215 * Sets an item selection listener. 216 */ 217 public void setOnItemViewSelectedListener(OnItemViewSelectedListener listener) { 218 mOnItemViewSelectedListener = listener; 219 VerticalGridView listView = getVerticalGridView(); 220 if (listView != null) { 221 final int count = listView.getChildCount(); 222 for (int i = 0; i < count; i++) { 223 View view = listView.getChildAt(i); 224 ItemBridgeAdapter.ViewHolder vh = (ItemBridgeAdapter.ViewHolder) 225 listView.getChildViewHolder(view); 226 setOnItemViewSelectedListener(vh, mOnItemViewSelectedListener); 227 } 228 } 229 } 230 231 /** 232 * Returns an item selection listener. 233 */ 234 public OnItemViewSelectedListener getOnItemViewSelectedListener() { 235 return mOnItemViewSelectedListener; 236 } 237 238 @Override 239 protected void onRowSelected(ViewGroup parent, View view, int position, long id) { 240 VerticalGridView listView = getVerticalGridView(); 241 if (listView == null) { 242 return; 243 } 244 ItemBridgeAdapter.ViewHolder vh = (view == null) ? null : 245 (ItemBridgeAdapter.ViewHolder) listView.getChildViewHolder(view); 246 247 if (mSelectedViewHolder != vh) { 248 if (DEBUG) Log.v(TAG, "new row selected position " + position + " view " + view); 249 250 if (mSelectedViewHolder != null) { 251 setRowViewSelected(mSelectedViewHolder, false, false); 252 } 253 mSelectedViewHolder = vh; 254 if (mSelectedViewHolder != null) { 255 setRowViewSelected(mSelectedViewHolder, true, false); 256 } 257 } 258 } 259 260 @Override 261 protected int getLayoutResourceId() { 262 return R.layout.lb_rows_fragment; 263 } 264 265 @Override 266 public void onCreate(Bundle savedInstanceState) { 267 super.onCreate(savedInstanceState); 268 mSelectAnimatorDuration = getResources().getInteger(R.integer.lb_browse_rows_anim_duration); 269 } 270 271 @Override 272 public void onViewCreated(View view, Bundle savedInstanceState) { 273 if (DEBUG) Log.v(TAG, "onViewCreated"); 274 super.onViewCreated(view, savedInstanceState); 275 // Align the top edge of child with id row_content. 276 // Need set this for directly using RowsFragment. 277 getVerticalGridView().setItemAlignmentViewId(R.id.row_content); 278 getVerticalGridView().setSaveChildrenPolicy(VerticalGridView.SAVE_LIMITED_CHILD); 279 280 mRecycledViewPool = null; 281 mPresenterMapper = null; 282 } 283 284 @Override 285 void setItemAlignment() { 286 super.setItemAlignment(); 287 if (getVerticalGridView() != null) { 288 getVerticalGridView().setItemAlignmentOffsetWithPadding(true); 289 } 290 } 291 292 void setExternalAdapterListener(ItemBridgeAdapter.AdapterListener listener) { 293 mExternalAdapterListener = listener; 294 } 295 296 private static void setRowViewExpanded(ItemBridgeAdapter.ViewHolder vh, boolean expanded) { 297 ((RowPresenter) vh.getPresenter()).setRowViewExpanded(vh.getViewHolder(), expanded); 298 } 299 300 private static void setRowViewSelected(ItemBridgeAdapter.ViewHolder vh, boolean selected, 301 boolean immediate) { 302 RowViewHolderExtra extra = (RowViewHolderExtra) vh.getExtraObject(); 303 extra.animateSelect(selected, immediate); 304 ((RowPresenter) vh.getPresenter()).setRowViewSelected(vh.getViewHolder(), selected); 305 } 306 307 private static void setOnItemSelectedListener(ItemBridgeAdapter.ViewHolder vh, 308 OnItemSelectedListener listener) { 309 ((RowPresenter) vh.getPresenter()).setOnItemSelectedListener(listener); 310 } 311 312 private static void setOnItemViewSelectedListener(ItemBridgeAdapter.ViewHolder vh, 313 OnItemViewSelectedListener listener) { 314 ((RowPresenter) vh.getPresenter()).setOnItemViewSelectedListener(listener); 315 } 316 317 private final ItemBridgeAdapter.AdapterListener mBridgeAdapterListener = 318 new ItemBridgeAdapter.AdapterListener() { 319 @Override 320 public void onAddPresenter(Presenter presenter, int type) { 321 ((RowPresenter) presenter).setOnItemClickedListener(mOnItemClickedListener); 322 ((RowPresenter) presenter).setOnItemViewClickedListener(mOnItemViewClickedListener); 323 if (mExternalAdapterListener != null) { 324 mExternalAdapterListener.onAddPresenter(presenter, type); 325 } 326 } 327 @Override 328 public void onCreate(ItemBridgeAdapter.ViewHolder vh) { 329 VerticalGridView listView = getVerticalGridView(); 330 if (listView != null && ((RowPresenter) vh.getPresenter()).canDrawOutOfBounds()) { 331 listView.setClipChildren(false); 332 } 333 setupSharedViewPool(vh); 334 mViewsCreated = true; 335 vh.setExtraObject(new RowViewHolderExtra(vh)); 336 // selected state is initialized to false, then driven by grid view onChildSelected 337 // events. When there is rebind, grid view fires onChildSelected event properly. 338 // So we don't need do anything special later in onBind or onAttachedToWindow. 339 setRowViewSelected(vh, false, true); 340 if (mExternalAdapterListener != null) { 341 mExternalAdapterListener.onCreate(vh); 342 } 343 } 344 @Override 345 public void onAttachedToWindow(ItemBridgeAdapter.ViewHolder vh) { 346 if (DEBUG) Log.v(TAG, "onAttachToWindow"); 347 // All views share the same mExpand value. When we attach a view to grid view, 348 // we should make sure it pick up the latest mExpand value we set early on other 349 // attached views. For no-structure-change update, the view is rebound to new data, 350 // but again it should use the unchanged mExpand value, so we don't need do any 351 // thing in onBind. 352 setRowViewExpanded(vh, mExpand); 353 setOnItemSelectedListener(vh, mOnItemSelectedListener); 354 setOnItemViewSelectedListener(vh, mOnItemViewSelectedListener); 355 if (mExternalAdapterListener != null) { 356 mExternalAdapterListener.onAttachedToWindow(vh); 357 } 358 } 359 @Override 360 public void onDetachedFromWindow(ItemBridgeAdapter.ViewHolder vh) { 361 if (mSelectedViewHolder == vh) { 362 setRowViewSelected(mSelectedViewHolder, false, true); 363 mSelectedViewHolder = null; 364 } 365 if (mExternalAdapterListener != null) { 366 mExternalAdapterListener.onDetachedFromWindow(vh); 367 } 368 } 369 @Override 370 public void onBind(ItemBridgeAdapter.ViewHolder vh) { 371 if (mExternalAdapterListener != null) { 372 mExternalAdapterListener.onBind(vh); 373 } 374 } 375 @Override 376 public void onUnbind(ItemBridgeAdapter.ViewHolder vh) { 377 RowViewHolderExtra extra = (RowViewHolderExtra) vh.getExtraObject(); 378 extra.endAnimations(); 379 if (mExternalAdapterListener != null) { 380 mExternalAdapterListener.onUnbind(vh); 381 } 382 } 383 }; 384 385 private void setupSharedViewPool(ItemBridgeAdapter.ViewHolder bridgeVh) { 386 RowPresenter rowPresenter = (RowPresenter) bridgeVh.getPresenter(); 387 RowPresenter.ViewHolder rowVh = rowPresenter.getRowViewHolder(bridgeVh.getViewHolder()); 388 389 if (rowVh instanceof ListRowPresenter.ViewHolder) { 390 HorizontalGridView view = ((ListRowPresenter.ViewHolder) rowVh).getGridView(); 391 // Recycled view pool is shared between all list rows 392 if (mRecycledViewPool == null) { 393 mRecycledViewPool = view.getRecycledViewPool(); 394 } else { 395 view.setRecycledViewPool(mRecycledViewPool); 396 } 397 398 ItemBridgeAdapter bridgeAdapter = 399 ((ListRowPresenter.ViewHolder) rowVh).getBridgeAdapter(); 400 if (mPresenterMapper == null) { 401 mPresenterMapper = bridgeAdapter.getPresenterMapper(); 402 } else { 403 bridgeAdapter.setPresenterMapper(mPresenterMapper); 404 } 405 } 406 } 407 408 @Override 409 protected void updateAdapter() { 410 super.updateAdapter(); 411 mSelectedViewHolder = null; 412 mViewsCreated = false; 413 414 ItemBridgeAdapter adapter = getBridgeAdapter(); 415 if (adapter != null) { 416 adapter.setAdapterListener(mBridgeAdapterListener); 417 } 418 } 419 420 @Override 421 void onTransitionStart() { 422 super.onTransitionStart(); 423 freezeRows(true); 424 } 425 426 @Override 427 void onTransitionEnd() { 428 super.onTransitionEnd(); 429 freezeRows(false); 430 } 431 432 private void freezeRows(boolean freeze) { 433 VerticalGridView verticalView = getVerticalGridView(); 434 final int count = verticalView.getChildCount(); 435 for (int i = 0; i < count; i++) { 436 ItemBridgeAdapter.ViewHolder ibvh = (ItemBridgeAdapter.ViewHolder) 437 verticalView.getChildViewHolder(verticalView.getChildAt(i)); 438 RowPresenter rowPresenter = (RowPresenter) ibvh.getPresenter(); 439 RowPresenter.ViewHolder vh = rowPresenter.getRowViewHolder(ibvh.getViewHolder()); 440 rowPresenter.freeze(vh, freeze); 441 } 442 } 443} 444