Timetables
安装
npm install timetables
直接引入
或者直接引入该地址下timetables.min.js
使用
import Timetables from 'timetables';
const courseList = [
['语文','语文','英语','物理','语文','数学','英语','物理','物理','数学','英语','物理'],
['数学','语文','物理','物理','语文','语文','语文','物理','数学','语文','语文','体育'],
['语文','数学','英语','物理','语文','数学','英语','物理','语文','数学','英语','物理'],
['数学','语文','物理','物理','语文','语文','语文','英语','数学','语文','语文','体育'],
['语文','数学','英语','物理','语文','数学','英语','物理','语文','数学','英语','物理']
];
// 对于 vue、react，可以在能够获取到真实dom节点的生命周期中进行实例化
const timetable = new Timetables({
el: '#coursesTable',
timetables: courseList,
week: ['一', '二', '三', '四', '五'],
timetableType: [
['上午', 4],
['下午', 4],
['晚上', 4]
],
});参数及方法
| 参数or方法 | 类型 | 说明 |
|---|---|---|
| el | String(必传) | 绑定dom节点的id('#id') |
| timetables | Array(必传) | 日程表内容，格式为二维数组 |
| week | Array(必传) | 日程表头部周，格式为二维数组 |
| timetableType | Array(必传) | 日程表左侧分类，格式为二维数组 |
| highlightWeek | Number | 传入表头当天的索引，为日程表头部区域高亮周增加一个class(可自定义样式) |
| styles | Object | 日程表内容样式，具体使用见下文 |
| merge | Boolean | 是否合并一天内临近的相同日程(默认为true) |
| gridOnClick | Function | 单元格点击触发事件，方法参数中可获取到该格的信息 |
| setOption | Function | 实例化上的方法，重新设置参数渲染表格，参数同上(没有el参数) |
参数示例
const timetables = [
['大学英语(Ⅳ)@10203','大学英语(Ⅳ)@10203','','','','','毛概@14208','毛概@14208','','','','选修'],
['','','信号与系统@11302','信号与系统@11302','模拟电子技术基础@16204','模拟电子技术基础@16204','','','','','',''],
['大学体育(Ⅳ)','大学体育(Ⅳ)','形势与政策(Ⅳ)@15208','形势与政策(Ⅳ)@15208','','','电路、信号与系统实验','电路、信号与系统实验','','','',''],
['','','','','电装实习@11301','电装实习@11301','','','','大学体育','大学体育',''],
['','','数据结构与算法分析','数据结构与算法分析','','','','','信号与系统','信号与系统','',''],
];
const timetableType = [
[{index: '1',name: '8:30'}, 1],
[{index: '2',name: '9:30'}, 1],
[{index: '3',name: '10:30'}, 1],
[{index: '4',name: '11:30'}, 1],
[{index: '5',name: '12:30'}, 1],
[{index: '6',name: '14:30'}, 1],
[{index: '7',name: '15:30'}, 1],
[{index: '8',name: '16:30'}, 1],
[{index: '9',name: '17:30'}, 1],
[{index: '10',name: '18:30'}, 1],
[{index: '11',name: '19:30'}, 1],
[{index: '12',name: '20:30'}, 1]
];
const week = ['周一', '周二', '周三', '周四', '周五'];
const highlightWeek = new Date().getDay();
const styles = {
Gheight: 50,
leftHandWidth: 50,
palette: ['#ff6633', '#eeeeee']
};
// 实例化(初始化课表)
const timetable = new Timetables({
el: '#coursesTable',
timetables: timetables,
week: week,
timetableType: timetableType,
highlightWeek: highlightWeek,
gridOnClick: function (e) {
alert(e.name + ' ' + e.week +', 第' + e.index + '节课, 课长' + e.length +'节')
console.log(e)
},
styles: styles
});
//重新设置参数 渲染
function onChange() {
Timetable.setOption({
timetables: courseListOther,
week: ['一', '二', '三', '四', '五', '六', '日'],
styles:{
palette: ['#dedcda', '#ff4081']
},
timetableType:courseType,
gridOnClick: function (e) {
console.log(e)
}})
};timetables参数为表格内容项，格式为二维数组，数组第二维中每项长度需要和timetableType中每一项的长度的累计总和一致，长度不足时会自动以空字符串追加补全。
同一天内临近的日程相同时会自动合并为一格展示(设置merge参数为false时不自动合并)。timetableType参数可以将表格内容分类，数组内的每一项为该行标签，用于分隔行。
每项中第一项可以是字符串或者一个对象，当为对象时会自动生成多项dom节点。
第二项为要分类的长度，所有长度累计总和应该与timetables参数中每一项的保持长度一致。week参数为表格列名,将内容依次分隔为相应列数highlightWeek参数为数字索引(从1开始),索引对应你上面week参数里的项,传入索引后会在表格头对应节点加上一个classstyles参数为表格表格样式:
Gheight 为表格内每一个单元格高度(number)单位为'px'
leftHandWidth 为表格左侧日程分类样式宽带度(number)单位为'px'
palette 为合并相同课程单元格后颜色调色盘,默认有15种颜色,可以传入颜色数组自定义(传入的颜色会与默认颜色合并,并优先使用自定义颜色)，设为false时不为课程单元格生成色盘颜色setOption在实例化对象上可以使用setOption方法重新渲染表格。参数使用同上,不需要再传入el参数绑定dom,默认使用实例化时候的dom节点- 日程表没有过多进行样式装饰,可以根据已有的css类自行美化。例如：有课程内容的节点会绑定名为course-hasContent的class，课程行单元会根据timetableType的分类对应生成stage_number的class，可以审查元素找到对应的自行修改样式。