Skip to content

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

6.4 KB
Raw Blame
import React, { Component, ReactElement, ReactNode } from 'react';
import { WithTranslation } from 'react-i18next';
import { GestureResponderEvent } from 'react-native';

import type { StyleType } from '../../styles/functions.any';
import { TOOLTIP_POSITION } from '../../ui/constants.any';

export type Styles = {

    /**
     * Style for the item's icon.
     */
    iconStyle?: StyleType;

    /**
     * Style for the item's label.
     */
    labelStyle?: StyleType;

    /**
     * Style for the item itself.
     */
    style?: StyleType;

    /**
     * Color for the item underlay (shows when clicked).
     */
    underlayColor?: string;
};

export interface IProps extends WithTranslation {

    /**
     * A succinct description of what the item does. Used by accessibility
     * tools and torture tests.
     */
    accessibilityLabel: string;

    /**
     * An extra class name to be added at the end of the element's class name
     * in order to enable custom styling.
     */
    customClass?: string;

    /**
     * Whether to suppress the tooltip while preserving the accessibility label.
     */
    disableTooltip?: boolean;

    /**
     * Whether this item is disabled or not. When disabled, clicking an the item
     * has no effect, and it may reflect on its style.
     */
    disabled: boolean;

    /**
     * Why the item is disabled, when it can say. Shown as its tooltip, in the overflow menu too, and given to
     * assistive technology.
     */
    disabledReason?: string;

    /**
     * A React Element to display at the end of {@code ToolboxItem}.
     */
    elementAfter?: ReactNode;

    /**
     * The icon to render for this {@code ToolboxItem}.
     */
    icon: Function;

    /**
     * The text associated with this item. When `showLabel` is set to
     * {@code true}, it will be displayed alongside the icon.
     */
    label: string;

    labelProps: any;

    /**
     * On click handler.
     */
    onClick: (e?: React.MouseEvent<HTMLElement> | GestureResponderEvent) => void;

    /**
     * Whether to show the label or not.
     */
    showLabel: boolean;

    /**
     * Collection of styles for the item. Used only on native.
     */
    styles?: Styles;

    /**
     * True if the item is toggled, false otherwise.
     */
    toggled?: boolean;

    /**
     * The text to display in the tooltip. Used only on web.
     */
    tooltip?: string;

    /**
     * From which direction the tooltip should appear, relative to the
     * item. Used only on web.
     */
    tooltipPosition: TOOLTIP_POSITION;

    /**
     * Whether this item is visible or not.
     */
    visible: boolean;
}

/**
 * Abstract (base) class for an item in {@link Toolbox}. The item can be located
 * anywhere in the {@link Toolbox}, it will morph its shape to accommodate it.
 *
 * @abstract
 */
export default class AbstractToolboxItem<P extends IProps> extends Component<P> {
    /**
     * Default values for {@code AbstractToolboxItem} component's properties.
     *
     * @static
     */
    static defaultProps = {
        disabled: false,
        label: '',
        showLabel: false,
        t: undefined,
        tooltip: '',
        tooltipPosition: 'top',
        visible: true
    };

    /**
     * Initializes a new {@code AbstractToolboxItem} instance.
     *
     * @param {Object} props - The React {@code Component} props to initialize
     * the new {@code AbstractToolboxItem} instance with.
     */
    constructor(props: P) {
        super(props);

        // Bind event handlers so they are only bound once per instance.
        this._onClick = this._onClick.bind(this);
    }

    /**
     * Helper property to get the item label. If a translation function was
     * provided then it will be translated using it.
     *
     * @protected
     * @returns {?string}
     */
    get label(): string | undefined {
        return this._maybeTranslateAttribute(this.props.label, this.props.labelProps);
    }

    /**
     * Helper property to get the item tooltip. If a translation function was
     * provided then it will be translated using it.
     *
     * @protected
     * @returns {?string}
     */
    get tooltip(): string | undefined {
        return this._maybeTranslateAttribute(this.props.tooltip ?? '');
    }

    /**
     * Helper property to get the item accessibilityLabel. If a translation
     * function was provided then it will be translated using it.
     *
     * @protected
     * @returns {?string}
     */
    get accessibilityLabel(): string {
        return this._maybeTranslateAttribute(this.props.accessibilityLabel);
    }

    /**
     * Helper property to get why the item is disabled, translated, if it is disabled and says why.
     *
     * @protected
     * @returns {?string}
     */
    get disabledReason(): string | undefined {
        const { disabled, disabledReason } = this.props;

        return disabled && disabledReason ? this._maybeTranslateAttribute(disabledReason) : undefined;
    }

    /**
     * Utility function to translate the given string, if a translation
     * function is available.
     *
     * @param {string} text - What needs translating.
     * @param {string} textProps - Additional properties for translation text.
     * @private
     * @returns {string}
     */
    _maybeTranslateAttribute(text: string, textProps?: any) {
        const { t } = this.props;

        if (textProps) {

            return typeof t === 'function' ? t(text, textProps) : `${text} ${textProps}`;
        }

        return typeof t === 'function' ? t(text) : text;
    }

    /**
     * Handles clicking/pressing this {@code AbstractToolboxItem} by
     * forwarding the event to the {@code onClick} prop of this instance if any.
     *
     * @protected
     * @returns {void}
     */
    _onClick(...args: any) {
        const { disabled, onClick } = this.props;

        disabled || onClick?.(...args);
    }

    /**
     * Renders this {@code AbstractToolboxItem} (if it is {@code visible}). To
     * be implemented/overridden by extenders. The default implementation of
     * {@code AbstractToolboxItem} does nothing.
     *
     * @protected
     * @returns {ReactElement}
     */
    _renderItem(): ReactElement | null {
        // To be implemented by a subclass.
        return null;
    }

    /**
     * Implements React's {@link Component#render()}.
     *
     * @inheritdoc
     * @returns {ReactElement}
     */
    override render() {
        return this.props.visible ? this._renderItem() : null;
    }
}