Skip to content

Jitsi Meet - Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.

7.7 KB
Raw Blame
import React, { ReactNode } from 'react';
import { makeStyles } from 'tss-react/mui';

import { ACTION_TRIGGER } from '../../../../participants-pane/constants';
import participantsPaneTheme from '../../../components/themes/participantsPaneTheme.json';
import { isMobileBrowser } from '../../../environment/utils';

interface IProps {

    /**
     * List item actions.
     */
    actions: ReactNode;

    /**
     * List item container class name.
     */
    className?: string;

    /**
    * The breakout name for aria-label.
    */
    defaultName?: string;

    /**
     * Whether or not the actions should be hidden.
     */
    hideActions?: boolean;

    /**
     * Icon to be displayed on the list item. (Avatar for participants).
     */
    icon: ReactNode;

    /**
     * Id of the container.
     */
    id?: string;

    /**
     * Indicators to be displayed on the list item.
     */
    indicators?: ReactNode;

    /**
     * Whether or not the item is highlighted.
     */
    isHighlighted?: boolean;

    /**
     * Click handler.
     */
    onClick?: (e?: React.MouseEvent) => void;

    /**
     * Long press handler.
     */
    onLongPress?: (e?: EventTarget) => void;

    /**
     * Mouse leave handler.
     */
    onMouseLeave?: (e?: React.MouseEvent) => void;

    /**
     * Data test id.
     */
    testId?: string;

    /**
     * Text children to be displayed on the list item.
     */
    textChildren: ReactNode | string;

    /**
     * The actions trigger. Can be Hover or Permanent.
     */
    trigger: string;

}

const useStyles = makeStyles()(theme => {
    return {
        container: {
            alignItems: 'center',
            color: theme.palette.listItemText,
            display: 'flex',
            ...theme.typography.bodyShortBold,
            margin: `0 -${participantsPaneTheme.panePadding}px`,
            padding: `${theme.spacing(2)} ${participantsPaneTheme.panePadding}px`,
            position: 'relative',
            boxShadow: 'inset 0px -1px 0px rgba(255, 255, 255, 0.15)',
            minHeight: '40px',

            '&:hover, &:focus-within': {
                backgroundColor: theme.palette.listItemHover,

                '& .indicators': {
                    display: 'none'
                },

                '& .actions': {
                    display: 'flex',
                    position: 'relative',
                    top: 'auto',
                    boxShadow: `-15px 0px 10px -5px ${theme.palette.listItemBoxShadow}`,
                    backgroundColor: theme.palette.listItemHover
                }
            },

            [`@media(max-width: ${participantsPaneTheme.MD_BREAKPOINT})`]: {
                ...theme.typography.bodyShortBoldLarge,
                padding: `${theme.spacing(3)} ${participantsPaneTheme.panePadding}px`
            }
        },

        highlighted: {
            backgroundColor: theme.palette.listItemHighlighted,

            '& .actions': {
                display: 'flex',
                position: 'relative',
                top: 'auto',
                boxShadow: `-15px 0px 10px -5px ${theme.palette.listItemBoxShadow}`,
                backgroundColor: theme.palette.listItemHighlighted
            }
        },

        detailsContainer: {
            display: 'flex',
            alignItems: 'center',
            flex: 1,
            height: '100%',
            overflow: 'hidden',
            position: 'relative'
        },

        name: {
            display: 'flex',
            flex: 1,
            marginRight: theme.spacing(2),
            overflow: 'hidden',
            flexDirection: 'column',
            justifyContent: 'flex-start'
        },

        indicators: {
            display: 'flex',
            justifyContent: 'flex-end',

            '& > *': {
                alignItems: 'center',
                display: 'flex',
                justifyContent: 'center'
            },

            '& > *:not(:last-child)': {
                marginRight: theme.spacing(2)
            },

            '& .jitsi-icon': {
                padding: '3px'
            }
        },

        indicatorsHidden: {
            display: 'none'
        },

        actionsContainer: {
            position: 'absolute',
            top: '-1000px',
            boxShadow: `-15px 0px 10px -5px ${theme.palette.listItemBoxShadow}`,
            backgroundColor: theme.palette.listItemHover
        },

        actionsPermanent: {
            display: 'flex',
            boxShadow: `-15px 0px 10px -5px ${theme.palette.listItemBackground}`,
            backgroundColor: theme.palette.listItemBackground
        },

        actionsVisible: {
            display: 'flex',
            boxShadow: `-15px 0px 10px -5px ${theme.palette.listItemBoxShadow}`,
            backgroundColor: theme.palette.listItemHighlighted
        }
    };
});

const ListItem = ({
    actions,
    className,
    defaultName,
    icon,
    id,
    hideActions = false,
    indicators,
    isHighlighted,
    onClick,
    onLongPress,
    onMouseLeave,
    testId,
    textChildren,
    trigger
}: IProps) => {
    const { classes, cx } = useStyles();
    const isMobile = isMobileBrowser();
    let timeoutHandler: number;

    /**
     * Set calling long press handler after x milliseconds.
     *
     * @param {TouchEvent} e - Touch start event.
     * @returns {void}
     */
    function _onTouchStart(e: React.TouchEvent) {
        const target = e.touches[0].target;

        timeoutHandler = window.setTimeout(() => onLongPress?.(target), 600);
    }

    /**
     * Cancel calling on long press after x milliseconds if the number of milliseconds is not reached
     * before a touch move(drag), or just clears the timeout.
     *
     * @returns {void}
     */
    function _onTouchMove() {
        clearTimeout(timeoutHandler);
    }

    /**
     * Cancel calling on long press after x milliseconds if the number of milliseconds is not reached yet,
     * or just clears the timeout.
     *
     * @returns {void}
     */
    function _onTouchEnd() {
        clearTimeout(timeoutHandler);
    }

    return (
        <div
            aria-label = { defaultName }
            className = { cx('list-item-container',
                classes.container,
                isHighlighted && classes.highlighted,
                className
            ) }
            data-testid = { testId }
            id = { id }
            onClick = { onClick }
            role = 'listitem'
            { ...(isMobile
                ? {
                    onTouchEnd: _onTouchEnd,
                    onTouchMove: _onTouchMove,
                    onTouchStart: _onTouchStart
                }
                : {
                    onMouseLeave
                }
            ) }>
            <div> {icon} </div>
            <div className = { classes.detailsContainer }>
                <div className = { classes.name }>
                    {textChildren}
                </div>
                {indicators && (
                    <div
                        className = { cx('indicators',
                            classes.indicators,
                            (isHighlighted || trigger === ACTION_TRIGGER.PERMANENT) && classes.indicatorsHidden
                        ) }>
                        {indicators}
                    </div>
                )}
                {!hideActions && (
                    <div
                        className = { cx('actions',
                            classes.actionsContainer,
                            trigger === ACTION_TRIGGER.PERMANENT && classes.actionsPermanent,
                            isHighlighted && classes.actionsVisible
                        ) }>
                        {actions}
                    </div>
                )}
            </div>
        </div>
    );
};

export default ListItem;