@mui/material
Version:
Material UI is an open-source React component library that implements Google's Material Design. It's comprehensive and can be used in production out of the box.
283 lines (282 loc) • 8.36 kB
JavaScript
'use client';
import * as React from 'react';
import PropTypes from 'prop-types';
import clsx from 'clsx';
import { alpha } from '@mui/system/colorManipulator';
import elementTypeAcceptingRef from '@mui/utils/elementTypeAcceptingRef';
import composeClasses from '@mui/utils/composeClasses';
import isFocusVisible from '@mui/utils/isFocusVisible';
import capitalize from "../utils/capitalize.js";
import { styled, useTheme } from "../zero-styled/index.js";
import memoTheme from "../utils/memoTheme.js";
import createSimplePaletteValueFilter from "../utils/createSimplePaletteValueFilter.js";
import { useDefaultProps } from "../DefaultPropsProvider/index.js";
import Typography from "../Typography/index.js";
import linkClasses, { getLinkUtilityClass } from "./linkClasses.js";
import getTextDecoration from "./getTextDecoration.js";
import { jsx as _jsx } from "react/jsx-runtime";
const v6Colors = {
primary: true,
secondary: true,
error: true,
info: true,
success: true,
warning: true,
textPrimary: true,
textSecondary: true,
textDisabled: true
};
const useUtilityClasses = ownerState => {
const {
classes,
component,
focusVisible,
underline
} = ownerState;
const slots = {
root: ['root', `underline${capitalize(underline)}`, component === 'button' && 'button', focusVisible && 'focusVisible']
};
return composeClasses(slots, getLinkUtilityClass, classes);
};
const LinkRoot = styled(Typography, {
name: 'MuiLink',
slot: 'Root',
overridesResolver: (props, styles) => {
const {
ownerState
} = props;
return [styles.root, styles[`underline${capitalize(ownerState.underline)}`], ownerState.component === 'button' && styles.button];
}
})(memoTheme(({
theme
}) => {
return {
variants: [{
props: {
underline: 'none'
},
style: {
textDecoration: 'none'
}
}, {
props: {
underline: 'hover'
},
style: {
textDecoration: 'none',
'&:hover': {
textDecoration: 'underline'
}
}
}, {
props: {
underline: 'always'
},
style: {
textDecoration: 'underline',
'&:hover': {
textDecorationColor: 'inherit'
}
}
}, {
props: ({
underline,
ownerState
}) => underline === 'always' && ownerState.color !== 'inherit',
style: {
textDecorationColor: 'var(--Link-underlineColor)'
}
}, ...Object.entries(theme.palette).filter(createSimplePaletteValueFilter()).map(([color]) => ({
props: {
underline: 'always',
color
},
style: {
'--Link-underlineColor': theme.vars ? `rgba(${theme.vars.palette[color].mainChannel} / 0.4)` : alpha(theme.palette[color].main, 0.4)
}
})), {
props: {
underline: 'always',
color: 'textPrimary'
},
style: {
'--Link-underlineColor': theme.vars ? `rgba(${theme.vars.palette.text.primaryChannel} / 0.4)` : alpha(theme.palette.text.primary, 0.4)
}
}, {
props: {
underline: 'always',
color: 'textSecondary'
},
style: {
'--Link-underlineColor': theme.vars ? `rgba(${theme.vars.palette.text.secondaryChannel} / 0.4)` : alpha(theme.palette.text.secondary, 0.4)
}
}, {
props: {
underline: 'always',
color: 'textDisabled'
},
style: {
'--Link-underlineColor': (theme.vars || theme).palette.text.disabled
}
}, {
props: {
component: 'button'
},
style: {
position: 'relative',
WebkitTapHighlightColor: 'transparent',
backgroundColor: 'transparent',
// Reset default value
// We disable the focus ring for mouse, touch and keyboard users.
outline: 0,
border: 0,
margin: 0,
// Remove the margin in Safari
borderRadius: 0,
padding: 0,
// Remove the padding in Firefox
cursor: 'pointer',
userSelect: 'none',
verticalAlign: 'middle',
MozAppearance: 'none',
// Reset
WebkitAppearance: 'none',
// Reset
'&::-moz-focus-inner': {
borderStyle: 'none' // Remove Firefox dotted outline.
},
[`&.${linkClasses.focusVisible}`]: {
outline: 'auto'
}
}
}]
};
}));
const Link = /*#__PURE__*/React.forwardRef(function Link(inProps, ref) {
const props = useDefaultProps({
props: inProps,
name: 'MuiLink'
});
const theme = useTheme();
const {
className,
color = 'primary',
component = 'a',
onBlur,
onFocus,
TypographyClasses,
underline = 'always',
variant = 'inherit',
sx,
...other
} = props;
const [focusVisible, setFocusVisible] = React.useState(false);
const handleBlur = event => {
if (!isFocusVisible(event.target)) {
setFocusVisible(false);
}
if (onBlur) {
onBlur(event);
}
};
const handleFocus = event => {
if (isFocusVisible(event.target)) {
setFocusVisible(true);
}
if (onFocus) {
onFocus(event);
}
};
const ownerState = {
...props,
color,
component,
focusVisible,
underline,
variant
};
const classes = useUtilityClasses(ownerState);
return /*#__PURE__*/_jsx(LinkRoot, {
color: color,
className: clsx(classes.root, className),
classes: TypographyClasses,
component: component,
onBlur: handleBlur,
onFocus: handleFocus,
ref: ref,
ownerState: ownerState,
variant: variant,
...other,
sx: [...(v6Colors[color] === undefined ? [{
color
}] : []), ...(Array.isArray(sx) ? sx : [sx])],
style: {
...other.style,
...(underline === 'always' && color !== 'inherit' && !v6Colors[color] && {
'--Link-underlineColor': getTextDecoration({
theme,
ownerState
})
})
}
});
});
process.env.NODE_ENV !== "production" ? Link.propTypes /* remove-proptypes */ = {
// ┌────────────────────────────── Warning ──────────────────────────────┐
// │ These PropTypes are generated from the TypeScript type definitions. │
// │ To update them, edit the d.ts file and run `pnpm proptypes`. │
// └─────────────────────────────────────────────────────────────────────┘
/**
* The content of the component.
*/
children: PropTypes.node,
/**
* Override or extend the styles applied to the component.
*/
classes: PropTypes.object,
/**
* @ignore
*/
className: PropTypes.string,
/**
* The color of the link.
* @default 'primary'
*/
color: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.oneOf(['primary', 'secondary', 'success', 'error', 'info', 'warning', 'textPrimary', 'textSecondary', 'textDisabled']), PropTypes.string]),
/**
* The component used for the root node.
* Either a string to use a HTML element or a component.
*/
component: elementTypeAcceptingRef,
/**
* @ignore
*/
onBlur: PropTypes.func,
/**
* @ignore
*/
onFocus: PropTypes.func,
/**
* @ignore
*/
style: PropTypes.object,
/**
* 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]),
/**
* `classes` prop applied to the [`Typography`](https://mui.com/material-ui/api/typography/) element.
*/
TypographyClasses: PropTypes.object,
/**
* Controls when the link should have an underline.
* @default 'always'
*/
underline: PropTypes.oneOf(['always', 'hover', 'none']),
/**
* Applies the theme typography styles.
* @default 'inherit'
*/
variant: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([PropTypes.oneOf(['body1', 'body2', 'button', 'caption', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'inherit', 'overline', 'subtitle1', 'subtitle2']), PropTypes.string])
} : void 0;
export default Link;