63cdc5ccb7
Fix (or suppress) lint warnings and make it fatal again in the build process. Additionally, warnings are treated as errors now. If there are warnings that are not applicable, add @SuppressLint or tools:ignore to suppress the warning, so code reviewers can be aware of the lint issue too. Test: ./gradlew lint Change-Id: I63c83ff1b95a0817dc2ac777adce0fa9f9ebd45a
278 lines
9.4 KiB
Java
278 lines
9.4 KiB
Java
/*
|
|
* Copyright (C) 2015 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.setupwizardlib.view;
|
|
|
|
import android.annotation.SuppressLint;
|
|
import android.content.Context;
|
|
import android.content.res.TypedArray;
|
|
import android.os.Build;
|
|
import android.support.v7.widget.RecyclerView;
|
|
import android.util.AttributeSet;
|
|
import android.view.LayoutInflater;
|
|
import android.view.View;
|
|
import android.view.ViewGroup;
|
|
import android.view.accessibility.AccessibilityEvent;
|
|
import android.widget.FrameLayout;
|
|
|
|
import com.android.setupwizardlib.DividerItemDecoration;
|
|
import com.android.setupwizardlib.R;
|
|
import com.android.setupwizardlib.annotations.VisibleForTesting;
|
|
|
|
/**
|
|
* A RecyclerView that can display a header item at the start of the list. The header can be set by
|
|
* {@code app:suwHeader} in XML. Note that the header will not be inflated until a layout manager
|
|
* is set.
|
|
*/
|
|
public class HeaderRecyclerView extends RecyclerView {
|
|
|
|
private static class HeaderViewHolder extends ViewHolder
|
|
implements DividerItemDecoration.DividedViewHolder {
|
|
|
|
public HeaderViewHolder(View itemView) {
|
|
super(itemView);
|
|
}
|
|
|
|
@Override
|
|
public boolean isDividerAllowedAbove() {
|
|
return false;
|
|
}
|
|
|
|
@Override
|
|
public boolean isDividerAllowedBelow() {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* An adapter that can optionally add one header item to the RecyclerView.
|
|
*/
|
|
public static class HeaderAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
|
|
|
|
private static final int HEADER_VIEW_TYPE = Integer.MAX_VALUE;
|
|
|
|
private RecyclerView.Adapter mAdapter;
|
|
private View mHeader;
|
|
|
|
private final AdapterDataObserver mObserver = new AdapterDataObserver() {
|
|
|
|
@Override
|
|
public void onChanged() {
|
|
notifyDataSetChanged();
|
|
}
|
|
|
|
@Override
|
|
public void onItemRangeChanged(int positionStart, int itemCount) {
|
|
if (mHeader != null) {
|
|
positionStart++;
|
|
}
|
|
notifyItemRangeChanged(positionStart, itemCount);
|
|
}
|
|
|
|
@Override
|
|
public void onItemRangeInserted(int positionStart, int itemCount) {
|
|
if (mHeader != null) {
|
|
positionStart++;
|
|
}
|
|
notifyItemRangeInserted(positionStart, itemCount);
|
|
}
|
|
|
|
@Override
|
|
public void onItemRangeMoved(int fromPosition, int toPosition, int itemCount) {
|
|
if (mHeader != null) {
|
|
fromPosition++;
|
|
toPosition++;
|
|
}
|
|
// Why is there no notifyItemRangeMoved?
|
|
for (int i = 0; i < itemCount; i++) {
|
|
notifyItemMoved(fromPosition + i, toPosition + i);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void onItemRangeRemoved(int positionStart, int itemCount) {
|
|
if (mHeader != null) {
|
|
positionStart++;
|
|
}
|
|
notifyItemRangeRemoved(positionStart, itemCount);
|
|
}
|
|
};
|
|
|
|
public HeaderAdapter(RecyclerView.Adapter adapter) {
|
|
mAdapter = adapter;
|
|
mAdapter.registerAdapterDataObserver(mObserver);
|
|
setHasStableIds(mAdapter.hasStableIds());
|
|
}
|
|
|
|
@SuppressLint("InlinedApi") // MATCH_PARENT is the same constant as FILL_PARENT available
|
|
// on earlier versions.
|
|
@Override
|
|
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
|
|
/*
|
|
* Returning the same view (mHeader) results in crash ".. but view is not a real child."
|
|
* The framework creates more than one instance of header because of "disappear"
|
|
* animations applied on the header and this necessitates creation of another headerview
|
|
* to use after the animation. We work around this restriction by returning an empty
|
|
* framelayout to which the header is attached using #onBindViewHolder method.
|
|
*/
|
|
if (viewType == HEADER_VIEW_TYPE) {
|
|
FrameLayout frameLayout = new FrameLayout(parent.getContext());
|
|
FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(
|
|
FrameLayout.LayoutParams.MATCH_PARENT,
|
|
FrameLayout.LayoutParams.WRAP_CONTENT
|
|
);
|
|
frameLayout.setLayoutParams(params);
|
|
return new HeaderViewHolder(frameLayout);
|
|
} else {
|
|
return mAdapter.onCreateViewHolder(parent, viewType);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
@SuppressWarnings("unchecked")
|
|
public void onBindViewHolder(ViewHolder holder, int position) {
|
|
if (mHeader != null) {
|
|
position--;
|
|
}
|
|
|
|
if (holder instanceof HeaderViewHolder) {
|
|
if (mHeader.getParent() != null) {
|
|
((ViewGroup) mHeader.getParent()).removeView(mHeader);
|
|
}
|
|
FrameLayout mHeaderParent = (FrameLayout) holder.itemView;
|
|
mHeaderParent.addView(mHeader);
|
|
} else {
|
|
mAdapter.onBindViewHolder(holder, position);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public int getItemViewType(int position) {
|
|
if (mHeader != null) {
|
|
position--;
|
|
}
|
|
if (position < 0) {
|
|
return HEADER_VIEW_TYPE;
|
|
}
|
|
return mAdapter.getItemViewType(position);
|
|
}
|
|
|
|
@Override
|
|
public int getItemCount() {
|
|
int count = mAdapter.getItemCount();
|
|
if (mHeader != null) {
|
|
count++;
|
|
}
|
|
return count;
|
|
}
|
|
|
|
@Override
|
|
public long getItemId(int position) {
|
|
if (mHeader != null) {
|
|
position--;
|
|
}
|
|
if (position < 0) {
|
|
return Long.MAX_VALUE;
|
|
}
|
|
return mAdapter.getItemId(position);
|
|
}
|
|
|
|
public void setHeader(View header) {
|
|
mHeader = header;
|
|
}
|
|
|
|
@VisibleForTesting
|
|
public RecyclerView.Adapter getWrappedAdapter() {
|
|
return mAdapter;
|
|
}
|
|
}
|
|
|
|
private View mHeader;
|
|
private int mHeaderRes;
|
|
|
|
public HeaderRecyclerView(Context context) {
|
|
super(context);
|
|
init(null, 0);
|
|
}
|
|
|
|
public HeaderRecyclerView(Context context, AttributeSet attrs) {
|
|
super(context, attrs);
|
|
init(attrs, 0);
|
|
}
|
|
|
|
public HeaderRecyclerView(Context context, AttributeSet attrs, int defStyleAttr) {
|
|
super(context, attrs, defStyleAttr);
|
|
init(attrs, defStyleAttr);
|
|
}
|
|
|
|
private void init(AttributeSet attrs, int defStyleAttr) {
|
|
final TypedArray a = getContext().obtainStyledAttributes(attrs,
|
|
R.styleable.SuwHeaderRecyclerView, defStyleAttr, 0);
|
|
mHeaderRes = a.getResourceId(R.styleable.SuwHeaderRecyclerView_suwHeader, 0);
|
|
a.recycle();
|
|
}
|
|
|
|
@Override
|
|
public void onInitializeAccessibilityEvent(AccessibilityEvent event) {
|
|
super.onInitializeAccessibilityEvent(event);
|
|
|
|
// Decoration-only headers should not count as an item for accessibility, adjust the
|
|
// accessibility event to account for that.
|
|
final int numberOfHeaders = mHeader != null ? 1 : 0;
|
|
event.setItemCount(event.getItemCount() - numberOfHeaders);
|
|
event.setFromIndex(Math.max(event.getFromIndex() - numberOfHeaders, 0));
|
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
|
|
event.setToIndex(Math.max(event.getToIndex() - numberOfHeaders, 0));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets the header view of this RecyclerView, or {@code null} if there are no headers.
|
|
*/
|
|
public View getHeader() {
|
|
return mHeader;
|
|
}
|
|
|
|
/**
|
|
* Set the view to use as the header of this recycler view.
|
|
* Note: This must be called before setAdapter.
|
|
*/
|
|
public void setHeader(View header) {
|
|
mHeader = header;
|
|
}
|
|
|
|
@Override
|
|
public void setLayoutManager(LayoutManager layout) {
|
|
super.setLayoutManager(layout);
|
|
if (layout != null && mHeader == null && mHeaderRes != 0) {
|
|
// Inflating a child view requires the layout manager to be set. Check here to see if
|
|
// any header item is specified in XML and inflate them.
|
|
final LayoutInflater inflater = LayoutInflater.from(getContext());
|
|
mHeader = inflater.inflate(mHeaderRes, this, false);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void setAdapter(Adapter adapter) {
|
|
if (mHeader != null && adapter != null) {
|
|
final HeaderAdapter headerAdapter = new HeaderAdapter(adapter);
|
|
headerAdapter.setHeader(mHeader);
|
|
adapter = headerAdapter;
|
|
}
|
|
super.setAdapter(adapter);
|
|
}
|
|
}
|