Installations

npm install rc-calendar

Pull Requests

Open

48

Total

608

Closed

360

Merged

200

Issues

Open

94

Total

298

Closed

204

Releases

Unable to fetch releases

Developer

react-component

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

Typescript Support

Yes

Node Version

10.16.0

NPM Version

6.13.1 Statistics

1,701 Stars

745 Commits

494 Forks

52 Watching

17 Branches

125 Contributors

Updated on 07 Nov 2024

Languages

JavaScript (90.86%)

Less (8.97%)

TypeScript (0.16%)

Total Downloads

Cumulative downloads

Total Downloads

60,833,836

Last day

-5.6%

23,437

Compared to previous day

Last week

-1.5%

133,650

Compared to previous week

Last month

2.3%

574,372

Compared to previous month

Last year

-11.5%

6,308,473

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

7

babel-runtime classnames moment prop-types rc-trigger rc-util react-lifecycles-compat

Dev Dependencies

18

@types/react async dtslint enzyme enzyme-adapter-react-16 enzyme-to-json jest mockdate pre-commit rc-dialog rc-select rc-time-picker rc-tools react react-dom react-test-renderer tslint typescript

Versions

rc-calendar

React Calendar

Screenshots

Feature

support ie9,ie9+,chrome,firefox,safari
support date, month, year, decade select panel
support week number
support en_US and zh_CN locale(UI), use moment.utcOffset to set timezone
support aria and keyboard accessibility

Keyboard

Previous month (PageUp)
Next month (PageDown)
tab into hour input: Last hour(Up), Next hour(Down)
tab into hour input: Last minute(Up), Next minute(Down)
tab into hour input: Last second(Up), Next second(Down)
Last year (Control + left)
Next year (Control + right)

install

Usage

1import Calendar from 'rc-calendar';
2import React from 'react';
3import ReactDOM from 'react-dom';
4ReactDOM.render(<Calendar />, container);

Development

npm install
npm start

Example

http://localhost:8002/examples/

online example:

http://react-component.github.io/calendar/examples/index.html

API

rc-calendar props

name	type	default	description
prefixCls	String		prefixCls of this component
className	String		additional css class of root dom node
style	Object		additional style of root dom node
dateRender	(current, value) => React.Node		date cell
renderSidebar	() => React.Node		side bar
renderFooter	(mode) => React.Node		extra footer
value	moment		current value like input's value
defaultValue	moment		defaultValue like input's defaultValue
locale	Object	import from 'rc-calendar/lib/locale/en_US'	calendar locale
format	String \| String[]	depends on whether you set timePicker and your locale	use to format/parse date(without time) value to/from input. When an array is provided, all values are used for parsing and first value for display.
disabledDate	Function(current:moment):Boolean		whether to disable select of current date
disabledTime	Function(current:moment):Object		a function which return a object with member of disabledHours/disabledMinutes/disabledSeconds according to rc-time-picker
showDateInput	Boolean	true	whether to show input on top of calendar panel
showWeekNumber	Boolean	false	whether to show week number of year
showToday	Boolean	true	whether to show today button
showOk	Boolean	auto	whether has ok button in footer
timePicker	React Element		rc-timer-picker/lib/module/panel element
onSelect	Function(date: moment)		called when a date is selected from calendar
onClear	Function()		called when a date is cleared from calendar
onChange	Function(date: moment)		called when a date is changed inside calendar (next year/next month/keyboard)
onOk	Function(date: moment)		called when ok button is pressed, only if it's visible
dateInputPlaceholder	String		date input's placeholder
mode	enum('time', 'date', 'month', 'year', 'decade')	'date'	control which kind of panel should be shown
onPanelChange	Function(date: moment, mode)		called when panel changed
clearIcon	ReactNode		specific the clear icon.
inputMode	string	text	Change the keyboard in mobile device

rc-calendar/lib/RangeCalendar props

name	type	default	description
prefixCls	String		prefixCls of this component
className	String		additional css class of root dom node
style	Object		additional style of root dom node
renderSidebar	() => React.Node		side bar
renderFooter	() => React.Node		extra footer
selectedValue	moment[]		current selected value range. with two elements.
defaultSelectedValue	moment[]		default selected value range
locale	Object	import from 'rc-calendar/lib/locale/en_US'	calendar locale
format	String	depends on whether you set timePicker and your locale	use to format/parse date(without time) value to/from input
disabledDate	Function(current:moment):Boolean		whether to disable select of current date
showWeekNumber	Boolean	false	whether to show week number of year
showToday	Boolean	true	whether to show today button
showOk	Boolean	auto	whether has ok button in footer
showClear	Boolean	false	whether has clear button in header
timePicker	React Element		rc-timer-picker/lib/module/panel element
onSelect	Function(date: moment[])		called when a date range is selected from calendar
onInputSelect	Function(date: moment[])		called when a valid date entered in input
onClear	Function()		called when a date range is cleared from calendar
onChange	Function(date: moment[])		called when a date range is changed inside calendar (next year/next month/keyboard)
onOk	Function(date: moment)		called when ok button is pressed, only if it's visible
dateInputPlaceholder	String[]		range date input's placeholders
disabledTime	Function(current: moment[], type:'start'\|'end'):Object		a function which return a object with member of disabledHours/disabledMinutes/disabledSeconds according to rc-time-picker
showDateInput	Boolean	true	whether to show date inputs on top of calendar panels
type	enum('both','start', 'end')	both	whether fix start or end selected value. check start-end-range example
mode	enum('date', 'month', 'year', 'decade')[]	['date', 'date']	control which kind of panels should be shown
onPanelChange	Function(date: moment[], mode)		called when panels changed
hoverValue	moment[]		control hover value
onHoverChange	Function(hoverValue: moment[])		called when hover value change
clearIcon	ReactNode		specific the clear icon.

rc-calendar/lib/MonthCalendar props

name	type	default	description
prefixCls	String		prefixCls of this component
className	String		additional css class of root dom node
style	Object		additional style of root dom node
value	moment		current value like input's value
defaultValue	moment		defaultValue like input's defaultValue
locale	Object	import from 'rc-calendar/lib/locale/en_US'	calendar locale
disabledDate	Function(current:moment):Boolean		whether to disable select of current month
onSelect	Function(date: moment)		called when a date is selected from calendar
monthCellRender	function		Custom month cell render method
monthCellContentRender	function		Custom month cell content render method,the content will be appended to the cell.
onChange	Function(date: moment)		called when a date is changed inside calendar (next year/next month/keyboard)
renderFooter	() => React.Node		extra footer

rc-calendar/lib/Picker props

name	type	default	description
prefixCls	String		prefixCls of this component
calendar	Calendar React Element
disabled	Boolean		whether picker is disabled
placement	String\|Object		one of ['left','right','top','bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight']
align	Object: alignConfig of [dom-align](https://github.com/yiminghe/dom-align)		value will be merged into placement's align config.
animation	String		index.css support 'slide-up'
transitionName	String		css class for animation
value	moment\|moment[]		current value like input's value
defaultValue	moment\|moment[]		defaultValue like input's defaultValue
onChange	Function		called when select a different value
onOpenChange	(open:boolean) => void		called when open/close picker
open	Boolean		current open state of picker. controlled prop
getCalendarContainer	() => HTMLElement	() => {return document.body;}	dom node where calendar to be rendered into
dropdownClassName	string		additional className applied to dropdown

rc-calendar/lib/FullCalendar props

name	type	default	description
prefixCls	String		prefixCls of this component
Select	React Component Class		rc-select Component Class
value	moment		current value like input's value
defaultValue	moment		defaultValue like input's defaultValue
defaultType	string	date	default panel type: date/month
type	string		panel type: date/month
onTypeChange	function(type)		called when panel type change
fullscreen	bool	false
monthCellRender	function		Custom month cell render method
dateCellRender	function		Custom date cell render method
monthCellContentRender	function		Custom month cell content render method,the content will be appended to the cell.
dateCellContentRender	function		Custom date cell content render method,the content will be appended to the cell.
onSelect	Function(date: moment)		called when a date is selected from calendar

Test Case

npm test

Coverage

npm run coverage

open coverage/ dir

License

rc-calendar is released under the MIT license.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

Score

3.7

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More