1.0.3 • Published 6 years ago

react-fancy-countdown v1.0.3

Weekly downloads
8
License
MIT
Repository
github
Last release
6 years ago

React-Fancy-Countdown

A fancy countdown component for React.

Demo

Live demo: https://abnerlin.github.io/React-Fancy-Countdown/

Installation

npm install --save react-fancy-countdown

Usage

Basic Countdown

This is basic usage, the more advanced usage please check Demo.

import { BasicCountdown } from 'react-fancy-countdown';
 
class App extends React.Component {
  ...
  render() {
    <BasicCountdown
      deadline="2030-12-31 14:23:22"
      format="Y[y] M[m] W[w] D[d] HH[hrs] mm[mins] ss[secs]" />
  }
}

Basic Countdown Props

ParameterTypeDescription
idStringDOM Id.
classNameStringDOM class.
deadlineStringDeadline, format must be "YYYY-MM-DD HH:mm:ss".Recommend to store deadline in State, once deadline updated in State, the countdown will reset.
intervalNumberThe interval(ms) for updating component.Deafult is 1000ms.
formatStringyears : Y or y months : M or MM weeks : W or WW days : D or DD hours : H or HH minutes: mm seconds: ss Escape token characters within the template string using square brackets. Example => Yy Mm Ww Dd HHhrs mmmins sssecs
callbackFunctionThe function will invoked when the time is up. Default is console.log('Time is up.');
dueElementElementThe Element will show up to replace the countdown component when the time is up. Default is <div> Time is up. </div>

Flip Countdown

This is basic usage, the more advanced usage please check Demo.

import { FlipCountdown } from 'react-fancy-countdown';
import 'react-fancy-countdown/dist/countdown.css';
 
class App extends React.Component {
  ...
  render() {
    <FlipCountdown
      deadline="2030-12-31 14:23:22" />
  }
}

Flip Countdown Props

ParameterTypeDescription
idStringDOM Id.
classNameStringDOM class.
weeksBooleanWhether to show the unit "weeks". If "days" set to false, "weeks" will always be false. If "weeks" is false, please make sure the deadline won't over than 99 days!
daysBooleanWhether to show the unit "days". If "days" is false, plsease make sure the deadline won't over than 99 hours!
deadlineStringDeadline, format must be "YYYY-MM-DD HH:mm:ss".Recommend to store deadline in State, once deadline updated in State, the countdown will reset.
intervalNumberThe interval(ms) for updating component.Deafult is 1000ms.
callbackFunctionThe function will invoked when the time is up. Default is console.log('Time is up.');
dueElementElementThe Element will show up to replace the countdown component when the time is up. Default is <div> Time is up. </div>

Slide Countdown

This is basic usage, the more advanced usage please check Demo.

import { SlideCountdown } from 'react-fancy-countdown';
import 'react-fancy-countdown/dist/countdown.css';

class App extends React.Component {
  ...
  render() {
    <SlideCountdown
      deadline="2030-12-31 14:23:22" />
  }
}

Slide Countdown Props

ParameterTypeDescription
idStringDOM Id.
classNameStringDOM class.
weeksBooleanWhether to show the unit "weeks". If "days" set to false, "weeks" will always be false. If "weeks" is false, please make sure the deadline won't over than 99 days!
daysBooleanWhether to show the unit "days". If "days" is false, plsease make sure the deadline won't over than 99 hours!
deadlineStringDeadline, format must be "YYYY-MM-DD HH:mm:ss".Recommend to store deadline in State, once deadline updated in State, the countdown will reset.
intervalNumberThe interval(ms) for updating component.Deafult is 1000ms.
callbackFunctionThe function will invoked when the time is up. Default is console.log('Time is up.');
dueElementElementThe Element will show up to replace the countdown component when the time is up. Default is <div> Time is up. </div>