2.1.2 • Published 3 years ago

react-countdown-clock-timer v2.1.2

Weekly downloads
13
License
ISC
Repository
github
Last release
3 years ago

react-countdown-clock-timer

react-countdown-clock-timer provides a timer functionality using reactJS.

Table of Contents

Installation

To install, you can use npm or yarn:

$ npm install react-countdown-clock-timer

OR

$ yarn add react-countdown-clock-timer

Examples

Here is a simple example of react-countdown-clock-timer being used in an app. You can also get remaining duration with onPause, onResume and onReset callbacks.

import React from 'react';
import ReactDOM from 'react-dom';
import { Timer } from 'react-countdown-clock-timer';

const App = () => {
  return (
    <div className='timer-container'>
      <Timer
      durationInSeconds={120}
      formatted={true}
      isPaused={false}
      showPauseButton={true}
      showResetButton={true}
      
      onStart = {()=> {
        console.log('Triggered when the timer starts')
      }}
      onPause = {(remainingDuration)=> {
        console.log('Triggered when the timer is paused', remainingDuration)
      }}
      onFinish = {()=> {
        console.log('Triggered when the timer finishes')
      }}
      onReset = {(remainingDuration)=> {
        console.log('Triggered when the timer is reset', remainingDuration)
      }}
      onResume = {(remainingDuration)=> {
        console.log('Triggered when the timer is resumed', remainingDuration)
      }}
      />
    </div>
  )
}
ReactDOM.render(<App />, document.getElementById('root'))

Parameters

NameDescriptionTypeDefault Value
durationInSecondsDuration for which the timer runsint0
formattedRenders the timer in a formatted way (Formatted: 51m 22s, Unformatted: 00:51:22)boolfalse
timerIdTimer resets when timerId changesanyundefined
isPausedThe parent component can pause/resume the timer using this propboolfalse
showPauseButtonShows a button to pause/resume the timer if set to trueboolfalse
showResetButtonShows a button to reset the timer if set to trueboolfalse
onStartA callback function to run when the timer starts()=>voidundefined
onFinishA callback function to run when timer finishes()=>voidundefined
onPauseA callback function to run when timer is paused()=>voidundefined
onResumeA callback function to run when timer is resumed()=>voidundefined
onResetA callback function to run when the timer is reset()=>voidundefined

Styling

We've provided class names for the following elements which can be used to add styling to them.

  • div wrapping the Timer - timer-wrapper
  • div wrapping the Pause and Reset buttons - buttons-wrapper
  • Pause button - pause-button
  • Reset button - reset-button