Add the render props to customize appearance

Author: arqex

DateTime.js

@@ -139,7 +139,7 @@ var Datetime = React.createClass({
 		;
 		return function( e ){
 			me.setState({
-				viewDate: me.state.viewDate.clone()[ type ]( e.target.innerHTML ).startOf( type ),
+				viewDate: me.state.viewDate.clone()[ type ]( parseInt(e.target.dataset.value) ).startOf( type ),
 				currentView: nextViews[ type ]
 			});
 		};
@@ -206,7 +206,7 @@ var Datetime = React.createClass({
 
 		date = this.state.viewDate.clone()
 			.month( this.state.viewDate.month() + modifier )
-			.date( parseInt( target.innerHTML ) )
+			.date( parseInt( target.dataset.value ) )
 			.hours( currentDate.hours() )
 			.minutes( currentDate.minutes() )
 			.seconds( currentDate.seconds() )
@@ -237,7 +237,7 @@ var Datetime = React.createClass({
 	},
 
 	componentProps: {
-		fromProps: ['viewMode', 'minDate', 'maxDate'],
+		fromProps: ['viewMode', 'minDate', 'maxDate', 'renderDay', 'renderMonth', 'renderYear'],
 		fromState: ['viewDate', 'selectedDate' ],
 		fromThis: ['setDate', 'setTime', 'showView', 'addTime', 'subtractTime', 'updateDate', 'localMoment']
 	},

README.md

@@ -2,6 +2,8 @@ react-datetime
 ===============================
 A date and time picker in the same React.js component. It can be used as a datepicker, timepicker or both at the same time.
 
+It allows to edit even date's milliseconds.
+
 This project started as a fork of https://github.com/quri/react-bootstrap-datetimepicker but the code and the API has changed a lot.
 
 Usage
@@ -30,15 +32,18 @@ API
 | Name         | Type    | Default | Description |
 | ------------ | ------- | ------- | ----------- |
 | **date** | Date  | new Date() | Represents the inital dateTime, this string is then parsed by moment.js |
-| **dateFormat**   | string  | "MM/DD/YY"     | Defines the format moment.js should use to parse and output the date. The default is only set if there is not `timeFormat` defined. |
-| **timeFormat**   | string  | "MM/DD/YY"     | Defines the format moment.js should use to parse and output the time. The default is only set if there is not `dateFormat` defined. |
+| **dateFormat**   | string  | Locale default | Defines the format moment.js should use to parse and output the date. The default is only set if there is not `timeFormat` defined. |
+| **timeFormat**   | string  | Locale default | Defines the format moment.js should use to parse and output the time. The default is only set if there is not `dateFormat` defined. |
 | **input** | boolean | true | Wether to show an input field to edit the date manually. |
 | **locale** | string | null | Manually set the locale for the react-datetime instance. Moment.js locale needs to be loaded to be used, see [i18n docs](#i18n).
 | **onChange** | function | x => console.log(x) | Callback trigger when the date changes |
 | **viewMode** | string or number | 'days' | The default view to display when the picker is shown. ('years', 'months', 'days', 'time') |
 | **inputProps** | object | undefined | Defines additional attributes for the input element of the component. |
 | **minDate** | moment | undefined | The earliest date allowed for entry in the calendar view. |
 | **maxDate** | moment | undefined | The latest date allowed for entry in the calendar view. |
+| **renderDay** | function | DOM.td( day ) | Customize the way that the days are shown in the day picker. The accepted function has the `selectedDate`, the current date and the default calculated `props` for the cell, and must return a React component. See [appearance customization](#appearance_customization) |
+| **renderMonth** | function | DOM.td( month ) | Customize the way that the months are shown in the month picker. The accepted function has the `selectedDate`, the current date and the default calculated `props` for the cell, and must return a React component. See [appearance customization](#appearance_customization) |
+| **renderYear** | function | DOM.td( year ) | Customize the way that the years are shown in the year picker. The accepted function has the `selectedDate`, the current date and the default calculated `props` for the cell, and must return a React component. See [appearance customization](#appearance_customization) |
 
 ## i18n
 Different language and date formats are supported by react-datetime. React uses [moment.js](http://momentjs.com/) to format the dates, and the easiest way of changing the language of the calendar is [changing the moment.js locale](http://momentjs.com/docs/#/i18n/changing-locale/).
@@ -56,6 +61,34 @@ If there are multiple locales loaded, you can use the prop `locale` to define wh
 ```
 [Here you can see the i18n example working](http://codepen.io/arqex/pen/PqJMQV).
 
+## Appearance customization
+It is possible to customize the way that the datetime picker display the days, months and years in the calendar. To adapt the calendar to every need it is possible to use the props `renderDay( props, currentDate, selectedDate )`, `renderMonth( props, month, year, selectedDate )` and `renderYear( props, year, selectedDate )` of react-datetime.
+
+```js
+var MyDTPicker = React.createClass({
+    render: function(){
+        return <Datetime
+            renderDay={ this.renderDay } 
+            renderMonth={ this.renderMonth } 
+            renderYear={ this.renderYear }
+        />;
+    },
+    renderDay: function( selectedDate, currentDate, props ){
+        return <td {...props}>{ currentDate.date() }</td>;
+    },
+    renderMonth: function( selectedDate, currentMonthDate, props ){
+        return <td {...props}>{ month }</td>;
+    },
+    renderDay: function( selectedDate, year, props ){
+        return <td {...props}>{ currentDate.date() }</td>;
+    }
+});
+```
+
+* `props` is the object that react-date picker has calculated for this object. It is convenient to use this object as the props for your custom component, since it knows how to handle the click event and its `className` attribute is used by the default styles.
+* `selectedDate` and `currentDate` are Moment.js objects and can be used to change the output depending on the selected date, or the date for the current day.
+* `month` and `year` are the numeric representation of the current month and year to be displayed. Notice that the possible `month` values go from `0` to `11`.
+
 Contributions
 ===============================
 Any help is always welcome :)

dist/react-datetime.js

@@ -1,6 +1,6 @@
 {
   "name": "react-datetime",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "A lightweight but complete datetime picker React.js component.",
   "homepage": "https://github.com/arqex/react-datetime",
   "repository": {

dist/react-datetime.min.js

@@ -53,7 +53,7 @@ var DateTimePickerDays = React.createClass({
 
 	renderDays: function() {
 		var date = this.props.viewDate,
-			selected = this.props.selectedDate,
+			selected = this.props.selectedDate.clone(),
 			prevMonth = date.clone().subtract( 1, 'months' ),
 			currentYear = date.year(),
 			currentMonth = date.month(),
@@ -62,6 +62,7 @@ var DateTimePickerDays = React.createClass({
 			maxDate = this.props.maxDate,
 			weeks = [],
 			days = [],
+			renderer = this.props.renderDay || this.renderDay,
 			classes, disabled, dayProps
 		;
 
@@ -87,11 +88,16 @@ var DateTimePickerDays = React.createClass({
 			if( disabled )
 				classes += ' disabled';
 
-			dayProps = { key: prevMonth.format('M_D'), className: classes };
+			dayProps = {
+				key: prevMonth.format('M_D'),
+				'data-value': prevMonth.date(),
+				className: classes
+			};
 			if( !disabled )
 				dayProps.onClick = this.props.updateDate;
 
-			days.push( DOM.td( dayProps, prevMonth.date() ));
+			days.push( renderer( dayProps, prevMonth.clone(), selected ) );
+
 			if( days.length == 7 ){
 				weeks.push( DOM.tr( {key: prevMonth.format('M_D')}, days ) );
 				days = [];
@@ -103,6 +109,10 @@ var DateTimePickerDays = React.createClass({
 		return weeks;
 	},
 
+	renderDay: function( props, currentDate, selectedDate ){
+		return DOM.td( props, currentDate.date() );
+	},
+
 	renderFooter: function(){
 		if( !this.props.timeFormat )
 			return '';

package.json

@@ -6,22 +6,42 @@ moment = require('moment')
 
 var DOM = React.DOM;
 var DateTimePickerMonths = React.createClass({
+	render: function() {
+		return DOM.div({ className: 'rdtMonths' },[
+			DOM.table({ key: 'a'}, DOM.thead({}, DOM.tr({},[
+				DOM.th({ key: 'prev', className: 'prev' }, DOM.button({onClick: this.props.subtractTime(1, 'years')}, '‹')),
+				DOM.th({ key: 'year', className: 'switch', onClick: this.props.showView('years'), colSpan: 2 }, this.props.viewDate.year() ),
+				DOM.th({ key: 'next', className: 'next' }, DOM.button({onClick: this.props.addTime(1, 'years')}, '›'))
+			]))),
+			DOM.table({ key: 'months'}, DOM.tbody({ key: 'b'}, this.renderMonths()))
+		]);
+	},
+
 	renderMonths: function() {
 		var date = this.props.selectedDate,
 			month = date.month(),
-			monthsShort = date.localeData()._monthsShort,
+			year = this.props.viewDate.year(),
 			rows = [],
 			i = 0,
 			months = [],
-			classes
+			renderer = this.props.renderMonth || this.renderMonth,
+			classes, props
 		;
 
 		while (i < 12) {
 			classes = "month";
-			if( i === month && this.props.viewDate.year() === date.year() )
+			if( i === month && year === date.year() )
 				classes += " active";
 
-			months.push( DOM.td( {key: i, className: classes, onClick: this.props.setDate('month') }, monthsShort[ i ] ));
+			props = {
+				key: i,
+				'data-value': i,
+				className: classes,
+				onClick: this.props.setDate('month')
+			};
+
+			months.push( renderer( props, i, year, date.clone() ));
+
 			if( months.length == 4 ){
 				rows.push( DOM.tr({ key: month + '_' + rows.length }, months) );
 				months = [];
@@ -33,15 +53,8 @@ var DateTimePickerMonths = React.createClass({
 		return rows;
 	},
 
-	render: function() {
-		return DOM.div({ className: 'rdtMonths' },[
-			DOM.table({ key: 'a'}, DOM.thead({}, DOM.tr({},[
-				DOM.th({ key: 'prev', className: 'prev' }, DOM.button({onClick: this.props.subtractTime(1, 'years')}, '‹')),
-				DOM.th({ key: 'year', className: 'switch', onClick: this.props.showView('years'), colSpan: 2 }, this.props.viewDate.year() ),
-				DOM.th({ key: 'next', className: 'next' }, DOM.button({onClick: this.props.addTime(1, 'years')}, '›'))
-			]))),
-			DOM.table({ key: 'months'}, DOM.tbody({ key: 'b'}, this.renderMonths()))
-		]);
+	renderMonth: function( props, month, year, selectedDate ) {
+		return DOM.td( props, selectedDate.localeData()._monthsShort[ month ] );
 	}
 });
 

src/DaysView.js

@@ -4,11 +4,25 @@ var React = require('react');
 
 var DOM = React.DOM;
 var DateTimePickerYears = React.createClass({
+	render: function() {
+		var year = parseInt(this.props.viewDate.year() / 10, 10) * 10;
+
+		return DOM.div({ className: 'rdtYears' },[
+			DOM.table({ key: 'a'}, DOM.thead({}, DOM.tr({},[
+				DOM.th({ key: 'prev', className: 'prev' }, DOM.button({onClick: this.props.subtractTime(10, 'years')}, '‹')),
+				DOM.th({ key: 'year', className: 'switch', onClick: this.props.showView('years'), colSpan: 2 }, year + '-' + (year + 9) ),
+				DOM.th({ key: 'next', className: 'next'}, DOM.button({onClick: this.props.addTime(10, 'years')}, '›'))
+				]))),
+			DOM.table({ key: 'years'}, DOM.tbody({}, this.renderYears( year )))
+		]);
+	},
+
 	renderYears: function( year ) {
 		var years = [],
 			i = -1,
 			rows = [],
-			classes
+			renderer = this.props.renderYear || this.renderYear,
+			classes, props
 		;
 
 		year--;
@@ -19,8 +33,15 @@ var DateTimePickerYears = React.createClass({
 			if( this.props.selectedDate.year() === year )
 				classes += ' active';
 
-			years.push( DOM.td({ key: year, className: classes, onClick: this.props.setDate('year') }, year ));
-			// years.push(<td key={year} className={ classes } onClick={this.props.setDate('year')}>{year}</td>);
+			props = {
+				key: year,
+				'data-value': year,
+				className: classes,
+				onClick: this.props.setDate('year')
+			};
+
+			years.push( renderer( props, year, this.props.selectedDate.clone() ));
+
 			if( years.length == 4 ){
 				rows.push( DOM.tr({ key: i }, years ) );
 				years = [];
@@ -29,19 +50,12 @@ var DateTimePickerYears = React.createClass({
 			year++;
 			i++;
 		}
+
 		return rows;
 	},
-	render: function() {
-		var year = parseInt(this.props.viewDate.year() / 10, 10) * 10;
 
-		return DOM.div({ className: 'rdtYears' },[
-			DOM.table({ key: 'a'}, DOM.thead({}, DOM.tr({},[
-				DOM.th({ key: 'prev', className: 'prev' }, DOM.button({onClick: this.props.subtractTime(10, 'years')}, '‹')),
-				DOM.th({ key: 'year', className: 'switch', onClick: this.props.showView('years'), colSpan: 2 }, year + '-' + (year + 9) ),
-				DOM.th({ key: 'next', className: 'next'}, DOM.button({onClick: this.props.addTime(10, 'years')}, '›'))
-				]))),
-			DOM.table({ key: 'years'}, DOM.tbody({}, this.renderYears( year )))
-		]);
+	renderYear: function( props, year, selectedDate ){
+		return DOM.td( props, year );
 	}
 });