| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648 |
- "use strict";
- exports.__esModule = true;
- exports.default = exports.EXITING = exports.ENTERED = exports.ENTERING = exports.EXITED = exports.UNMOUNTED = void 0;
- var _propTypes = _interopRequireDefault(require("prop-types"));
- var _react = _interopRequireDefault(require("react"));
- var _reactDom = _interopRequireDefault(require("react-dom"));
- var _config = _interopRequireDefault(require("./config"));
- var _PropTypes = require("./utils/PropTypes");
- var _TransitionGroupContext = _interopRequireDefault(require("./TransitionGroupContext"));
- var _reflow = require("./utils/reflow");
- function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
- function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
- function _inheritsLoose(subClass, superClass) { subClass.prototype = Object.create(superClass.prototype); subClass.prototype.constructor = subClass; subClass.__proto__ = superClass; }
- var UNMOUNTED = 'unmounted';
- exports.UNMOUNTED = UNMOUNTED;
- var EXITED = 'exited';
- exports.EXITED = EXITED;
- var ENTERING = 'entering';
- exports.ENTERING = ENTERING;
- var ENTERED = 'entered';
- exports.ENTERED = ENTERED;
- var EXITING = 'exiting';
- /**
- * The Transition component lets you describe a transition from one component
- * state to another _over time_ with a simple declarative API. Most commonly
- * it's used to animate the mounting and unmounting of a component, but can also
- * be used to describe in-place transition states as well.
- *
- * ---
- *
- * **Note**: `Transition` is a platform-agnostic base component. If you're using
- * transitions in CSS, you'll probably want to use
- * [`CSSTransition`](https://reactcommunity.org/react-transition-group/css-transition)
- * instead. It inherits all the features of `Transition`, but contains
- * additional features necessary to play nice with CSS transitions (hence the
- * name of the component).
- *
- * ---
- *
- * By default the `Transition` component does not alter the behavior of the
- * component it renders, it only tracks "enter" and "exit" states for the
- * components. It's up to you to give meaning and effect to those states. For
- * example we can add styles to a component when it enters or exits:
- *
- * ```jsx
- * import { Transition } from 'react-transition-group';
- *
- * const duration = 300;
- *
- * const defaultStyle = {
- * transition: `opacity ${duration}ms ease-in-out`,
- * opacity: 0,
- * }
- *
- * const transitionStyles = {
- * entering: { opacity: 1 },
- * entered: { opacity: 1 },
- * exiting: { opacity: 0 },
- * exited: { opacity: 0 },
- * };
- *
- * const Fade = ({ in: inProp }) => (
- * <Transition in={inProp} timeout={duration}>
- * {state => (
- * <div style={{
- * ...defaultStyle,
- * ...transitionStyles[state]
- * }}>
- * I'm a fade Transition!
- * </div>
- * )}
- * </Transition>
- * );
- * ```
- *
- * There are 4 main states a Transition can be in:
- * - `'entering'`
- * - `'entered'`
- * - `'exiting'`
- * - `'exited'`
- *
- * Transition state is toggled via the `in` prop. When `true` the component
- * begins the "Enter" stage. During this stage, the component will shift from
- * its current transition state, to `'entering'` for the duration of the
- * transition and then to the `'entered'` stage once it's complete. Let's take
- * the following example (we'll use the
- * [useState](https://reactjs.org/docs/hooks-reference.html#usestate) hook):
- *
- * ```jsx
- * function App() {
- * const [inProp, setInProp] = useState(false);
- * return (
- * <div>
- * <Transition in={inProp} timeout={500}>
- * {state => (
- * // ...
- * )}
- * </Transition>
- * <button onClick={() => setInProp(true)}>
- * Click to Enter
- * </button>
- * </div>
- * );
- * }
- * ```
- *
- * When the button is clicked the component will shift to the `'entering'` state
- * and stay there for 500ms (the value of `timeout`) before it finally switches
- * to `'entered'`.
- *
- * When `in` is `false` the same thing happens except the state moves from
- * `'exiting'` to `'exited'`.
- */
- exports.EXITING = EXITING;
- var Transition = /*#__PURE__*/function (_React$Component) {
- _inheritsLoose(Transition, _React$Component);
- function Transition(props, context) {
- var _this;
- _this = _React$Component.call(this, props, context) || this;
- var parentGroup = context; // In the context of a TransitionGroup all enters are really appears
- var appear = parentGroup && !parentGroup.isMounting ? props.enter : props.appear;
- var initialStatus;
- _this.appearStatus = null;
- if (props.in) {
- if (appear) {
- initialStatus = EXITED;
- _this.appearStatus = ENTERING;
- } else {
- initialStatus = ENTERED;
- }
- } else {
- if (props.unmountOnExit || props.mountOnEnter) {
- initialStatus = UNMOUNTED;
- } else {
- initialStatus = EXITED;
- }
- }
- _this.state = {
- status: initialStatus
- };
- _this.nextCallback = null;
- return _this;
- }
- Transition.getDerivedStateFromProps = function getDerivedStateFromProps(_ref, prevState) {
- var nextIn = _ref.in;
- if (nextIn && prevState.status === UNMOUNTED) {
- return {
- status: EXITED
- };
- }
- return null;
- } // getSnapshotBeforeUpdate(prevProps) {
- // let nextStatus = null
- // if (prevProps !== this.props) {
- // const { status } = this.state
- // if (this.props.in) {
- // if (status !== ENTERING && status !== ENTERED) {
- // nextStatus = ENTERING
- // }
- // } else {
- // if (status === ENTERING || status === ENTERED) {
- // nextStatus = EXITING
- // }
- // }
- // }
- // return { nextStatus }
- // }
- ;
- var _proto = Transition.prototype;
- _proto.componentDidMount = function componentDidMount() {
- this.updateStatus(true, this.appearStatus);
- };
- _proto.componentDidUpdate = function componentDidUpdate(prevProps) {
- var nextStatus = null;
- if (prevProps !== this.props) {
- var status = this.state.status;
- if (this.props.in) {
- if (status !== ENTERING && status !== ENTERED) {
- nextStatus = ENTERING;
- }
- } else {
- if (status === ENTERING || status === ENTERED) {
- nextStatus = EXITING;
- }
- }
- }
- this.updateStatus(false, nextStatus);
- };
- _proto.componentWillUnmount = function componentWillUnmount() {
- this.cancelNextCallback();
- };
- _proto.getTimeouts = function getTimeouts() {
- var timeout = this.props.timeout;
- var exit, enter, appear;
- exit = enter = appear = timeout;
- if (timeout != null && typeof timeout !== 'number') {
- exit = timeout.exit;
- enter = timeout.enter; // TODO: remove fallback for next major
- appear = timeout.appear !== undefined ? timeout.appear : enter;
- }
- return {
- exit: exit,
- enter: enter,
- appear: appear
- };
- };
- _proto.updateStatus = function updateStatus(mounting, nextStatus) {
- if (mounting === void 0) {
- mounting = false;
- }
- if (nextStatus !== null) {
- // nextStatus will always be ENTERING or EXITING.
- this.cancelNextCallback();
- if (nextStatus === ENTERING) {
- if (this.props.unmountOnExit || this.props.mountOnEnter) {
- var node = this.props.nodeRef ? this.props.nodeRef.current : _reactDom.default.findDOMNode(this); // https://github.com/reactjs/react-transition-group/pull/749
- // With unmountOnExit or mountOnEnter, the enter animation should happen at the transition between `exited` and `entering`.
- // To make the animation happen, we have to separate each rendering and avoid being processed as batched.
- if (node) (0, _reflow.forceReflow)(node);
- }
- this.performEnter(mounting);
- } else {
- this.performExit();
- }
- } else if (this.props.unmountOnExit && this.state.status === EXITED) {
- this.setState({
- status: UNMOUNTED
- });
- }
- };
- _proto.performEnter = function performEnter(mounting) {
- var _this2 = this;
- var enter = this.props.enter;
- var appearing = this.context ? this.context.isMounting : mounting;
- var _ref2 = this.props.nodeRef ? [appearing] : [_reactDom.default.findDOMNode(this), appearing],
- maybeNode = _ref2[0],
- maybeAppearing = _ref2[1];
- var timeouts = this.getTimeouts();
- var enterTimeout = appearing ? timeouts.appear : timeouts.enter; // no enter animation skip right to ENTERED
- // if we are mounting and running this it means appear _must_ be set
- if (!mounting && !enter || _config.default.disabled) {
- this.safeSetState({
- status: ENTERED
- }, function () {
- _this2.props.onEntered(maybeNode);
- });
- return;
- }
- this.props.onEnter(maybeNode, maybeAppearing);
- this.safeSetState({
- status: ENTERING
- }, function () {
- _this2.props.onEntering(maybeNode, maybeAppearing);
- _this2.onTransitionEnd(enterTimeout, function () {
- _this2.safeSetState({
- status: ENTERED
- }, function () {
- _this2.props.onEntered(maybeNode, maybeAppearing);
- });
- });
- });
- };
- _proto.performExit = function performExit() {
- var _this3 = this;
- var exit = this.props.exit;
- var timeouts = this.getTimeouts();
- var maybeNode = this.props.nodeRef ? undefined : _reactDom.default.findDOMNode(this); // no exit animation skip right to EXITED
- if (!exit || _config.default.disabled) {
- this.safeSetState({
- status: EXITED
- }, function () {
- _this3.props.onExited(maybeNode);
- });
- return;
- }
- this.props.onExit(maybeNode);
- this.safeSetState({
- status: EXITING
- }, function () {
- _this3.props.onExiting(maybeNode);
- _this3.onTransitionEnd(timeouts.exit, function () {
- _this3.safeSetState({
- status: EXITED
- }, function () {
- _this3.props.onExited(maybeNode);
- });
- });
- });
- };
- _proto.cancelNextCallback = function cancelNextCallback() {
- if (this.nextCallback !== null) {
- this.nextCallback.cancel();
- this.nextCallback = null;
- }
- };
- _proto.safeSetState = function safeSetState(nextState, callback) {
- // This shouldn't be necessary, but there are weird race conditions with
- // setState callbacks and unmounting in testing, so always make sure that
- // we can cancel any pending setState callbacks after we unmount.
- callback = this.setNextCallback(callback);
- this.setState(nextState, callback);
- };
- _proto.setNextCallback = function setNextCallback(callback) {
- var _this4 = this;
- var active = true;
- this.nextCallback = function (event) {
- if (active) {
- active = false;
- _this4.nextCallback = null;
- callback(event);
- }
- };
- this.nextCallback.cancel = function () {
- active = false;
- };
- return this.nextCallback;
- };
- _proto.onTransitionEnd = function onTransitionEnd(timeout, handler) {
- this.setNextCallback(handler);
- var node = this.props.nodeRef ? this.props.nodeRef.current : _reactDom.default.findDOMNode(this);
- var doesNotHaveTimeoutOrListener = timeout == null && !this.props.addEndListener;
- if (!node || doesNotHaveTimeoutOrListener) {
- setTimeout(this.nextCallback, 0);
- return;
- }
- if (this.props.addEndListener) {
- var _ref3 = this.props.nodeRef ? [this.nextCallback] : [node, this.nextCallback],
- maybeNode = _ref3[0],
- maybeNextCallback = _ref3[1];
- this.props.addEndListener(maybeNode, maybeNextCallback);
- }
- if (timeout != null) {
- setTimeout(this.nextCallback, timeout);
- }
- };
- _proto.render = function render() {
- var status = this.state.status;
- if (status === UNMOUNTED) {
- return null;
- }
- var _this$props = this.props,
- children = _this$props.children,
- _in = _this$props.in,
- _mountOnEnter = _this$props.mountOnEnter,
- _unmountOnExit = _this$props.unmountOnExit,
- _appear = _this$props.appear,
- _enter = _this$props.enter,
- _exit = _this$props.exit,
- _timeout = _this$props.timeout,
- _addEndListener = _this$props.addEndListener,
- _onEnter = _this$props.onEnter,
- _onEntering = _this$props.onEntering,
- _onEntered = _this$props.onEntered,
- _onExit = _this$props.onExit,
- _onExiting = _this$props.onExiting,
- _onExited = _this$props.onExited,
- _nodeRef = _this$props.nodeRef,
- childProps = _objectWithoutPropertiesLoose(_this$props, ["children", "in", "mountOnEnter", "unmountOnExit", "appear", "enter", "exit", "timeout", "addEndListener", "onEnter", "onEntering", "onEntered", "onExit", "onExiting", "onExited", "nodeRef"]);
- return (
- /*#__PURE__*/
- // allows for nested Transitions
- _react.default.createElement(_TransitionGroupContext.default.Provider, {
- value: null
- }, typeof children === 'function' ? children(status, childProps) : _react.default.cloneElement(_react.default.Children.only(children), childProps))
- );
- };
- return Transition;
- }(_react.default.Component);
- Transition.contextType = _TransitionGroupContext.default;
- Transition.propTypes = process.env.NODE_ENV !== "production" ? {
- /**
- * A React reference to DOM element that need to transition:
- * https://stackoverflow.com/a/51127130/4671932
- *
- * - When `nodeRef` prop is used, `node` is not passed to callback functions
- * (e.g. `onEnter`) because user already has direct access to the node.
- * - When changing `key` prop of `Transition` in a `TransitionGroup` a new
- * `nodeRef` need to be provided to `Transition` with changed `key` prop
- * (see
- * [test/CSSTransition-test.js](https://github.com/reactjs/react-transition-group/blob/13435f897b3ab71f6e19d724f145596f5910581c/test/CSSTransition-test.js#L362-L437)).
- */
- nodeRef: _propTypes.default.shape({
- current: typeof Element === 'undefined' ? _propTypes.default.any : function (propValue, key, componentName, location, propFullName, secret) {
- var value = propValue[key];
- return _propTypes.default.instanceOf(value && 'ownerDocument' in value ? value.ownerDocument.defaultView.Element : Element)(propValue, key, componentName, location, propFullName, secret);
- }
- }),
- /**
- * A `function` child can be used instead of a React element. This function is
- * called with the current transition status (`'entering'`, `'entered'`,
- * `'exiting'`, `'exited'`), which can be used to apply context
- * specific props to a component.
- *
- * ```jsx
- * <Transition in={this.state.in} timeout={150}>
- * {state => (
- * <MyComponent className={`fade fade-${state}`} />
- * )}
- * </Transition>
- * ```
- */
- children: _propTypes.default.oneOfType([_propTypes.default.func.isRequired, _propTypes.default.element.isRequired]).isRequired,
- /**
- * Show the component; triggers the enter or exit states
- */
- in: _propTypes.default.bool,
- /**
- * By default the child component is mounted immediately along with
- * the parent `Transition` component. If you want to "lazy mount" the component on the
- * first `in={true}` you can set `mountOnEnter`. After the first enter transition the component will stay
- * mounted, even on "exited", unless you also specify `unmountOnExit`.
- */
- mountOnEnter: _propTypes.default.bool,
- /**
- * By default the child component stays mounted after it reaches the `'exited'` state.
- * Set `unmountOnExit` if you'd prefer to unmount the component after it finishes exiting.
- */
- unmountOnExit: _propTypes.default.bool,
- /**
- * By default the child component does not perform the enter transition when
- * it first mounts, regardless of the value of `in`. If you want this
- * behavior, set both `appear` and `in` to `true`.
- *
- * > **Note**: there are no special appear states like `appearing`/`appeared`, this prop
- * > only adds an additional enter transition. However, in the
- * > `<CSSTransition>` component that first enter transition does result in
- * > additional `.appear-*` classes, that way you can choose to style it
- * > differently.
- */
- appear: _propTypes.default.bool,
- /**
- * Enable or disable enter transitions.
- */
- enter: _propTypes.default.bool,
- /**
- * Enable or disable exit transitions.
- */
- exit: _propTypes.default.bool,
- /**
- * The duration of the transition, in milliseconds.
- * Required unless `addEndListener` is provided.
- *
- * You may specify a single timeout for all transitions:
- *
- * ```jsx
- * timeout={500}
- * ```
- *
- * or individually:
- *
- * ```jsx
- * timeout={{
- * appear: 500,
- * enter: 300,
- * exit: 500,
- * }}
- * ```
- *
- * - `appear` defaults to the value of `enter`
- * - `enter` defaults to `0`
- * - `exit` defaults to `0`
- *
- * @type {number | { enter?: number, exit?: number, appear?: number }}
- */
- timeout: function timeout(props) {
- var pt = _PropTypes.timeoutsShape;
- if (!props.addEndListener) pt = pt.isRequired;
- for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
- args[_key - 1] = arguments[_key];
- }
- return pt.apply(void 0, [props].concat(args));
- },
- /**
- * Add a custom transition end trigger. Called with the transitioning
- * DOM node and a `done` callback. Allows for more fine grained transition end
- * logic. Timeouts are still used as a fallback if provided.
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed.
- *
- * ```jsx
- * addEndListener={(node, done) => {
- * // use the css transitionend event to mark the finish of a transition
- * node.addEventListener('transitionend', done, false);
- * }}
- * ```
- */
- addEndListener: _propTypes.default.func,
- /**
- * Callback fired before the "entering" status is applied. An extra parameter
- * `isAppearing` is supplied to indicate if the enter stage is occurring on the initial mount
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed.
- *
- * @type Function(node: HtmlElement, isAppearing: bool) -> void
- */
- onEnter: _propTypes.default.func,
- /**
- * Callback fired after the "entering" status is applied. An extra parameter
- * `isAppearing` is supplied to indicate if the enter stage is occurring on the initial mount
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed.
- *
- * @type Function(node: HtmlElement, isAppearing: bool)
- */
- onEntering: _propTypes.default.func,
- /**
- * Callback fired after the "entered" status is applied. An extra parameter
- * `isAppearing` is supplied to indicate if the enter stage is occurring on the initial mount
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed.
- *
- * @type Function(node: HtmlElement, isAppearing: bool) -> void
- */
- onEntered: _propTypes.default.func,
- /**
- * Callback fired before the "exiting" status is applied.
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed.
- *
- * @type Function(node: HtmlElement) -> void
- */
- onExit: _propTypes.default.func,
- /**
- * Callback fired after the "exiting" status is applied.
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed.
- *
- * @type Function(node: HtmlElement) -> void
- */
- onExiting: _propTypes.default.func,
- /**
- * Callback fired after the "exited" status is applied.
- *
- * **Note**: when `nodeRef` prop is passed, `node` is not passed
- *
- * @type Function(node: HtmlElement) -> void
- */
- onExited: _propTypes.default.func
- } : {}; // Name the function so it is clearer in the documentation
- function noop() {}
- Transition.defaultProps = {
- in: false,
- mountOnEnter: false,
- unmountOnExit: false,
- appear: false,
- enter: true,
- exit: true,
- onEnter: noop,
- onEntering: noop,
- onEntered: noop,
- onExit: noop,
- onExiting: noop,
- onExited: noop
- };
- Transition.UNMOUNTED = UNMOUNTED;
- Transition.EXITED = EXITED;
- Transition.ENTERING = ENTERING;
- Transition.ENTERED = ENTERED;
- Transition.EXITING = EXITING;
- var _default = Transition;
- exports.default = _default;
|