/react-activity-heading

Reflect activity state in your headings.

Primary LanguageCoffeeScript

react-activity-heading

react-activity-heading lets you push activity state to a heading area, temporarily replacing the text with a status message.

You also have the ability to update the status message just before it animates out. This is useful for displaying success/error messages.

Under the hood it throttles the rate at which new status props are accepted so that quick changes have a chance to display and the animations always look good.

activity-heading-gif

Installation

npm install react-activity-heading --save

This package depends on velocity-react for animation and lodash for some utility functions.

Usage

Example usage of <ActivityHeading />:

<ActivityHeading 
  title="My Heading"
  showActivityStatus={this.state.is_saving}
  activityStatus="Saving..."
  showCompleteStatus={this.state.save_success}
  completeStatus="Saved"
/>

Props

title str

Text to display when there is no activity status.

showActivityStatus bool

Set true to animate status text in.

activityStatus str

Text that will animate in when showActivityStatus is set true

showCompleteStatus bool

Set true to update text just before activityStatus animates out

completeStatus str

Text that will replace activityStatus just before it animates out

refreshRate num

Rate (in milliseconds) at which pushed props update state. Default 1000.

speed num

Enter/leave animation speed (in milliseconds). Default 300.

height str

Set the height of wrapper. Necessary because of absolute positioned content.

styles obj

Apply custom styles to wrapper and heading. Merged with default styles.