/* Copyright 2020 The Matrix.org Foundation C.I.C. 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. */ import * as React from "react"; import { createRef } from "react"; import TagPanel from "./TagPanel"; import classNames from "classnames"; import dis from "../../dispatcher/dispatcher"; import { _t } from "../../languageHandler"; import RoomList2 from "../views/rooms/RoomList2"; import { HEADER_HEIGHT } from "../views/rooms/RoomSublist2"; import { Action } from "../../dispatcher/actions"; import UserMenu from "./UserMenu"; import RoomSearch from "./RoomSearch"; import AccessibleButton from "../views/elements/AccessibleButton"; import RoomBreadcrumbs2 from "../views/rooms/RoomBreadcrumbs2"; import { BreadcrumbsStore } from "../../stores/BreadcrumbsStore"; import { UPDATE_EVENT } from "../../stores/AsyncStore"; import ResizeNotifier from "../../utils/ResizeNotifier"; import SettingsStore from "../../settings/SettingsStore"; import RoomListStore, { LISTS_UPDATE_EVENT } from "../../stores/room-list/RoomListStore2"; import {Key} from "../../Keyboard"; import IndicatorScrollbar from "../structures/IndicatorScrollbar"; // TODO: Remove banner on launch: https://github.com/vector-im/riot-web/issues/14367 // TODO: Rename on launch: https://github.com/vector-im/riot-web/issues/14367 /******************************************************************* * CAUTION * ******************************************************************* * This is a work in progress implementation and isn't complete or * * even useful as a component. Please avoid using it until this * * warning disappears. * *******************************************************************/ interface IProps { isMinimized: boolean; resizeNotifier: ResizeNotifier; } interface IState { searchFilter: string; showBreadcrumbs: boolean; showTagPanel: boolean; } // List of CSS classes which should be included in keyboard navigation within the room list const cssClasses = [ "mx_RoomSearch_input", "mx_RoomSearch_icon", // minimized "mx_RoomSublist2_headerText", "mx_RoomTile2", "mx_RoomSublist2_showNButton", ]; export default class LeftPanel2 extends React.Component { private listContainerRef: React.RefObject = createRef(); private tagPanelWatcherRef: string; private focusedElement = null; private isDoingStickyHeaders = false; constructor(props: IProps) { super(props); this.state = { searchFilter: "", showBreadcrumbs: BreadcrumbsStore.instance.visible, showTagPanel: SettingsStore.getValue('TagPanel.enableTagPanel'), }; BreadcrumbsStore.instance.on(UPDATE_EVENT, this.onBreadcrumbsUpdate); RoomListStore.instance.on(LISTS_UPDATE_EVENT, this.onBreadcrumbsUpdate); this.tagPanelWatcherRef = SettingsStore.watchSetting("TagPanel.enableTagPanel", null, () => { this.setState({showTagPanel: SettingsStore.getValue("TagPanel.enableTagPanel")}); }); // We watch the middle panel because we don't actually get resized, the middle panel does. // We listen to the noisy channel to avoid choppy reaction times. this.props.resizeNotifier.on("middlePanelResizedNoisy", this.onResize); } public componentWillUnmount() { SettingsStore.unwatchSetting(this.tagPanelWatcherRef); BreadcrumbsStore.instance.off(UPDATE_EVENT, this.onBreadcrumbsUpdate); RoomListStore.instance.off(LISTS_UPDATE_EVENT, this.onBreadcrumbsUpdate); this.props.resizeNotifier.off("middlePanelResizedNoisy", this.onResize); } private onSearch = (term: string): void => { this.setState({searchFilter: term}); }; private onExplore = () => { dis.fire(Action.ViewRoomDirectory); }; private onBreadcrumbsUpdate = () => { const newVal = BreadcrumbsStore.instance.visible; if (newVal !== this.state.showBreadcrumbs) { this.setState({showBreadcrumbs: newVal}); } }; private handleStickyHeaders(list: HTMLDivElement) { if (this.isDoingStickyHeaders) return; this.isDoingStickyHeaders = true; window.requestAnimationFrame(() => { this.doStickyHeaders(list); this.isDoingStickyHeaders = false; }); } private doStickyHeaders(list: HTMLDivElement) { const topEdge = list.scrollTop; const bottomEdge = list.offsetHeight + list.scrollTop; const sublists = list.querySelectorAll(".mx_RoomSublist2"); const headerRightMargin = 16; // calculated from margins and widths to align with non-sticky tiles const headerStickyWidth = list.clientWidth - headerRightMargin; // We track which styles we want on a target before making the changes to avoid // excessive layout updates. const targetStyles = new Map(); let lastTopHeader; let firstBottomHeader; for (const sublist of sublists) { const header = sublist.querySelector(".mx_RoomSublist2_stickable"); header.style.removeProperty("display"); // always clear display:none first // When an element is <=40% off screen, make it take over const offScreenFactor = 0.4; const isOffTop = (sublist.offsetTop + (offScreenFactor * HEADER_HEIGHT)) <= topEdge; const isOffBottom = (sublist.offsetTop + (offScreenFactor * HEADER_HEIGHT)) >= bottomEdge; if (isOffTop || sublist === sublists[0]) { targetStyles.set(header, { stickyTop: true }); if (lastTopHeader) { lastTopHeader.style.display = "none"; targetStyles.set(lastTopHeader, { makeInvisible: true }); } lastTopHeader = header; } else if (isOffBottom && !firstBottomHeader) { targetStyles.set(header, { stickyBottom: true }); firstBottomHeader = header; } else { targetStyles.set(header, {}); // nothing == clear } } // Run over the style changes and make them reality. We check to see if we're about to // cause a no-op update, as adding/removing properties that are/aren't there cause // layout updates. for (const header of targetStyles.keys()) { const style = targetStyles.get(header); const headerContainer = header.parentElement; // .mx_RoomSublist2_headerContainer if (style.makeInvisible) { // we will have already removed the 'display: none', so add it back. header.style.display = "none"; continue; // nothing else to do, even if sticky somehow } if (style.stickyTop) { if (!header.classList.contains("mx_RoomSublist2_headerContainer_stickyTop")) { header.classList.add("mx_RoomSublist2_headerContainer_stickyTop"); } const newTop = `${list.parentElement.offsetTop}px`; if (header.style.top !== newTop) { header.style.top = newTop; } } else { if (header.classList.contains("mx_RoomSublist2_headerContainer_stickyTop")) { header.classList.remove("mx_RoomSublist2_headerContainer_stickyTop"); } if (header.style.top) { header.style.removeProperty('top'); } } if (style.stickyBottom) { if (!header.classList.contains("mx_RoomSublist2_headerContainer_stickyBottom")) { header.classList.add("mx_RoomSublist2_headerContainer_stickyBottom"); } } else { if (header.classList.contains("mx_RoomSublist2_headerContainer_stickyBottom")) { header.classList.remove("mx_RoomSublist2_headerContainer_stickyBottom"); } } if (style.stickyTop || style.stickyBottom) { if (!header.classList.contains("mx_RoomSublist2_headerContainer_sticky")) { header.classList.add("mx_RoomSublist2_headerContainer_sticky"); } if (!headerContainer.classList.contains("mx_RoomSublist2_headerContainer_hasSticky")) { headerContainer.classList.add("mx_RoomSublist2_headerContainer_hasSticky"); } const newWidth = `${headerStickyWidth}px`; if (header.style.width !== newWidth) { header.style.width = newWidth; } } else if (!style.stickyTop && !style.stickyBottom) { if (header.classList.contains("mx_RoomSublist2_headerContainer_sticky")) { header.classList.remove("mx_RoomSublist2_headerContainer_sticky"); } if (headerContainer.classList.contains("mx_RoomSublist2_headerContainer_hasSticky")) { headerContainer.classList.remove("mx_RoomSublist2_headerContainer_hasSticky"); } if (header.style.width) { header.style.removeProperty('width'); } } } // add appropriate sticky classes to wrapper so it has // the necessary top/bottom padding to put the sticky header in const listWrapper = list.parentElement; // .mx_LeftPanel2_roomListWrapper if (lastTopHeader) { listWrapper.classList.add("mx_LeftPanel2_roomListWrapper_stickyTop"); } else { listWrapper.classList.remove("mx_LeftPanel2_roomListWrapper_stickyTop"); } if (firstBottomHeader) { listWrapper.classList.add("mx_LeftPanel2_roomListWrapper_stickyBottom"); } else { listWrapper.classList.remove("mx_LeftPanel2_roomListWrapper_stickyBottom"); } } // TODO: Improve header reliability: https://github.com/vector-im/riot-web/issues/14232 private onScroll = (ev: React.MouseEvent) => { const list = ev.target as HTMLDivElement; this.handleStickyHeaders(list); }; private onResize = () => { if (!this.listContainerRef.current) return; // ignore: no headers to sticky this.handleStickyHeaders(this.listContainerRef.current); }; private onFocus = (ev: React.FocusEvent) => { this.focusedElement = ev.target; }; private onBlur = () => { this.focusedElement = null; }; private onKeyDown = (ev: React.KeyboardEvent) => { if (!this.focusedElement) return; switch (ev.key) { case Key.ARROW_UP: case Key.ARROW_DOWN: ev.stopPropagation(); ev.preventDefault(); this.onMoveFocus(ev.key === Key.ARROW_UP); break; } }; private onEnter = () => { const firstRoom = this.listContainerRef.current.querySelector(".mx_RoomTile2"); if (firstRoom) { firstRoom.click(); this.onSearch(""); // clear the search field } }; private onMoveFocus = (up: boolean) => { let element = this.focusedElement; let descending = false; // are we currently descending or ascending through the DOM tree? let classes: DOMTokenList; do { const child = up ? element.lastElementChild : element.firstElementChild; const sibling = up ? element.previousElementSibling : element.nextElementSibling; if (descending) { if (child) { element = child; } else if (sibling) { element = sibling; } else { descending = false; element = element.parentElement; } } else { if (sibling) { element = sibling; descending = true; } else { element = element.parentElement; } } if (element) { classes = element.classList; } } while (element && !cssClasses.some(c => classes.contains(c))); if (element) { element.focus(); this.focusedElement = element; } }; private renderHeader(): React.ReactNode { let breadcrumbs; if (this.state.showBreadcrumbs && !this.props.isMinimized) { breadcrumbs = ( ); } return (
{breadcrumbs}
); } private renderSearchExplore(): React.ReactNode { return (
); } public render(): React.ReactNode { const tagPanel = !this.state.showTagPanel ? null : (
); const roomList = ; // TODO: Conference handling / calls: https://github.com/vector-im/riot-web/issues/14177 const containerClasses = classNames({ "mx_LeftPanel2": true, "mx_LeftPanel2_hasTagPanel": !!tagPanel, "mx_LeftPanel2_minimized": this.props.isMinimized, }); const roomListClasses = classNames( "mx_LeftPanel2_actualRoomListContainer", "mx_AutoHideScrollbar", ); return (
{tagPanel}
); } }