TimetableUI

A UI library of timetable by NPC from National Taipei University of Technology.

Screenshots

Download

TimetableUI is available on jitpack.io. See the full information here.

Gradle dependency:

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

dependencies {
    compile 'com.github.yaoandy107:TimetableUI:v1.0.0'
}

Usage

Basic

Once imported into your project, you just need to put it into your layout like:

<me.yaoandy107.ntut_timetable.CourseTableLayout  
   android:id="@+id/courseTable"  
   android:layout_width="match_parent"  
   android:layout_height="match_parent" />

And then you can start to add some courses like this.

public class MainActivity extends AppCompatActivity {  
    @Override  
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  

        CourseTableLayout courseTable = findViewById(R.id.courseTable);  
        StudentCourse studentCourse = new StudentCourse();  
        ArrayList<CourseInfo> courseInfoList = new ArrayList<>();  

        // Add course1 - sample1  
        CourseInfo courseInfo1 = new CourseInfo();  
        courseInfo1.setName("Course 1");  
        courseInfo1.setCourseTime("1 2", "", "4", "", "", "", "");  
        courseInfoList.add(courseInfo1);  

        // Add course2 - sample2 
        CourseInfo courseInfo2 = new CourseInfo(); 
        courseInfo2.setName("Course 2");  
        courseInfo2.setCourseTime(new String[]{"4", "5", "3", "6 7 8", "", "", ""});  
        courseInfoList.add(courseInfo2);  

        // Set timetable
        studentCourse.setCourseList(courseInfoList);  
        courseTable.setStudentCourse(studentCourse);  
    }  
}

setCourseTime

Set the course time in order of Monday to Sunday. For example, courseInfo1 is at the first and second period on Monday, also the fourth on Wednesday.

Add OnClickListner for course block

If you want to add OnClickListner for course blocks, you just need to add the listener like:

courseTable.setOnCourseClickListener(new View.OnClickListener() {  
    @Override  
    public void onClick(View view) {  
        CourseInfo item = (CustomCourseInfo) view.getTag();  
        showInfoDialog(view.getId(), item.getName(), item);  
    }  
});

Add Initialize Listener

If you want to execute some code when layout finished initial, you can do as the code below.

courseTable.setTableInitializeListener(new CourseTableLayout.TableInitializeListener() {  
    @Override  
    public void onTableInitialized(CourseTableLayout course_table) {  
        Toast.makeText(MainActivity.this, "Finish intialized", Toast.LENGTH_SHORT).show();  
    }  
});

Customize Course Info

By default, CourseInfo have two basis parameters which are name and times, so you don't have to implement by yourself.

If you want to have more parameter in CourseInfo, you can extends CourseInfo in our library and add some parameter yourself like the sample below.

public class CustomCourseInfo extends CourseInfo {  
    private String loaction;  
    private String id;  
    private String teacher;  
  
    public String getLoaction() {  
        return loaction;  
    }  
  
    public void setLoaction(String loaction) {  
        this.loaction = loaction;  
    }  
  
    public String getId() {  
        return id;  
    }  
  
    public void setId(String id) {  
        this.id = id;  
    }  
  
    public String getTeacher() {  
        return teacher;  
    }  
  
    public void setTeacher(String teacher) {  
        this.teacher = teacher;  
    }  
}

More sample

You can download my repo to see some sample code I write.

Contributing to the project

Issues

Feel free to submit issues requests.

Contributing

We follow the "fork-and-pull" Git workflow, be free to contribute for this project.

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

License

Copyright (c) 2018 Wei Chen Yao (https://yaoandy107.github.io/).

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.