@egjs/flicking 4.7.3 → 4.9.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.7.3
+version: 4.9.0
 */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory(require('@egjs/component'), require('@egjs/axes'), require('@egjs/imready')) :
@@ -780,6 +780,29 @@ version: 4.7.3
 
       return arr;
     };
+    var getElementSize = function (_a) {
+      var el = _a.el,
+          horizontal = _a.horizontal,
+          useFractionalSize = _a.useFractionalSize,
+          useOffset = _a.useOffset,
+          style = _a.style;
+
+      if (useFractionalSize) {
+        var baseSize = parseFloat(horizontal ? style.width : style.height);
+        var isBorderBoxSizing = style.boxSizing === "border-box";
+        var border = horizontal ? parseFloat(style.borderLeftWidth || "0") + parseFloat(style.borderRightWidth || "0") : parseFloat(style.borderTopWidth || "0") + parseFloat(style.borderBottomWidth || "0");
+
+        if (isBorderBoxSizing) {
+          return useOffset ? baseSize : baseSize - border;
+        } else {
+          var padding = horizontal ? parseFloat(style.paddingLeft || "0") + parseFloat(style.paddingRight || "0") : parseFloat(style.paddingTop || "0") + parseFloat(style.paddingBottom || "0");
+          return useOffset ? baseSize + padding + border : baseSize + padding;
+        }
+      } else {
+        var sizeStr = horizontal ? "Width" : "Height";
+        return useOffset ? el["offset" + sizeStr] : el["client" + sizeStr];
+      }
+    };
     var setPrototypeOf = Object.setPrototypeOf || function (obj, proto) {
       obj.__proto__ = proto;
       return obj;
@@ -814,6 +837,7 @@ version: 4.7.3
         isBetween: isBetween,
         circulateIndex: circulateIndex,
         range: range,
+        getElementSize: getElementSize,
         setPrototypeOf: setPrototypeOf
     };
 
@@ -826,7 +850,7 @@ version: 4.7.3
      * @ko Flicking 내부에서 알려진 오류 발생시 throw되는 에러
      * @property {number} code Error code<ko>에러 코드</ko>
      * @property {string} message Error message<ko>에러 메시지</ko>
-     * @see {@link Constants.ERROR_CODE ERROR_CODE}
+     * @see {@link ERROR_CODE ERROR_CODE}
      * @example
      * ```ts
      * import Flicking, { FlickingError, ERROR_CODES } from "@egjs/flicking";
@@ -862,10 +886,6 @@ version: 4.7.3
       return FlickingError;
     }(Error);
 
-    /*
-     * Copyright (c) 2015 NAVER Corp.
-     * egjs projects are licensed under the MIT license
-     */
     /**
      * A component that manages viewport size
      * @ko 뷰포트 크기 정보를 담당하는 컴포넌트
@@ -877,7 +897,8 @@ version: 4.7.3
       /**
        * @param el A viewport element<ko>뷰포트 엘리먼트</ko>
        */
-      function Viewport(el) {
+      function Viewport(flicking, el) {
+        this._flicking = flicking;
         this._el = el;
         this._width = 0;
         this._height = 0;
@@ -993,8 +1014,21 @@ version: 4.7.3
       __proto.resize = function () {
         var el = this._el;
         var elStyle = getStyle(el);
-        this._width = el.clientWidth;
-        this._height = el.clientHeight;
+        var useFractionalSize = this._flicking.useFractionalSize;
+        this._width = getElementSize({
+          el: el,
+          horizontal: true,
+          useFractionalSize: useFractionalSize,
+          useOffset: false,
+          style: elStyle
+        });
+        this._height = getElementSize({
+          el: el,
+          horizontal: false,
+          useFractionalSize: useFractionalSize,
+          useOffset: false,
+          style: elStyle
+        });
         this._padding = {
           left: elStyle.paddingLeft ? parseFloat(elStyle.paddingLeft) : 0,
           right: elStyle.paddingRight ? parseFloat(elStyle.paddingRight) : 0,
@@ -1985,8 +2019,15 @@ version: 4.7.3
         var flicking = ctx.flicking,
             axesEvent = ctx.axesEvent,
             transitTo = ctx.transitTo;
+        var targetPanel = this._targetPanel;
+        var control = flicking.control;
         this._delta = 0;
         flicking.control.updateInput();
+
+        if (flicking.changeOnHold && targetPanel) {
+          control.setActive(targetPanel, control.activePanel, axesEvent.isTrusted);
+        }
+
         var holdStartEvent = new Component.ComponentEvent(EVENTS.HOLD_START, {
           axesEvent: axesEvent
         });
@@ -2193,7 +2234,9 @@ version: 4.7.3
         };
 
         this._onAxesChange = function () {
-          _this._dragged = true;
+          var _a;
+
+          _this._dragged = !!((_a = _this._panInput) === null || _a === void 0 ? void 0 : _a.isEnabled());
         };
 
         this._preventClickWhenDragged = function (e) {
@@ -3156,7 +3199,7 @@ version: 4.7.3
         var camera = flicking.camera;
         var activeAnchor = camera.findActiveAnchor();
         var anchorAtCamera = camera.findNearestAnchor(camera.position);
-        var state = flicking.control.controller.state;
+        var state = this._controller.state;
 
         if (!activeAnchor || !anchorAtCamera) {
           return Promise.reject(new FlickingError(MESSAGE.POSITION_NOT_REACHABLE(position), CODE.POSITION_NOT_REACHABLE));
@@ -3174,10 +3217,13 @@ version: 4.7.3
           targetAnchor = this._findSnappedAnchor(position, anchorAtCamera);
         } else if (absPosDelta >= flicking.threshold && absPosDelta > 0) {
           // Move to the adjacent panel
-          targetAnchor = this._findAdjacentAnchor(posDelta, anchorAtCamera);
+          targetAnchor = this._findAdjacentAnchor(position, posDelta, anchorAtCamera);
         } else {
           // Restore to active panel
-          targetAnchor = anchorAtCamera;
+          return this.moveToPanel(activeAnchor.panel, {
+            duration: duration,
+            axesEvent: axesEvent
+          });
         }
 
         this._triggerIndexChangeEvent(targetAnchor.panel, position, axesEvent);
@@ -3248,11 +3294,20 @@ version: 4.7.3
         }
       };
 
-      __proto._findAdjacentAnchor = function (posDelta, anchorAtCamera) {
+      __proto._findAdjacentAnchor = function (position, posDelta, anchorAtCamera) {
         var _a;
 
         var flicking = getFlickingAttached(this._flicking);
         var camera = flicking.camera;
+
+        if (camera.circularEnabled) {
+          var anchorIncludePosition = camera.findAnchorIncludePosition(position);
+
+          if (anchorIncludePosition && anchorIncludePosition.position !== anchorAtCamera.position) {
+            return anchorIncludePosition;
+          }
+        }
+
         var adjacentAnchor = (_a = posDelta > 0 ? camera.getNextAnchor(anchorAtCamera) : camera.getPrevAnchor(anchorAtCamera)) !== null && _a !== void 0 ? _a : anchorAtCamera;
         return adjacentAnchor;
       };
@@ -3598,6 +3653,7 @@ version: 4.7.3
         var axesRange = this._controller.range;
         var indexRange = this._indexRange;
         var cameraRange = camera.range;
+        var state = this._controller.state;
         var clampedPosition = clamp(camera.clampToReachablePosition(position), axesRange[0], axesRange[1]);
         var anchorAtPosition = camera.findAnchorIncludePosition(clampedPosition);
 
@@ -3606,7 +3662,8 @@ version: 4.7.3
         }
 
         var prevPos = activePanel.position;
-        var isOverThreshold = Math.abs(position - prevPos) >= flicking.threshold;
+        var posDelta = flicking.animating ? state.delta : position - camera.position;
+        var isOverThreshold = Math.abs(posDelta) >= flicking.threshold;
         var adjacentAnchor = position > prevPos ? camera.getNextAnchor(anchorAtPosition) : camera.getPrevAnchor(anchorAtPosition);
         var targetPos;
         var targetPanel;
@@ -6045,7 +6102,8 @@ version: 4.7.3
       __proto.resize = function (cached) {
         var el = this.element;
         var flicking = this._flicking;
-        var horizontal = flicking.horizontal;
+        var horizontal = flicking.horizontal,
+            useFractionalSize = flicking.useFractionalSize;
 
         if (cached) {
           this._size = cached.size;
@@ -6053,7 +6111,13 @@ version: 4.7.3
           this._height = cached.height;
         } else {
           var elStyle = getStyle(el);
-          this._size = horizontal ? el.offsetWidth : el.offsetHeight;
+          this._size = getElementSize({
+            el: el,
+            horizontal: horizontal,
+            useFractionalSize: useFractionalSize,
+            useOffset: true,
+            style: elStyle
+          });
           this._margin = horizontal ? {
             prev: parseFloat(elStyle.marginLeft || "0"),
             next: parseFloat(elStyle.marginRight || "0")
@@ -6061,7 +6125,13 @@ version: 4.7.3
             prev: parseFloat(elStyle.marginTop || "0"),
             next: parseFloat(elStyle.marginBottom || "0")
           };
-          this._height = horizontal ? el.offsetHeight : this._size;
+          this._height = horizontal ? getElementSize({
+            el: el,
+            horizontal: false,
+            useFractionalSize: useFractionalSize,
+            useOffset: true,
+            style: elStyle
+          }) : this._size;
         }
 
         this.updatePosition();
@@ -6755,24 +6825,28 @@ version: 4.7.3
             preventClickOnDrag = _0 === void 0 ? true : _0,
             _1 = _b.disableOnInit,
             disableOnInit = _1 === void 0 ? false : _1,
-            _2 = _b.renderOnlyVisible,
-            renderOnlyVisible = _2 === void 0 ? false : _2,
-            _3 = _b.virtual,
-            virtual = _3 === void 0 ? null : _3,
-            _4 = _b.autoInit,
-            autoInit = _4 === void 0 ? true : _4,
-            _5 = _b.autoResize,
-            autoResize = _5 === void 0 ? true : _5,
-            _6 = _b.useResizeObserver,
-            useResizeObserver = _6 === void 0 ? true : _6,
-            _7 = _b.resizeDebounce,
-            resizeDebounce = _7 === void 0 ? 0 : _7,
-            _8 = _b.maxResizeDebounce,
-            maxResizeDebounce = _8 === void 0 ? 100 : _8,
-            _9 = _b.externalRenderer,
-            externalRenderer = _9 === void 0 ? null : _9,
-            _10 = _b.renderExternal,
-            renderExternal = _10 === void 0 ? null : _10;
+            _2 = _b.changeOnHold,
+            changeOnHold = _2 === void 0 ? false : _2,
+            _3 = _b.renderOnlyVisible,
+            renderOnlyVisible = _3 === void 0 ? false : _3,
+            _4 = _b.virtual,
+            virtual = _4 === void 0 ? null : _4,
+            _5 = _b.autoInit,
+            autoInit = _5 === void 0 ? true : _5,
+            _6 = _b.autoResize,
+            autoResize = _6 === void 0 ? true : _6,
+            _7 = _b.useResizeObserver,
+            useResizeObserver = _7 === void 0 ? true : _7,
+            _8 = _b.resizeDebounce,
+            resizeDebounce = _8 === void 0 ? 0 : _8,
+            _9 = _b.maxResizeDebounce,
+            maxResizeDebounce = _9 === void 0 ? 100 : _9,
+            _10 = _b.useFractionalSize,
+            useFractionalSize = _10 === void 0 ? false : _10,
+            _11 = _b.externalRenderer,
+            externalRenderer = _11 === void 0 ? null : _11,
+            _12 = _b.renderExternal,
+            renderExternal = _12 === void 0 ? null : _12;
 
         var _this = _super.call(this) || this; // Internal states
 
@@ -6805,16 +6879,18 @@ version: 4.7.3
         _this._iOSEdgeSwipeThreshold = iOSEdgeSwipeThreshold;
         _this._preventClickOnDrag = preventClickOnDrag;
         _this._disableOnInit = disableOnInit;
+        _this._changeOnHold = changeOnHold;
         _this._renderOnlyVisible = renderOnlyVisible;
         _this._autoInit = autoInit;
         _this._autoResize = autoResize;
         _this._useResizeObserver = useResizeObserver;
         _this._resizeDebounce = resizeDebounce;
         _this._maxResizeDebounce = maxResizeDebounce;
+        _this._useFractionalSize = useFractionalSize;
         _this._externalRenderer = externalRenderer;
         _this._renderExternal = renderExternal; // Create core components
 
-        _this._viewport = new Viewport(getElement(root));
+        _this._viewport = new Viewport(_this, getElement(root));
         _this._autoResizer = new AutoResizer(_this);
         _this._renderer = _this._createRenderer();
         _this._camera = _this._createCamera();
@@ -7561,6 +7637,24 @@ version: 4.7.3
         enumerable: false,
         configurable: true
       });
+      Object.defineProperty(__proto, "changeOnHold", {
+        /**
+         * Change active panel index on mouse/touch hold while animating.
+         * `index` of the `willChange`/`willRestore` event will be used as new index.
+         * @ko 애니메이션 도중 마우스/터치 입력시 현재 활성화된 패널의 인덱스를 변경합니다.
+         * `willChange`/`willRestore` 이벤트의 `index`값이 새로운 인덱스로 사용될 것입니다.
+         * @type {boolean}
+         * @default false
+         */
+        get: function () {
+          return this._changeOnHold;
+        },
+        set: function (val) {
+          this._changeOnHold = val;
+        },
+        enumerable: false,
+        configurable: true
+      });
       Object.defineProperty(__proto, "renderOnlyVisible", {
         // PERFORMANCE
 
@@ -7709,6 +7803,23 @@ version: 4.7.3
         enumerable: false,
         configurable: true
       });
+      Object.defineProperty(__proto, "useFractionalSize", {
+        /**
+         * By enabling this, Flicking will calculate all internal size with CSS width computed with getComputedStyle.
+         * This can prevent 1px offset issue in some cases where panel size has the fractional part.
+         * All sizes will have the original size before CSS {@link https://developer.mozilla.org/en-US/docs/Web/CSS/transform transform} is applied on the element.
+         * @ko 이 옵션을 활성화할 경우, Flicking은 내부의 모든 크기를 {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect getBoundingClientRect}를 이용하여 계산합니다.
+         * 이를 통해, 패널 크기에 소수점을 포함할 경우에 발생할 수 있는 일부 1px 오프셋 이슈를 해결 가능합니다.
+         * 모든 크기는 CSS {@link https://developer.mozilla.org/en-US/docs/Web/CSS/transform transform}이 엘리먼트에 적용되기 이전의 크기를 사용할 것입니다.
+         * @type {boolean}
+         * @default false
+         */
+        get: function () {
+          return this._useFractionalSize;
+        },
+        enumerable: false,
+        configurable: true
+      });
       Object.defineProperty(__proto, "externalRenderer", {
         /**
          * This is an option for the frameworks(React, Vue, Angular, ...). Don't set it as it's automatically managed by Flicking.
@@ -8241,6 +8352,8 @@ version: 4.7.3
                 camera.updateAlignPos();
                 camera.updateRange();
                 camera.updateAnchors();
+                camera.updateAdaptiveHeight();
+                camera.updateOffset();
                 return [4
                 /*yield*/
                 , renderer.render()];
@@ -8518,7 +8631,7 @@ version: 4.7.3
        */
 
 
-      Flicking.VERSION = "4.7.3";
+      Flicking.VERSION = "4.9.0";
       return Flicking;
     }(Component);