UNPKG

@salesforce/design-system-react

Version:

Salesforce Lightning Design System for React

124 lines (96 loc) 4.12 kB
'use strict'; Object.defineProperty(exports, "__esModule", { value: true }); var _react = require('react'); var _react2 = _interopRequireDefault(_react); var _propTypes = require('prop-types'); var _propTypes2 = _interopRequireDefault(_propTypes); var _classnames = require('classnames'); var _classnames2 = _interopRequireDefault(_classnames); var _constants = require('../../../utilities/constants'); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _objectWithoutProperties(obj, keys) { var target = {}; for (var i in obj) { if (keys.indexOf(i) >= 0) continue; if (!Object.prototype.hasOwnProperty.call(obj, i)) continue; target[i] = obj[i]; } return target; } /* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved */ /* Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */ // # Tabs Component // Implements the [Tabs design pattern](https://www.lightningdesignsystem.com/components/tabs/) in React. // ## Dependencies // ### React // ### classNames /* eslint-disable no-unused-vars */ var TabPanel = function TabPanel(_ref) { var className = _ref.className, children = _ref.children, variant = _ref.variant, selected = _ref.selected, id = _ref.id, tabId = _ref.tabId, attributes = _objectWithoutProperties(_ref, ['className', 'children', 'variant', 'selected', 'id', 'tabId']); return _react2.default.createElement( 'div', { 'aria-labelledby': tabId, className: (0, _classnames2.default)(className, { 'slds-show': selected, 'slds-hide': !selected, 'slds-tabs--default__content': variant === 'default', 'slds-tabs--scoped__content': variant === 'scoped' }), id: id, role: 'tabpanel' }, children.props.children ); }; TabPanel.displayName = _constants.TAB_PANEL; TabPanel.propTypes = { /** * The `children` are the contents of the tab panel. * * Note that the structure of the `<Tabs />` component **does not** correspond to the DOM structure that is rendered. The `<Tabs />` component requires one or more children of type `<TabsPanel />`, which themselves require a `label` property which will be what shows in the `<Tab />` and has `children`, which end up being the _contents of the tab's corresponding panel_. * * The component iterates through each `<TabsPanel />` and rendering one `<Tab />` and one `<TabPanel />` for each of them. The tab(s) end up being children of the `<TabsList />`. * * The tab panel component actually returns the _children_ of the _children_ which were provided by the `<TabsPanel />` component. * * Due to React's nature, the `<TabsPanel />` component wraps its children in a `div` element which we don't need nor want in our rendered DOM structure, so we just bypass it and get its kids via `{children.props.children}` in the render method below. * ``` * <Tabs> * <TabsPanel label="Tab 1"> * <h2 className="slds-text-heading--medium">This is my tab 1 contents!</h2> * <p>They show when you click the first tab.</p> * </TabsPanel> * <TabsPanel label="Tab 2"> * <h2 className="slds-text-heading--medium">This is my tab 2 contents!</h2> * <p>They show when you click the second tab.</p> * </TabsPanel> * </Tabs> * ``` */ children: _propTypes2.default.oneOfType([_propTypes2.default.array, _propTypes2.default.object, _propTypes2.default.string]), /** * CSS classes to be added to the tab panel. */ className: _propTypes2.default.string, /** * The HTML ID of this tab panel. Also used by the `<Tab />`that controls it as `panelId`. */ id: _propTypes2.default.string, /** * Whether this panel is hidden or shown. Uses the `.slds-show` and `.slds-hide` classes. */ selected: _propTypes2.default.bool, /** * If the Tabs should be scopped, defaults to false */ variant: _propTypes2.default.oneOf(['default', 'scoped']), /** * The HTML ID of the `<Tab />` that controls this panel. */ tabId: _propTypes2.default.string }; TabPanel.defaultProps = { variant: 'default', selected: false }; exports.default = TabPanel;