react-sanfona

React accordion component

Usage

CommonJS

Install via NPM:

npm install react-sanfona

Then:

import { Accordion, AccordionItem } from 'react-sanfona';

…

	render: function () {
		return (
			<Accordion>
				{[1, 2, 3, 4, 5].map((item) => {
					return (
						<AccordionItem title={`Item ${ item }`} slug={item} key={item}>
							<div>
								{`Item ${ item } content`}
								{item === 3 ? <p><img src="https://cloud.githubusercontent.com/assets/38787/8015584/2883817e-0bda-11e5-9662-b7daf40e8c27.gif" /></p> : null}
							</div>
						</AccordionItem>
					);
				})}
			</Accordion>
		);
	}

…

Browser

Download or install via bower:

bower install react-sanfona

Then:

<script src="https://cdnjs.cloudflare.com/ajax/libs/babel-standalone/6.7.7/babel.min.js" type="text/javascript" charset="utf-8"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/react/15.0.2/react.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/react/15.0.2/react-dom.min.js"></script>
<script src="react-sanfona/dist/react-sanfona.js" type="text/javascript" charset="utf-8"></script>

<script type="text/javascript">
	var input = `
		var Accordion = ReactSanfona.default.Accordion;
		var AccordionItem = ReactSanfona.default.AccordionItem;

		ReactDOM.render(
		    <Accordion>
		      {[1, 2, 3, 4, 5].map(function (item) {
		        return (
		          <AccordionItem title={'Item' + item} key={item} titleColor="blue">
		            <div>
		              {'Item ' +  item + ' content'}
		              {item === 3 ? <p><img src="https://cloud.githubusercontent.com/assets/38787/8015584/2883817e-0bda-11e5-9662-b7daf40e8c27.gif" /></p> : null}
		            </div>
		          </AccordionItem>
		        );
		      })}
		    </Accordion>,
		    document.getElementById('demo')
		);
	`

	var output = Babel.transform(input, { presets: ['es2015', 'react'] }).code;
	var script = document.createElement('script');
	script.innerHTML = output;
	document.body.appendChild(script);
</script>

options / PropTypes

Accordion

| Property | Type | Description | Default | |:---|:---|:---|:---| | allowMultiple | Boolean | Allow multiple items to be open at the same time. | false | | activeItems | Array | Receives either an array of indexes or a single index. Each index corresponds to the item order, starting from 0. Ex: activeItems={0}, activeItems=[0, 1, 2] | [0] | | openNextAccordionItem | Boolean | Opens the next accordion item after the previous one is closed. Defaults first one as active and applies for each accordion item except the last one. Not compatible when passing in a custom slug | false | | className | String | Custom classname applied to root div | null | | style | Object | Inline styles applied to root div | null | | onChange | Function | Triggered when component updates and passes new state as an argument | null |

AccordionItem

| Property | Type | Description | Default | |:---|:---|:---|:---| | title | String/ Object | Text or Object to display in header. | null | | slug | String/Number | Key used in activeItems lookup | null | | expanded | Boolean | If item body should be expanded or not | false | | onExpand | Function | Callback for when item is expanded | null | | onClose | Function | Callback for when item closes | null | | className | String | Custom classname applied to root item div | null | | bodyClassName | String | Custom classname applied to the accordion item body | null | | expandedClassName | String | Custom classname applied when accordion is expanded | null | | titleClassName | String | Custom classname applied to accordion item header text | null | | disabled | Boolean | If item should be expanded or not | false | | disabledClassName | String | Custom classname applied to accordion item header text when item is disabled | null |

Styling with classnames

| Classname | Targets | |:---|:---| | react-sanfona| Accordion container | | react-sanfona-item | AccordionItem container | | react-sanfona-item-expanded | AccordionItem container when expanded | | react-sanfona-item-title | AccordionItem header text | | react-sanfona-item-body | AccordionItem body container | | react-sanfona-item-body-wrapper | AccordionItem body children wrapper | | react-sanfona-item-disabled | AccordionItem is disabled |

development

npm install

npm run demo // served on localhost:8080

npm test