jiti-meet/react/features/app/components/AbstractApp.js

131 lines
3.5 KiB
JavaScript

import React, { Component } from 'react';
import {
localParticipantJoined,
localParticipantLeft
} from '../../base/participants';
import {
appNavigate,
appWillMount,
appWillUnmount
} from '../actions';
/**
* Default config.
*
* @type {Object}
*/
const DEFAULT_CONFIG = {
configLocation: './config.js',
hosts: {
domain: 'meet.jit.si'
}
};
/**
* Base (abstract) class for main App component.
*
* @abstract
*/
export class AbstractApp extends Component {
/**
* Init lib-jitsi-meet and create local participant when component is going
* to be mounted.
*
* @inheritdoc
*/
componentWillMount() {
const dispatch = this.props.store.dispatch;
dispatch(appWillMount(this));
dispatch(localParticipantJoined());
const config
= typeof this.props.config === 'object'
? this.props.config
: DEFAULT_CONFIG;
this._openURL(this.props.url || `https://${config.hosts.domain}`);
}
/**
* Dispose lib-jitsi-meet and remove local participant when component is
* going to be unmounted.
*
* @inheritdoc
*/
componentWillUnmount() {
const dispatch = this.props.store.dispatch;
dispatch(localParticipantLeft());
dispatch(appWillUnmount(this));
}
/**
* Create a ReactElement from the specified component, the specified props
* and the props of this AbstractApp which are suitable for propagation to
* the children of this Component.
*
* @param {Component} component - The component from which the ReactElement
* is to be created.
* @param {Object} props - The read-only React Component props with which
* the ReactElement is to be initialized.
* @returns {ReactElement}
* @protected
*/
_createElement(component, props) {
/* eslint-disable no-unused-vars, lines-around-comment */
const {
// Don't propagate the config prop(erty) because the config is
// stored inside the Redux state and, thus, is visible to the
// children anyway.
config,
// Don't propagate the dispatch and store props because they usually
// come from react-redux and programmers don't really expect them to
// be inherited but rather explicitly connected.
dispatch, // eslint-disable-line react/prop-types
store,
// The url property was introduced to be consumed entirely by
// AbstractApp.
url,
// The remaining props, if any, are considered suitable for
// propagation to the children of this Component.
...thisProps
} = this.props;
/* eslint-enable no-unused-vars, lines-around-comment */
// eslint-disable-next-line object-property-newline
return React.createElement(component, { ...thisProps, ...props });
}
/**
* Navigates this AbstractApp to (i.e. opens) a specific URL.
*
* @param {string} url - The URL to which to navigate this AbstractApp (i.e.
* the URL to open).
* @protected
* @returns {void}
*/
_openURL(url) {
this.props.store.dispatch(appNavigate(url));
}
}
/**
* AbstractApp component's property types.
*
* @static
*/
AbstractApp.propTypes = {
config: React.PropTypes.object,
store: React.PropTypes.object,
/**
* The URL, if any, with which the app was launched.
*/
url: React.PropTypes.string
};