Skip to content

Latest commit

 

History

History
167 lines (135 loc) · 8.32 KB

readme.md

File metadata and controls

167 lines (135 loc) · 8.32 KB
Raw

#Synopsis This is a custom implementation of a RelativeLayout that you can use along with a ViewPager to navigate between fragments.

alt text alt text alt text

#Code usage

You can use this properties in xml for convenience. You can set the number of tabs you want to use and the starting tab position.

        app:number_of_tabs="five"
        app:starting_position="three"
        
        app:tab_color="@color/colorPrimary"
        app:button_color="@color/colorAccent"
        app:text_color="#61FFFFFF"
        
        app:icon_one="@drawable/ic_hotel_black_24dp"
        app:icon_two="@drawable/design_ic_visibility"
        app:icon_three="@drawable/ic_content_cut_black_24dp"
        app:icon_four="@drawable/ic_check_black_24dp"
        app:icon_five="@drawable/ic_fingerprint_black_24dp"
         
        app:text_one="Action"
        app:text_two="Action"
        app:text_three="Action"

You can also use the fallowing methods to customize its appearance and behavior:

Method Description
getTabLayout(); Gives you the base RelativeLayout.
setTabColor(@ColorInt int backgroundColor); Change the color of the Tab.
getCurrentPosition(); Gives you the current tab position.
getButton(); Give you the Floating Action Button View.
setButtonColor(@ColorInt int backgroundColor); Change the color of the Floating Button.
setOnClickListener(View.OnClickListener l); Set the same OnClickListener to all positions.
setTabOneOnClickListener(View.OnClickListener ll); Set the OnClickListener for the first position.
setTabTwoOnClickListener(View.OnClickListener cl); Set the OnClickListener for the second position.
getTabOneView(); Get you the first base LinearLayout that contains an ImageView or an ImageView and a TextView.
setTabOneView(View tabOneView); You can set the base layout for the first position.
getTabTwoView(); Get you the second base LinearLayout that contains an ImageView or an ImageView and a TextView.
setTabTwoView(View centerView); You can set the base layout for the second position.
setTabOneIcon(@DrawableRes int tabOneIcon); Set the icon for both the first tab and the Action Button when in the first position.
setTabTwoIcon(@DrawableRes int tabTwoIcon); Set the icon for both the second tab and the Action Button when in the second position.

#Motivation I get the inspiration from the Google Space app that uses a center Floating Action Button. I liked the idea so much that I though that it would be so nice if we could have this like a TabLayout.

You can see in the image:

alt text

#Installation ###Declaring dependencies Add this to dependencies brackets in the gradle.build file:

compile 'eu.long1:spacetablayout:1.0.4'

###XML implementation In your layout just include this. You can customize the Tab here with text, icons, colors...

 <eu.long1.spacetablayout.SpaceTabLayout
        android:id="@+id/spaceTabLayout"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" 
        app:number_of_tabs="five"
        app:starting_position="three"
        app:tab_color="@color/colorPrimary"
        app:button_color="@color/colorAccent"
        app:text_color="#61FFFFFF"
        app:icon_one="@drawable/ic_hotel_black_24dp"
        app:icon_two="@drawable/design_ic_visibility"
        app:icon_three="@drawable/ic_content_cut_black_24dp"
        app:icon_four="@drawable/ic_check_black_24dp"
        app:icon_five="@drawable/ic_fingerprint_black_24dp"/>

####SnackBar behavior If you are using a CoordinatorLayout as the root of your layout you can add this line to proper handle the behavior when a SnackBar is visible.

 app:layout_behavior="eu.long1.spacetablayout.SpaceTabLayoutBehavior"

####XML Example

<android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v4.view.ViewPager
        android:id="@+id/viewPager"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="56dp" />

    <eu.long1.spacetablayout.SpaceTabLayout
        android:id="@+id/spaceTabLayout"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:layout_behavior="eu.long1.spacetablayout.SpaceTabLayoutBehavior"
        app:number_of_tabs="five"
        app:starting_position="three" />

</android.support.design.widget.CoordinatorLayout>

###Code implementation In your MainActivity.java you need to initialize the SpaceTabLayout like this:

    SpaceTabLayout tabLayout;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            //add the fragments you want to display in a List
            List<Fragment> fragmentList = new ArrayList<>();
            fragmentList.add(new FragmentA());
            fragmentList.add(new FragmentB());
            fragmentList.add(new FragmentC());
            
            ViewPager viewPager = (ViewPager) findViewById(R.id.viewPager);
            tabLayout = (SpaceTabLayout) findViewById(R.id.spaceTabLayout);
            
            //we need the savedInstanceState to get the position
            tabLayout.initialize(viewPager, getSupportFragmentManager(), 
                            fragmentList, savedInstanceState);
        }
    
    
        //we need the outState to save the position
        @Override
        protected void onSaveInstanceState(Bundle outState) {
            tabLayout.saveState(outState);
            super.onSaveInstanceState(outState);
        }

#Issues

If you have an issues with this library, please open a issue here: https://github.com/thelong1EU/SpaceTabLayout/issues and provide enough information to reproduce it. The following information needs to be provided:

  1. Which version of the SDK are you using?
  • What device are you using?
  • What steps will reproduce the problem?
  • Relevant logcat output.
  • Optional: Any screenshot(s) that demonstrate the issue.

#License Copyright (c) 2016 Lung Răzvan

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.