@salesforce/design-system-react/lib/components/app-launcher/section.js

Salesforce Lightning Design System for React

'use strict';

Object.defineProperty(exports, "__esModule", {
	value: true
});

var _react = require('react');

var _react2 = _interopRequireDefault(_react);

var _createReactClass = require('create-react-class');

var _createReactClass2 = _interopRequireDefault(_createReactClass);

var _propTypes = require('prop-types');

var _propTypes2 = _interopRequireDefault(_propTypes);

var _lodash = require('lodash.isfunction');

var _lodash2 = _interopRequireDefault(_lodash);

var _classnames = require('classnames');

var _classnames2 = _interopRequireDefault(_classnames);

var _button = require('../button');

var _button2 = _interopRequireDefault(_button);

var _constants = require('../../utilities/constants');

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

/**
 * App Launcher Sections allow users to categorize App Tiles as well as toggle their display
 */


// ## Children


// ### isFunction
var AppLauncherSection = (0, _createReactClass2.default)({
	// ### Display Name
	// Always use the canonical component name as the React display name.
	displayName: _constants.APP_LAUNCHER_SECTION,

	// ### Prop Types
	propTypes: {
		/**
   * The title for this section of apps
   */
		title: _propTypes2.default.string.isRequired,
		/**
   * Allows the user to show/hide the section
   */
		toggleable: _propTypes2.default.bool,
		/**
   * The assistive text for the section collapse icons
   */
		collapseSectionAssistiveText: _propTypes2.default.string,
		/**
   * An array of applications to display
   */
		children: _propTypes2.default.node.isRequired,
		/**
   * Controls the open/closed state of the section
   */
		isOpen: _propTypes2.default.bool,
		/**
   * Callback for when section is toggled. Passes "isOpen" bool. Forces `toggleable` to true
   */
		onToggleClick: _propTypes2.default.func
	},

	getDefaultProps: function getDefaultProps() {
		return {
			collapseSectionAssistiveText: 'Toggle visibility of section'
		};
	},
	getInitialState: function getInitialState() {
		return {
			isOpen: true
		};
	},
	toggleOpen: function toggleOpen(event) {
		this.setState({ isOpen: !this.state.isOpen });

		if ((0, _lodash2.default)(this.props.onToggleClick)) {
			this.props.onToggleClick(event);
		}
	},
	render: function render() {
		var isOpen = this.props.isOpen !== undefined ? this.props.isOpen : this.state.isOpen;
		var iconIsOpenClass = isOpen ? 'slds-is-open' : 'slds-is-close';
		var sectionIsOpenClass = isOpen ? 'slds-is-expanded' : 'slds-is-collapsed';

		return _react2.default.createElement(
			'div',
			{ className: (0, _classnames2.default)('slds-section', iconIsOpenClass) },
			_react2.default.createElement(
				'div',
				{ className: 'slds-section__title' },
				this.props.toggleable || this.props.onToggleClick ? _react2.default.createElement(_button2.default, {
					assistiveText: this.props.collapseSectionAssistiveText,
					iconName: 'switch',
					onClick: this.toggleOpen,
					className: 'slds-m-right--small',
					variant: 'icon'
				}) : null,
				_react2.default.createElement(
					'h3',
					null,
					this.props.title
				)
			),
			_react2.default.createElement(
				'div',
				{ className: 'slds-section__content' },
				_react2.default.createElement(
					'ul',
					{
						className: (0, _classnames2.default)('slds-grid slds-grid--pull-padded slds-wrap', sectionIsOpenClass)
					},
					_react2.default.Children.map(this.props.children, function (child) {
						return _react2.default.createElement(
							'li',
							{
								className: (0, _classnames2.default)('slds-col--padded slds-grow-none', child.props.size === 'small' ? 'slds-size--xx-small' : 'slds-size--1-of-1 slds-medium-size--1-of-3')
							},
							child
						);
					})
				)
			)
		);
	}
});

// ## Constants


// ### classNames
// [github.com/JedWatson/classnames](https://github.com/JedWatson/classnames)
// A simple javascript utility for conditionally joining classNames together.
/* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved */
/* Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */

// # App Launcher Section Component

// ## Dependencies

// ### React
exports.default = AppLauncherSection;