Need help with StickyTimeLine?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

sangcomz
498 Stars 73 Forks Apache License 2.0 99 Commits 3 Opened issues

Description

:book:StickyTimeLine is timeline view for android.

Services available

!
?

Need anything else?

Contributors list

# 70,408
Java
Shell
photopi...
Kotlin
64 commits
# 466,046
Kotlin
stickyh...
sticky
Android
1 commit
# 467,545
Kotlin
Java
stickyh...
sticky
1 commit
# 342,950
stickyh...
Android
C
Shell
1 commit

StickyTimeLine

StickyTimeLine is timeline view for android.

What's New in 0.1.1? :tada:

  • Remove the way of using xml view of VerticalSectionItemDecoration
  • Add dot size attribute
    • timeLineDotRadius
      ,
      timeLineDotStrokeSize
  • Support RTL (#26)

## Result Screen

Feel free to send me a pull request with your app and I'll link you here:

| Sample

Get it on Google Play

| AlleysMap

Get it on Google Play

| StockRoom

Get it on Google Play

| |:---------------------------------:|:--------------------------------:|:--------------------------------:| | |||

How to Use

Gradle

    repositories {
        maven { url 'https://jitpack.io' }
    }

dependencies {
    //StickyTimeLine v0.0.20 and above only supports projects that have been migrated to androidx.
    compile 'com.github.sangcomz:StickyTimeLine:v0.1.1'
}

Usage

activity_main.xml

<xyz.sangcomz.stickytimelineview.timelinerecyclerview android:id="@+id/recycler_view" android:layout_width="match_parent" android:layout_height="wrap_content"></xyz.sangcomz.stickytimelineview.timelinerecyclerview>

</android.support.constraint.constraintlayout>

MainActivity.kt

class MainActivity : AppCompatActivity() {

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val recyclerView: TimeLineRecyclerView = findViewById(R.id.recycler_view)

    //Currently only LinearLayoutManager is supported.
    recyclerView.layoutManager = LinearLayoutManager(this,
            LinearLayoutManager.VERTICAL,
            false)

    //Get data
    val singerList = getSingerList()


    //Add RecyclerSectionItemDecoration.SectionCallback
    recyclerView.addItemDecoration(getSectionCallback(singerList))

    //Set Adapter
    recyclerView.adapter = SingerAdapter(layoutInflater,
            singerList,
            R.layout.recycler_row)
}

//Get data method
private fun getSingerList(): List<singer> = SingerRepo().singerList


//Get SectionCallback method
private fun getSectionCallback(singerList: List<singer>): RecyclerSectionItemDecoration.SectionCallback {
    return object : RecyclerSectionItemDecoration.SectionCallback {
        //In your data, implement a method to determine if this is a section.
        override fun isSection(position: Int): Boolean =
                singerList[position].debuted != singerList[position - 1].debuted

        //Implement a method that returns a SectionHeader.
        override fun getSectionHeader(position: Int): SectionInfo? =
                SectionInfo(singerList[position].debuted, singerList[position].group)
    }
}

}

JavaExampleActivity.java

public class JavaExampleActivity extends AppCompatActivity {

private Drawable icFinkl, icBuzz, icWannaOne, icGirlsGeneration, icSolo;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    initDrawable();

    TimeLineRecyclerView recyclerView = findViewById(R.id.recycler_view);

    recyclerView.setLayoutManager(new LinearLayoutManager(this,
            RecyclerView.VERTICAL,
            false));

    List<singer> singerList = getSingerList();

    recyclerView.addItemDecoration(getSectionCallback(singerList));

    recyclerView.setAdapter(new SingerAdapter(getLayoutInflater(), singerList, R.layout.recycler_row));
}

private RecyclerSectionItemDecoration.SectionCallback getSectionCallback(final List<singer> singerList) {
    return new RecyclerSectionItemDecoration.SectionCallback() {

        @Nullable
        @Override
        public SectionInfo getSectionHeader(int position) {
            Singer singer = singerList.get(position);
            Drawable dot;
            switch (singer.getGroup()) {
                case "FIN.K.L": {
                    dot = icFinkl;
                    break;
                }
                case "Girls' Generation": {
                    dot = icGirlsGeneration;
                    break;
                }
                case "Buzz": {
                    dot = icBuzz;
                    break;
                }
                case "Wanna One": {
                    dot = icWannaOne;
                    break;
                }
                default: {
                    dot = icSolo;
                }
            }
            return new SectionInfo(singer.getDebuted(), singer.getGroup(), dot);
        }

        @Override
        public boolean isSection(int position) {
            return !singerList.get(position).getDebuted().equals(singerList.get(position - 1).getDebuted());
        }
    };
}

private List<singer> getSingerList() {
    return new SingerRepo().getSingerList();
}

private void initDrawable() {
    icFinkl = AppCompatResources.getDrawable(this, R.drawable.ic_finkl);
    icBuzz = AppCompatResources.getDrawable(this, R.drawable.ic_buzz);
    icWannaOne = AppCompatResources.getDrawable(this, R.drawable.ic_wannaone);
    icGirlsGeneration = AppCompatResources.getDrawable(this, R.drawable.ic_girlsgeneration);
    icSolo = AppCompatResources.getDrawable(this, R.drawable.ic_wannaone);
}

}

caution
  • Currently only LinearLayoutManager is supported.

recycler_row.xml


<textview android:id="@+id/full_name_tv" android:layout_width="match_parent" android:layout_height="wrap_content" android:padding="10dp"></textview>

</android.support.v7.widget.cardview>

caution
  • Don't set margin value in the parent view.

attribute

| Method Name | Description | Default Value | |:------------------------:|-------------------------------------------------------|:-------------:| |sectionBackgroundColor | To change section section background color | #f9f9f9 | |sectionTitleTextColor | To change section title color | #414fca | |sectionSubTitleTextColor | To change section sub title color | #d16767 | |timeLineColor | To change line color in timeline | #51ae45 | |timeLineDotColor | To change dot color in timeline | #51ae45 | |timeLineCircleStrokeColor | To change dot stroke color in timeline | #f9f9f9 | |sectionTitleTextSize | To change section title text size | 14sp | |sectionSubTitleTextSize | To change section sub title text size | 12sp | |timeLineWidth | To change line width in timeline | 4dp | |isSticky | To change Sticky functionality in the Timeline | true | |customDotDrawable | To change the circle to custom drawable | null | |sectionBackgroundColorMode| To change section background area(for horizontal mode)| MODE_FULL | |timeLineDotRadius | To change dot radius | 8dp | |timeLineDotStrokeSize | To change dot stroke size | 4dp |

Contribute

We welcome any contributions.

Inspired by

  • tim.paetz, I was inspired by his code. And I used some of his code in the library.

License

Copyright 2019 Jeong Seok-Won

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.