UNPKG

@mui/material

Version:

React components that implement Google's Material Design.

202 lines (201 loc) 8.48 kB
import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties"; import _defineProperty from "@babel/runtime/helpers/esm/defineProperty"; import _extends from "@babel/runtime/helpers/esm/extends"; import * as React from 'react'; import PropTypes from 'prop-types'; import clsx from 'clsx'; import { chainPropTypes } from '@mui/utils'; import { unstable_composeClasses as composeClasses } from '@mui/base'; import { alpha } from '@mui/system'; import styled from '../styles/styled'; import useThemeProps from '../styles/useThemeProps'; import ButtonBase from '../ButtonBase'; import capitalize from '../utils/capitalize'; import iconButtonClasses, { getIconButtonUtilityClass } from './iconButtonClasses'; import { jsx as _jsx } from "react/jsx-runtime"; var useUtilityClasses = function useUtilityClasses(ownerState) { var classes = ownerState.classes, disabled = ownerState.disabled, color = ownerState.color, edge = ownerState.edge, size = ownerState.size; var slots = { root: ['root', disabled && 'disabled', color !== 'default' && "color".concat(capitalize(color)), edge && "edge".concat(capitalize(edge)), "size".concat(capitalize(size))] }; return composeClasses(slots, getIconButtonUtilityClass, classes); }; var IconButtonRoot = styled(ButtonBase, { name: 'MuiIconButton', slot: 'Root', overridesResolver: function overridesResolver(props, styles) { var ownerState = props.ownerState; return [styles.root, ownerState.color !== 'default' && styles["color".concat(capitalize(ownerState.color))], ownerState.edge && styles["edge".concat(capitalize(ownerState.edge))], styles["size".concat(capitalize(ownerState.size))]]; } })(function (_ref) { var theme = _ref.theme, ownerState = _ref.ownerState; return _extends({ textAlign: 'center', flex: '0 0 auto', fontSize: theme.typography.pxToRem(24), padding: 8, borderRadius: '50%', overflow: 'visible', // Explicitly set the default value to solve a bug on IE11. color: (theme.vars || theme).palette.action.active, transition: theme.transitions.create('background-color', { duration: theme.transitions.duration.shortest }) }, !ownerState.disableRipple && { '&:hover': { backgroundColor: theme.vars ? "rgba(".concat(theme.vars.palette.action.activeChannel, " / ").concat(theme.vars.palette.action.hoverOpacity, ")") : alpha(theme.palette.action.active, theme.palette.action.hoverOpacity), // Reset on touch devices, it doesn't add specificity '@media (hover: none)': { backgroundColor: 'transparent' } } }, ownerState.edge === 'start' && { marginLeft: ownerState.size === 'small' ? -3 : -12 }, ownerState.edge === 'end' && { marginRight: ownerState.size === 'small' ? -3 : -12 }); }, function (_ref2) { var _palette; var theme = _ref2.theme, ownerState = _ref2.ownerState; var palette = (_palette = (theme.vars || theme).palette) == null ? void 0 : _palette[ownerState.color]; return _extends({}, ownerState.color === 'inherit' && { color: 'inherit' }, ownerState.color !== 'inherit' && ownerState.color !== 'default' && _extends({ color: palette == null ? void 0 : palette.main }, !ownerState.disableRipple && { '&:hover': _extends({}, palette && { backgroundColor: theme.vars ? "rgba(".concat(palette.mainChannel, " / ").concat(theme.vars.palette.action.hoverOpacity, ")") : alpha(palette.main, theme.palette.action.hoverOpacity) }, { // Reset on touch devices, it doesn't add specificity '@media (hover: none)': { backgroundColor: 'transparent' } }) }), ownerState.size === 'small' && { padding: 5, fontSize: theme.typography.pxToRem(18) }, ownerState.size === 'large' && { padding: 12, fontSize: theme.typography.pxToRem(28) }, _defineProperty({}, "&.".concat(iconButtonClasses.disabled), { backgroundColor: 'transparent', color: (theme.vars || theme).palette.action.disabled })); }); /** * Refer to the [Icons](/material-ui/icons/) section of the documentation * regarding the available icon options. */ var IconButton = /*#__PURE__*/React.forwardRef(function IconButton(inProps, ref) { var props = useThemeProps({ props: inProps, name: 'MuiIconButton' }); var _props$edge = props.edge, edge = _props$edge === void 0 ? false : _props$edge, children = props.children, className = props.className, _props$color = props.color, color = _props$color === void 0 ? 'default' : _props$color, _props$disabled = props.disabled, disabled = _props$disabled === void 0 ? false : _props$disabled, _props$disableFocusRi = props.disableFocusRipple, disableFocusRipple = _props$disableFocusRi === void 0 ? false : _props$disableFocusRi, _props$size = props.size, size = _props$size === void 0 ? 'medium' : _props$size, other = _objectWithoutProperties(props, ["edge", "children", "className", "color", "disabled", "disableFocusRipple", "size"]); var ownerState = _extends({}, props, { edge: edge, color: color, disabled: disabled, disableFocusRipple: disableFocusRipple, size: size }); var classes = useUtilityClasses(ownerState); return /*#__PURE__*/_jsx(IconButtonRoot, _extends({ className: clsx(classes.root, className), centerRipple: true, focusRipple: !disableFocusRipple, disabled: disabled, ref: ref, ownerState: ownerState }, other, { children: children })); }); process.env.NODE_ENV !== "production" ? IconButton.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 icon to display. */ children: chainPropTypes(PropTypes.node, function (props) { var found = React.Children.toArray(props.children).some(function (child) { return /*#__PURE__*/React.isValidElement(child) && child.props.onClick; }); if (found) { return new Error(['MUI: You are providing an onClick event listener to a child of a button element.', 'Prefer applying it to the IconButton directly.', 'This guarantees that the whole <button> will be responsive to click events.'].join('\n')); } return null; }), /** * Override or extend the styles applied to the component. */ classes: PropTypes.object, /** * @ignore */ className: PropTypes.string, /** * The color of the component. * It supports both default and custom theme colors, which can be added as shown in the * [palette customization guide](https://mui.com/material-ui/customization/palette/#adding-new-colors). * @default 'default' */ color: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.oneOf(['inherit', 'default', 'primary', 'secondary', 'error', 'info', 'success', 'warning']), PropTypes.string]), /** * If `true`, the component is disabled. * @default false */ disabled: PropTypes.bool, /** * If `true`, the keyboard focus ripple is disabled. * @default false */ disableFocusRipple: PropTypes.bool, /** * If `true`, the ripple effect is disabled. * * ⚠️ Without a ripple there is no styling for :focus-visible by default. Be sure * to highlight the element by applying separate styles with the `.Mui-focusVisible` class. * @default false */ disableRipple: PropTypes.bool, /** * If given, uses a negative margin to counteract the padding on one * side (this is often helpful for aligning the left or right * side of the icon with content above or below, without ruining the border * size and shape). * @default false */ edge: PropTypes.oneOf(['end', 'start', false]), /** * The size of the component. * `small` is equivalent to the dense button styling. * @default 'medium' */ size: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.oneOf(['small', 'medium', 'large']), PropTypes.string]), /** * 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]) } : void 0; export default IconButton;