@syncfusion/ej2-navigations 31.1.17 → 31.1.20

package/dist/ts/common/v-scroll.ts

@@ -1,454 +0,0 @@
-import { Touch, ScrollEventArgs, TouchEventArgs, Component, EventHandler, selectAll, getUniqueID, removeClass } from '@syncfusion/ej2-base';
-import { NotifyPropertyChanges, INotifyPropertyChanged, Property, Browser, detach, createElement as buildTag } from '@syncfusion/ej2-base';
-import { classList, SwipeEventArgs, isNullOrUndefined } from '@syncfusion/ej2-base';
-import { VScrollModel } from './v-scroll-model';
-
-type HTEle = HTMLElement;
-type Str = string;
-
-const CLS_ROOT: Str = 'e-vscroll';
-const CLS_RTL: Str = 'e-rtl';
-const CLS_DISABLE: Str = 'e-overlay';
-const CLS_VSCROLLBAR: Str = 'e-vscroll-bar';
-const CLS_VSCROLLCON: Str = 'e-vscroll-content';
-const CLS_NAVARROW: Str = 'e-nav-arrow';
-const CLS_NAVUPARROW: Str = 'e-nav-up-arrow';
-const CLS_NAVDOWNARROW: Str = 'e-nav-down-arrow';
-const CLS_VSCROLLNAV: Str = 'e-scroll-nav';
-const CLS_VSCROLLNAVUP: Str = 'e-scroll-up-nav';
-const CLS_VSCROLLNAVDOWN: Str = 'e-scroll-down-nav';
-const CLS_DEVICE: Str = 'e-scroll-device';
-const CLS_OVERLAY: Str = 'e-scroll-overlay';
-const CLS_UPOVERLAY: Str = 'e-scroll-up-overlay';
-const CLS_DOWNOVERLAY: Str = 'e-scroll-down-overlay';
-const OVERLAY_MAXWID: number = 40;
-
-interface TapEventArgs {
-    name: string
-    originalEvent: TouchEventArgs | TouchEvent | KeyboardEvent
-}
-/**
- * VScroll module is introduces vertical scroller when content exceeds the current viewing area.
- * It can be useful for the components like Toolbar, Tab which needs vertical scrolling alone.
- * Hidden content can be view by touch moving or icon click.
- * ```html
- * <div id="scroll"/>
- * <script>
- *   var scrollObj = new VScroll();
- *   scrollObj.appendTo("#scroll");
- * </script>
- * ```
- */
-@NotifyPropertyChanges
-export class VScroll extends Component<HTMLElement> implements INotifyPropertyChanged {
-    private touchModule: Touch;
-    private scrollEle: HTEle;
-    private scrollItems: HTEle;
-    private uniqueId: boolean;
-    private timeout: number;
-    private keyTimeout: boolean;
-    private keyTimer: number;
-    private browser: string;
-    private browserCheck: boolean;
-    private ieCheck: boolean;
-    /* eslint-disable */
-    private isDevice: Boolean;
-    private customStep: boolean;
-
-    /**
-     * Specifies the up or down scrolling distance of the vertical scrollbar moving.
-     *
-     * @default null
-     */
-    @Property(null)
-    public scrollStep: number;
-    /**
-     * Initialize the event handler
-     *
-     * @private
-     * @returns {void}
-     */
-    protected preRender(): void {
-        this.browser = Browser.info.name;
-        this.browserCheck = this.browser === 'mozilla';
-        this.isDevice = Browser.isDevice;
-        this.customStep = true;
-        const ele: HTEle = this.element;
-        this.ieCheck = this.browser === 'edge' || this.browser === 'msie';
-        this.initialize();
-        if (ele.id === '') {
-            ele.id = getUniqueID('vscroll');
-            this.uniqueId = true;
-        }
-        ele.style.display = 'block';
-        if (this.enableRtl) {
-            ele.classList.add(CLS_RTL);
-        }
-    }
-    /**
-     * To Initialize the vertical scroll rendering
-     *
-     * @private
-     * @returns {void}
-     */
-    protected render(): void {
-        this.touchModule = new Touch(this.element, { scroll: this.touchHandler.bind(this), swipe: this.swipeHandler.bind(this) });
-        EventHandler.add(this.scrollEle, 'scroll', this.scrollEventHandler, this);
-        if (!this.isDevice) {
-            this.createNavIcon(this.element);
-        } else {
-            this.element.classList.add(CLS_DEVICE);
-            this.createOverlayElement(this.element);
-        }
-        this.setScrollState();
-        EventHandler.add(this.element, 'wheel', this.wheelEventHandler, this);
-    }
-    private setScrollState(): void {
-        if (isNullOrUndefined(this.scrollStep) || this.scrollStep < 0) {
-            this.scrollStep = this.scrollEle.offsetHeight;
-            this.customStep = false;
-        } else {
-            this.customStep = true;
-        }
-    }
-    /**
-     * Initializes a new instance of the VScroll class.
-     *
-     * @param {VScrollModel} options  - Specifies VScroll model properties as options.
-     * @param {string | HTMLElement} element  - Specifies the element for which vertical scrolling applies.
-     */
-    public constructor(options?: VScrollModel, element?: string | HTMLElement) {
-        super(options, <HTEle | string>element);
-    }
-    private initialize(): void {
-        const scrollCnt: HTEle = buildTag('div', { className: CLS_VSCROLLCON });
-        const scrollBar: HTEle = buildTag('div', { className: CLS_VSCROLLBAR });
-        scrollBar.setAttribute('tabindex', '-1');
-        const ele: HTEle = this.element;
-        const innerEle: HTEle[] = [].slice.call(ele.children);
-        for (const ele of innerEle) {
-            scrollCnt.appendChild(ele);
-        }
-        scrollBar.appendChild(scrollCnt);
-        ele.appendChild(scrollBar);
-        scrollBar.style.overflow = 'hidden';
-        this.scrollEle = scrollBar;
-        this.scrollItems = scrollCnt;
-    }
-    protected getPersistData(): string {
-        const keyEntity: string[] = ['scrollStep'];
-        return this.addOnPersist(keyEntity);
-    }
-    /**
-     * Returns the current module name.
-     *
-     * @returns {string} - It returns the current module name.
-     * @private
-     */
-    protected getModuleName(): string {
-        return 'vScroll';
-    }
-    /**
-     * Removes the control from the DOM and also removes all its related events.
-     *
-     * @returns {void}
-     */
-    public destroy(): void {
-        const el: HTEle = this.element;
-        el.style.display = '';
-        removeClass([this.element], [CLS_ROOT, CLS_DEVICE, CLS_RTL]);
-        const navs: HTEle[] = selectAll('.e-' + el.id + '_nav.' + CLS_VSCROLLNAV, el);
-        const overlays: HTEle[] = selectAll('.' + CLS_OVERLAY, el);
-        [].slice.call(overlays).forEach((ele: HTMLElement) => {
-            detach(ele);
-        });
-        for (const elem of [].slice.call(this.scrollItems.children)) {
-            el.appendChild(elem);
-        }
-        if (this.uniqueId) {
-            this.element.removeAttribute('id');
-        }
-        detach(this.scrollEle);
-        if (navs.length > 0) {
-            detach(navs[0]);
-            if (!isNullOrUndefined(navs[1])) {
-                detach(navs[1]);
-            }
-        }
-        EventHandler.remove(this.scrollEle, 'scroll', this.scrollEventHandler);
-        this.touchModule.destroy();
-        this.touchModule = null;
-        super.destroy();
-    }
-    /**
-     * Specifies the value to disable/enable the VScroll component.
-     * When set to `true` , the component will be disabled.
-     *
-     * @param  {boolean} value - Based on this Boolean value, VScroll will be enabled (false) or disabled (true).
-     * @returns {void}.
-     */
-    public disable(value: boolean): void {
-        const navEle: HTMLElement[] = selectAll('.e-scroll-nav:not(.' + CLS_DISABLE + ')', this.element);
-        if (value) {
-            this.element.classList.add(CLS_DISABLE);
-        } else {
-            this.element.classList.remove(CLS_DISABLE);
-        }
-        [].slice.call(navEle).forEach((el: HTMLElement) => {
-            el.setAttribute('tabindex', !value ? '0' : '-1');
-        });
-    }
-    private createOverlayElement(element: HTEle): void {
-        const id: string = element.id.concat('_nav');
-        const downOverlayEle: HTEle = buildTag('div', { className: CLS_OVERLAY + ' ' + CLS_DOWNOVERLAY });
-        const clsDown: string = 'e-' + element.id.concat('_nav ' + CLS_VSCROLLNAV + ' ' + CLS_VSCROLLNAVDOWN);
-        const downEle: HTEle = buildTag('div', { id: id.concat('down'), className: clsDown });
-        const navItem: HTEle = buildTag('div', { className: CLS_NAVDOWNARROW + ' ' + CLS_NAVARROW + ' e-icons' });
-        downEle.appendChild(navItem);
-        const upEle: HTEle = buildTag('div', { className: CLS_OVERLAY + ' ' + CLS_UPOVERLAY });
-        if (this.ieCheck) {
-            downEle.classList.add('e-ie-align');
-        }
-        element.appendChild(downOverlayEle);
-        element.appendChild(downEle);
-        element.insertBefore(upEle, element.firstChild);
-        this.eventBinding([downEle]);
-    }
-    private createNavIcon(element: HTEle): void {
-        const id: string = element.id.concat('_nav');
-        const clsDown: string = 'e-' + element.id.concat('_nav ' + CLS_VSCROLLNAV + ' ' + CLS_VSCROLLNAVDOWN);
-        const nav: HTEle = buildTag('div', { id: id.concat('_down'), className: clsDown });
-        nav.setAttribute('aria-disabled', 'false');
-        const navItem: HTEle = buildTag('div', { className: CLS_NAVDOWNARROW + ' ' + CLS_NAVARROW + ' e-icons' });
-        const clsUp: string = 'e-' + element.id.concat('_nav ' + CLS_VSCROLLNAV + ' ' + CLS_VSCROLLNAVUP);
-        const navElement: HTEle = buildTag('div', { id: id.concat('_up'), className: clsUp + ' ' + CLS_DISABLE });
-        navElement.setAttribute('aria-disabled', 'true');
-        const navUpItem: HTEle = buildTag('div', { className: CLS_NAVUPARROW + ' ' + CLS_NAVARROW + ' e-icons' });
-        navElement.appendChild(navUpItem);
-        nav.appendChild(navItem);
-        nav.setAttribute('tabindex', '0');
-        element.appendChild(nav);
-        element.insertBefore(navElement, element.firstChild);
-        if (this.ieCheck) {
-            nav.classList.add('e-ie-align');
-            navElement.classList.add('e-ie-align');
-        }
-        this.eventBinding([nav, navElement]);
-    }
-    private onKeyPress(ev: KeyboardEvent): void {
-        if (ev.key === 'Enter') {
-            const timeoutFun: () => void = () => {
-                this.keyTimeout = true;
-                this.eleScrolling(10, <HTEle>ev.target, true);
-            };
-            this.keyTimer = window.setTimeout(() => {
-                timeoutFun();
-            }, 100);
-        }
-    }
-    private onKeyUp(ev: KeyboardEvent): void {
-        if (ev.key !== 'Enter') {
-            return;
-        }
-        if (this.keyTimeout) {
-            this.keyTimeout = false;
-        } else {
-            (<HTEle>ev.target).click();
-        }
-        clearTimeout(this.keyTimer);
-    }
-    private eventBinding(element: HTEle[]): void {
-        [].slice.call(element).forEach((ele: HTEle) => {
-            new Touch(ele, { tapHold: this.tabHoldHandler.bind(this), tapHoldThreshold: 500 });
-            ele.addEventListener('keydown', this.onKeyPress.bind(this));
-            ele.addEventListener('keyup', this.onKeyUp.bind(this));
-            ele.addEventListener('mouseup', this.repeatScroll.bind(this));
-            ele.addEventListener('touchend', this.repeatScroll.bind(this));
-            ele.addEventListener('contextmenu', (e: Event) => {
-                e.preventDefault();
-            });
-            EventHandler.add(ele, 'click', this.clickEventHandler, this);
-        });
-    }
-    private repeatScroll(): void {
-        clearInterval(this.timeout);
-    }
-    private tabHoldHandler(ev: TapEventArgs): void {
-        let trgt: HTEle = ev.originalEvent.target as HTEle;
-        trgt = this.contains(trgt, CLS_VSCROLLNAV) ? <HTEle>trgt.firstElementChild : trgt;
-        const scrollDistance: number = 10;
-        const timeoutFun: () => void = () => {
-            this.eleScrolling(scrollDistance, trgt, true);
-        };
-        this.timeout = window.setInterval(() => {
-            timeoutFun();
-        }, 50);
-    }
-    private contains(element: HTEle, className: string): boolean {
-        return element.classList.contains(className);
-    }
-    private eleScrolling(scrollDis: number, trgt: HTEle, isContinuous: boolean): void {
-        let classList: DOMTokenList = trgt.classList;
-        if (classList.contains(CLS_VSCROLLNAV)) {
-            classList = trgt.querySelector('.' + CLS_NAVARROW).classList;
-        }
-        if (classList.contains(CLS_NAVDOWNARROW)) {
-            this.frameScrollRequest(scrollDis, 'add', isContinuous);
-        } else if (classList.contains(CLS_NAVUPARROW)) {
-            this.frameScrollRequest(scrollDis, '', isContinuous);
-        }
-    }
-    private clickEventHandler(event: Event): void {
-        this.eleScrolling(this.scrollStep, <HTEle>event.target, false);
-    }
-    private wheelEventHandler(e: WheelEvent): void {
-        e.preventDefault();
-        this.frameScrollRequest(this.scrollStep, (e.deltaY > 0 ? 'add' : ''), false);
-    }
-
-    private swipeHandler(e: SwipeEventArgs): void {
-        const swipeElement: HTEle = this.scrollEle;
-        let distance: number;
-        if (e.velocity <= 1) {
-            distance = e.distanceY / (e.velocity * 10);
-        } else {
-            distance = e.distanceY / e.velocity;
-        }
-        let start: number = 0.5;
-        const animate: () => void = () => {
-            const step: number = Math.sin(start);
-            if (step <= 0) {
-                window.cancelAnimationFrame(step);
-            } else {
-                if (e.swipeDirection === 'Up') {
-                    swipeElement.scrollTop += distance * step;
-                } else if (e.swipeDirection === 'Down') {
-                    swipeElement.scrollTop -= distance * step;
-                }
-                start -= 0.02;
-                window.requestAnimationFrame(animate as FrameRequestCallback);
-            }
-        };
-        animate();
-    }
-
-    private scrollUpdating(scrollVal: number, action: string): void {
-        if (action === 'add') {
-            this.scrollEle.scrollTop += scrollVal;
-        } else {
-            this.scrollEle.scrollTop -= scrollVal;
-        }
-    }
-
-    private frameScrollRequest(scrollValue: number, action: string, isContinuous: boolean): void {
-        const step: number = 10;
-        if (isContinuous) {
-            this.scrollUpdating(scrollValue, action);
-            return;
-        }
-        if (!this.customStep) {
-            [].slice.call(selectAll('.' + CLS_OVERLAY, this.element)).forEach((el: HTMLElement) => {
-                scrollValue -= el.offsetHeight;
-            });
-        }
-        const animate:  () => void = () => {
-            if (scrollValue < step) {
-                window.cancelAnimationFrame(step);
-            } else {
-                this.scrollUpdating(step, action);
-                scrollValue -= step;
-                window.requestAnimationFrame(animate as FrameRequestCallback);
-            }
-        };
-        animate();
-    }
-
-    private touchHandler(e: ScrollEventArgs): void {
-        const el: HTEle = this.scrollEle;
-        const distance: number = e.distanceY;
-        if (e.scrollDirection === 'Up') {
-            el.scrollTop = el.scrollTop + distance;
-        } else if (e.scrollDirection === 'Down') {
-            el.scrollTop = el.scrollTop - distance;
-        }
-    }
-    private arrowDisabling(addDisableCls: HTEle, removeDisableCls: HTEle): void {
-        if (this.isDevice) {
-            const arrowEle: HTMLElement = isNullOrUndefined(addDisableCls) ? removeDisableCls : addDisableCls;
-            const arrowIcon: HTMLElement = arrowEle.querySelector('.' + CLS_NAVARROW) as HTMLElement;
-            if (isNullOrUndefined(addDisableCls)) {
-                classList(arrowIcon, [CLS_NAVDOWNARROW], [CLS_NAVUPARROW]);
-            } else {
-                classList(arrowIcon, [CLS_NAVUPARROW], [CLS_NAVDOWNARROW]);
-            }
-        } else {
-            addDisableCls.classList.add(CLS_DISABLE);
-            addDisableCls.setAttribute('aria-disabled', 'true');
-            addDisableCls.removeAttribute('tabindex');
-            removeDisableCls.classList.remove(CLS_DISABLE);
-            removeDisableCls.setAttribute('aria-disabled', 'false');
-            removeDisableCls.setAttribute('tabindex', '0');
-        }
-        this.repeatScroll();
-    }
-    private scrollEventHandler(e: Event): void {
-        const target: HTEle = <HTEle>e.target;
-        const height: number = target.offsetHeight;
-        const navUpEle: HTEle = (<HTEle>this.element.querySelector('.' + CLS_VSCROLLNAVUP));
-        const navDownEle: HTEle = (<HTEle>this.element.querySelector('.' + CLS_VSCROLLNAVDOWN));
-        const upOverlay: HTEle = (<HTEle>this.element.querySelector('.' + CLS_UPOVERLAY));
-        const downOverlay: HTEle = (<HTEle>this.element.querySelector('.' + CLS_DOWNOVERLAY));
-        let scrollTop: number = target.scrollTop;
-        if (scrollTop <= 0) {
-            scrollTop = -scrollTop;
-        }
-        if (this.isDevice) {
-            if (scrollTop < OVERLAY_MAXWID) {
-                upOverlay.style.height = scrollTop + 'px';
-            } else {
-                upOverlay.style.height = '40px';
-            }
-            if ((target.scrollHeight - Math.ceil(height + scrollTop)) < OVERLAY_MAXWID) {
-                downOverlay.style.height = (target.scrollHeight - Math.ceil(height + scrollTop)) + 'px';
-            } else {
-                downOverlay.style.height = '40px';
-            }
-        }
-        if (scrollTop === 0) {
-            this.arrowDisabling(navUpEle, navDownEle);
-        } else if (Math.ceil(height + scrollTop + .1) >= target.scrollHeight) {
-            this.arrowDisabling(navDownEle, navUpEle);
-        } else {
-            const disEle: HTEle = <HTEle>this.element.querySelector('.' + CLS_VSCROLLNAV + '.' + CLS_DISABLE);
-            if (disEle) {
-                disEle.classList.remove(CLS_DISABLE);
-                disEle.setAttribute('aria-disabled', 'false');
-                disEle.setAttribute('tabindex', '0');
-            }
-        }
-    }
-    /**
-     * Gets called when the model property changes.The data that describes the old and new values of property that changed.
-     *
-     * @param  {VScrollModel} newProp - It contains the new value of data.
-     * @param  {VScrollModel} oldProp - It contains the old value of data.
-     * @returns {void}
-     * @private
-     */
-    public onPropertyChanged(newProp: VScrollModel, oldProp: VScrollModel): void {
-        for (const prop of Object.keys(newProp)) {
-            switch (prop) {
-            case 'scrollStep':
-                this.setScrollState();
-                break;
-            case 'enableRtl':
-                if (newProp.enableRtl) {
-                    this.element.classList.add(CLS_RTL);
-                } else {
-                    this.element.classList.remove(CLS_RTL);
-                }
-                break;
-            }
-        }
-    }
-}

package/dist/ts/context-menu/context-menu-model.d.ts

@@ -1,47 +0,0 @@
-import { attributes, getUniqueID, Collection, NotifyPropertyChanges, INotifyPropertyChanged, Property, removeClass, isNullOrUndefined, addClass } from '@syncfusion/ej2-base';import { getZindexPartial } from '@syncfusion/ej2-popups';import { MenuBase, MenuItem } from '../common/menu-base';import { MenuItemModel } from './../common/menu-base-model';
-import {MenuBaseModel} from "../common/menu-base-model";
-
-/**
- * Interface for a class ContextMenu
- */
-export interface ContextMenuModel extends MenuBaseModel{
-
-    /**
-     * Specifies target element selector in which the ContextMenu should be opened.
-     *
-     * @default ''
-     */
-    target?: string;
-
-    /**
-     * Specifies the filter selector for elements inside the target in that the context menu will be opened.
-     *
-     * @default ''
-     */
-    filter?: string;
-
-    /**
-     * Specifies menu items with its properties which will be rendered as ContextMenu.
-     *
-     * @default []
-     * @aspType object
-     * @blazorType object
-     */
-    items?: MenuItemModel[];
-
-    /**
-     * This property allows you to define custom templates for items in the ContextMenu.
-     *
-     * @default null
-     * @aspType string
-     */
-    itemTemplate?: string | Function;
-
-    /**
-     * Specifies whether to enable / disable the scrollable option in ContextMenu.
-     *
-     * @default false
-     */
-    enableScrolling?: boolean;
-
-}

package/dist/ts/context-menu/context-menu.d.ts

@@ -1,102 +0,0 @@
-/// <reference path="../common/menu-base-model.d.ts" />
-import { INotifyPropertyChanged } from '@syncfusion/ej2-base';
-import { ContextMenuModel } from './context-menu-model';
-import { MenuBase } from '../common/menu-base';
-import { MenuItemModel } from './../common/menu-base-model';
-/**
- * The ContextMenu is a graphical user interface that appears on the user right click/touch hold operation.
- * ```html
- * <div id = 'target'></div>
- * <ul id = 'contextmenu'></ul>
- * ```
- * ```typescript
- * <script>
- * var contextMenuObj = new ContextMenu({items: [{ text: 'Cut' }, { text: 'Copy' },{ text: 'Paste' }], target: '#target'});
- * </script>
- * ```
- */
-export declare class ContextMenu extends MenuBase implements INotifyPropertyChanged {
-    /**
-     * Constructor for creating the widget.
-     *
-     * @private
-     * @param {ContextMenuModel} options - Specifies the context menu model
-     * @param {string} element - Specifies the element
-     */
-    constructor(options?: ContextMenuModel, element?: string | HTMLUListElement);
-    /**
-     * Specifies target element selector in which the ContextMenu should be opened.
-     *
-     * @default ''
-     */
-    target: string;
-    /**
-     * Specifies the filter selector for elements inside the target in that the context menu will be opened.
-     *
-     * @default ''
-     */
-    filter: string;
-    /**
-     * Specifies menu items with its properties which will be rendered as ContextMenu.
-     *
-     * @default []
-     * @aspType object
-     * @blazorType object
-     */
-    items: MenuItemModel[];
-    /**
-     * This property allows you to define custom templates for items in the ContextMenu.
-     *
-     * @default null
-     * @aspType string
-     */
-    itemTemplate: string | Function;
-    /**
-     * Specifies whether to enable / disable the scrollable option in ContextMenu.
-     *
-     * @default false
-     */
-    enableScrolling: boolean;
-    /**
-     * For internal use only - prerender processing.
-     *
-     * @private
-     * @returns {void}
-     */
-    protected preRender(): void;
-    protected initialize(): void;
-    /**
-     * This method is used to open the ContextMenu in specified position.
-     *
-     * @param {number} top - To specify ContextMenu vertical positioning.
-     * @param {number} left - To specify ContextMenu horizontal positioning.
-     * @param {HTMLElement} target - To calculate z-index for ContextMenu based upon the specified target.
-     * @function open
-     * @returns {void}
-     */
-    open(top: number, left: number, target?: HTMLElement): void;
-    /**
-     * Closes the ContextMenu if it is opened.
-     *
-     * @function close
-     * @returns {void}
-     */
-    close(): void;
-    private addTemplateClass;
-    /**
-     * Called internally if any of the property value changed.
-     *
-     * @private
-     * @param {ContextMenuModel} newProp - Specifies new properties
-     * @param {ContextMenuModel} oldProp - Specifies old properties
-     * @returns {void}
-     */
-    onPropertyChanged(newProp: ContextMenuModel, oldProp: ContextMenuModel): void;
-    /**
-     * Get module name.
-     *
-     * @returns {string} - Module Name
-     * @private
-     */
-    protected getModuleName(): string;
-}