jiti-meet/react/features/base/icons/components/Icon.js

188 lines
4.0 KiB
JavaScript
Raw Normal View History

2019-08-30 16:39:06 +00:00
// @flow
import React, { useCallback } from 'react';
2019-08-30 16:39:06 +00:00
import { Container } from '../../react/base';
2020-05-20 10:57:03 +00:00
import { styleTypeToObject } from '../../styles';
2019-08-30 16:39:06 +00:00
type Props = {
/**
* Class name for the web platform, if any.
*/
className?: string,
2019-08-30 16:39:06 +00:00
/**
* Color of the icon (if not provided by the style object).
*/
color?: ?string,
2019-08-30 16:39:06 +00:00
/**
* Id prop (mainly for autotests).
*/
id?: string,
/**
2021-11-04 21:10:43 +00:00
* Id of the icon container.
*/
containerId?: string,
/**
* Function to invoke on click.
*/
onClick?: Function,
2019-08-30 16:39:06 +00:00
/**
* The size of the icon (if not provided by the style object).
*/
size?: ?number | string,
2019-08-30 16:39:06 +00:00
/**
* The preloaded icon component to render.
*/
src: Function,
/**
* Style object to be applied.
*/
style?: Object,
/**
2021-11-04 21:10:43 +00:00
* Aria disabled flag for the Icon.
*/
ariaDisabled?: boolean,
/**
2021-11-04 21:10:43 +00:00
* Aria label for the Icon.
*/
ariaLabel?: string,
/**
2021-11-04 21:10:43 +00:00
* Whether the element has a popup.
*/
ariaHasPopup?: boolean,
/**
2021-11-04 21:10:43 +00:00
* Whether the element has a pressed.
*/
ariaPressed?: boolean,
/**
2021-11-04 21:10:43 +00:00
* Id of description label.
*/
ariaDescribedBy?: string,
/**
2021-11-04 21:10:43 +00:00
* Whether the element popup is expanded.
*/
ariaExpanded?: boolean,
/**
2021-11-04 21:10:43 +00:00
* The id of the element this button icon controls.
*/
ariaControls?: string,
/**
2021-11-04 21:10:43 +00:00
* TabIndex for the Icon.
*/
tabIndex?: number,
/**
2021-11-04 21:10:43 +00:00
* Role for the Icon.
*/
role?: string,
/**
2021-11-04 21:10:43 +00:00
* Keypress handler.
*/
onKeyPress?: Function,
/**
2021-11-04 21:10:43 +00:00
* Keydown handler.
*/
onKeyDown?: Function
}
2019-08-30 16:39:06 +00:00
export const DEFAULT_COLOR = navigator.product === 'ReactNative' ? 'white' : undefined;
2021-02-23 11:09:22 +00:00
export const DEFAULT_SIZE = navigator.product === 'ReactNative' ? 36 : 22;
2019-08-30 16:39:06 +00:00
/**
* Implements an Icon component that takes a loaded SVG file as prop and renders it as an icon.
*
* @param {Props} props - The props of the component.
* @returns {Reactelement}
*/
export default function Icon(props: Props) {
const {
className,
color,
id,
containerId,
onClick,
2019-08-30 16:39:06 +00:00
size,
src: IconComponent,
style,
ariaHasPopup,
ariaLabel,
ariaDisabled,
ariaExpanded,
ariaControls,
tabIndex,
ariaPressed,
ariaDescribedBy,
role,
onKeyPress,
onKeyDown,
...rest
}: Props = props;
2019-08-30 16:39:06 +00:00
const {
color: styleColor,
fontSize: styleSize,
...restStyle
} = styleTypeToObject(style ?? {});
const calculatedColor = color ?? styleColor ?? DEFAULT_COLOR;
const calculatedSize = size ?? styleSize ?? DEFAULT_SIZE;
const onKeyPressHandler = useCallback(e => {
if ((e.key === 'Enter' || e.key === ' ') && onClick) {
e.preventDefault();
onClick(e);
} else if (onKeyPress) {
onKeyPress(e);
}
}, [ onClick, onKeyPress ]);
const jitsiIconClassName = calculatedColor ? 'jitsi-icon' : 'jitsi-icon jitsi-icon-default';
2019-08-30 16:39:06 +00:00
return (
<Container
{ ...rest }
aria-controls = { ariaControls }
aria-describedby = { ariaDescribedBy }
aria-disabled = { ariaDisabled }
aria-expanded = { ariaExpanded }
aria-haspopup = { ariaHasPopup }
aria-label = { ariaLabel }
aria-pressed = { ariaPressed }
className = { `${jitsiIconClassName} ${className || ''}` }
id = { containerId }
onClick = { onClick }
onKeyDown = { onKeyDown }
onKeyPress = { onKeyPressHandler }
role = { role }
style = { restStyle }
tabIndex = { tabIndex }>
2019-08-30 16:39:06 +00:00
<IconComponent
fill = { calculatedColor }
height = { calculatedSize }
id = { id }
width = { calculatedSize } />
</Container>
);
}
Icon.defaultProps = {
className: ''
};