/* * Copyright 2015 Palantir Technologies, Inc. All rights reserved. * * 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 classNames from "classnames"; import * as React from "react"; import { polyfill } from "react-lifecycles-compat"; import { AbstractPureComponent2, Classes } from "../../common"; import { DISPLAYNAME_PREFIX, IProps } from "../../common/props"; export interface ICollapseProps extends IProps { /** * Component to render as the root element. * Useful when rendering a `Collapse` inside a ``, for instance. * @default "div" */ component?: React.ReactType; /** * Whether the component is open or closed. * @default false */ isOpen?: boolean; /** * Whether the child components will remain mounted when the `Collapse` is closed. * Setting to true may improve performance by avoiding re-mounting children. * @default false */ keepChildrenMounted?: boolean; /** * The length of time the transition takes, in milliseconds. This must match * the duration of the animation in CSS. Only set this prop if you override * Blueprint's default transitions with new transitions of a different * length. * @default 200 */ transitionDuration?: number; } export interface ICollapseState { /** The height that should be used for the content animations. This is a CSS value, not just a number. */ height: string; /** The state the element is currently in. */ animationState: AnimationStates; } /** * `Collapse` can be in one of six states, enumerated here. * When changing the `isOpen` prop, the following happens to the states: * isOpen={true} : CLOSED -> OPEN_START -> OPENING -> OPEN * isOpen={false} : OPEN -> CLOSING_START -> CLOSING -> CLOSED */ export enum AnimationStates { /** * The body is re-rendered, height is set to the measured body height and * the body Y is set to 0. */ OPEN_START, /** * Animation begins, height is set to auto. This is all animated, and on * complete, the state changes to OPEN. */ OPENING, /** * The collapse height is set to auto, and the body Y is set to 0 (so the * element can be seen as normal). */ OPEN, /** * Height has been changed from auto to the measured height of the body to * prepare for the closing animation in CLOSING. */ CLOSING_START, /** * Height is set to 0 and the body Y is at -height. Both of these properties * are transformed, and then after the animation is complete, the state * changes to CLOSED. */ CLOSING, /** * The contents of the collapse is not rendered, the collapse height is 0, * and the body Y is at -height (so that the bottom of the body is at Y=0). */ CLOSED, } @polyfill export class Collapse extends AbstractPureComponent2 { public static displayName = `${DISPLAYNAME_PREFIX}.Collapse`; public static defaultProps: ICollapseProps = { component: "div", isOpen: false, keepChildrenMounted: false, transitionDuration: 200, }; public static getDerivedStateFromProps(props: ICollapseProps, state: ICollapseState) { const { isOpen } = props; const { animationState } = state; if (isOpen) { switch (animationState) { case AnimationStates.OPENING: // allow Collapse#onDelayedStateChange() to handle the transition here break; case AnimationStates.OPEN: break; default: return { animationState: AnimationStates.OPEN_START }; } } else { switch (animationState) { case AnimationStates.CLOSING: // allow Collapse#onDelayedStateChange() to handle the transition here break; case AnimationStates.CLOSED: break; default: return { animationState: AnimationStates.CLOSING_START }; } } return null; } public state = { animationState: this.props.isOpen ? AnimationStates.OPEN : AnimationStates.CLOSED, height: "0px", }; // The element containing the contents of the collapse. private contents: HTMLElement; public render() { const isContentVisible = this.state.animationState !== AnimationStates.CLOSED; const shouldRenderChildren = isContentVisible || this.props.keepChildrenMounted; const displayWithTransform = isContentVisible && this.state.animationState !== AnimationStates.CLOSING; const isAutoHeight = this.state.height === "auto"; const containerStyle = { height: isContentVisible ? this.state.height : undefined, overflowY: (isAutoHeight ? "visible" : undefined) as "visible" | undefined, transition: isAutoHeight ? "none" : undefined, }; const contentsStyle = { transform: displayWithTransform ? "translateY(0)" : `translateY(-${this.state.height}px)`, transition: isAutoHeight ? "none" : undefined, }; return React.createElement( this.props.component, { className: classNames(Classes.COLLAPSE, this.props.className), style: containerStyle, },
{shouldRenderChildren ? this.props.children : null}
, ); } public componentDidMount() { this.forceUpdate(); if (this.props.isOpen) { this.setState({ animationState: AnimationStates.OPEN, height: "auto" }); } else { this.setState({ animationState: AnimationStates.CLOSED }); } } public componentDidUpdate() { let height: number | undefined; if (this.contents != null && this.contents.clientHeight !== 0) { height = this.contents.clientHeight; } const { transitionDuration } = this.props; const { animationState } = this.state; if (animationState === AnimationStates.CLOSING_START) { this.setTimeout(() => this.setState({ animationState: AnimationStates.CLOSING, height: "0px", }), ); this.setTimeout(() => this.onDelayedStateChange(), transitionDuration); } else if (animationState === AnimationStates.OPEN_START) { this.setState({ animationState: AnimationStates.OPENING, height: height !== undefined ? `${height}px` : this.state.height, }); this.setTimeout(() => this.onDelayedStateChange(), transitionDuration); } } private contentsRefHandler = (el: HTMLElement) => { this.contents = el; if (el != null) { this.setState({ animationState: this.props.isOpen ? AnimationStates.OPEN : AnimationStates.CLOSED, height: `${this.contents.clientHeight}px`, }); } }; private onDelayedStateChange() { switch (this.state.animationState) { case AnimationStates.OPENING: this.setState({ animationState: AnimationStates.OPEN, height: "auto" }); break; case AnimationStates.CLOSING: this.setState({ animationState: AnimationStates.CLOSED }); break; default: break; } } }