2020-07-10 09:09:49 +00:00
|
|
|
/**
|
|
|
|
* External dependencies
|
|
|
|
*/
|
|
|
|
import classNames from 'classnames';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Internal dependencies
|
|
|
|
*/
|
|
|
|
import './style.scss';
|
|
|
|
|
2021-12-03 17:23:25 +00:00
|
|
|
export interface ChipProps {
|
|
|
|
/**
|
|
|
|
* Text for chip content.
|
|
|
|
*/
|
2022-06-21 14:53:49 +00:00
|
|
|
text: string | JSX.Element;
|
2021-12-03 17:23:25 +00:00
|
|
|
/**
|
|
|
|
* Screenreader text for the content.
|
|
|
|
*/
|
|
|
|
screenReaderText?: string;
|
|
|
|
/**
|
|
|
|
* The element type for the chip. Default 'li'.
|
|
|
|
*/
|
|
|
|
element?: string;
|
|
|
|
/**
|
|
|
|
* CSS class used.
|
|
|
|
*/
|
|
|
|
className?: string;
|
|
|
|
/**
|
|
|
|
* React children.
|
|
|
|
*/
|
|
|
|
children?: React.ReactNode | React.ReactNode[];
|
|
|
|
/**
|
|
|
|
* Radius size.
|
|
|
|
*/
|
|
|
|
radius?: 'none' | 'small' | 'medium' | 'large';
|
|
|
|
}
|
2020-09-20 23:54:08 +00:00
|
|
|
|
2020-07-10 09:09:49 +00:00
|
|
|
/**
|
|
|
|
* Component used to render a "chip" -- a list item containing some text.
|
|
|
|
*
|
|
|
|
* Each chip defaults to a list element but this can be customized by providing
|
|
|
|
* a wrapperElement.
|
|
|
|
*/
|
2021-12-03 17:23:25 +00:00
|
|
|
const Chip: React.FC< ChipProps > = ( {
|
2020-07-10 09:09:49 +00:00
|
|
|
text,
|
|
|
|
screenReaderText = '',
|
|
|
|
element = 'li',
|
|
|
|
className = '',
|
|
|
|
radius = 'small',
|
|
|
|
children = null,
|
|
|
|
...props
|
|
|
|
} ) => {
|
|
|
|
const Wrapper = element;
|
|
|
|
const wrapperClassName = classNames(
|
|
|
|
className,
|
|
|
|
'wc-block-components-chip',
|
|
|
|
'wc-block-components-chip--radius-' + radius
|
|
|
|
);
|
|
|
|
|
|
|
|
const showScreenReaderText = Boolean(
|
|
|
|
screenReaderText && screenReaderText !== text
|
|
|
|
);
|
|
|
|
|
|
|
|
return (
|
|
|
|
<Wrapper className={ wrapperClassName } { ...props }>
|
|
|
|
<span
|
|
|
|
aria-hidden={ showScreenReaderText }
|
|
|
|
className="wc-block-components-chip__text"
|
|
|
|
>
|
|
|
|
{ text }
|
|
|
|
</span>
|
|
|
|
{ showScreenReaderText && (
|
|
|
|
<span className="screen-reader-text">{ screenReaderText }</span>
|
|
|
|
) }
|
|
|
|
{ children }
|
|
|
|
</Wrapper>
|
|
|
|
);
|
|
|
|
};
|
|
|
|
export default Chip;
|