UNPKG

@mui/material

Version:

Quickly build beautiful React apps. MUI is a simple and customizable component library to build faster, beautiful, and more accessible React applications. Follow your own design system, or start with Material Design.

340 lines (317 loc) 11.7 kB
import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose"; import _extends from "@babel/runtime/helpers/esm/extends"; const _excluded = ["anchorOrigin", "component", "components", "componentsProps", "overlap", "color", "invisible", "badgeContent", "showZero", "variant"]; import * as React from 'react'; import PropTypes from 'prop-types'; import clsx from 'clsx'; import { usePreviousProps } from '@mui/utils'; import { generateUtilityClasses } from '@mui/base'; import BadgeUnstyled, { badgeUnstyledClasses, getBadgeUtilityClass } from '@mui/base/BadgeUnstyled'; import styled from '../styles/styled'; import useThemeProps from '../styles/useThemeProps'; import shouldSpreadAdditionalProps from '../utils/shouldSpreadAdditionalProps'; import capitalize from '../utils/capitalize'; import { jsx as _jsx } from "react/jsx-runtime"; export const badgeClasses = _extends({}, badgeUnstyledClasses, generateUtilityClasses('MuiBadge', ['colorError', 'colorInfo', 'colorPrimary', 'colorSecondary', 'colorSuccess', 'colorWarning', 'overlapRectangular', 'overlapCircular', // TODO: v6 remove the overlap value from these class keys 'anchorOriginTopLeftCircular', 'anchorOriginTopLeftRectangular', 'anchorOriginTopRightCircular', 'anchorOriginTopRightRectangular', 'anchorOriginBottomLeftCircular', 'anchorOriginBottomLeftRectangular', 'anchorOriginBottomRightCircular', 'anchorOriginBottomRightRectangular'])); const RADIUS_STANDARD = 10; const RADIUS_DOT = 4; const extendUtilityClasses = ownerState => { const { color, anchorOrigin, overlap, classes = {} } = ownerState; return _extends({}, classes, { badge: clsx(classes.badge, getBadgeUtilityClass(`anchorOrigin${capitalize(anchorOrigin.vertical)}${capitalize(anchorOrigin.horizontal)}${capitalize(overlap)}`), getBadgeUtilityClass(`overlap${capitalize(overlap)}`), color !== 'default' && [getBadgeUtilityClass(`color${capitalize(color)}`), classes[`color${capitalize(color)}`]]) }); }; const BadgeRoot = styled('span', { name: 'MuiBadge', slot: 'Root', overridesResolver: (props, styles) => styles.root })({ position: 'relative', display: 'inline-flex', // For correct alignment with the text. verticalAlign: 'middle', flexShrink: 0 }); const BadgeBadge = styled('span', { name: 'MuiBadge', slot: 'Badge', overridesResolver: (props, styles) => { const { ownerState } = props; return [styles.badge, styles[ownerState.variant], styles[`anchorOrigin${capitalize(ownerState.anchorOrigin.vertical)}${capitalize(ownerState.anchorOrigin.horizontal)}${capitalize(ownerState.overlap)}`], ownerState.color !== 'default' && styles[`color${capitalize(ownerState.color)}`], ownerState.invisible && styles.invisible]; } })(({ theme, ownerState }) => _extends({ display: 'flex', flexDirection: 'row', flexWrap: 'wrap', justifyContent: 'center', alignContent: 'center', alignItems: 'center', position: 'absolute', boxSizing: 'border-box', fontFamily: theme.typography.fontFamily, fontWeight: theme.typography.fontWeightMedium, fontSize: theme.typography.pxToRem(12), minWidth: RADIUS_STANDARD * 2, lineHeight: 1, padding: '0 6px', height: RADIUS_STANDARD * 2, borderRadius: RADIUS_STANDARD, zIndex: 1, // Render the badge on top of potential ripples. transition: theme.transitions.create('transform', { easing: theme.transitions.easing.easeInOut, duration: theme.transitions.duration.enteringScreen }) }, ownerState.color !== 'default' && { backgroundColor: theme.palette[ownerState.color].main, color: theme.palette[ownerState.color].contrastText }, ownerState.variant === 'dot' && { borderRadius: RADIUS_DOT, height: RADIUS_DOT * 2, minWidth: RADIUS_DOT * 2, padding: 0 }, ownerState.anchorOrigin.vertical === 'top' && ownerState.anchorOrigin.horizontal === 'right' && ownerState.overlap === 'rectangular' && { top: 0, right: 0, transform: 'scale(1) translate(50%, -50%)', transformOrigin: '100% 0%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(50%, -50%)' } }, ownerState.anchorOrigin.vertical === 'bottom' && ownerState.anchorOrigin.horizontal === 'right' && ownerState.overlap === 'rectangular' && { bottom: 0, right: 0, transform: 'scale(1) translate(50%, 50%)', transformOrigin: '100% 100%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(50%, 50%)' } }, ownerState.anchorOrigin.vertical === 'top' && ownerState.anchorOrigin.horizontal === 'left' && ownerState.overlap === 'rectangular' && { top: 0, left: 0, transform: 'scale(1) translate(-50%, -50%)', transformOrigin: '0% 0%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(-50%, -50%)' } }, ownerState.anchorOrigin.vertical === 'bottom' && ownerState.anchorOrigin.horizontal === 'left' && ownerState.overlap === 'rectangular' && { bottom: 0, left: 0, transform: 'scale(1) translate(-50%, 50%)', transformOrigin: '0% 100%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(-50%, 50%)' } }, ownerState.anchorOrigin.vertical === 'top' && ownerState.anchorOrigin.horizontal === 'right' && ownerState.overlap === 'circular' && { top: '14%', right: '14%', transform: 'scale(1) translate(50%, -50%)', transformOrigin: '100% 0%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(50%, -50%)' } }, ownerState.anchorOrigin.vertical === 'bottom' && ownerState.anchorOrigin.horizontal === 'right' && ownerState.overlap === 'circular' && { bottom: '14%', right: '14%', transform: 'scale(1) translate(50%, 50%)', transformOrigin: '100% 100%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(50%, 50%)' } }, ownerState.anchorOrigin.vertical === 'top' && ownerState.anchorOrigin.horizontal === 'left' && ownerState.overlap === 'circular' && { top: '14%', left: '14%', transform: 'scale(1) translate(-50%, -50%)', transformOrigin: '0% 0%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(-50%, -50%)' } }, ownerState.anchorOrigin.vertical === 'bottom' && ownerState.anchorOrigin.horizontal === 'left' && ownerState.overlap === 'circular' && { bottom: '14%', left: '14%', transform: 'scale(1) translate(-50%, 50%)', transformOrigin: '0% 100%', [`&.${badgeClasses.invisible}`]: { transform: 'scale(0) translate(-50%, 50%)' } }, ownerState.invisible && { transition: theme.transitions.create('transform', { easing: theme.transitions.easing.easeInOut, duration: theme.transitions.duration.leavingScreen }) })); const Badge = /*#__PURE__*/React.forwardRef(function Badge(inProps, ref) { var _componentsProps$root, _componentsProps$badg; const props = useThemeProps({ props: inProps, name: 'MuiBadge' }); const { anchorOrigin: anchorOriginProp = { vertical: 'top', horizontal: 'right' }, component = 'span', components = {}, componentsProps = {}, overlap: overlapProp = 'rectangular', color: colorProp = 'default', invisible: invisibleProp, badgeContent: badgeContentProp, showZero = false, variant: variantProp = 'standard' } = props, other = _objectWithoutPropertiesLoose(props, _excluded); const prevProps = usePreviousProps({ anchorOrigin: anchorOriginProp, color: colorProp, overlap: overlapProp }); let invisible = invisibleProp; if (invisibleProp == null && (badgeContentProp === 0 && !showZero || badgeContentProp == null && variantProp !== 'dot')) { invisible = true; } const { color = colorProp, overlap = overlapProp, anchorOrigin = anchorOriginProp } = invisible ? prevProps : props; const ownerState = _extends({}, props, { anchorOrigin, invisible, color, overlap }); const classes = extendUtilityClasses(ownerState); return /*#__PURE__*/_jsx(BadgeUnstyled, _extends({ anchorOrigin: anchorOrigin, invisible: invisibleProp, badgeContent: badgeContentProp, showZero: showZero, variant: variantProp }, other, { components: _extends({ Root: BadgeRoot, Badge: BadgeBadge }, components), componentsProps: { root: _extends({}, componentsProps.root, shouldSpreadAdditionalProps(components.Root) && { as: component, ownerState: _extends({}, (_componentsProps$root = componentsProps.root) == null ? void 0 : _componentsProps$root.ownerState, { color, overlap }) }), badge: _extends({}, componentsProps.badge, shouldSpreadAdditionalProps(components.Badge) && { ownerState: _extends({}, (_componentsProps$badg = componentsProps.badge) == null ? void 0 : _componentsProps$badg.ownerState, { color, overlap }) }) }, classes: classes, ref: ref })); }); process.env.NODE_ENV !== "production" ? Badge.propTypes /* remove-proptypes */ = { // ----------------------------- Warning -------------------------------- // | These PropTypes are generated from the TypeScript type definitions | // | To update them edit the d.ts file and run "yarn proptypes" | // ---------------------------------------------------------------------- /** * The anchor of the badge. * @default { * vertical: 'top', * horizontal: 'right', * } */ anchorOrigin: PropTypes.shape({ horizontal: PropTypes.oneOf(['left', 'right']).isRequired, vertical: PropTypes.oneOf(['bottom', 'top']).isRequired }), /** * The content rendered within the badge. */ badgeContent: PropTypes.node, /** * The badge will be added relative to this node. */ children: PropTypes.node, /** * Override or extend the styles applied to the component. */ classes: PropTypes.object, /** * The color of the component. It supports those theme colors that make sense for this component. * @default 'default' */ color: PropTypes /* @typescript-to-proptypes-ignore */ .oneOfType([PropTypes.oneOf(['default', 'primary', 'secondary', 'error', 'info', 'success', 'warning']), PropTypes.string]), /** * The component used for the root node. * Either a string to use a HTML element or a component. */ component: PropTypes.elementType, /** * The components used for each slot inside the Badge. * Either a string to use a HTML element or a component. * @default {} */ components: PropTypes.shape({ Badge: PropTypes.elementType, Root: PropTypes.elementType }), /** * The props used for each slot inside the Badge. * @default {} */ componentsProps: PropTypes.shape({ badge: PropTypes.object, root: PropTypes.object }), /** * If `true`, the badge is invisible. */ invisible: PropTypes.bool, /** * Max count to show. * @default 99 */ max: PropTypes.number, /** * Wrapped shape the badge should overlap. * @default 'rectangular' */ overlap: PropTypes.oneOf(['circular', 'rectangular']), /** * Controls whether the badge is hidden when `badgeContent` is zero. * @default false */ showZero: PropTypes.bool, /** * The system prop that allows defining system overrides as well as additional CSS styles. */ sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]), /** * The variant to use. * @default 'standard' */ variant: PropTypes /* @typescript-to-proptypes-ignore */ .oneOfType([PropTypes.oneOf(['dot', 'standard']), PropTypes.string]) } : void 0; export default Badge;