@egjs/flicking 4.11.0 → 4.11.2-beta.0

package/declaration/camera/Camera.d.ts

@@ -1,6 +1,7 @@
 import Flicking, { FlickingOptions } from "../Flicking";
 import Panel from "../core/panel/Panel";
 import AnchorPoint from "../core/AnchorPoint";
+import { ValueOf } from "../type/internal";
 import { CameraMode } from "./mode";
 export interface CameraOptions {
     align: FlickingOptions["align"];
@@ -20,6 +21,7 @@ declare class Camera {
     private _visiblePanels;
     private _anchors;
     private _needPanelTriggered;
+    private _panelOrder;
     get element(): HTMLElement;
     get children(): HTMLElement[];
     get position(): number;
@@ -49,6 +51,10 @@ declare class Camera {
     get atEdge(): boolean;
     get size(): number;
     get progress(): number;
+    get panelOrder(): ValueOf<{
+        readonly LTR: "ltr";
+        readonly RTL: "rtl";
+    }>;
     get align(): FlickingOptions["align"];
     set align(val: FlickingOptions["align"]);
     constructor(flicking: Flicking, { align }?: Partial<CameraOptions>);
@@ -69,6 +75,7 @@ declare class Camera {
     updateAnchors(): this;
     updateAdaptiveHeight(): void;
     updateOffset(): this;
+    updatePanelOrder(): this;
     resetNeedPanelHistory(): this;
     applyTransform(): this;
     private _resetInternalValues;

package/declaration/const/external.d.ts

@@ -42,3 +42,7 @@ export declare const CIRCULAR_FALLBACK: {
     readonly LINEAR: "linear";
     readonly BOUND: "bound";
 };
+export declare const ORDER: {
+    readonly LTR: "ltr";
+    readonly RTL: "rtl";
+};

package/declaration/control/Control.d.ts

@@ -8,6 +8,7 @@ declare abstract class Control {
     protected _flicking: Flicking | null;
     protected _controller: AxesController;
     protected _activePanel: Panel | null;
+    protected _nextPanel: Panel | null;
     get controller(): AxesController;
     get activeIndex(): number;
     get activePanel(): Panel;

package/dist/flicking.cjs.js

@@ -4,7 +4,7 @@ name: @egjs/flicking
 license: MIT
 author: NAVER Corp.
 repository: https://github.com/naver/egjs-flicking
-version: 4.11.0
+version: 4.11.2-beta.0
 */
 'use strict';
 
@@ -398,6 +398,17 @@ var CIRCULAR_FALLBACK = {
   LINEAR: "linear",
   BOUND: "bound"
 };
+/**
+ * An object for identifying {@link https://developer.mozilla.org/en-US/docs/Web/CSS/direction direction} CSS property applied to the camera element(`.flicking-camera`)
+ * @ko 카메라 엘리먼트(`.flicking-camera`)에 적용된 {@link https://developer.mozilla.org/en-US/docs/Web/CSS/direction direction} CSS 속성을 구분하기 위한 객체
+ * @type {object}
+ * @property {string} LTR "ltr"
+ * @property {string} RTL "rtl"
+ */
+var ORDER = {
+  LTR: "ltr",
+  RTL: "rtl"
+};
 
 // eslint-disable-next-line @typescript-eslint/ban-types
 var merge = function (target) {
@@ -691,20 +702,22 @@ var getElementSize = function (_a) {
     useFractionalSize = _a.useFractionalSize,
     useOffset = _a.useOffset,
     style = _a.style;
+  var size = 0;
   if (useFractionalSize) {
-    var baseSize = parseFloat(horizontal ? style.width : style.height);
+    var baseSize = parseFloat(horizontal ? style.width : style.height) || 0;
     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;
+      size = 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;
+      size = useOffset ? baseSize + padding + border : baseSize + padding;
     }
   } else {
     var sizeStr = horizontal ? "Width" : "Height";
-    return useOffset ? el["offset" + sizeStr] : el["client" + sizeStr];
+    size = useOffset ? el["offset" + sizeStr] : el["client" + sizeStr];
   }
+  return Math.max(size, 0);
 };
 var setPrototypeOf = Object.setPrototypeOf || function (obj, proto) {
   obj.__proto__ = proto;
@@ -2088,7 +2101,7 @@ var AxesController = /*#__PURE__*/function () {
       threshold: 1,
       iOSEdgeSwipeThreshold: flicking.iOSEdgeSwipeThreshold,
       preventDefaultOnDrag: flicking.preventDefaultOnDrag,
-      scale: flicking.horizontal ? [-1, 0] : [0, -1],
+      scale: flicking.horizontal ? [flicking.camera.panelOrder === ORDER.RTL ? 1 : -1, 0] : [0, -1],
       releaseOnScroll: true
     });
     var axes = this._axes;
@@ -2313,7 +2326,7 @@ var AxesController = /*#__PURE__*/function () {
     var panInput = this._panInput;
     axes.disconnect(panInput);
     axes.connect(flicking.horizontal ? [POSITION_KEY, ""] : ["", POSITION_KEY], panInput);
-    panInput.options.scale = flicking.horizontal ? [-1, 0] : [0, -1];
+    panInput.options.scale = flicking.horizontal ? [flicking.camera.panelOrder === ORDER.RTL ? 1 : -1, 0] : [0, -1];
   };
   __proto._resetInternalValues = function () {
     this._flicking = null;
@@ -2595,6 +2608,7 @@ var Control = /*#__PURE__*/function () {
     var _a;
     var flicking = getFlickingAttached(this._flicking);
     this._activePanel = newActivePanel;
+    this._nextPanel = null;
     flicking.camera.updateAdaptiveHeight();
     if (newActivePanel !== prevActivePanel) {
       flicking.trigger(new Component.ComponentEvent(EVENTS.CHANGED, {
@@ -2631,6 +2645,7 @@ var Control = /*#__PURE__*/function () {
       isTrusted: (axesEvent === null || axesEvent === void 0 ? void 0 : axesEvent.isTrusted) || false,
       direction: getDirection((_a = activePanel === null || activePanel === void 0 ? void 0 : activePanel.position) !== null && _a !== void 0 ? _a : camera.position, position)
     });
+    this._nextPanel = panel;
     flicking.trigger(event);
     if (event.isCanceled()) {
       throw new FlickingError(MESSAGE.STOP_CALLED_BY_USER, CODE.STOP_CALLED_BY_USER);
@@ -3218,19 +3233,20 @@ var StrictControl = /*#__PURE__*/function (_super) {
    * @return {Promise<void>} A Promise which will be resolved after reaching the target position<ko>해당 좌표 도달시에 resolve되는 Promise</ko>
    */
   __proto.moveToPosition = function (position, duration, axesEvent) {
+    var _a;
     var flicking = getFlickingAttached(this._flicking);
     var camera = flicking.camera;
-    var activePanel = this._activePanel;
+    var currentPanel = (_a = this._nextPanel) !== null && _a !== void 0 ? _a : this._activePanel;
     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);
-    if (!anchorAtPosition || !activePanel) {
+    if (!anchorAtPosition || !currentPanel) {
       return Promise.reject(new FlickingError(MESSAGE.POSITION_NOT_REACHABLE(position), CODE.POSITION_NOT_REACHABLE));
     }
-    var prevPos = activePanel.position;
+    var prevPos = currentPanel.position;
     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);
@@ -3247,7 +3263,7 @@ var StrictControl = /*#__PURE__*/function (_super) {
       var targetAnchor = position < cameraRange.min ? firstAnchor : lastAnchor;
       targetPanel = targetAnchor.panel;
       targetPos = targetAnchor.position;
-    } else if (isOverThreshold && anchorAtPosition.position !== activePanel.position) {
+    } else if (isOverThreshold && anchorAtPosition.position !== currentPanel.position) {
       // Move to anchor at position
       targetPanel = anchorAtPosition.panel;
       targetPos = anchorAtPosition.position;
@@ -3985,6 +4001,19 @@ var Camera = /*#__PURE__*/function () {
     enumerable: false,
     configurable: true
   });
+  Object.defineProperty(__proto, "panelOrder", {
+    /**
+     * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/direction direction} CSS property applied to the camera element(`.flicking-camera`)
+     * @ko 카메라 엘리먼트(`.flicking-camera`)에 적용된 {@link https://developer.mozilla.org/en-US/docs/Web/CSS/direction direction} CSS 속성
+     * @type {string}
+     * @readonly
+     */
+    get: function () {
+      return this._panelOrder;
+    },
+    enumerable: false,
+    configurable: true
+  });
   Object.defineProperty(__proto, "align", {
     // Options Getter
     /**
@@ -4016,6 +4045,7 @@ var Camera = /*#__PURE__*/function () {
     this._el = viewportEl.firstElementChild;
     this._checkTranslateSupport();
     this._updateMode();
+    this.updatePanelOrder();
     return this;
   };
   /**
@@ -4258,6 +4288,24 @@ var Camera = /*#__PURE__*/function () {
     this.applyTransform();
     return this;
   };
+  /**
+   * Update direction to match the {@link https://developer.mozilla.org/en-US/docs/Web/CSS/direction direction} CSS property applied to the camera element
+   * @ko 카메라 엘리먼트에 적용된 {@link https://developer.mozilla.org/en-US/docs/Web/CSS/direction direction} CSS 속성에 맞게 방향을 업데이트합니다
+   * @return {this}
+   */
+  __proto.updatePanelOrder = function () {
+    var flicking = getFlickingAttached(this._flicking);
+    if (!flicking.horizontal) return this;
+    var el = this._el;
+    var direction = getStyle(el).direction;
+    if (direction !== this._panelOrder) {
+      this._panelOrder = direction === ORDER.RTL ? ORDER.RTL : ORDER.LTR;
+      if (flicking.initialized) {
+        flicking.control.controller.updateDirection();
+      }
+    }
+    return this;
+  };
   /**
    * Reset the history of {@link Flicking#event:needPanel needPanel} events so it can be triggered again
    * @ko 발생한 {@link Flicking#event:needPanel needPanel} 이벤트들을 초기화하여 다시 발생할 수 있도록 합니다
@@ -4282,7 +4330,7 @@ var Camera = /*#__PURE__*/function () {
     var renderer = flicking.renderer;
     if (renderer.rendering || !flicking.initialized) return this;
     var actualPosition = this._position - this._alignPos - this._offset + this._circularOffset;
-    el.style[this._transform] = flicking.horizontal ? "translate(" + -actualPosition + "px)" : "translate(0, " + -actualPosition + "px)";
+    el.style[this._transform] = flicking.horizontal ? "translate(" + (this._panelOrder === ORDER.RTL ? actualPosition : -actualPosition) + "px)" : "translate(0, " + -actualPosition + "px)";
     return this;
   };
   __proto._resetInternalValues = function () {
@@ -7535,6 +7583,7 @@ var Flicking = /*#__PURE__*/function (_super) {
             camera.updateRange();
             camera.updateAnchors();
             camera.updateAdaptiveHeight();
+            camera.updatePanelOrder();
             camera.updateOffset();
             return [4 /*yield*/, renderer.render()];
           case 2:
@@ -7775,7 +7824,7 @@ var Flicking = /*#__PURE__*/function (_super) {
    * Flicking.VERSION;  // ex) 4.0.0
    * ```
    */
-  Flicking.VERSION = "4.11.0";
+  Flicking.VERSION = "4.11.2-beta.0";
   return Flicking;
 }(Component);
 
@@ -8032,6 +8081,7 @@ var modules = {
     MOVE_TYPE: MOVE_TYPE,
     CLASS: CLASS,
     CIRCULAR_FALLBACK: CIRCULAR_FALLBACK,
+    ORDER: ORDER,
     withFlickingMethods: withFlickingMethods,
     sync: sync,
     getRenderingPanels: getRenderingPanels,
@@ -8099,6 +8149,7 @@ exports.IdleState = IdleState;
 exports.LinearCameraMode = LinearCameraMode;
 exports.MOVE_TYPE = MOVE_TYPE;
 exports.NormalRenderingStrategy = NormalRenderingStrategy;
+exports.ORDER = ORDER;
 exports.Panel = Panel;
 exports.Renderer = Renderer;
 exports.SnapControl = SnapControl;