| /* |
| * Copyright (C) 2016 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package com.android.documentsui; |
| |
| import android.content.Context; |
| import android.util.AttributeSet; |
| import android.view.GestureDetector; |
| import android.view.KeyEvent; |
| import android.view.LayoutInflater; |
| import android.view.MotionEvent; |
| import android.view.View; |
| import android.view.ViewGroup; |
| |
| import androidx.recyclerview.widget.LinearLayoutManager; |
| import androidx.recyclerview.widget.RecyclerView; |
| |
| import com.android.documentsui.NavigationViewManager.Breadcrumb; |
| import com.android.documentsui.NavigationViewManager.Environment; |
| import com.android.documentsui.dirlist.AccessibilityEventRouter; |
| |
| import java.util.function.Consumer; |
| import java.util.function.IntConsumer; |
| |
| /** |
| * Horizontal breadcrumb |
| */ |
| public final class HorizontalBreadcrumb extends RecyclerView implements Breadcrumb { |
| |
| private static final int USER_NO_SCROLL_OFFSET_THRESHOLD = 5; |
| |
| private LinearLayoutManager mLayoutManager; |
| private BreadcrumbAdapter mAdapter; |
| private IntConsumer mClickListener; |
| |
| public HorizontalBreadcrumb(Context context, AttributeSet attrs, int defStyleAttr) { |
| super(context, attrs, defStyleAttr); |
| } |
| |
| public HorizontalBreadcrumb(Context context, AttributeSet attrs) { |
| super(context, attrs); |
| } |
| |
| public HorizontalBreadcrumb(Context context) { |
| super(context); |
| } |
| |
| @Override |
| public void setup(Environment env, |
| com.android.documentsui.base.State state, |
| IntConsumer listener) { |
| |
| mClickListener = listener; |
| mLayoutManager = new HorizontalBreadcrumbLinearLayoutManager( |
| getContext(), LinearLayoutManager.HORIZONTAL, false); |
| mAdapter = new BreadcrumbAdapter(state, env, this::onKey); |
| // Since we are using GestureDetector to detect click events, a11y services don't know which |
| // views are clickable because we aren't using View.OnClickListener. Thus, we need to use a |
| // custom accessibility delegate to route click events correctly. |
| // See AccessibilityClickEventRouter for more details on how we are routing these a11y |
| // events. |
| setAccessibilityDelegateCompat( |
| new AccessibilityEventRouter(this, |
| (View child) -> onAccessibilityClick(child), null)); |
| |
| setLayoutManager(mLayoutManager); |
| addOnItemTouchListener(new ClickListener(getContext(), this::onSingleTapUp)); |
| } |
| |
| @Override |
| public void show(boolean visibility) { |
| if (visibility) { |
| setVisibility(VISIBLE); |
| boolean shouldScroll = !hasUserDefineScrollOffset(); |
| if (getAdapter() == null) { |
| setAdapter(mAdapter); |
| } else { |
| int currentItemCount = mAdapter.getItemCount(); |
| int lastItemCount = mAdapter.getLastItemSize(); |
| if (currentItemCount > lastItemCount) { |
| mAdapter.notifyItemRangeInserted(lastItemCount, |
| currentItemCount - lastItemCount); |
| mAdapter.notifyItemChanged(lastItemCount - 1); |
| } else if (currentItemCount < lastItemCount) { |
| mAdapter.notifyItemRangeRemoved(currentItemCount, |
| lastItemCount - currentItemCount); |
| mAdapter.notifyItemChanged(currentItemCount - 1); |
| } else { |
| mAdapter.notifyItemChanged(currentItemCount - 1); |
| } |
| } |
| if (shouldScroll) { |
| mLayoutManager.scrollToPosition(mAdapter.getItemCount() - 1); |
| } |
| } else { |
| setVisibility(GONE); |
| setAdapter(null); |
| } |
| mAdapter.updateLastItemSize(); |
| } |
| |
| private boolean hasUserDefineScrollOffset() { |
| final int maxOffset = computeHorizontalScrollRange() - computeHorizontalScrollExtent(); |
| return (maxOffset - computeHorizontalScrollOffset() > USER_NO_SCROLL_OFFSET_THRESHOLD); |
| } |
| |
| private boolean onAccessibilityClick(View child) { |
| int pos = getChildAdapterPosition(child); |
| if (pos != getAdapter().getItemCount() - 1) { |
| mClickListener.accept(pos); |
| return true; |
| } |
| return false; |
| } |
| |
| private boolean onKey(View v, int keyCode, KeyEvent event) { |
| switch (keyCode) { |
| case KeyEvent.KEYCODE_ENTER: |
| return onAccessibilityClick(v); |
| default: |
| return false; |
| } |
| } |
| |
| @Override |
| public void postUpdate() { |
| } |
| |
| private void onSingleTapUp(MotionEvent e) { |
| View itemView = findChildViewUnder(e.getX(), e.getY()); |
| int pos = getChildAdapterPosition(itemView); |
| if (pos != mAdapter.getItemCount() - 1 && pos != -1) { |
| mClickListener.accept(pos); |
| } |
| } |
| |
| private static final class BreadcrumbAdapter |
| extends RecyclerView.Adapter<BreadcrumbHolder> { |
| |
| private final Environment mEnv; |
| private final com.android.documentsui.base.State mState; |
| private final View.OnKeyListener mClickListener; |
| // We keep the old item size so the breadcrumb will only re-render views that are necessary |
| private int mLastItemSize; |
| |
| public BreadcrumbAdapter(com.android.documentsui.base.State state, |
| Environment env, |
| View.OnKeyListener clickListener) { |
| mState = state; |
| mEnv = env; |
| mClickListener = clickListener; |
| mLastItemSize = getItemCount(); |
| } |
| |
| @Override |
| public BreadcrumbHolder onCreateViewHolder(ViewGroup parent, int viewType) { |
| View v = LayoutInflater.from(parent.getContext()) |
| .inflate(R.layout.navigation_breadcrumb_item, null); |
| return new BreadcrumbHolder(v); |
| } |
| |
| @Override |
| public void onBindViewHolder(BreadcrumbHolder holder, int position) { |
| final int padding = (int) holder.itemView.getResources() |
| .getDimension(R.dimen.breadcrumb_item_padding); |
| final boolean isFirst = position == 0; |
| // Note that when isFirst is true, there might not be a DocumentInfo on the stack as it |
| // could be an error state screen accessible from the root info. |
| final boolean isLast = position == getItemCount() - 1; |
| |
| holder.mTitle.setText( |
| isFirst ? mEnv.getCurrentRoot().title : mState.stack.get(position).displayName); |
| holder.mTitle.setEnabled(isLast); |
| holder.mTitle.setPadding(isFirst ? padding * 3 : padding, |
| padding, isLast ? padding * 2 : padding, padding); |
| holder.mArrow.setVisibility(isLast ? View.GONE : View.VISIBLE); |
| |
| holder.itemView.setOnKeyListener(mClickListener); |
| holder.setLast(isLast); |
| } |
| |
| @Override |
| public int getItemCount() { |
| // Don't show recents in the breadcrumb. |
| if (mState.stack.isRecents()) { |
| return 0; |
| } |
| // Continue showing the root title in the breadcrumb for cross-profile error screens. |
| if (mState.supportsCrossProfile() |
| && mState.stack.size() == 0 |
| && mState.stack.getRoot() != null |
| && mState.stack.getRoot().supportsCrossProfile()) { |
| return 1; |
| } |
| return mState.stack.size(); |
| } |
| |
| public int getLastItemSize() { |
| return mLastItemSize; |
| } |
| |
| public void updateLastItemSize() { |
| mLastItemSize = getItemCount(); |
| } |
| } |
| |
| private static final class ClickListener extends GestureDetector |
| implements OnItemTouchListener { |
| |
| public ClickListener(Context context, Consumer<MotionEvent> listener) { |
| super(context, new SimpleOnGestureListener() { |
| @Override |
| public boolean onSingleTapUp(MotionEvent e) { |
| listener.accept(e); |
| return true; |
| } |
| }); |
| } |
| |
| @Override |
| public boolean onInterceptTouchEvent(RecyclerView rv, MotionEvent e) { |
| onTouchEvent(e); |
| return false; |
| } |
| |
| @Override |
| public void onTouchEvent(RecyclerView rv, MotionEvent e) { |
| onTouchEvent(e); |
| } |
| |
| @Override |
| public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) { |
| } |
| } |
| |
| private static class HorizontalBreadcrumbLinearLayoutManager extends LinearLayoutManager { |
| |
| /** |
| * Disable predictive animations. There is a bug in RecyclerView which causes views that |
| * are being reloaded to pull invalid view holders from the internal recycler stack if the |
| * adapter size has decreased since the ViewHolder was recycled. |
| */ |
| @Override |
| public boolean supportsPredictiveItemAnimations() { |
| return false; |
| } |
| |
| HorizontalBreadcrumbLinearLayoutManager( |
| Context context, int orientation, boolean reverseLayout) { |
| super(context, orientation, reverseLayout); |
| } |
| } |
| } |