import AKDropdownMenu from '@atlaskit/dropdown-menu'; import ChevronDownIcon from '@atlaskit/icon/glyph/chevron-down'; import PropTypes from 'prop-types'; import React, { Component } from 'react'; import { translate } from '../../base/i18n'; /** * React component for selecting a device from a select element. Wraps * AKDropdownMenu with device selection specific logic. * * @extends Component */ class DeviceSelector extends Component { /** * DeviceSelector component's property types. * * @static */ static propTypes = { /** * MediaDeviceInfos used for display in the select element. */ devices: PropTypes.array, /** * If false, will return a selector with no selection options. */ hasPermission: PropTypes.bool, /** * CSS class for the icon to the left of the dropdown trigger. */ icon: PropTypes.string, /** * If true, will render the selector disabled with a default selection. */ isDisabled: PropTypes.bool, /** * The translation key to display as a menu label. */ label: PropTypes.string, /** * The callback to invoke when a selection is made. */ onSelect: PropTypes.func, /** * The default device to display as selected. */ selectedDeviceId: PropTypes.string, /** * Invoked to obtain translated strings. */ t: PropTypes.func }; /** * Initializes a new DeviceSelector instance. * * @param {Object} props - The read-only React Component props with which * the new instance is to be initialized. */ constructor(props) { super(props); this._onSelect = this._onSelect.bind(this); } /** * Implements React's {@link Component#render()}. * * @inheritdoc * @returns {ReactElement} */ render() { if (!this.props.hasPermission) { return this._renderNoPermission(); } if (!this.props.devices || !this.props.devices.length) { return this._renderNoDevices(); } const items = this.props.devices.map(this._createDropdownItem); const defaultSelected = items.find(item => item.value === this.props.selectedDeviceId ); return this._createDropdown({ defaultSelected, isDisabled: this.props.isDisabled, items, placeholder: this.props.t('deviceSelection.selectADevice') }); } /** * Creates a React Element for displaying the passed in text surrounded by * two icons. The left icon is the icon class passed in through props and * the right icon is AtlasKit ExpandIcon. * * @param {string} triggerText - The text to display within the element. * @private * @returns {ReactElement} */ _createDropdownTrigger(triggerText) { return (
{ triggerText }
); } /** * Creates an object in the format expected by AKDropdownMenu for an option. * * @param {MediaDeviceInfo} device - An object with a label and a deviceId. * @private * @returns {Object} The passed in media device description converted to a * format recognized as a valid AKDropdownMenu item. */ _createDropdownItem(device) { return { content: device.label, value: device.deviceId }; } /** * Creates a AKDropdownMenu Component using passed in props and options. If * the dropdown needs to be disabled, then only the AKDropdownMenu trigger * element is returned to simulate a disabled state. * * @param {Object} options - Additional configuration for display. * @param {Object} options.defaultSelected - The option that should be set * as currently chosen. * @param {boolean} options.isDisabled - If true, only the AKDropdownMenu * trigger component will be returned to simulate a disabled dropdown. * @param {Array} options.items - All the selectable options to display. * @param {string} options.placeholder - The translation key to display when * no selection has been made. * @private * @returns {ReactElement} */ _createDropdown(options) { const triggerText = (options.defaultSelected && options.defaultSelected.content) || options.placeholder; const trigger = this._createDropdownTrigger(triggerText); if (options.isDisabled) { return (
{ trigger }
); } return ( { trigger } ); } /** * Invokes the passed in callback to notify of selection changes. * * @param {Object} selection - Event from choosing a AKDropdownMenu option. * @private * @returns {void} */ _onSelect(selection) { const newDeviceId = selection.item.value; if (this.props.selectedDeviceId !== newDeviceId) { this.props.onSelect(selection.item.value); } } /** * Creates a Select Component that is disabled and has a placeholder * indicating there are no devices to select. * * @private * @returns {ReactElement} */ _renderNoDevices() { return this._createDropdown({ isDisabled: true, placeholder: this.props.t('settings.noDevice') }); } /** * Creates a AKDropdownMenu Component that is disabled and has a placeholder * stating there is no permission to display the devices. * * @private * @returns {ReactElement} */ _renderNoPermission() { return this._createDropdown({ isDisabled: true, placeholder: this.props.t('deviceSelection.noPermission') }); } } export default translate(DeviceSelector);