element-web/src/components/views/elements/AppTile.js

744 lines
31 KiB
JavaScript
Raw Normal View History

2018-01-11 14:49:46 +03:00
/**
2017-06-28 14:23:33 +03:00
Copyright 2017 Vector Creations Ltd
Copyright 2018 New Vector Ltd
2017-05-22 14:34:27 +03:00
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
'use strict';
2017-07-12 16:16:47 +03:00
import url from 'url';
2017-11-10 14:42:56 +03:00
import qs from 'querystring';
import React from 'react';
import PropTypes from 'prop-types';
import MatrixClientPeg from '../../../MatrixClientPeg';
import ScalarAuthClient from '../../../ScalarAuthClient';
2017-11-30 01:16:22 +03:00
import WidgetMessaging from '../../../WidgetMessaging';
2019-02-01 13:02:02 +03:00
import AccessibleButton from './AccessibleButton';
import Modal from '../../../Modal';
2019-02-01 13:02:02 +03:00
import { _t } from '../../../languageHandler';
import sdk from '../../../index';
2017-07-26 13:28:43 +03:00
import AppPermission from './AppPermission';
import AppWarning from './AppWarning';
2017-07-27 18:41:52 +03:00
import MessageSpinner from './MessageSpinner';
2018-06-26 13:59:16 +03:00
import WidgetUtils from '../../../utils/WidgetUtils';
import dis from '../../../dispatcher';
import ActiveWidgetStore from '../../../stores/ActiveWidgetStore';
2019-02-01 13:02:02 +03:00
import classNames from 'classnames';
2017-05-22 14:34:27 +03:00
2017-07-12 16:16:47 +03:00
const ALLOWED_APP_URL_SCHEMES = ['https:', 'http:'];
const ENABLE_REACT_PERF = false;
2018-01-11 14:49:46 +03:00
export default class AppTile extends React.Component {
2018-01-11 15:33:02 +03:00
constructor(props) {
super(props);
// The key used for PersistedElement
this._persistKey = 'widget_' + this.props.id;
2018-01-11 16:20:58 +03:00
this.state = this._getNewState(props);
2018-01-11 15:33:02 +03:00
this._onAction = this._onAction.bind(this);
2018-01-11 15:33:02 +03:00
this._onLoaded = this._onLoaded.bind(this);
this._onEditClick = this._onEditClick.bind(this);
this._onDeleteClick = this._onDeleteClick.bind(this);
2019-02-01 13:02:02 +03:00
this._onCancelClick = this._onCancelClick.bind(this);
2018-01-11 15:33:02 +03:00
this._onSnapshotClick = this._onSnapshotClick.bind(this);
this.onClickMenuBar = this.onClickMenuBar.bind(this);
this._onMinimiseClick = this._onMinimiseClick.bind(this);
2018-04-05 01:45:47 +03:00
this._grantWidgetPermission = this._grantWidgetPermission.bind(this);
this._revokeWidgetPermission = this._revokeWidgetPermission.bind(this);
this._onPopoutWidgetClick = this._onPopoutWidgetClick.bind(this);
2018-05-22 21:14:54 +03:00
this._onReloadWidgetClick = this._onReloadWidgetClick.bind(this);
2018-01-11 15:33:02 +03:00
}
/**
2017-11-10 14:50:14 +03:00
* Set initial component state when the App wUrl (widget URL) is being updated.
* Component props *must* be passed (rather than relying on this.props).
* @param {Object} newProps The new properties of the component
* @return {Object} Updated component state to be set with setState
*/
2017-11-10 13:17:55 +03:00
_getNewState(newProps) {
const widgetPermissionId = [newProps.room.roomId, encodeURIComponent(newProps.url)].join('_');
const hasPermissionToLoad = localStorage.getItem(widgetPermissionId);
const PersistedElement = sdk.getComponent("elements.PersistedElement");
return {
initialising: true, // True while we are mangling the widget URL
// True while the iframe content is loading
loading: this.props.waitForIframeLoad && !PersistedElement.isMounted(this._persistKey),
2017-11-30 01:16:22 +03:00
widgetUrl: this._addWurlParams(newProps.url),
widgetPermissionId: widgetPermissionId,
2017-11-10 14:50:14 +03:00
// Assume that widget has permission to load if we are the user who
// added it to the room, or if explicitly granted by the user
hasPermissionToLoad: hasPermissionToLoad === 'true' || newProps.userId === newProps.creatorUserId,
error: null,
deleting: false,
widgetPageTitle: newProps.widgetPageTitle,
};
2018-01-11 14:49:46 +03:00
}
/**
* Does the widget support a given capability
* @param {string} capability Capability to check for
* @return {Boolean} True if capability supported
*/
_hasCapability(capability) {
return ActiveWidgetStore.widgetHasCapability(this.props.id, capability);
2018-01-11 14:49:46 +03:00
}
2017-11-30 01:16:22 +03:00
/**
* Add widget instance specific parameters to pass in wUrl
* Properties passed to widget instance:
* - widgetId
* - origin / parent URL
* @param {string} urlString Url string to modify
* @return {string}
* Url string with parameters appended.
* If url can not be parsed, it is returned unmodified.
*/
_addWurlParams(urlString) {
const u = url.parse(urlString);
if (!u) {
console.error("_addWurlParams", "Invalid URL", urlString);
return url;
}
const params = qs.parse(u.query);
// Append widget ID to query parameters
params.widgetId = this.props.id;
// Append current / parent URL, minus the hash because that will change when
// we view a different room (ie. may change for persistent widgets)
params.parentUrl = window.location.href.split('#', 2)[0];
2017-11-30 01:16:22 +03:00
u.search = undefined;
u.query = params;
return u.format();
2018-01-11 14:49:46 +03:00
}
2017-11-30 01:16:22 +03:00
isMixedContent() {
const parentContentProtocol = window.location.protocol;
const u = url.parse(this.props.url);
const childContentProtocol = u.protocol;
2017-08-01 19:49:41 +03:00
if (parentContentProtocol === 'https:' && childContentProtocol !== 'https:') {
2017-08-02 19:05:46 +03:00
console.warn("Refusing to load mixed-content app:",
parentContentProtocol, childContentProtocol, window.location, this.props.url);
return true;
}
return false;
2018-01-11 14:49:46 +03:00
}
componentWillMount() {
this.setScalarToken();
2018-01-11 14:49:46 +03:00
}
2017-12-15 19:56:02 +03:00
componentDidMount() {
2018-01-18 15:02:45 +03:00
// Widget action listeners
this.dispatcherRef = dis.register(this._onAction);
2018-01-11 14:49:46 +03:00
}
2017-12-15 19:56:02 +03:00
2018-01-18 15:02:45 +03:00
componentWillUnmount() {
// Widget action listeners
dis.unregister(this.dispatcherRef);
// if it's not remaining on screen, get rid of the PersistedElement container
if (!ActiveWidgetStore.getWidgetPersistence(this.props.id)) {
2018-07-24 18:50:34 +03:00
ActiveWidgetStore.destroyPersistentWidget();
const PersistedElement = sdk.getComponent("elements.PersistedElement");
PersistedElement.destroyElement(this._persistKey);
}
2018-01-18 15:02:45 +03:00
}
/**
* Adds a scalar token to the widget URL, if required
* Component initialisation is only complete when this function has resolved
*/
setScalarToken() {
2017-11-10 12:44:58 +03:00
this.setState({initialising: true});
if (!WidgetUtils.isScalarUrl(this.props.url)) {
console.warn('Non-scalar widget, not setting scalar token!', url);
this.setState({
error: null,
2017-11-30 01:16:22 +03:00
widgetUrl: this._addWurlParams(this.props.url),
initialising: false,
});
return;
}
// Fetch the token before loading the iframe as we need it to mangle the URL
2017-10-31 13:04:37 +03:00
if (!this._scalarClient) {
this._scalarClient = new ScalarAuthClient();
}
this._scalarClient.getScalarToken().done((token) => {
// Append scalar_token as a query param if not already present
2017-08-01 17:53:42 +03:00
this._scalarClient.scalarToken = token;
2017-11-30 01:16:22 +03:00
const u = url.parse(this._addWurlParams(this.props.url));
2017-11-07 15:33:38 +03:00
const params = qs.parse(u.query);
2017-10-31 13:37:40 +03:00
if (!params.scalar_token) {
params.scalar_token = encodeURIComponent(token);
// u.search must be set to undefined, so that u.format() uses query paramerters - https://nodejs.org/docs/latest/api/url.html#url_url_format_url_options
u.search = undefined;
u.query = params;
}
this.setState({
error: null,
widgetUrl: u.format(),
initialising: false,
});
2017-12-06 00:41:44 +03:00
// Fetch page title from remote content if not already set
2017-12-08 21:47:00 +03:00
if (!this.state.widgetPageTitle && params.url) {
this._fetchWidgetTitle(params.url);
}
}, (err) => {
console.error("Failed to get scalar_token", err);
this.setState({
error: err.message,
initialising: false,
});
});
2018-01-11 14:49:46 +03:00
}
componentWillReceiveProps(nextProps) {
if (nextProps.url !== this.props.url) {
2017-11-10 13:17:55 +03:00
this._getNewState(nextProps);
this.setScalarToken();
} else if (nextProps.show && !this.props.show && this.props.waitForIframeLoad) {
this.setState({
loading: true,
});
2017-12-13 13:14:26 +03:00
} else if (nextProps.widgetPageTitle !== this.props.widgetPageTitle) {
this.setState({
widgetPageTitle: nextProps.widgetPageTitle,
});
}
2018-01-11 14:49:46 +03:00
}
_canUserModify() {
// User widgets should always be modifiable by their creator
if (this.props.userWidget && MatrixClientPeg.get().credentials.userId === this.props.creatorUserId) {
return true;
}
// Check if the current user can modify widgets in the current room
2017-08-01 13:39:17 +03:00
return WidgetUtils.canUserModifyWidgets(this.props.room.roomId);
2018-01-11 14:49:46 +03:00
}
_onEditClick(e) {
console.log("Edit widget ID ", this.props.id);
2018-02-07 17:44:01 +03:00
if (this.props.onEditClick) {
this.props.onEditClick();
} else {
// The dialog handles scalar auth for us
2018-02-07 17:44:01 +03:00
const IntegrationsManager = sdk.getComponent("views.settings.IntegrationsManager");
Modal.createTrackedDialog('Integrations Manager', '', IntegrationsManager, {
room: this.props.room,
screen: 'type_' + this.props.type,
integrationId: this.props.id
}, "mx_IntegrationsManager");
2018-02-07 17:44:01 +03:00
}
2018-01-11 14:49:46 +03:00
}
2017-05-22 20:00:17 +03:00
2017-12-03 14:25:15 +03:00
_onSnapshotClick(e) {
2017-12-15 19:56:02 +03:00
console.warn("Requesting widget snapshot");
ActiveWidgetStore.getWidgetMessaging(this.props.id).getScreenshot()
2018-03-28 14:22:06 +03:00
.catch((err) => {
console.error("Failed to get screenshot", err);
})
.then((screenshot) => {
dis.dispatch({
action: 'picture_snapshot',
file: screenshot,
}, true);
});
2018-01-11 14:49:46 +03:00
}
2017-12-03 14:25:15 +03:00
2017-11-10 14:50:14 +03:00
/* If user has permission to modify widgets, delete the widget,
* otherwise revoke access for the widget to load in the user's browser
*/
_onDeleteClick() {
2018-02-07 17:44:01 +03:00
if (this.props.onDeleteClick) {
this.props.onDeleteClick();
2019-02-01 13:02:02 +03:00
} else if (this._canUserModify()) {
// Show delete confirmation dialog
const QuestionDialog = sdk.getComponent("dialogs.QuestionDialog");
Modal.createTrackedDialog('Delete Widget', '', QuestionDialog, {
title: _t("Delete Widget"),
description: _t(
"Deleting a widget removes it for all users in this room." +
" Are you sure you want to delete this widget?"),
button: _t("Delete widget"),
onFinished: (confirmed) => {
if (!confirmed) {
return;
}
this.setState({deleting: true});
// HACK: This is a really dirty way to ensure that Jitsi cleans up
// its hold on the webcam. Without this, the widget holds a media
// stream open, even after death. See https://github.com/vector-im/riot-web/issues/7351
if (this.refs.appFrame) {
// In practice we could just do `+= ''` to trick the browser
// into thinking the URL changed, however I can foresee this
// being optimized out by a browser. Instead, we'll just point
// the iframe at a page that is reasonably safe to use in the
// event the iframe doesn't wink away.
// This is relative to where the Riot instance is located.
this.refs.appFrame.src = 'about:blank';
}
WidgetUtils.setRoomWidget(
this.props.room.roomId,
this.props.id,
).catch((e) => {
console.error('Failed to delete widget', e);
const ErrorDialog = sdk.getComponent("dialogs.ErrorDialog");
Modal.createTrackedDialog('Failed to remove widget', '', ErrorDialog, {
title: _t('Failed to remove widget'),
description: _t('An error ocurred whilst trying to remove the widget from the room'),
2018-02-07 17:44:01 +03:00
});
2019-02-01 13:02:02 +03:00
}).finally(() => {
this.setState({deleting: false});
});
},
});
}
}
_onCancelClick() {
if (this.props.onDeleteClick) {
this.props.onDeleteClick();
} else {
console.log("Revoke widget permissions - %s", this.props.id);
this._revokeWidgetPermission();
}
2018-01-11 14:49:46 +03:00
}
2017-11-30 01:16:22 +03:00
/**
* Called when widget iframe has finished loading
*/
_onLoaded() {
// Destroy the old widget messaging before starting it back up again. Some widgets
// have startup routines that run when they are loaded, so we just need to reinitialize
// the messaging for them.
ActiveWidgetStore.delWidgetMessaging(this.props.id);
this._setupWidgetMessaging();
ActiveWidgetStore.setRoomId(this.props.id, this.props.room.roomId);
this.setState({loading: false});
2018-03-28 14:22:06 +03:00
}
_setupWidgetMessaging() {
// FIXME: There's probably no reason to do this here: it should probably be done entirely
// in ActiveWidgetStore.
2019-03-24 08:31:19 +03:00
const widgetMessaging = new WidgetMessaging(
this.props.id, this.props.url, this.props.userWidget, this.refs.appFrame.contentWindow);
ActiveWidgetStore.setWidgetMessaging(this.props.id, widgetMessaging);
widgetMessaging.getCapabilities().then((requestedCapabilities) => {
console.log(`Widget ${this.props.id} requested capabilities: ` + requestedCapabilities);
requestedCapabilities = requestedCapabilities || [];
// Allow whitelisted capabilities
let requestedWhitelistCapabilies = [];
if (this.props.whitelistCapabilities && this.props.whitelistCapabilities.length > 0) {
requestedWhitelistCapabilies = requestedCapabilities.filter(function(e) {
return this.indexOf(e)>=0;
}, this.props.whitelistCapabilities);
if (requestedWhitelistCapabilies.length > 0 ) {
console.warn(`Widget ${this.props.id} allowing requested, whitelisted properties: ` +
requestedWhitelistCapabilies,
);
}
}
// TODO -- Add UI to warn about and optionally allow requested capabilities
ActiveWidgetStore.setWidgetCapabilities(this.props.id, requestedWhitelistCapabilies);
if (this.props.onCapabilityRequest) {
this.props.onCapabilityRequest(requestedCapabilities);
}
}).catch((err) => {
2018-03-13 14:01:51 +03:00
console.log(`Failed to get capabilities for widget type ${this.props.type}`, this.props.id, err);
});
2018-01-11 14:49:46 +03:00
}
_onAction(payload) {
if (payload.widgetId === this.props.id) {
switch (payload.action) {
case 'm.sticker':
if (this._hasCapability('m.sticker')) {
dis.dispatch({action: 'post_sticker_message', data: payload.data});
} else {
console.warn('Ignoring sticker message. Invalid capability');
}
break;
}
}
2018-01-11 14:49:46 +03:00
}
2018-01-04 21:41:47 +03:00
2017-11-30 01:16:22 +03:00
/**
* Set remote content title on AppTile
2017-12-06 00:41:44 +03:00
* @param {string} url Url to check for title
2017-11-30 01:16:22 +03:00
*/
_fetchWidgetTitle(url) {
2017-12-06 00:41:44 +03:00
this._scalarClient.getScalarPageTitle(url).then((widgetPageTitle) => {
if (widgetPageTitle) {
this.setState({widgetPageTitle: widgetPageTitle});
}
}, (err) =>{
console.error("Failed to get page title", err);
});
2018-01-11 14:49:46 +03:00
}
2017-07-28 20:21:23 +03:00
/* TODO -- Store permission in account data so that it is persisted across multiple devices */
2017-07-26 13:28:43 +03:00
_grantWidgetPermission() {
console.warn('Granting permission to load widget - ', this.state.widgetUrl);
localStorage.setItem(this.state.widgetPermissionId, true);
2017-07-27 18:41:52 +03:00
this.setState({hasPermissionToLoad: true});
2018-01-11 14:49:46 +03:00
}
2017-07-26 13:28:43 +03:00
_revokeWidgetPermission() {
console.warn('Revoking permission to load widget - ', this.state.widgetUrl);
localStorage.removeItem(this.state.widgetPermissionId);
this.setState({hasPermissionToLoad: false});
// Force the widget to be non-persistent
2018-07-24 18:50:34 +03:00
ActiveWidgetStore.destroyPersistentWidget();
2018-08-17 11:42:23 +03:00
const PersistedElement = sdk.getComponent("elements.PersistedElement");
PersistedElement.destroyElement(this._persistKey);
2018-01-11 14:49:46 +03:00
}
2017-05-22 20:00:17 +03:00
formatAppTileName() {
let appTileName = "No name";
2017-11-16 16:19:36 +03:00
if (this.props.name && this.props.name.trim()) {
appTileName = this.props.name.trim();
}
return appTileName;
2018-01-11 14:49:46 +03:00
}
onClickMenuBar(ev) {
ev.preventDefault();
// Ignore clicks on menu bar children
if (ev.target !== this.refs.menu_bar) {
return;
}
// Toggle the view state of the apps drawer
if (this.props.userWidget) {
this._onMinimiseClick();
} else {
dis.dispatch({
action: 'appsDrawer',
show: !this.props.show,
});
}
2018-01-11 14:49:46 +03:00
}
2017-11-30 01:16:22 +03:00
_getSafeUrl() {
const parsedWidgetUrl = url.parse(this.state.widgetUrl, true);
if (ENABLE_REACT_PERF) {
parsedWidgetUrl.search = null;
parsedWidgetUrl.query.react_perf = true;
}
2017-11-30 01:16:22 +03:00
let safeWidgetUrl = '';
if (ALLOWED_APP_URL_SCHEMES.indexOf(parsedWidgetUrl.protocol) !== -1) {
safeWidgetUrl = url.format(parsedWidgetUrl);
}
return safeWidgetUrl;
2018-01-11 14:49:46 +03:00
}
2017-11-30 01:16:22 +03:00
2018-02-07 17:44:01 +03:00
_getTileTitle() {
const name = this.formatAppTileName();
const titleSpacer = <span>&nbsp;-&nbsp;</span>;
let title = '';
if (this.state.widgetPageTitle && this.state.widgetPageTitle != this.formatAppTileName()) {
title = this.state.widgetPageTitle;
}
return (
<span>
<b>{ name }</b>
<span>{ title ? titleSpacer : '' }{ title }</span>
</span>
);
}
_onMinimiseClick(e) {
if (this.props.onMinimiseClick) {
this.props.onMinimiseClick();
}
}
_onPopoutWidgetClick(e) {
// Using Object.assign workaround as the following opens in a new window instead of a new tab.
// window.open(this._getSafeUrl(), '_blank', 'noopener=yes');
Object.assign(document.createElement('a'),
{ target: '_blank', href: this._getSafeUrl(), rel: 'noopener'}).click();
}
2018-05-22 21:14:54 +03:00
_onReloadWidgetClick(e) {
// Reload iframe in this way to avoid cross-origin restrictions
this.refs.appFrame.src = this.refs.appFrame.src;
}
render() {
let appTileBody;
// Don't render widget if it is in the process of being deleted
if (this.state.deleting) {
return <div></div>;
}
2017-07-26 13:28:43 +03:00
// Note that there is advice saying allow-scripts shouldn't be used with allow-same-origin
// because that would allow the iframe to prgramatically remove the sandbox attribute, but
// this would only be for content hosted on the same origin as the riot client: anything
// hosted on the same origin as the client will get the same access as if you clicked
// a link to it.
const sandboxFlags = "allow-forms allow-popups allow-popups-to-escape-sandbox "+
"allow-same-origin allow-scripts allow-presentation";
2017-07-26 13:28:43 +03:00
// Additional iframe feature pemissions
// (see - https://sites.google.com/a/chromium.org/dev/Home/chromium-security/deprecating-permissions-in-cross-origin-iframes and https://wicg.github.io/feature-policy/)
const iframeFeatures = "microphone; camera; encrypted-media; autoplay;";
const appTileBodyClass = 'mx_AppTileBody' + (this.props.miniMode ? '_mini ' : ' ');
if (this.props.show) {
const loadingElement = (
<div className="mx_AppLoading_spinner_fadeIn">
<MessageSpinner msg='Loading...' />
</div>
);
if (this.state.initialising) {
appTileBody = (
<div className={appTileBodyClass + (this.state.loading ? 'mx_AppLoading' : '')}>
{ loadingElement }
</div>
);
} else if (this.state.hasPermissionToLoad == true) {
if (this.isMixedContent()) {
appTileBody = (
<div className={appTileBodyClass}>
<AppWarning errorMsg="Error - Mixed content" />
</div>
);
} else {
appTileBody = (
<div className={appTileBodyClass + (this.state.loading ? 'mx_AppLoading' : '')}>
2017-11-08 23:38:54 +03:00
{ this.state.loading && loadingElement }
2018-02-22 02:35:57 +03:00
{ /*
The "is" attribute in the following iframe tag is needed in order to enable rendering of the
"allow" attribute, which is unknown to react 15.
*/ }
<iframe
2018-02-22 02:35:57 +03:00
is
allow={iframeFeatures}
ref="appFrame"
2017-11-30 01:16:22 +03:00
src={this._getSafeUrl()}
allowFullScreen="true"
sandbox={sandboxFlags}
2017-10-31 13:43:17 +03:00
onLoad={this._onLoaded}
></iframe>
</div>
);
// if the widget would be allowed to remian on screen, we must put it in
// a PersistedElement from the get-go, otherwise the iframe will be
// re-mounted later when we do.
if (this.props.whitelistCapabilities.includes('m.always_on_screen')) {
const PersistedElement = sdk.getComponent("elements.PersistedElement");
// Also wrap the PersistedElement in a div to fix the height, otherwise
// AppTile's border is in the wrong place
appTileBody = <div className="mx_AppTile_persistedWrapper">
<PersistedElement persistKey={this._persistKey}>
{appTileBody}
</PersistedElement>
</div>;
}
}
} else {
const isRoomEncrypted = MatrixClientPeg.get().isRoomEncrypted(this.props.room.roomId);
appTileBody = (
<div className={appTileBodyClass}>
<AppPermission
isRoomEncrypted={isRoomEncrypted}
url={this.state.widgetUrl}
onPermissionGranted={this._grantWidgetPermission}
/>
</div>
);
2017-07-12 16:16:47 +03:00
}
}
// editing is done in scalar
2019-02-01 13:02:02 +03:00
const canUserModify = this._canUserModify();
const showEditButton = Boolean(this._scalarClient && canUserModify);
const showDeleteButton = (this.props.showDelete === undefined || this.props.showDelete) && canUserModify;
const showCancelButton = (this.props.showCancel === undefined || this.props.showCancel) && !showDeleteButton;
// Picture snapshot - only show button when apps are maximised.
const showPictureSnapshotButton = this._hasCapability('m.capability.screenshot') && this.props.show;
2019-02-01 13:02:02 +03:00
const showMinimiseButton = this.props.showMinimise && this.props.show;
const showMaximiseButton = this.props.showMinimise && !this.props.show;
2017-12-03 14:25:15 +03:00
let appTileClass;
if (this.props.miniMode) {
2018-07-23 17:58:07 +03:00
appTileClass = 'mx_AppTile_mini';
} else if (this.props.fullWidth) {
appTileClass = 'mx_AppTileFullWidth';
} else {
appTileClass = 'mx_AppTile';
}
2019-02-01 13:02:02 +03:00
const menuBarClasses = classNames({
mx_AppTileMenuBar: true,
mx_AppTileMenuBar_expanded: this.props.show,
2019-02-02 09:46:52 +03:00
});
2019-02-01 13:02:02 +03:00
2017-05-22 14:34:27 +03:00
return (
<div className={appTileClass} id={this.props.id}>
2018-01-11 16:20:58 +03:00
{ this.props.showMenubar &&
2019-02-01 13:02:02 +03:00
<div ref="menu_bar" className={menuBarClasses} onClick={this.onClickMenuBar}>
<span className="mx_AppTileMenuBarTitle" style={{pointerEvents: (this.props.handleMinimisePointerEvents ? 'all' : false)}}>
2019-02-01 13:02:02 +03:00
{ /* Minimise widget */ }
{ showMinimiseButton && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_minimise"
title={_t('Minimize apps')}
onClick={this._onMinimiseClick}
/> }
{ /* Maximise widget */ }
{ showMaximiseButton && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_maximise"
title={_t('Maximize apps')}
onClick={this._onMinimiseClick}
2018-02-07 17:44:01 +03:00
/> }
2019-02-01 13:02:02 +03:00
{ /* Title */ }
2018-02-07 17:44:01 +03:00
{ this.props.showTitle && this._getTileTitle() }
</span>
2017-05-22 14:34:27 +03:00
<span className="mx_AppTileMenuBarWidgets">
2018-05-22 21:14:54 +03:00
{ /* Reload widget */ }
2019-02-01 13:02:02 +03:00
{ this.props.showReload && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_reload"
2018-05-22 21:14:54 +03:00
title={_t('Reload widget')}
onClick={this._onReloadWidgetClick}
/> }
{ /* Popout widget */ }
2019-02-01 13:02:02 +03:00
{ this.props.showPopout && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_popout"
title={_t('Popout widget')}
onClick={this._onPopoutWidgetClick}
2018-04-25 18:28:27 +03:00
/> }
{ /* Snapshot widget */ }
2019-02-01 13:02:02 +03:00
{ showPictureSnapshotButton && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_snapshot"
title={_t('Picture')}
onClick={this._onSnapshotClick}
/> }
{ /* Edit widget */ }
2019-02-01 13:02:02 +03:00
{ showEditButton && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_edit"
title={_t('Edit')}
2017-05-22 20:00:17 +03:00
onClick={this._onEditClick}
/> }
{ /* Delete widget */ }
2019-02-01 13:02:02 +03:00
{ showDeleteButton && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_delete"
title={_t('Delete widget')}
onClick={this._onDeleteClick}
2019-02-01 13:02:02 +03:00
/> }
{ /* Cancel widget */ }
{ showCancelButton && <AccessibleButton
className="mx_AppTileMenuBar_iconButton mx_AppTileMenuBar_iconButton_cancel"
title={_t('Revoke widget access')}
onClick={this._onCancelClick}
/> }
2017-05-22 14:34:27 +03:00
</span>
2018-01-11 16:20:58 +03:00
</div> }
{ appTileBody }
2017-05-22 14:34:27 +03:00
</div>
);
2018-01-11 14:49:46 +03:00
}
}
2018-02-07 17:48:43 +03:00
AppTile.displayName ='AppTile';
2018-01-11 14:49:46 +03:00
AppTile.propTypes = {
2018-02-26 01:36:59 +03:00
id: PropTypes.string.isRequired,
url: PropTypes.string.isRequired,
name: PropTypes.string.isRequired,
room: PropTypes.object.isRequired,
type: PropTypes.string.isRequired,
2018-01-11 14:49:46 +03:00
// Specifying 'fullWidth' as true will render the app tile to fill the width of the app drawer continer.
// This should be set to true when there is only one widget in the app drawer, otherwise it should be false.
2018-02-26 01:36:59 +03:00
fullWidth: PropTypes.bool,
// Optional. If set, renders a smaller view of the widget
miniMode: PropTypes.bool,
2018-01-11 14:49:46 +03:00
// UserId of the current user
2018-02-26 01:36:59 +03:00
userId: PropTypes.string.isRequired,
2018-01-11 14:49:46 +03:00
// UserId of the entity that added / modified the widget
2018-02-26 01:36:59 +03:00
creatorUserId: PropTypes.string,
waitForIframeLoad: PropTypes.bool,
showMenubar: PropTypes.bool,
2018-01-11 16:20:58 +03:00
// Should the AppTile render itself
2018-02-26 01:36:59 +03:00
show: PropTypes.bool,
2018-02-07 17:44:01 +03:00
// Optional onEditClickHandler (overrides default behaviour)
2018-02-26 01:36:59 +03:00
onEditClick: PropTypes.func,
2018-02-07 17:44:01 +03:00
// Optional onDeleteClickHandler (overrides default behaviour)
2018-02-26 01:36:59 +03:00
onDeleteClick: PropTypes.func,
// Optional onMinimiseClickHandler
onMinimiseClick: PropTypes.func,
2018-02-07 17:44:01 +03:00
// Optionally hide the tile title
2018-02-26 01:36:59 +03:00
showTitle: PropTypes.bool,
2018-02-07 17:44:01 +03:00
// Optionally hide the tile minimise icon
2018-02-26 01:36:59 +03:00
showMinimise: PropTypes.bool,
// Optionally handle minimise button pointer events (default false)
handleMinimisePointerEvents: PropTypes.bool,
// Optionally hide the delete icon
showDelete: PropTypes.bool,
2018-04-25 18:28:27 +03:00
// Optionally hide the popout widget icon
showPopout: PropTypes.bool,
2018-05-22 21:14:54 +03:00
// Optionally show the reload widget icon
// This is not currently intended for use with production widgets. However
// it can be useful when developing persistent widgets in order to avoid
// having to reload all of riot to get new widget content.
showReload: PropTypes.bool,
// Widget capabilities to allow by default (without user confirmation)
// NOTE -- Use with caution. This is intended to aid better integration / UX
// basic widget capabilities, e.g. injecting sticker message events.
whitelistCapabilities: PropTypes.array,
// Optional function to be called on widget capability request
// Called with an array of the requested capabilities
onCapabilityRequest: PropTypes.func,
// Is this an instance of a user widget
userWidget: PropTypes.bool,
2018-01-11 14:49:46 +03:00
};
AppTile.defaultProps = {
url: "",
waitForIframeLoad: true,
2018-01-11 16:20:58 +03:00
showMenubar: true,
2018-02-07 17:44:01 +03:00
showTitle: true,
showMinimise: true,
showDelete: true,
2018-04-25 18:28:27 +03:00
showPopout: true,
2018-05-22 21:14:54 +03:00
showReload: false,
handleMinimisePointerEvents: false,
whitelistCapabilities: [],
userWidget: false,
miniMode: false,
2018-01-11 14:49:46 +03:00
};