UNPKG

@salesforce/design-system-react

Version:

Salesforce Lightning Design System for React

192 lines (158 loc) 8.06 kB
function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); } var _THEME_CLASSES; function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } } function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; } function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); } function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); } function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; } function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); } function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; } function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } } function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); } function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; } /* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved */ /* Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */ // Implements the [Progress Ring design pattern](https://lightningdesignsystem.com/components/progress-ring/) in React. // Based on SLDS v2.4.5 import React from 'react'; import PropTypes from 'prop-types'; import classNames from 'classnames'; import { PROGRESS_RING } from '../../utilities/constants'; import Icon from '../icon'; import ProgressRingShape from './private/ring-shape'; /** * The themes available for the progress ring */ export var THEME_OPTIONS = Object.freeze({ ACTIVE: 'active', WARNING: 'warning', EXPIRED: 'expired', COMPLETE: 'complete' }); /** * The CSS classes associated with each theme */ var THEME_CLASSES = (_THEME_CLASSES = {}, _defineProperty(_THEME_CLASSES, THEME_OPTIONS.ACTIVE, 'slds-progress-ring_active-step'), _defineProperty(_THEME_CLASSES, THEME_OPTIONS.WARNING, 'slds-progress-ring_warning'), _defineProperty(_THEME_CLASSES, THEME_OPTIONS.EXPIRED, 'slds-progress-ring_expired'), _defineProperty(_THEME_CLASSES, THEME_OPTIONS.COMPLETE, 'slds-progress-ring_complete'), _THEME_CLASSES); var propTypes = { /** * HTML id for component. */ id: PropTypes.string, /** * CSS classes to be added to tag with `.slds-progress-ring`. Uses `classNames` [API](https://github.com/JedWatson/classnames). */ className: PropTypes.oneOfType([PropTypes.array, PropTypes.object, PropTypes.string]), /** * The theme applied to the ring. */ theme: PropTypes.oneOf(['active', 'warning', 'expired', 'complete']), /** * Overrides the icon to be displayed. */ icon: PropTypes.node, /** * Display the icon associated with the theme. */ hasIcon: PropTypes.bool, /** * Percentage of progress completion, ranging [0, 100]. */ value: PropTypes.number.isRequired, /** * Direction that the progress ring "flows." Default is counter-clockwise, or `drain`. For clockwise flow, use `fill` */ flowDirection: PropTypes.oneOf(['drain', 'fill']), /** * Size of the progress ring. Default is 'medium' */ size: PropTypes.oneOf(['medium', 'large']) }; var defaultProps = { flowDirection: 'drain', size: 'medium' }; /** * Customizable and configurable progress ring. Will display progress in a circular progress bar factor, and is capable of displaying iconography inside of the ring structure. */ var ProgressRing = /*#__PURE__*/function (_React$Component) { _inherits(ProgressRing, _React$Component); var _super = _createSuper(ProgressRing); function ProgressRing() { _classCallCheck(this, ProgressRing); return _super.apply(this, arguments); } _createClass(ProgressRing, [{ key: "icon", value: /** * Gets the icon to display * @returns {node} Icon */ function icon() { var icon = ''; if (this.props.hasIcon) { if (this.props.icon) { // eslint-disable-next-line prefer-destructuring icon = this.props.icon; } else if (this.props.theme === THEME_OPTIONS.WARNING) { icon = /*#__PURE__*/React.createElement(Icon, { category: "utility", name: "warning", title: "Warning" }); } else if (this.props.theme === THEME_OPTIONS.EXPIRED) { icon = /*#__PURE__*/React.createElement(Icon, { category: "utility", name: "error", title: "Expired" }); } else if (this.props.theme === THEME_OPTIONS.COMPLETE) { icon = /*#__PURE__*/React.createElement(Icon, { category: "utility", name: "check", title: "Complete" }); } } return icon; } /** * Percentage as a decimal * @returns {decimal} Percentage */ }, { key: "percentDecimal", value: function percentDecimal() { return this.props.value / 100; } /** * Gets the theme CSS class * @returns {string} Class name */ }, { key: "themeClass", value: function themeClass() { return THEME_CLASSES[this.props.theme] || ''; } }, { key: "render", value: function render() { return /*#__PURE__*/React.createElement(ProgressRingShape, { id: this.props.id, size: this.props.size, className: classNames(this.props.className, this.themeClass(), { 'slds-progress-ring_large': this.props.size === 'large' }), fillPercentDecimal: this.percentDecimal(), flowDirection: this.props.flowDirection }, this.icon()); } }]); return ProgressRing; }(React.Component); ProgressRing.displayName = PROGRESS_RING; ProgressRing.propTypes = propTypes; ProgressRing.defaultProps = defaultProps; export default ProgressRing; //# sourceMappingURL=index.js.map