@egjs/flicking 4.9.3-beta.0 → 4.10.0

package/dist/flicking.js

@@ -4,7 +4,7 @@ name: @egjs/flicking
 license: MIT
 author: NAVER Corp.
 repository: https://github.com/naver/egjs-flicking
-version: 4.9.3-beta.0
+version: 4.10.0
 */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory(require('@egjs/component'), require('@egjs/axes'), require('@egjs/imready')) :
@@ -2212,10 +2212,6 @@ version: 4.9.3-beta.0
       return StateMachine;
     }();
 
-    /*
-     * Copyright (c) 2015 NAVER Corp.
-     * egjs projects are licensed under the MIT license
-     */
     /**
      * A controller that handles the {@link https://naver.github.io/egjs-axes/ @egjs/axes} events
      * @ko {@link https://naver.github.io/egjs-axes/ @egjs/axes}의 이벤트를 처리하는 컨트롤러 컴포넌트
@@ -2510,6 +2506,44 @@ version: 4.9.3-beta.0
         (_a = this._panInput) === null || _a === void 0 ? void 0 : _a.release();
         return this;
       };
+      /**
+       * Change the destination and duration of the animation currently playing
+       * @ko 재생 중인 애니메이션의 목적지와 재생 시간을 변경합니다
+       * @param {number} position A position to move<ko>이동할 좌표</ko>
+       * @param {number} duration Duration of the animation (unit: ms)<ko>애니메이션 진행 시간 (단위: ms)</ko>
+       * @chainable
+       * @return {this}
+       */
+
+
+      __proto.updateAnimation = function (position, duration) {
+        var _a;
+
+        var _b;
+
+        this._animatingContext = __assign(__assign({}, this._animatingContext), {
+          end: position
+        });
+        (_b = this._axes) === null || _b === void 0 ? void 0 : _b.updateAnimation({
+          destPos: (_a = {}, _a[POSITION_KEY] = position, _a),
+          duration: duration
+        });
+        return this;
+      };
+      /**
+       * Stops the animation currently playing
+       * @ko 재생 중인 애니메이션을 중단시킵니다
+       * @chainable
+       * @return {this}
+       */
+
+
+      __proto.stopAnimation = function () {
+        var _a;
+
+        (_a = this._axes) === null || _a === void 0 ? void 0 : _a.stopAnimation();
+        return this;
+      };
       /**
        * Update {@link https://naver.github.io/egjs-axes/ @egjs/axes}'s state
        * @ko {@link https://naver.github.io/egjs-axes/ @egjs/axes}의 상태를 갱신합니다
@@ -2834,6 +2868,47 @@ version: 4.9.3-beta.0
 
         return this;
       };
+      /**
+       * Change the destination and duration of the animation currently playing
+       * @ko 재생 중인 애니메이션의 목적지와 재생 시간을 변경합니다
+       * @param {Panel} panel The target panel to move<ko>이동할 패널</ko>
+       * @param {number} duration Duration of the animation (unit: ms)<ko>애니메이션 진행 시간 (단위: ms)</ko>
+       * @param {DIRECTION} direction Direction to move, only available in the {@link Flicking#circular circular} mode<ko>이동할 방향. {@link Flicking#circular circular} 옵션 활성화시에만 사용 가능합니다</ko>
+       * @chainable
+       * @throws {FlickingError}
+       * {@link ERROR_CODE POSITION_NOT_REACHABLE} When the given panel is already removed or not in the Camera's {@link Camera#range range}
+       * <ko>{@link ERROR_CODE POSITION_NOT_REACHABLE} 주어진 패널이 제거되었거나, Camera의 {@link Camera#range range} 밖에 있을 경우</ko>
+       * @return {this}
+       */
+
+
+      __proto.updateAnimation = function (panel, duration, direction) {
+        var state = this._controller.state;
+
+        var position = this._getPosition(panel, direction !== null && direction !== void 0 ? direction : DIRECTION.NONE);
+
+        state.targetPanel = panel;
+
+        this._controller.updateAnimation(position, duration);
+
+        return this;
+      };
+      /**
+       * Stops the animation currently playing
+       * @ko 재생 중인 애니메이션을 중단시킵니다
+       * @chainable
+       * @return {this}
+       */
+
+
+      __proto.stopAnimation = function () {
+        var state = this._controller.state;
+        state.targetPanel = null;
+
+        this._controller.stopAnimation();
+
+        return this;
+      };
       /**
        * Update position after resizing
        * @ko resize 이후에 position을 업데이트합니다
@@ -2929,38 +3004,9 @@ version: 4.9.3-beta.0
             direction = _b === void 0 ? DIRECTION.NONE : _b,
             axesEvent = _a.axesEvent;
         return __awaiter(this, void 0, void 0, function () {
-          var flicking, camera, position, nearestAnchor, camPos_1, camRangeDiff, possiblePositions;
+          var position;
           return __generator(this, function (_c) {
-            flicking = getFlickingAttached(this._flicking);
-            camera = flicking.camera;
-            position = panel.position;
-            nearestAnchor = camera.findNearestAnchor(position);
-
-            if (panel.removed || !nearestAnchor) {
-              return [2
-              /*return*/
-              , Promise.reject(new FlickingError(MESSAGE.POSITION_NOT_REACHABLE(panel.position), CODE.POSITION_NOT_REACHABLE))];
-            }
-
-            if (!camera.canReach(panel)) {
-              // Override position & panel if that panel is not reachable
-              position = nearestAnchor.position;
-              panel = nearestAnchor.panel;
-            } else if (flicking.circularEnabled) {
-              camPos_1 = this._controller.position;
-              camRangeDiff = camera.rangeDiff;
-              possiblePositions = [position, position + camRangeDiff, position - camRangeDiff].filter(function (pos) {
-                if (direction === DIRECTION.NONE) return true;
-                return direction === DIRECTION.PREV ? pos <= camPos_1 : pos >= camPos_1;
-              });
-              position = possiblePositions.reduce(function (nearestPosition, pos) {
-                if (Math.abs(camPos_1 - pos) < Math.abs(camPos_1 - nearestPosition)) {
-                  return pos;
-                } else {
-                  return nearestPosition;
-                }
-              }, Infinity);
-            }
+            position = this._getPosition(panel, direction);
 
             this._triggerIndexChangeEvent(panel, panel.position, axesEvent);
 
@@ -3077,6 +3123,45 @@ version: 4.9.3-beta.0
         });
       };
 
+      __proto._getPosition = function (panel, direction) {
+        if (direction === void 0) {
+          direction = DIRECTION.NONE;
+        }
+
+        var flicking = getFlickingAttached(this._flicking);
+        var camera = flicking.camera;
+        var position = panel.position;
+        var nearestAnchor = camera.findNearestAnchor(position);
+
+        if (panel.removed || !nearestAnchor) {
+          throw new FlickingError(MESSAGE.POSITION_NOT_REACHABLE(panel.position), CODE.POSITION_NOT_REACHABLE);
+        }
+
+        if (!camera.canReach(panel)) {
+          // Override position & panel if that panel is not reachable
+          position = nearestAnchor.position;
+          panel = nearestAnchor.panel;
+        } else if (flicking.circularEnabled) {
+          // Circular mode is enabled, find nearest distance to panel
+          var camPos_1 = this._controller.position; // Actual position of the Axes
+
+          var camRangeDiff = camera.rangeDiff;
+          var possiblePositions = [position, position + camRangeDiff, position - camRangeDiff].filter(function (pos) {
+            if (direction === DIRECTION.NONE) return true;
+            return direction === DIRECTION.PREV ? pos <= camPos_1 : pos >= camPos_1;
+          });
+          position = possiblePositions.reduce(function (nearestPosition, pos) {
+            if (Math.abs(camPos_1 - pos) < Math.abs(camPos_1 - nearestPosition)) {
+              return pos;
+            } else {
+              return nearestPosition;
+            }
+          }, Infinity);
+        }
+
+        return position;
+      };
+
       return Control;
     }();
 
@@ -8130,6 +8215,49 @@ version: 4.9.3-beta.0
           direction: direction
         });
       };
+      /**
+       * Change the destination and duration of the animation currently playing
+       * @ko 재생 중인 애니메이션의 목적지와 재생 시간을 변경합니다
+       * @param {number} index The index of the panel to move<ko>이동할 패널의 인덱스</ko>
+       * @param {number} duration Duration of the animation (unit: ms)<ko>애니메이션 진행 시간 (단위: ms)</ko>
+       * @param {DIRECTION} direction Direction to move, only available in the {@link Flicking#circular circular} mode<ko>이동할 방향. {@link Flicking#circular circular} 옵션 활성화시에만 사용 가능합니다</ko>
+       * @throws {FlickingError}
+       * {@link ERROR_CODE INDEX_OUT_OF_RANGE} When the root is not either string or HTMLElement
+       * <ko>{@link ERROR_CODE INDEX_OUT_OF_RANGE} 해당 인덱스를 가진 패널이 존재하지 않을 경우</ko>
+       * @return {void}
+       */
+
+
+      __proto.updateAnimation = function (index, duration, direction) {
+        if (!this._control.animating) {
+          return;
+        }
+
+        var renderer = this._renderer;
+        var panelCount = renderer.panelCount;
+        var panel = renderer.getPanel(index);
+
+        if (!panel) {
+          throw new FlickingError(MESSAGE.INDEX_OUT_OF_RANGE(index, 0, panelCount - 1), CODE.INDEX_OUT_OF_RANGE);
+        }
+
+        this._control.updateAnimation(panel, duration, direction);
+      };
+      /**
+       * Stops the animation currently playing
+       * @ko 재생 중인 애니메이션을 중단시킵니다
+       * @fires Flicking#moveEnd
+       * @return {void}
+       */
+
+
+      __proto.stopAnimation = function () {
+        if (!this._control.animating) {
+          return;
+        }
+
+        this._control.stopAnimation();
+      };
       /**
        * Return the {@link Panel} at the given index. `null` if it doesn't exists.
        * @ko 주어진 인덱스에 해당하는 {@link Panel}을 반환합니다. 주어진 인덱스에 해당하는 패널이 존재하지 않을 경우 `null`을 반환합니다.
@@ -8673,7 +8801,7 @@ version: 4.9.3-beta.0
        */
 
 
-      Flicking.VERSION = "4.9.3-beta.0";
+      Flicking.VERSION = "4.10.0";
       return Flicking;
     }(Component);