BrowseSupportFragment.java revision 1f97045e486f6680a5e8ddcff383df6988fc1b56
1/* This file is auto-generated from BrowseFragment.java.  DO NOT MODIFY. */
2
3/*
4 * Copyright (C) 2014 The Android Open Source Project
5 *
6 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
7 * in compliance with the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software distributed under the License
12 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
13 * or implied. See the License for the specific language governing permissions and limitations under
14 * the License.
15 */
16package android.support.v17.leanback.app;
17
18import android.support.v17.leanback.R;
19import android.support.v17.leanback.transition.TransitionHelper;
20import android.support.v17.leanback.transition.TransitionListener;
21import android.support.v17.leanback.widget.BrowseFrameLayout;
22import android.support.v17.leanback.widget.HorizontalGridView;
23import android.support.v17.leanback.widget.ItemBridgeAdapter;
24import android.support.v17.leanback.widget.OnItemViewClickedListener;
25import android.support.v17.leanback.widget.OnItemViewSelectedListener;
26import android.support.v17.leanback.widget.Presenter;
27import android.support.v17.leanback.widget.PresenterSelector;
28import android.support.v17.leanback.widget.RowPresenter;
29import android.support.v17.leanback.widget.TitleView;
30import android.support.v17.leanback.widget.VerticalGridView;
31import android.support.v17.leanback.widget.Row;
32import android.support.v17.leanback.widget.ObjectAdapter;
33import android.support.v17.leanback.widget.OnItemSelectedListener;
34import android.support.v17.leanback.widget.OnItemClickedListener;
35import android.support.v17.leanback.widget.SearchOrbView;
36import android.util.Log;
37import android.support.v4.app.FragmentActivity;
38import android.support.v4.app.Fragment;
39import android.support.v4.app.FragmentManager;
40import android.support.v4.app.FragmentManager.BackStackEntry;
41import android.content.Context;
42import android.content.res.TypedArray;
43import android.os.Bundle;
44import android.view.LayoutInflater;
45import android.view.View;
46import android.view.View.OnClickListener;
47import android.view.ViewGroup;
48import android.view.ViewGroup.MarginLayoutParams;
49import android.graphics.Color;
50import android.graphics.Rect;
51import android.graphics.drawable.Drawable;
52
53import static android.support.v7.widget.RecyclerView.NO_POSITION;
54
55/**
56 * A fragment for creating Leanback browse screens. It is composed of a
57 * RowsSupportFragment and a HeadersSupportFragment.
58 * <p>
59 * A BrowseSupportFragment renders the elements of its {@link ObjectAdapter} as a set
60 * of rows in a vertical list. The elements in this adapter must be subclasses
61 * of {@link Row}.
62 * <p>
63 * The HeadersSupportFragment can be set to be either shown or hidden by default, or
64 * may be disabled entirely. See {@link #setHeadersState} for details.
65 * <p>
66 * By default the BrowseSupportFragment includes support for returning to the headers
67 * when the user presses Back. For Activities that customize {@link
68 * android.support.v4.app.FragmentActivity#onBackPressed()}, you must disable this default Back key support by
69 * calling {@link #setHeadersTransitionOnBackEnabled(boolean)} with false and
70 * use {@link BrowseSupportFragment.BrowseTransitionListener} and
71 * {@link #startHeadersTransition(boolean)}.
72 */
73public class BrowseSupportFragment extends Fragment {
74
75    // BUNDLE attribute for saving header show/hide status when backstack is used:
76    static final String HEADER_STACK_INDEX = "headerStackIndex";
77    // BUNDLE attribute for saving header show/hide status when backstack is not used:
78    static final String HEADER_SHOW = "headerShow";
79    // BUNDLE attribute for title is showing
80    static final String TITLE_SHOW = "titleShow";
81
82    final class BackStackListener implements FragmentManager.OnBackStackChangedListener {
83        int mLastEntryCount;
84        int mIndexOfHeadersBackStack;
85
86        BackStackListener() {
87            mLastEntryCount = getFragmentManager().getBackStackEntryCount();
88            mIndexOfHeadersBackStack = -1;
89        }
90
91        void load(Bundle savedInstanceState) {
92            if (savedInstanceState != null) {
93                mIndexOfHeadersBackStack = savedInstanceState.getInt(HEADER_STACK_INDEX, -1);
94                mShowingHeaders = mIndexOfHeadersBackStack == -1;
95            } else {
96                if (!mShowingHeaders) {
97                    getFragmentManager().beginTransaction()
98                            .addToBackStack(mWithHeadersBackStackName).commit();
99                }
100            }
101        }
102
103        void save(Bundle outState) {
104            outState.putInt(HEADER_STACK_INDEX, mIndexOfHeadersBackStack);
105        }
106
107
108        @Override
109        public void onBackStackChanged() {
110            if (getFragmentManager() == null) {
111                Log.w(TAG, "getFragmentManager() is null, stack:", new Exception());
112                return;
113            }
114            int count = getFragmentManager().getBackStackEntryCount();
115            // if backstack is growing and last pushed entry is "headers" backstack,
116            // remember the index of the entry.
117            if (count > mLastEntryCount) {
118                BackStackEntry entry = getFragmentManager().getBackStackEntryAt(count - 1);
119                if (mWithHeadersBackStackName.equals(entry.getName())) {
120                    mIndexOfHeadersBackStack = count - 1;
121                }
122            } else if (count < mLastEntryCount) {
123                // if popped "headers" backstack, initiate the show header transition if needed
124                if (mIndexOfHeadersBackStack >= count) {
125                    mIndexOfHeadersBackStack = -1;
126                    if (!mShowingHeaders) {
127                        startHeadersTransitionInternal(true);
128                    }
129                }
130            }
131            mLastEntryCount = count;
132        }
133    }
134
135    /**
136     * Listener for transitions between browse headers and rows.
137     */
138    public static class BrowseTransitionListener {
139        /**
140         * Callback when headers transition starts.
141         *
142         * @param withHeaders True if the transition will result in headers
143         *        being shown, false otherwise.
144         */
145        public void onHeadersTransitionStart(boolean withHeaders) {
146        }
147        /**
148         * Callback when headers transition stops.
149         *
150         * @param withHeaders True if the transition will result in headers
151         *        being shown, false otherwise.
152         */
153        public void onHeadersTransitionStop(boolean withHeaders) {
154        }
155    }
156
157    private static final String TAG = "BrowseSupportFragment";
158
159    private static final String LB_HEADERS_BACKSTACK = "lbHeadersBackStack_";
160
161    private static boolean DEBUG = false;
162
163    /** The headers fragment is enabled and shown by default. */
164    public static final int HEADERS_ENABLED = 1;
165
166    /** The headers fragment is enabled and hidden by default. */
167    public static final int HEADERS_HIDDEN = 2;
168
169    /** The headers fragment is disabled and will never be shown. */
170    public static final int HEADERS_DISABLED = 3;
171
172    private static final float SLIDE_DISTANCE_FACTOR = 2;
173
174    private RowsSupportFragment mRowsSupportFragment;
175    private HeadersSupportFragment mHeadersSupportFragment;
176
177    private ObjectAdapter mAdapter;
178
179    private String mTitle;
180    private Drawable mBadgeDrawable;
181    private int mHeadersState = HEADERS_ENABLED;
182    private int mBrandColor = Color.TRANSPARENT;
183    private boolean mBrandColorSet;
184
185    private BrowseFrameLayout mBrowseFrame;
186    private TitleView mTitleView;
187    private boolean mShowingTitle = true;
188    private boolean mHeadersBackStackEnabled = true;
189    private String mWithHeadersBackStackName;
190    private boolean mShowingHeaders = true;
191    private boolean mCanShowHeaders = true;
192    private int mContainerListMarginLeft;
193    private int mContainerListAlignTop;
194    private boolean mRowScaleEnabled = true;
195    private SearchOrbView.Colors mSearchAffordanceColors;
196    private boolean mSearchAffordanceColorSet;
197    private OnItemSelectedListener mExternalOnItemSelectedListener;
198    private OnClickListener mExternalOnSearchClickedListener;
199    private OnItemClickedListener mOnItemClickedListener;
200    private OnItemViewSelectedListener mExternalOnItemViewSelectedListener;
201    private OnItemViewClickedListener mOnItemViewClickedListener;
202    private int mSelectedPosition = -1;
203
204    private PresenterSelector mHeaderPresenterSelector;
205
206    // transition related:
207    private static TransitionHelper sTransitionHelper = TransitionHelper.getInstance();
208    private int mReparentHeaderId = View.generateViewId();
209    private Object mSceneWithTitle;
210    private Object mSceneWithoutTitle;
211    private Object mSceneWithHeaders;
212    private Object mSceneWithoutHeaders;
213    private Object mTitleUpTransition;
214    private Object mTitleDownTransition;
215    private Object mHeadersTransition;
216    private int mHeadersTransitionStartDelay;
217    private int mHeadersTransitionDuration;
218    private BackStackListener mBackStackChangedListener;
219    private BrowseTransitionListener mBrowseTransitionListener;
220
221    private static final String ARG_TITLE = BrowseSupportFragment.class.getCanonicalName() + ".title";
222    private static final String ARG_BADGE_URI = BrowseSupportFragment.class.getCanonicalName() + ".badge";
223    private static final String ARG_HEADERS_STATE =
224        BrowseSupportFragment.class.getCanonicalName() + ".headersState";
225
226    /**
227     * Create arguments for a browse fragment.
228     *
229     * @param args The Bundle to place arguments into, or null if the method
230     *        should return a new Bundle.
231     * @param title The title of the BrowseSupportFragment.
232     * @param headersState The initial state of the headers of the
233     *        BrowseSupportFragment. Must be one of {@link #HEADERS_ENABLED}, {@link
234     *        #HEADERS_HIDDEN}, or {@link #HEADERS_DISABLED}.
235     * @return A Bundle with the given arguments for creating a BrowseSupportFragment.
236     */
237    public static Bundle createArgs(Bundle args, String title, int headersState) {
238        if (args == null) {
239            args = new Bundle();
240        }
241        args.putString(ARG_TITLE, title);
242        args.putInt(ARG_HEADERS_STATE, headersState);
243        return args;
244    }
245
246    /**
247     * Sets the brand color for the browse fragment. The brand color is used as
248     * the primary color for UI elements in the browse fragment. For example,
249     * the background color of the headers fragment uses the brand color.
250     *
251     * @param color The color to use as the brand color of the fragment.
252     */
253    public void setBrandColor(int color) {
254        mBrandColor = color;
255        mBrandColorSet = true;
256
257        if (mHeadersSupportFragment != null) {
258            mHeadersSupportFragment.setBackgroundColor(mBrandColor);
259        }
260    }
261
262    /**
263     * Returns the brand color for the browse fragment.
264     * The default is transparent.
265     */
266    public int getBrandColor() {
267        return mBrandColor;
268    }
269
270    /**
271     * Sets the adapter containing the rows for the fragment.
272     *
273     * <p>The items referenced by the adapter must be be derived from
274     * {@link Row}. These rows will be used by the rows fragment and the headers
275     * fragment (if not disabled) to render the browse rows.
276     *
277     * @param adapter An ObjectAdapter for the browse rows. All items must
278     *        derive from {@link Row}.
279     */
280    public void setAdapter(ObjectAdapter adapter) {
281        mAdapter = adapter;
282        if (mRowsSupportFragment != null) {
283            mRowsSupportFragment.setAdapter(adapter);
284            mHeadersSupportFragment.setAdapter(adapter);
285        }
286    }
287
288    /**
289     * Returns the adapter containing the rows for the fragment.
290     */
291    public ObjectAdapter getAdapter() {
292        return mAdapter;
293    }
294
295    /**
296     * Sets an item selection listener. This listener will be called when an
297     * item or row is selected by a user.
298     *
299     * @param listener The listener to call when an item or row is selected.
300     * @deprecated Use {@link #setOnItemViewSelectedListener(OnItemViewSelectedListener)}
301     */
302    public void setOnItemSelectedListener(OnItemSelectedListener listener) {
303        mExternalOnItemSelectedListener = listener;
304    }
305
306    /**
307     * Sets an item selection listener.
308     */
309    public void setOnItemViewSelectedListener(OnItemViewSelectedListener listener) {
310        mExternalOnItemViewSelectedListener = listener;
311    }
312
313    /**
314     * Returns an item selection listener.
315     */
316    public OnItemViewSelectedListener getOnItemViewSelectedListener() {
317        return mExternalOnItemViewSelectedListener;
318    }
319
320    /**
321     * Sets an item clicked listener on the fragment.
322     *
323     * <p>OnItemClickedListener will override {@link View.OnClickListener} that
324     * an item presenter may set during
325     * {@link Presenter#onCreateViewHolder(ViewGroup)}. So in general, you
326     * should choose to use an {@link OnItemClickedListener} or a
327     * {@link View.OnClickListener} on your item views, but not both.
328     *
329     * @param listener The listener to call when an item is clicked.
330     * @deprecated Use {@link #setOnItemViewClickedListener(OnItemViewClickedListener)}
331     */
332    public void setOnItemClickedListener(OnItemClickedListener listener) {
333        mOnItemClickedListener = listener;
334        if (mRowsSupportFragment != null) {
335            mRowsSupportFragment.setOnItemClickedListener(listener);
336        }
337    }
338
339    /**
340     * Returns the item clicked listener.
341     * @deprecated Use {@link #getOnItemViewClickedListener()}
342     */
343    public OnItemClickedListener getOnItemClickedListener() {
344        return mOnItemClickedListener;
345    }
346
347    /**
348     * Sets an item clicked listener on the fragment.
349     * OnItemViewClickedListener will override {@link View.OnClickListener} that
350     * item presenter sets during {@link Presenter#onCreateViewHolder(ViewGroup)}.
351     * So in general,  developer should choose one of the listeners but not both.
352     */
353    public void setOnItemViewClickedListener(OnItemViewClickedListener listener) {
354        mOnItemViewClickedListener = listener;
355        if (mRowsSupportFragment != null) {
356            mRowsSupportFragment.setOnItemViewClickedListener(listener);
357        }
358    }
359
360    /**
361     * Returns the item Clicked listener.
362     */
363    public OnItemViewClickedListener getOnItemViewClickedListener() {
364        return mOnItemViewClickedListener;
365    }
366
367    /**
368     * Sets a click listener for the search affordance.
369     *
370     * <p>The presence of a listener will change the visibility of the search
371     * affordance in the fragment title. When set to non-null, the title will
372     * contain an element that a user may click to begin a search.
373     *
374     * <p>The listener's {@link View.OnClickListener#onClick onClick} method
375     * will be invoked when the user clicks on the search element.
376     *
377     * @param listener The listener to call when the search element is clicked.
378     */
379    public void setOnSearchClickedListener(View.OnClickListener listener) {
380        mExternalOnSearchClickedListener = listener;
381        if (mTitleView != null) {
382            mTitleView.setOnSearchClickedListener(listener);
383        }
384    }
385
386    /**
387     * Sets the {@link SearchOrbView.Colors} used to draw the search affordance.
388     */
389    public void setSearchAffordanceColors(SearchOrbView.Colors colors) {
390        mSearchAffordanceColors = colors;
391        mSearchAffordanceColorSet = true;
392        if (mTitleView != null) {
393            mTitleView.setSearchAffordanceColors(mSearchAffordanceColors);
394        }
395    }
396
397    /**
398     * Returns the {@link SearchOrbView.Colors} used to draw the search affordance.
399     */
400    public SearchOrbView.Colors getSearchAffordanceColors() {
401        if (mSearchAffordanceColorSet) {
402            return mSearchAffordanceColors;
403        }
404        if (mTitleView == null) {
405            throw new IllegalStateException("Fragment views not yet created");
406        }
407        return mTitleView.getSearchAffordanceColors();
408    }
409
410    /**
411     * Sets the color used to draw the search affordance.
412     * A default brighter color will be set by the framework.
413     *
414     * @param color The color to use for the search affordance.
415     */
416    public void setSearchAffordanceColor(int color) {
417        setSearchAffordanceColors(new SearchOrbView.Colors(color));
418    }
419
420    /**
421     * Returns the color used to draw the search affordance.
422     */
423    public int getSearchAffordanceColor() {
424        return getSearchAffordanceColors().color;
425    }
426
427    /**
428     * Start a headers transition.
429     *
430     * <p>This method will begin a transition to either show or hide the
431     * headers, depending on the value of withHeaders. If headers are disabled
432     * for this browse fragment, this method will throw an exception.
433     *
434     * @param withHeaders True if the headers should transition to being shown,
435     *        false if the transition should result in headers being hidden.
436     */
437    public void startHeadersTransition(boolean withHeaders) {
438        if (!mCanShowHeaders) {
439            throw new IllegalStateException("Cannot start headers transition");
440        }
441        if (isInHeadersTransition() || mShowingHeaders == withHeaders) {
442            return;
443        }
444        startHeadersTransitionInternal(withHeaders);
445    }
446
447    /**
448     * Returns true if the headers transition is currently running.
449     */
450    public boolean isInHeadersTransition() {
451        return mHeadersTransition != null;
452    }
453
454    /**
455     * Returns true if headers are shown.
456     */
457    public boolean isShowingHeaders() {
458        return mShowingHeaders;
459    }
460
461    /**
462     * Set a listener for browse fragment transitions.
463     *
464     * @param listener The listener to call when a browse headers transition
465     *        begins or ends.
466     */
467    public void setBrowseTransitionListener(BrowseTransitionListener listener) {
468        mBrowseTransitionListener = listener;
469    }
470
471    /**
472     * Enables scaling of rows when headers are present.
473     * By default enabled to increase density.
474     *
475     * @param enable true to enable row scaling
476     */
477    public void enableRowScaling(boolean enable) {
478        mRowScaleEnabled = enable;
479        if (mRowsSupportFragment != null) {
480            mRowsSupportFragment.enableRowScaling(mRowScaleEnabled);
481        }
482    }
483
484    private void startHeadersTransitionInternal(final boolean withHeaders) {
485        if (getFragmentManager().isDestroyed()) {
486            return;
487        }
488        mShowingHeaders = withHeaders;
489        mRowsSupportFragment.onExpandTransitionStart(!withHeaders, new Runnable() {
490            @Override
491            public void run() {
492                mHeadersSupportFragment.onTransitionStart();
493                createHeadersTransition();
494                if (mBrowseTransitionListener != null) {
495                    mBrowseTransitionListener.onHeadersTransitionStart(withHeaders);
496                }
497                sTransitionHelper.runTransition(withHeaders ? mSceneWithHeaders : mSceneWithoutHeaders,
498                        mHeadersTransition);
499                if (mHeadersBackStackEnabled) {
500                    if (!withHeaders) {
501                        getFragmentManager().beginTransaction()
502                                .addToBackStack(mWithHeadersBackStackName).commit();
503                    } else {
504                        int index = mBackStackChangedListener.mIndexOfHeadersBackStack;
505                        if (index >= 0) {
506                            BackStackEntry entry = getFragmentManager().getBackStackEntryAt(index);
507                            getFragmentManager().popBackStackImmediate(entry.getId(),
508                                    FragmentManager.POP_BACK_STACK_INCLUSIVE);
509                        }
510                    }
511                }
512            }
513        });
514    }
515
516    private boolean isVerticalScrolling() {
517        // don't run transition
518        return mHeadersSupportFragment.getVerticalGridView().getScrollState()
519                != HorizontalGridView.SCROLL_STATE_IDLE
520                || mRowsSupportFragment.getVerticalGridView().getScrollState()
521                != HorizontalGridView.SCROLL_STATE_IDLE;
522    }
523
524    private final BrowseFrameLayout.OnFocusSearchListener mOnFocusSearchListener =
525            new BrowseFrameLayout.OnFocusSearchListener() {
526        @Override
527        public View onFocusSearch(View focused, int direction) {
528            // If headers fragment is disabled, just return null.
529            if (!mCanShowHeaders) return null;
530
531            final View searchOrbView = mTitleView.getSearchAffordanceView();
532            // if headers is running transition,  focus stays
533            if (isInHeadersTransition()) return focused;
534            if (DEBUG) Log.v(TAG, "onFocusSearch focused " + focused + " + direction " + direction);
535            if (direction == View.FOCUS_LEFT) {
536                if (isVerticalScrolling() || mShowingHeaders) {
537                    return focused;
538                }
539                return mHeadersSupportFragment.getVerticalGridView();
540            } else if (direction == View.FOCUS_RIGHT) {
541                if (isVerticalScrolling() || !mShowingHeaders) {
542                    return focused;
543                }
544                return mRowsSupportFragment.getVerticalGridView();
545            } else if (focused == searchOrbView && direction == View.FOCUS_DOWN) {
546                return mShowingHeaders ? mHeadersSupportFragment.getVerticalGridView() :
547                    mRowsSupportFragment.getVerticalGridView();
548
549            } else if (focused != searchOrbView && searchOrbView.getVisibility() == View.VISIBLE
550                    && direction == View.FOCUS_UP) {
551                return searchOrbView;
552
553            } else {
554                return null;
555            }
556        }
557    };
558
559    private final BrowseFrameLayout.OnChildFocusListener mOnChildFocusListener =
560            new BrowseFrameLayout.OnChildFocusListener() {
561
562        @Override
563        public boolean onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect) {
564            if (getChildFragmentManager().isDestroyed()) {
565                return true;
566            }
567            // Make sure not changing focus when requestFocus() is called.
568            if (mCanShowHeaders && mShowingHeaders) {
569                if (mHeadersSupportFragment.getView().requestFocus(direction, previouslyFocusedRect)) {
570                    return true;
571                }
572            }
573            if (mRowsSupportFragment.getView().requestFocus(direction, previouslyFocusedRect)) {
574                return true;
575            }
576            return mTitleView.requestFocus(direction, previouslyFocusedRect);
577        };
578
579        @Override
580        public void onRequestChildFocus(View child, View focused) {
581            if (getChildFragmentManager().isDestroyed()) {
582                return;
583            }
584            if (!mCanShowHeaders || isInHeadersTransition()) return;
585            int childId = child.getId();
586            if (childId == R.id.browse_container_dock && mShowingHeaders) {
587                startHeadersTransitionInternal(false);
588            } else if (childId == R.id.browse_headers_dock && !mShowingHeaders) {
589                startHeadersTransitionInternal(true);
590            }
591        }
592    };
593
594    @Override
595    public void onSaveInstanceState(Bundle outState) {
596        if (mBackStackChangedListener != null) {
597            mBackStackChangedListener.save(outState);
598        } else {
599            outState.putBoolean(HEADER_SHOW, mShowingHeaders);
600        }
601        outState.putBoolean(TITLE_SHOW, mShowingTitle);
602    }
603
604    @Override
605    public void onCreate(Bundle savedInstanceState) {
606        super.onCreate(savedInstanceState);
607        TypedArray ta = getActivity().obtainStyledAttributes(R.styleable.LeanbackTheme);
608        mContainerListMarginLeft = (int) ta.getDimension(
609                R.styleable.LeanbackTheme_browseRowsMarginStart, 0);
610        mContainerListAlignTop = (int) ta.getDimension(
611                R.styleable.LeanbackTheme_browseRowsMarginTop, 0);
612        ta.recycle();
613
614        mHeadersTransitionStartDelay = getResources()
615                .getInteger(R.integer.lb_browse_headers_transition_delay);
616        mHeadersTransitionDuration = getResources()
617                .getInteger(R.integer.lb_browse_headers_transition_duration);
618
619        readArguments(getArguments());
620
621    }
622
623    @Override
624    public void onDestroy() {
625        if (mBackStackChangedListener != null) {
626            getFragmentManager().removeOnBackStackChangedListener(mBackStackChangedListener);
627        }
628        super.onDestroy();
629    }
630
631    @Override
632    public View onCreateView(LayoutInflater inflater, ViewGroup container,
633            Bundle savedInstanceState) {
634        if (getChildFragmentManager().findFragmentById(R.id.browse_container_dock) == null) {
635            mRowsSupportFragment = new RowsSupportFragment();
636            mHeadersSupportFragment = new HeadersSupportFragment();
637            getChildFragmentManager().beginTransaction()
638                    .replace(R.id.browse_headers_dock, mHeadersSupportFragment)
639                    .replace(R.id.browse_container_dock, mRowsSupportFragment).commit();
640        } else {
641            mHeadersSupportFragment = (HeadersSupportFragment) getChildFragmentManager()
642                    .findFragmentById(R.id.browse_headers_dock);
643            mRowsSupportFragment = (RowsSupportFragment) getChildFragmentManager()
644                    .findFragmentById(R.id.browse_container_dock);
645        }
646
647        mHeadersSupportFragment.setHeadersGone(!mCanShowHeaders);
648
649        mRowsSupportFragment.setAdapter(mAdapter);
650        if (mHeaderPresenterSelector != null) {
651            mHeadersSupportFragment.setPresenterSelector(mHeaderPresenterSelector);
652        }
653        mHeadersSupportFragment.setAdapter(mAdapter);
654
655        mRowsSupportFragment.enableRowScaling(mRowScaleEnabled);
656        mRowsSupportFragment.setOnItemSelectedListener(mRowSelectedListener);
657        mRowsSupportFragment.setOnItemViewSelectedListener(mRowViewSelectedListener);
658        mHeadersSupportFragment.setOnItemSelectedListener(mHeaderSelectedListener);
659        mHeadersSupportFragment.setOnHeaderClickedListener(mHeaderClickedListener);
660        mRowsSupportFragment.setOnItemClickedListener(mOnItemClickedListener);
661        mRowsSupportFragment.setOnItemViewClickedListener(mOnItemViewClickedListener);
662
663        View root = inflater.inflate(R.layout.lb_browse_fragment, container, false);
664
665        mBrowseFrame = (BrowseFrameLayout) root.findViewById(R.id.browse_frame);
666        mBrowseFrame.setOnFocusSearchListener(mOnFocusSearchListener);
667        mBrowseFrame.setOnChildFocusListener(mOnChildFocusListener);
668
669        mTitleView = (TitleView) root.findViewById(R.id.browse_title_group);
670        mTitleView.setTitle(mTitle);
671        mTitleView.setBadgeDrawable(mBadgeDrawable);
672        if (mSearchAffordanceColorSet) {
673            mTitleView.setSearchAffordanceColors(mSearchAffordanceColors);
674        }
675        if (mExternalOnSearchClickedListener != null) {
676            mTitleView.setOnSearchClickedListener(mExternalOnSearchClickedListener);
677        }
678
679        if (mBrandColorSet) {
680            mHeadersSupportFragment.setBackgroundColor(mBrandColor);
681        }
682
683        mSceneWithTitle = sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
684            @Override
685            public void run() {
686                mTitleView.setVisibility(View.VISIBLE);
687            }
688        });
689        mSceneWithoutTitle = sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
690            @Override
691            public void run() {
692                mTitleView.setVisibility(View.INVISIBLE);
693            }
694        });
695        mSceneWithHeaders = sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
696            @Override
697            public void run() {
698                showHeaders(true);
699            }
700        });
701        mSceneWithoutHeaders =  sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
702            @Override
703            public void run() {
704                showHeaders(false);
705            }
706        });
707        mTitleUpTransition = TitleTransitionHelper.createTransitionTitleUp(sTransitionHelper);
708        mTitleDownTransition = TitleTransitionHelper.createTransitionTitleDown(sTransitionHelper);
709
710        sTransitionHelper.excludeChildren(mTitleUpTransition, R.id.browse_headers, true);
711        sTransitionHelper.excludeChildren(mTitleDownTransition, R.id.browse_headers, true);
712        sTransitionHelper.excludeChildren(mTitleUpTransition, R.id.container_list, true);
713        sTransitionHelper.excludeChildren(mTitleDownTransition, R.id.container_list, true);
714
715        if (mCanShowHeaders) {
716            if (mHeadersBackStackEnabled) {
717                mWithHeadersBackStackName = LB_HEADERS_BACKSTACK + this;
718                mBackStackChangedListener = new BackStackListener();
719                getFragmentManager().addOnBackStackChangedListener(mBackStackChangedListener);
720                mBackStackChangedListener.load(savedInstanceState);
721            } else {
722                if (savedInstanceState != null) {
723                    mShowingHeaders = savedInstanceState.getBoolean(HEADER_SHOW);
724                }
725            }
726        }
727        if (savedInstanceState != null) {
728            mShowingTitle = savedInstanceState.getBoolean(TITLE_SHOW);
729        }
730        mTitleView.setVisibility(mShowingTitle ? View.VISIBLE: View.INVISIBLE);
731
732        return root;
733    }
734
735    private void createHeadersTransition() {
736        mHeadersTransition = sTransitionHelper.createTransitionSet(false);
737        sTransitionHelper.excludeChildren(mHeadersTransition, R.id.browse_title_group, true);
738        Object changeBounds = sTransitionHelper.createChangeBounds(false);
739        Object fadeIn = sTransitionHelper.createFadeTransition(TransitionHelper.FADE_IN);
740        Object fadeOut = sTransitionHelper.createFadeTransition(TransitionHelper.FADE_OUT);
741        Object scale = sTransitionHelper.createScale();
742        if (TransitionHelper.systemSupportsTransitions()) {
743            Context context = getView().getContext();
744            sTransitionHelper.setInterpolator(changeBounds,
745                    sTransitionHelper.createDefaultInterpolator(context));
746            sTransitionHelper.setInterpolator(fadeIn,
747                    sTransitionHelper.createDefaultInterpolator(context));
748            sTransitionHelper.setInterpolator(fadeOut,
749                    sTransitionHelper.createDefaultInterpolator(context));
750            sTransitionHelper.setInterpolator(scale,
751                    sTransitionHelper.createDefaultInterpolator(context));
752        }
753
754        sTransitionHelper.setDuration(fadeOut, mHeadersTransitionDuration);
755        sTransitionHelper.addTransition(mHeadersTransition, fadeOut);
756
757        if (mShowingHeaders) {
758            sTransitionHelper.setStartDelay(changeBounds, mHeadersTransitionStartDelay);
759            sTransitionHelper.setStartDelay(scale, mHeadersTransitionStartDelay);
760        }
761        sTransitionHelper.setDuration(changeBounds, mHeadersTransitionDuration);
762        sTransitionHelper.addTransition(mHeadersTransition, changeBounds);
763        sTransitionHelper.addTarget(scale, mRowsSupportFragment.getScaleFrameLayout());
764        sTransitionHelper.setDuration(scale, mHeadersTransitionDuration);
765        sTransitionHelper.addTransition(mHeadersTransition, scale);
766
767        sTransitionHelper.setDuration(fadeIn, mHeadersTransitionDuration);
768        sTransitionHelper.setStartDelay(fadeIn, mHeadersTransitionStartDelay);
769        sTransitionHelper.addTransition(mHeadersTransition, fadeIn);
770
771        sTransitionHelper.setTransitionListener(mHeadersTransition, new TransitionListener() {
772            @Override
773            public void onTransitionStart(Object transition) {
774            }
775            @Override
776            public void onTransitionEnd(Object transition) {
777                mHeadersTransition = null;
778                mRowsSupportFragment.onTransitionEnd();
779                mHeadersSupportFragment.onTransitionEnd();
780                if (mShowingHeaders) {
781                    VerticalGridView headerGridView = mHeadersSupportFragment.getVerticalGridView();
782                    if (headerGridView != null && !headerGridView.hasFocus()) {
783                        headerGridView.requestFocus();
784                    }
785                } else {
786                    VerticalGridView rowsGridView = mRowsSupportFragment.getVerticalGridView();
787                    if (rowsGridView != null && !rowsGridView.hasFocus()) {
788                        rowsGridView.requestFocus();
789                    }
790                }
791                if (mBrowseTransitionListener != null) {
792                    mBrowseTransitionListener.onHeadersTransitionStop(mShowingHeaders);
793                }
794            }
795        });
796    }
797
798    /**
799     * Sets the {@link PresenterSelector} used to render the row headers.
800     *
801     * @param headerPresenterSelector The PresenterSelector that will determine
802     *        the Presenter for each row header.
803     */
804    public void setHeaderPresenterSelector(PresenterSelector headerPresenterSelector) {
805        mHeaderPresenterSelector = headerPresenterSelector;
806        if (mHeadersSupportFragment != null) {
807            mHeadersSupportFragment.setPresenterSelector(mHeaderPresenterSelector);
808        }
809    }
810
811    private void showHeaders(boolean show) {
812        if (DEBUG) Log.v(TAG, "showHeaders " + show);
813        mHeadersSupportFragment.setHeadersEnabled(show);
814        MarginLayoutParams lp;
815        View containerList;
816
817        containerList = mRowsSupportFragment.getView();
818        lp = (MarginLayoutParams) containerList.getLayoutParams();
819        lp.leftMargin = show ? mContainerListMarginLeft : 0;
820        containerList.setLayoutParams(lp);
821
822        containerList = mHeadersSupportFragment.getView();
823        lp = (MarginLayoutParams) containerList.getLayoutParams();
824        lp.leftMargin = show ? 0 : -mContainerListMarginLeft;
825        containerList.setLayoutParams(lp);
826
827        mRowsSupportFragment.setExpand(!show);
828    }
829
830    private HeadersSupportFragment.OnHeaderClickedListener mHeaderClickedListener =
831        new HeadersSupportFragment.OnHeaderClickedListener() {
832            @Override
833            public void onHeaderClicked() {
834                if (!mCanShowHeaders || !mShowingHeaders || isInHeadersTransition()) {
835                    return;
836                }
837                startHeadersTransitionInternal(false);
838                mRowsSupportFragment.getVerticalGridView().requestFocus();
839            }
840        };
841
842    private OnItemViewSelectedListener mRowViewSelectedListener = new OnItemViewSelectedListener() {
843        @Override
844        public void onItemSelected(Presenter.ViewHolder itemViewHolder, Object item,
845                RowPresenter.ViewHolder rowViewHolder, Row row) {
846            int position = mRowsSupportFragment.getVerticalGridView().getSelectedPosition();
847            if (DEBUG) Log.v(TAG, "row selected position " + position);
848            onRowSelected(position);
849            if (mExternalOnItemViewSelectedListener != null) {
850                mExternalOnItemViewSelectedListener.onItemSelected(itemViewHolder, item,
851                        rowViewHolder, row);
852            }
853        }
854    };
855
856    private OnItemSelectedListener mRowSelectedListener = new OnItemSelectedListener() {
857        @Override
858        public void onItemSelected(Object item, Row row) {
859            if (mExternalOnItemSelectedListener != null) {
860                mExternalOnItemSelectedListener.onItemSelected(item, row);
861            }
862        }
863    };
864
865    private OnItemSelectedListener mHeaderSelectedListener = new OnItemSelectedListener() {
866        @Override
867        public void onItemSelected(Object item, Row row) {
868            int position = mHeadersSupportFragment.getVerticalGridView().getSelectedPosition();
869            if (DEBUG) Log.v(TAG, "header selected position " + position);
870            onRowSelected(position);
871        }
872    };
873
874    private void onRowSelected(int position) {
875        if (position != mSelectedPosition) {
876            mSetSelectionRunnable.mPosition = position;
877            mBrowseFrame.getHandler().post(mSetSelectionRunnable);
878
879            if (getAdapter() == null || getAdapter().size() == 0 || position == 0) {
880                if (!mShowingTitle) {
881                    sTransitionHelper.runTransition(mSceneWithTitle, mTitleDownTransition);
882                    mShowingTitle = true;
883                }
884            } else if (mShowingTitle) {
885                sTransitionHelper.runTransition(mSceneWithoutTitle, mTitleUpTransition);
886                mShowingTitle = false;
887            }
888        }
889    }
890
891    private class SetSelectionRunnable implements Runnable {
892        int mPosition;
893        @Override
894        public void run() {
895            setSelection(mPosition);
896        }
897    }
898
899    private final SetSelectionRunnable mSetSelectionRunnable = new SetSelectionRunnable();
900
901    private void setSelection(int position) {
902        if (position != NO_POSITION) {
903            mRowsSupportFragment.setSelectedPosition(position);
904            mHeadersSupportFragment.setSelectedPosition(position);
905        }
906        mSelectedPosition = position;
907    }
908
909    @Override
910    public void onStart() {
911        super.onStart();
912        mHeadersSupportFragment.setWindowAlignmentFromTop(mContainerListAlignTop);
913        mHeadersSupportFragment.setItemAlignment();
914        mRowsSupportFragment.setWindowAlignmentFromTop(mContainerListAlignTop);
915        mRowsSupportFragment.setItemAlignment();
916
917        mRowsSupportFragment.getScaleFrameLayout().setPivotX(0);
918        mRowsSupportFragment.getScaleFrameLayout().setPivotY(mContainerListAlignTop);
919
920        if (mCanShowHeaders && mShowingHeaders && mHeadersSupportFragment.getView() != null) {
921            mHeadersSupportFragment.getView().requestFocus();
922        } else if ((!mCanShowHeaders || !mShowingHeaders)
923                && mRowsSupportFragment.getView() != null) {
924            mRowsSupportFragment.getView().requestFocus();
925        }
926        if (mCanShowHeaders) {
927            showHeaders(mShowingHeaders);
928        }
929    }
930
931    /**
932     * Enable/disable headers transition on back key support. This is enabled by
933     * default. The BrowseSupportFragment will add a back stack entry when headers are
934     * showing. Running a headers transition when the back key is pressed only
935     * works when the headers state is {@link #HEADERS_ENABLED} or
936     * {@link #HEADERS_HIDDEN}.
937     * <p>
938     * NOTE: If an Activity has its own onBackPressed() handling, you must
939     * disable this feature. You may use {@link #startHeadersTransition(boolean)}
940     * and {@link BrowseTransitionListener} in your own back stack handling.
941     */
942    public final void setHeadersTransitionOnBackEnabled(boolean headersBackStackEnabled) {
943        mHeadersBackStackEnabled = headersBackStackEnabled;
944    }
945
946    /**
947     * Returns true if headers transition on back key support is enabled.
948     */
949    public final boolean isHeadersTransitionOnBackEnabled() {
950        return mHeadersBackStackEnabled;
951    }
952
953    private void readArguments(Bundle args) {
954        if (args == null) {
955            return;
956        }
957        if (args.containsKey(ARG_TITLE)) {
958            setTitle(args.getString(ARG_TITLE));
959        }
960        if (args.containsKey(ARG_HEADERS_STATE)) {
961            setHeadersState(args.getInt(ARG_HEADERS_STATE));
962        }
963    }
964
965    /**
966     * Sets the drawable displayed in the browse fragment title.
967     *
968     * @param drawable The Drawable to display in the browse fragment title.
969     */
970    public void setBadgeDrawable(Drawable drawable) {
971        if (mBadgeDrawable != drawable) {
972            mBadgeDrawable = drawable;
973            if (mTitleView != null) {
974                mTitleView.setBadgeDrawable(drawable);
975            }
976        }
977    }
978
979    /**
980     * Returns the badge drawable used in the fragment title.
981     */
982    public Drawable getBadgeDrawable() {
983        return mBadgeDrawable;
984    }
985
986    /**
987     * Sets a title for the browse fragment.
988     *
989     * @param title The title of the browse fragment.
990     */
991    public void setTitle(String title) {
992        mTitle = title;
993        if (mTitleView != null) {
994            mTitleView.setTitle(title);
995        }
996    }
997
998    /**
999     * Returns the title for the browse fragment.
1000     */
1001    public String getTitle() {
1002        return mTitle;
1003    }
1004
1005    /**
1006     * Sets the state for the headers column in the browse fragment. Must be one
1007     * of {@link #HEADERS_ENABLED}, {@link #HEADERS_HIDDEN}, or
1008     * {@link #HEADERS_DISABLED}.
1009     *
1010     * @param headersState The state of the headers for the browse fragment.
1011     */
1012    public void setHeadersState(int headersState) {
1013        if (headersState < HEADERS_ENABLED || headersState > HEADERS_DISABLED) {
1014            throw new IllegalArgumentException("Invalid headers state: " + headersState);
1015        }
1016        if (DEBUG) Log.v(TAG, "setHeadersState " + headersState);
1017
1018        if (headersState != mHeadersState) {
1019            mHeadersState = headersState;
1020            switch (headersState) {
1021                case HEADERS_ENABLED:
1022                    mCanShowHeaders = true;
1023                    mShowingHeaders = true;
1024                    break;
1025                case HEADERS_HIDDEN:
1026                    mCanShowHeaders = true;
1027                    mShowingHeaders = false;
1028                    break;
1029                case HEADERS_DISABLED:
1030                    mCanShowHeaders = false;
1031                    mShowingHeaders = false;
1032                    break;
1033                default:
1034                    Log.w(TAG, "Unknown headers state: " + headersState);
1035                    break;
1036            }
1037            if (mHeadersSupportFragment != null) {
1038                mHeadersSupportFragment.setHeadersGone(!mCanShowHeaders);
1039            }
1040        }
1041    }
1042
1043    /**
1044     * Returns the state of the headers column in the browse fragment.
1045     */
1046    public int getHeadersState() {
1047        return mHeadersState;
1048    }
1049}
1050
1051