/**
* External dependencies
*/
import { Fragment } from '@wordpress/element';
import clsx from 'clsx';
import type { ReactElement, HTMLProps } from 'react';
export interface LabelProps extends HTMLProps< HTMLElement > {
label?: string | undefined;
screenReaderLabel?: string | undefined;
wrapperElement?: string | undefined;
wrapperProps?: HTMLProps< HTMLElement > | undefined;
}
/**
* Component used to render an accessible text given a label and/or a
* screenReaderLabel. The wrapper element and wrapper props can also be
* specified via props.
*
*/
const Label = ( {
label,
screenReaderLabel,
wrapperElement,
wrapperProps = {},
}: LabelProps ): ReactElement => {
let Wrapper;
const hasLabel = typeof label !== 'undefined' && label !== null;
const hasScreenReaderLabel =
typeof screenReaderLabel !== 'undefined' && screenReaderLabel !== null;
if ( ! hasLabel && hasScreenReaderLabel ) {
Wrapper = wrapperElement || 'span';
wrapperProps = {
...wrapperProps,
className: clsx( wrapperProps.className, 'screen-reader-text' ),
};
return { screenReaderLabel };
}
Wrapper = wrapperElement || Fragment;
if ( hasLabel && hasScreenReaderLabel && label !== screenReaderLabel ) {
return (
{ label }
{ screenReaderLabel }
);
}
return { label };
};
export default Label;