calendar-month-view v1.0.1

calendar-month-view

Creates an html structure to display a calendar month.

example

var calendar = require('calendar-month-view')
var cal = calendar(new Date(2017,6))
document.body.appendChild(cal)

This produce an html table element:

<table class="calendar-block">
  <tr>
    <th><span>Sun</span></th>
    <th><span>Mon</span>
    ...

  </tr>
  <tr>
    <td class="calendar-inactive"><span>25</span></td>
    <td class="calendar-inactive"><span>26</span></td>
    ...

  </tr>
  <tr>
    <td><span>2</span></td>
    <td><span>3</span></td>
    ...

  </tr>
  ...

</table>

try it

Run

npm run example

to start a demo page on port 9966.

Or check the demo page

customization

custom day classnames

To add some styling to specific days, there is a selected option, a map of calendar dates to classnames.

var cal = calendar(new Date(2017,6), {
  selected: {
    '-1': 'shore-shopping', // previous and next month are offset
    0: 'activity-code ', // last day of previous month
    1: 'rest', // first day of current month
    2: ['activity-sport', 'shore-cleaning'], //array is ok...
    3: 'work activity-photgraphy' // ... or space separated words is similar
  }
})

Result:

    ...
    
    <td class="calendar-inactive"><span>28</span></td>
    <td class="calendar-inactive shore-shopping"><span>29</span></td>
    <td class="calendar-inactive activity-code "><span>30</span></td>
    <td class="rest"><span>1</span></td>
  </tr>
  <tr>
    <td class="activity-sport shore-cleaning"><span>2</span></td>
    <td class="work activity-photgraphy"><span>3</span></td>
    ...

Check the examples in selection or marks.

rewriting content

The header cells and day cells content are customizable. Specify those options to get what you want inside the table th or td:

var cal = calendar(new Date(2017,6), {
  headerContent: (date) => date.toString().slice(0, 1),
  dateContent: (date) => {
    var el = document.createElement('div')
    el.innerText = date.getDate()
    return el
  },
  siblingMonthDateContent: () => ''
})

Result:

<table class="calendar-block">
  <tr>
    <th>S</th>
    <th>M</th>
    ...

  </tr>
  <tr>
    <td class="calendar-inactive"></td>
    <td class="calendar-inactive"></td>
    ...

    <td><div>1</div></td>
  </tr>
  <tr>
    <td><div>2</div></td>
    ...

advanced customization

For extreme case where full calendar customization is needed, there is the template options. they are function that takes the content as input and let you override the container. You could either return an html element or a function taking the same params as the content options in case date info are required. Check the template.js file to see the defaults. Keep in mind that for intensive customization, working directly with calendar-month-array could be more efficient.

Example:

var cal = calendar(new Date(2017,6), {
  headerTemplate: content => html`<div class="header">${content}</div>`,
  dateTemplate: content => (date, info) => html`<div class=${info.siblingMonth ? 'inactive' : 'current' }>${content}</div>`,
  containerTemplate: month => html`<div class="calendar-flex">
    ${month.reduce((acc, n) => acc.concat(n))}
  </div>`
})

Result:

<div class="calendar-flex">
	<div class="header"><span>Sun</span></div>
	<div class="header"><span>Mon</span></div>
	<div class="header"><span>Tue</span></div>
	<div class="header"><span>Wed</span></div>
	<div class="header"><span>Thu</span></div>
	<div class="header"><span>Fri</span></div>
	<div class="header"><span>Sat</span></div>
	<div class="inactive"><span>25</span></div>
	<div class="inactive"><span>26</span></div>
	<div class="inactive"><span>27</span></div>
	<div class="inactive"><span>28</span></div>
	<div class="inactive"><span>29</span></div>
	<div class="inactive"><span>30</span></div>
	<div class="current"><span>1</span></div>
	<div class="current"><span>2</span></div>
	...

</div>

Complete example here.

styling

No default styles are provided, check the example dir for more styling.

Here is a minimal style:

table.calendar-block {
  border-collapse: collapse;
  border-spacing: 0;
  border: 1px solid rgba(0,0,0,.05);
}

.calendar-block td,
.calendar-block th {
  font-size: 1em;
  line-height: 1.8em;
  height: 2.2em; 
  min-width: 1em;
  text-align:center;
  border: 1px solid rgba(0,0,0,.05);
}

.calendar-inactive { 
	color: rgba(0,0,0,.2); 
}

i18n

Internationalization is let to you, so you can use any i18n libray or just do it yourself. Usual way would be to specify headerContent in options:

var calendar = require('calendar-month-view')
var html = require('bel')
var daysOfWeekFr = ['dim', 'lun', 'mar', 'mer', 'jeu', 'ven', 'sam'] // should be aligned to weekStartDay!
var cal = calendar(new Date(2017, 0), {
  headerContent: (date, position) => html`<span>${daysOfWeekFr(position)}</span>`
})

For a complete example, check this file using d3-time-format module.

api

var calendar = require('calendar-month-view')

var cal = calendar(date, opts)

Return a html table element for the month given in date, a Date instance.

• opts.weekStartDay - set the first day of week, default 0 (Sunday). Monday would be 1.
• opts.noHeader - do not display days name header.
• opts.selected - specify how to format some cells, key is dayOfMonth, value is a string or array of classes to add for this day.
• opts.classPrefix - prefix the classnames used in the project, default is calendar-.
• opts.headerContent(date, info) - custom header cell content, check calendar-month-array API for details.
• opts.dateContent(date, info) - custom date cell content.
• opts.siblingMonthDateContent(date, info) - specific content when other month dates are displayed, defaults to opts.dateContent.
• opts.headerTemplate(content, options) =>: Customize headers, content is header content specified in opts.headerContent, options provide a way to access opts object. A All template options return either an Element or (date, info) => Element function.
• opts.dateTemplate(content, options) - same principle as opts.headerTemplate, but for dates.
• opts.siblingMonthateTemplate(content, options) - customize other month dates container, defaults to opts.dateTemplate.
• opts.containerTemplate(month, options): customize the calendar container. month is an array with headers and week rows, which are themselves an array of each day elements.

compatibility

Using yo-yoify with browserify, this module should work fine on pretty old browsers.

Examples and tests are written for more recent es6 browsers.

license

MIT

install

npm install calendar-month-view