BrowseSupportFragment.java revision 34f3ee7e818a20939ef49abf5509bcfaea5c3db0
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        if (mCanShowHeaders) {
622            if (mHeadersBackStackEnabled) {
623                mWithHeadersBackStackName = LB_HEADERS_BACKSTACK + this;
624                mBackStackChangedListener = new BackStackListener();
625                getFragmentManager().addOnBackStackChangedListener(mBackStackChangedListener);
626                mBackStackChangedListener.load(savedInstanceState);
627            } else {
628                if (savedInstanceState != null) {
629                    mShowingHeaders = savedInstanceState.getBoolean(HEADER_SHOW);
630                }
631            }
632        }
633
634    }
635
636    @Override
637    public void onDestroy() {
638        if (mBackStackChangedListener != null) {
639            getFragmentManager().removeOnBackStackChangedListener(mBackStackChangedListener);
640        }
641        super.onDestroy();
642    }
643
644    @Override
645    public View onCreateView(LayoutInflater inflater, ViewGroup container,
646            Bundle savedInstanceState) {
647        if (getChildFragmentManager().findFragmentById(R.id.browse_container_dock) == null) {
648            mRowsSupportFragment = new RowsSupportFragment();
649            mHeadersSupportFragment = new HeadersSupportFragment();
650            getChildFragmentManager().beginTransaction()
651                    .replace(R.id.browse_headers_dock, mHeadersSupportFragment)
652                    .replace(R.id.browse_container_dock, mRowsSupportFragment).commit();
653        } else {
654            mHeadersSupportFragment = (HeadersSupportFragment) getChildFragmentManager()
655                    .findFragmentById(R.id.browse_headers_dock);
656            mRowsSupportFragment = (RowsSupportFragment) getChildFragmentManager()
657                    .findFragmentById(R.id.browse_container_dock);
658        }
659
660        mHeadersSupportFragment.setHeadersGone(!mCanShowHeaders);
661
662        mRowsSupportFragment.setAdapter(mAdapter);
663        if (mHeaderPresenterSelector != null) {
664            mHeadersSupportFragment.setPresenterSelector(mHeaderPresenterSelector);
665        }
666        mHeadersSupportFragment.setAdapter(mAdapter);
667
668        mRowsSupportFragment.enableRowScaling(mRowScaleEnabled);
669        mRowsSupportFragment.setOnItemSelectedListener(mRowSelectedListener);
670        mRowsSupportFragment.setOnItemViewSelectedListener(mRowViewSelectedListener);
671        mHeadersSupportFragment.setOnItemSelectedListener(mHeaderSelectedListener);
672        mHeadersSupportFragment.setOnHeaderClickedListener(mHeaderClickedListener);
673        mRowsSupportFragment.setOnItemClickedListener(mOnItemClickedListener);
674        mRowsSupportFragment.setOnItemViewClickedListener(mOnItemViewClickedListener);
675
676        View root = inflater.inflate(R.layout.lb_browse_fragment, container, false);
677
678        mBrowseFrame = (BrowseFrameLayout) root.findViewById(R.id.browse_frame);
679        mBrowseFrame.setOnFocusSearchListener(mOnFocusSearchListener);
680        mBrowseFrame.setOnChildFocusListener(mOnChildFocusListener);
681
682        mTitleView = (TitleView) root.findViewById(R.id.browse_title_group);
683        mTitleView.setTitle(mTitle);
684        mTitleView.setBadgeDrawable(mBadgeDrawable);
685        if (mSearchAffordanceColorSet) {
686            mTitleView.setSearchAffordanceColors(mSearchAffordanceColors);
687        }
688        if (mExternalOnSearchClickedListener != null) {
689            mTitleView.setOnSearchClickedListener(mExternalOnSearchClickedListener);
690        }
691
692        if (mBrandColorSet) {
693            mHeadersSupportFragment.setBackgroundColor(mBrandColor);
694        }
695
696        mSceneWithTitle = sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
697            @Override
698            public void run() {
699                mTitleView.setVisibility(View.VISIBLE);
700            }
701        });
702        mSceneWithoutTitle = sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
703            @Override
704            public void run() {
705                mTitleView.setVisibility(View.INVISIBLE);
706            }
707        });
708        mSceneWithHeaders = sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
709            @Override
710            public void run() {
711                showHeaders(true);
712            }
713        });
714        mSceneWithoutHeaders =  sTransitionHelper.createScene(mBrowseFrame, new Runnable() {
715            @Override
716            public void run() {
717                showHeaders(false);
718            }
719        });
720        mTitleUpTransition = TitleTransitionHelper.createTransitionTitleUp(sTransitionHelper);
721        mTitleDownTransition = TitleTransitionHelper.createTransitionTitleDown(sTransitionHelper);
722
723        sTransitionHelper.excludeChildren(mTitleUpTransition, R.id.browse_headers, true);
724        sTransitionHelper.excludeChildren(mTitleDownTransition, R.id.browse_headers, true);
725        sTransitionHelper.excludeChildren(mTitleUpTransition, R.id.container_list, true);
726        sTransitionHelper.excludeChildren(mTitleDownTransition, R.id.container_list, true);
727
728        if (savedInstanceState != null) {
729            mShowingTitle = savedInstanceState.getBoolean(TITLE_SHOW);
730        }
731        mTitleView.setVisibility(mShowingTitle ? View.VISIBLE: View.INVISIBLE);
732
733        return root;
734    }
735
736    private void createHeadersTransition() {
737        mHeadersTransition = sTransitionHelper.createTransitionSet(false);
738        sTransitionHelper.excludeChildren(mHeadersTransition, R.id.browse_title_group, true);
739        Object changeBounds = sTransitionHelper.createChangeBounds(false);
740        Object fadeIn = sTransitionHelper.createFadeTransition(TransitionHelper.FADE_IN);
741        Object fadeOut = sTransitionHelper.createFadeTransition(TransitionHelper.FADE_OUT);
742        Object scale = sTransitionHelper.createScale();
743        if (TransitionHelper.systemSupportsTransitions()) {
744            Context context = getView().getContext();
745            sTransitionHelper.setInterpolator(changeBounds,
746                    sTransitionHelper.createDefaultInterpolator(context));
747            sTransitionHelper.setInterpolator(fadeIn,
748                    sTransitionHelper.createDefaultInterpolator(context));
749            sTransitionHelper.setInterpolator(fadeOut,
750                    sTransitionHelper.createDefaultInterpolator(context));
751            sTransitionHelper.setInterpolator(scale,
752                    sTransitionHelper.createDefaultInterpolator(context));
753        }
754
755        sTransitionHelper.setDuration(fadeOut, mHeadersTransitionDuration);
756        sTransitionHelper.addTransition(mHeadersTransition, fadeOut);
757
758        if (mShowingHeaders) {
759            sTransitionHelper.setStartDelay(changeBounds, mHeadersTransitionStartDelay);
760            sTransitionHelper.setStartDelay(scale, mHeadersTransitionStartDelay);
761        }
762        sTransitionHelper.setDuration(changeBounds, mHeadersTransitionDuration);
763        sTransitionHelper.addTransition(mHeadersTransition, changeBounds);
764        sTransitionHelper.addTarget(scale, mRowsSupportFragment.getView());
765        sTransitionHelper.setDuration(scale, mHeadersTransitionDuration);
766        sTransitionHelper.addTransition(mHeadersTransition, scale);
767
768        sTransitionHelper.setDuration(fadeIn, mHeadersTransitionDuration);
769        sTransitionHelper.setStartDelay(fadeIn, mHeadersTransitionStartDelay);
770        sTransitionHelper.addTransition(mHeadersTransition, fadeIn);
771
772        sTransitionHelper.setTransitionListener(mHeadersTransition, new TransitionListener() {
773            @Override
774            public void onTransitionStart(Object transition) {
775            }
776            @Override
777            public void onTransitionEnd(Object transition) {
778                mHeadersTransition = null;
779                mRowsSupportFragment.onTransitionEnd();
780                mHeadersSupportFragment.onTransitionEnd();
781                if (mShowingHeaders) {
782                    VerticalGridView headerGridView = mHeadersSupportFragment.getVerticalGridView();
783                    if (headerGridView != null && !headerGridView.hasFocus()) {
784                        headerGridView.requestFocus();
785                    }
786                } else {
787                    VerticalGridView rowsGridView = mRowsSupportFragment.getVerticalGridView();
788                    if (rowsGridView != null && !rowsGridView.hasFocus()) {
789                        rowsGridView.requestFocus();
790                    }
791                }
792                if (mBrowseTransitionListener != null) {
793                    mBrowseTransitionListener.onHeadersTransitionStop(mShowingHeaders);
794                }
795            }
796        });
797    }
798
799    /**
800     * Sets the {@link PresenterSelector} used to render the row headers.
801     *
802     * @param headerPresenterSelector The PresenterSelector that will determine
803     *        the Presenter for each row header.
804     */
805    public void setHeaderPresenterSelector(PresenterSelector headerPresenterSelector) {
806        mHeaderPresenterSelector = headerPresenterSelector;
807        if (mHeadersSupportFragment != null) {
808            mHeadersSupportFragment.setPresenterSelector(mHeaderPresenterSelector);
809        }
810    }
811
812    private void showHeaders(boolean show) {
813        if (DEBUG) Log.v(TAG, "showHeaders " + show);
814        mHeadersSupportFragment.setHeadersEnabled(show);
815        MarginLayoutParams lp;
816        View containerList;
817
818        containerList = mRowsSupportFragment.getView();
819        lp = (MarginLayoutParams) containerList.getLayoutParams();
820        lp.leftMargin = show ? mContainerListMarginLeft : 0;
821        containerList.setLayoutParams(lp);
822
823        containerList = mHeadersSupportFragment.getView();
824        lp = (MarginLayoutParams) containerList.getLayoutParams();
825        lp.leftMargin = show ? 0 : -mContainerListMarginLeft;
826        containerList.setLayoutParams(lp);
827
828        mRowsSupportFragment.setExpand(!show);
829    }
830
831    private HeadersSupportFragment.OnHeaderClickedListener mHeaderClickedListener =
832        new HeadersSupportFragment.OnHeaderClickedListener() {
833            @Override
834            public void onHeaderClicked() {
835                if (!mCanShowHeaders || !mShowingHeaders || isInHeadersTransition()) {
836                    return;
837                }
838                startHeadersTransitionInternal(false);
839                mRowsSupportFragment.getVerticalGridView().requestFocus();
840            }
841        };
842
843    private OnItemViewSelectedListener mRowViewSelectedListener = new OnItemViewSelectedListener() {
844        @Override
845        public void onItemSelected(Presenter.ViewHolder itemViewHolder, Object item,
846                RowPresenter.ViewHolder rowViewHolder, Row row) {
847            int position = mRowsSupportFragment.getVerticalGridView().getSelectedPosition();
848            if (DEBUG) Log.v(TAG, "row selected position " + position);
849            onRowSelected(position);
850            if (mExternalOnItemViewSelectedListener != null) {
851                mExternalOnItemViewSelectedListener.onItemSelected(itemViewHolder, item,
852                        rowViewHolder, row);
853            }
854        }
855    };
856
857    private OnItemSelectedListener mRowSelectedListener = new OnItemSelectedListener() {
858        @Override
859        public void onItemSelected(Object item, Row row) {
860            if (mExternalOnItemSelectedListener != null) {
861                mExternalOnItemSelectedListener.onItemSelected(item, row);
862            }
863        }
864    };
865
866    private OnItemSelectedListener mHeaderSelectedListener = new OnItemSelectedListener() {
867        @Override
868        public void onItemSelected(Object item, Row row) {
869            int position = mHeadersSupportFragment.getVerticalGridView().getSelectedPosition();
870            if (DEBUG) Log.v(TAG, "header selected position " + position);
871            onRowSelected(position);
872        }
873    };
874
875    private void onRowSelected(int position) {
876        if (position != mSelectedPosition) {
877            mSetSelectionRunnable.mPosition = position;
878            mBrowseFrame.getHandler().post(mSetSelectionRunnable);
879
880            if (getAdapter() == null || getAdapter().size() == 0 || position == 0) {
881                if (!mShowingTitle) {
882                    sTransitionHelper.runTransition(mSceneWithTitle, mTitleDownTransition);
883                    mShowingTitle = true;
884                }
885            } else if (mShowingTitle) {
886                sTransitionHelper.runTransition(mSceneWithoutTitle, mTitleUpTransition);
887                mShowingTitle = false;
888            }
889        }
890    }
891
892    private class SetSelectionRunnable implements Runnable {
893        int mPosition;
894        @Override
895        public void run() {
896            setSelection(mPosition);
897        }
898    }
899
900    private final SetSelectionRunnable mSetSelectionRunnable = new SetSelectionRunnable();
901
902    private void setSelection(int position) {
903        if (position != NO_POSITION) {
904            mRowsSupportFragment.setSelectedPosition(position);
905            mHeadersSupportFragment.setSelectedPosition(position);
906        }
907        mSelectedPosition = position;
908    }
909
910    @Override
911    public void onStart() {
912        super.onStart();
913        mHeadersSupportFragment.setWindowAlignmentFromTop(mContainerListAlignTop);
914        mHeadersSupportFragment.setItemAlignment();
915        mRowsSupportFragment.setWindowAlignmentFromTop(mContainerListAlignTop);
916        mRowsSupportFragment.setItemAlignment();
917
918        mRowsSupportFragment.getView().setPivotX(0);
919        mRowsSupportFragment.getView().setPivotY(mContainerListAlignTop);
920
921        if (mCanShowHeaders && mShowingHeaders && mHeadersSupportFragment.getView() != null) {
922            mHeadersSupportFragment.getView().requestFocus();
923        } else if ((!mCanShowHeaders || !mShowingHeaders)
924                && mRowsSupportFragment.getView() != null) {
925            mRowsSupportFragment.getView().requestFocus();
926        }
927        if (mCanShowHeaders) {
928            showHeaders(mShowingHeaders);
929        }
930    }
931
932    /**
933     * Enable/disable headers transition on back key support. This is enabled by
934     * default. The BrowseSupportFragment will add a back stack entry when headers are
935     * showing. Running a headers transition when the back key is pressed only
936     * works when the headers state is {@link #HEADERS_ENABLED} or
937     * {@link #HEADERS_HIDDEN}.
938     * <p>
939     * NOTE: If an Activity has its own onBackPressed() handling, you must
940     * disable this feature. You may use {@link #startHeadersTransition(boolean)}
941     * and {@link BrowseTransitionListener} in your own back stack handling.
942     */
943    public final void setHeadersTransitionOnBackEnabled(boolean headersBackStackEnabled) {
944        mHeadersBackStackEnabled = headersBackStackEnabled;
945    }
946
947    /**
948     * Returns true if headers transition on back key support is enabled.
949     */
950    public final boolean isHeadersTransitionOnBackEnabled() {
951        return mHeadersBackStackEnabled;
952    }
953
954    private void readArguments(Bundle args) {
955        if (args == null) {
956            return;
957        }
958        if (args.containsKey(ARG_TITLE)) {
959            setTitle(args.getString(ARG_TITLE));
960        }
961        if (args.containsKey(ARG_HEADERS_STATE)) {
962            setHeadersState(args.getInt(ARG_HEADERS_STATE));
963        }
964    }
965
966    /**
967     * Sets the drawable displayed in the browse fragment title.
968     *
969     * @param drawable The Drawable to display in the browse fragment title.
970     */
971    public void setBadgeDrawable(Drawable drawable) {
972        if (mBadgeDrawable != drawable) {
973            mBadgeDrawable = drawable;
974            if (mTitleView != null) {
975                mTitleView.setBadgeDrawable(drawable);
976            }
977        }
978    }
979
980    /**
981     * Returns the badge drawable used in the fragment title.
982     */
983    public Drawable getBadgeDrawable() {
984        return mBadgeDrawable;
985    }
986
987    /**
988     * Sets a title for the browse fragment.
989     *
990     * @param title The title of the browse fragment.
991     */
992    public void setTitle(String title) {
993        mTitle = title;
994        if (mTitleView != null) {
995            mTitleView.setTitle(title);
996        }
997    }
998
999    /**
1000     * Returns the title for the browse fragment.
1001     */
1002    public String getTitle() {
1003        return mTitle;
1004    }
1005
1006    /**
1007     * Sets the state for the headers column in the browse fragment. Must be one
1008     * of {@link #HEADERS_ENABLED}, {@link #HEADERS_HIDDEN}, or
1009     * {@link #HEADERS_DISABLED}.
1010     *
1011     * @param headersState The state of the headers for the browse fragment.
1012     */
1013    public void setHeadersState(int headersState) {
1014        if (headersState < HEADERS_ENABLED || headersState > HEADERS_DISABLED) {
1015            throw new IllegalArgumentException("Invalid headers state: " + headersState);
1016        }
1017        if (DEBUG) Log.v(TAG, "setHeadersState " + headersState);
1018
1019        if (headersState != mHeadersState) {
1020            mHeadersState = headersState;
1021            switch (headersState) {
1022                case HEADERS_ENABLED:
1023                    mCanShowHeaders = true;
1024                    mShowingHeaders = true;
1025                    break;
1026                case HEADERS_HIDDEN:
1027                    mCanShowHeaders = true;
1028                    mShowingHeaders = false;
1029                    break;
1030                case HEADERS_DISABLED:
1031                    mCanShowHeaders = false;
1032                    mShowingHeaders = false;
1033                    break;
1034                default:
1035                    Log.w(TAG, "Unknown headers state: " + headersState);
1036                    break;
1037            }
1038            if (mHeadersSupportFragment != null) {
1039                mHeadersSupportFragment.setHeadersGone(!mCanShowHeaders);
1040            }
1041        }
1042    }
1043
1044    /**
1045     * Returns the state of the headers column in the browse fragment.
1046     */
1047    public int getHeadersState() {
1048        return mHeadersState;
1049    }
1050}
1051
1052