Java tutorial
/* Copyright 2016 StepStone Services 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.stepstone.stepper.internal; import android.content.Context; import android.content.res.TypedArray; import android.support.annotation.ColorInt; import android.support.annotation.NonNull; import android.support.annotation.Nullable; import android.support.annotation.UiThread; import android.support.v4.content.ContextCompat; import android.util.AttributeSet; import android.view.LayoutInflater; import android.view.View; import android.widget.FrameLayout; import android.widget.HorizontalScrollView; import android.widget.LinearLayout; import com.stepstone.stepper.R; import com.stepstone.stepper.StepperLayout; import java.util.List; /** * Layout used for displaying tabs from the horizontal stepper. * Steps must be added via {@link #setSteps(List)}.<br> * <b>NOTE:</b> {@link #setSelectedColor(int)} and {@link #setUnselectedColor(int)} should be set before calling {@link #setSteps(List)}. */ public class TabsContainer extends FrameLayout { /** * Listeners for actions on individual tabs of the horizontal stepper */ public interface TabItemListener { /** * Called when a tab gets clicked * * @param position position of the tab/step */ @UiThread void onTabClicked(int position); TabItemListener NULL = new TabItemListener() { @Override public void onTabClicked(int position) { } }; } @ColorInt private int mUnselectedColor; @ColorInt private int mSelectedColor; @ColorInt private int mErrorColor; private int mDividerWidth = StepperLayout.DEFAULT_TAB_DIVIDER_WIDTH; private final int mContainerLateralPadding; private HorizontalScrollView mTabsScrollView; private LinearLayout mTabsInnerContainer; private TabItemListener mListener = TabItemListener.NULL; private List<CharSequence> mStepTitles; private boolean mShowErrorStateOnBack; public TabsContainer(Context context) { this(context, null); } public TabsContainer(Context context, AttributeSet attrs) { this(context, attrs, 0); } public TabsContainer(Context context, AttributeSet attrs, int defStyleAttr) { super(context, attrs, defStyleAttr); LayoutInflater.from(context).inflate(R.layout.ms_tabs_container, this, true); mSelectedColor = ContextCompat.getColor(context, R.color.ms_selectedColor); mUnselectedColor = ContextCompat.getColor(context, R.color.ms_unselectedColor); mErrorColor = ContextCompat.getColor(context, R.color.ms_errorColor); if (attrs != null) { final TypedArray a = getContext().obtainStyledAttributes(attrs, R.styleable.TabsContainer, defStyleAttr, 0); if (a.hasValue(R.styleable.TabsContainer_ms_activeTabColor)) { mSelectedColor = a.getColor(R.styleable.TabsContainer_ms_activeTabColor, mSelectedColor); } if (a.hasValue(R.styleable.TabsContainer_ms_inactiveTabColor)) { mUnselectedColor = a.getColor(R.styleable.TabsContainer_ms_inactiveTabColor, mUnselectedColor); } if (a.hasValue(R.styleable.StepperLayout_ms_errorColor)) { mErrorColor = a.getColor(R.styleable.StepperLayout_ms_errorColor, mErrorColor); } a.recycle(); } mContainerLateralPadding = context.getResources() .getDimensionPixelOffset(R.dimen.ms_tabs_container_lateral_padding); mTabsInnerContainer = (LinearLayout) findViewById(R.id.ms_stepTabsInnerContainer); mTabsScrollView = (HorizontalScrollView) findViewById(R.id.ms_stepTabsScrollView); } public void setUnselectedColor(@ColorInt int unselectedColor) { this.mUnselectedColor = unselectedColor; } public void setSelectedColor(@ColorInt int selectedColor) { this.mSelectedColor = selectedColor; } public void setErrorColor(@ColorInt int mErrorColor) { this.mErrorColor = mErrorColor; } public void setDividerWidth(int dividerWidth) { this.mDividerWidth = dividerWidth; } public void setListener(@NonNull TabItemListener listener) { this.mListener = listener; } /** * Sets the steps to display in the {@link TabsContainer}. * * @param stepTitles a list of tab titles */ public void setSteps(List<CharSequence> stepTitles) { this.mStepTitles = stepTitles; mTabsInnerContainer.removeAllViews(); for (int i = 0; i < stepTitles.size(); i++) { final View tab = createStepTab(i, stepTitles.get(i)); mTabsInnerContainer.addView(tab, tab.getLayoutParams()); } } /** * Changes the position of the current step and updates the UI based on it. * * @param newStepPosition new current step */ public void setCurrentStep(int newStepPosition) { int size = mStepTitles.size(); for (int i = 0; i < size; i++) { StepTab childTab = (StepTab) mTabsInnerContainer.getChildAt(i); boolean done = i < newStepPosition; final boolean current = i == newStepPosition; childTab.updateState(done, mShowErrorStateOnBack, current); if (current) { mTabsScrollView.smoothScrollTo(childTab.getLeft() - mContainerLateralPadding, 0); } } } /** * Set whether when going backwards should clear the error state from the Tab. Default is false * * @param mShowErrorStateOnBack true if navigating backwards should keep the error state, false otherwise */ public void setShowErrorStateOnBack(boolean mShowErrorStateOnBack) { this.mShowErrorStateOnBack = mShowErrorStateOnBack; } public void setErrorStep(int stepPosition, boolean hasError) { if (mStepTitles.size() < stepPosition) { return; } StepTab childTab = (StepTab) mTabsInnerContainer.getChildAt(stepPosition); childTab.updateErrorState(mStepTitles.size() - 1 == stepPosition, hasError); } private View createStepTab(final int position, @Nullable CharSequence title) { StepTab view = (StepTab) LayoutInflater.from(getContext()).inflate(R.layout.ms_step_tab_container, mTabsInnerContainer, false); view.setStepNumber(String.valueOf(position + 1)); view.toggleDividerVisibility(!isLastPosition(position)); view.setStepTitle(title); view.setSelectedColor(mSelectedColor); view.setUnselectedColor(mUnselectedColor); view.setErrorColor(mErrorColor); view.setDividerWidth(mDividerWidth); view.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { mListener.onTabClicked(position); } }); return view; } private boolean isLastPosition(int position) { return position == mStepTitles.size() - 1; } }