react-expand-collapse

A simple and customizable expand-collapse react component for the web.

• Customizable - Easy to customize button state and text.
• Lightweight - Less than 5kb of size. No dependencies other than prop-types.

Demo

Demo Link

Installation

npm install react-expand-collapse

Usage

Important: Make sure to include the css file or feel free to create your own.

import React from 'react';
import ExpandCollapse from 'react-expand-collapse';

class MovieInfo extends React.Component {
  constructor(props) {
    super(props);
  }

  render() {
    return (
      <div>
        <h4>Inception</h4>
        <ExpandCollapse
          previewHeight="88px"
        >
          Visionary filmmaker Christopher Nolan (Memento, The Dark Knight) writes and directs this psychological sci-fi action film about a thief who possesses the power to enter into the dreams of others. Dom Cobb (Leonardo DiCaprio) doesn't steal things, he steals ideas. By projecting himself deep into the subconscious of his targets, he can glean information that even the best computer hackers can't get to. In the world of corporate espionage, Cobb is the ultimate weapon. But even weapons have their weakness, and when Cobb loses everything, he's forced to embark on one final mission in a desperate quest for redemption. This time, Cobb won't be harvesting an idea, but sowing one. Should he and his team of specialists succeed, they will have discovered a new frontier in the art of psychic espionage. They've planned everything to perfection, and they have all the tools to get the job done. Their mission is complicated, however, by the sudden appearance of a malevolent foe that seems to know exactly what they're up to, and precisely how to stop them. ~ Jason Buchanan, Rovi
        </ExpandCollapse>
      </div>
    );
  }
}

API

| Prop | Type | Default | Description | -------------- | ------------- | ------------- | ------------- | | previewHeight | string | Required | The height of component in collapsed state. | | children | node | Required | Element to render inside the component. | | className | string | '' | A custom class will be applied to the root of ExpandCollapse. | | expanded | bool | false | If true, the component is in expanded state. If false, it is in collapsed state. | | expandText | string | Expand | The text shown in expanded state. | | collapseText | string | Collapse | The text shown in collapsed state. | | collapse | bool | true | If true, the component can be collapsed. If false, once it is expanded, it cannot be collapsed. | | ellipsis | bool | true | If true, the expandText will have a prefix of ellipsisText prop. If false, no prefix will appear. | | ellipsisText | string | '...' | The text to show before expandText text. | | onExpandClick | func | null | Invoked when the user clicks on expand button | | onCollapseClick | func | null | Invoked when the user clicks on collapse button | | onClick | func | null | Invoked when the user clicks on button |

License

MIT