simple-bookreader/client/islets/core/y-dom/y-dom.js

modules.define(
    'y-dom',
    ['jquery', 'y-block'],
    function (provide, $, YBlock) {

    /**
     * @name yDom
     */
    provide({
        /**
         * Отсоединяет фрагмент DOM-дерева от документа.
         * Сохраняет слушатели событий и данные (jQuery data).
         *
         * @name yDom.detach
         * @param {jQuery|HTMLElement|YBlock} domNode
         */
        detach: function (domNode) {
            domNode = this._getDomElement(domNode);
            var l = domNode.length;
            for (var i = 0; i < l; i++) {
                var node = domNode[i];
                if (node.parentNode) {
                    node.parentNode.removeChild(node);
                }
            }
        },

        /**
         * Заменяет один DOM-фрагмент другим.
         *
         * @name yDom.replace
         * @param {jQuery|HTMLElement|YBlock} replaceWhat
         * @param {jQuery|HTMLElement|YBlock} replaceWith
         */
        replace: function (replaceWhat, replaceWith) {
            replaceWhat = this._getDomElement(replaceWhat);
            replaceWith = this._getDomElement(replaceWith);
            replaceWith.insertBefore(replaceWhat);
            this.detach(replaceWhat);
        },

        /**
         * Вставляет `domNode` перед `sourceDomNode`.
         *
         * @name yDom.insertBefore
         * @param {jQuery|HTMLElement|YBlock} domNode
         * @param {jQuery|HTMLElement|YBlock} sourceDomNode
         */
        insertBefore: function (domNode, sourceDomNode) {
            domNode = this._getDomElement(domNode);
            sourceDomNode = this._getDomElement(sourceDomNode);
            sourceDomNode.insertBefore(domNode);
        },

        /**
         * Вставляет `domNode` после `sourceDomNode`.
         *
         * @name yDom.insertAfter
         * @param {jQuery|HTMLElement|YBlock} domNode
         * @param {jQuery|HTMLElement|YBlock} sourceDomNode
         */
        insertAfter: function (domNode, sourceDomNode) {
            domNode = this._getDomElement(domNode);
            sourceDomNode = this._getDomElement(sourceDomNode);
            sourceDomNode.insertAfter(domNode);
        },

        /**
         * Добавляет `domNode` в конец `parentDomNode`.
         *
         * @name yDom.append
         * @param {jQuery|HTMLElement} parentDomNode
         * @param {jQuery|HTMLElement|YBlock} domNode
         */
        append: function (parentDomNode, domNode) {
            parentDomNode = $(parentDomNode);
            parentDomNode.append(this._getDomElement(domNode));
        },

        /**
         * Добавляет `domNode` в начало `parentDomNode`.
         *
         * @name yDom.prepend
         * @param {jQuery|HTMLElement} parentDomNode
         * @param {jQuery|HTMLElement|YBlock} domNode
         */
        prepend: function (parentDomNode, domNode) {
            parentDomNode = $(parentDomNode);
            parentDomNode.prepend(this._getDomElement(domNode));
        },

        /**
         * Заменяет содержимое `parentDomNode` фрагментом `domNode`.
         *
         * @name yDom.replaceContents
         * @param {jQuery|HTMLElement} parentDomNode
         * @param {jQuery|HTMLElement|YBlock} domNode
         */
        replaceContents: function (parentDomNode, domNode) {
            parentDomNode = $(parentDomNode);
            domNode = this._getDomElement(domNode);
            var contents = parentDomNode.contents();
            if (contents.length) {
                this.replace(contents, domNode);
            } else {
                parentDomNode.append(domNode);
            }
        },

        /**
         * Возвращает jQuery-элемент для переданного `HTML`/`jQuery`/`YBlock`/`String`-представления элемента.
         *
         * @param {jQuery|HTMLElement|YBlock|String} domNode
         * @returns {jQuery}
         */
        _getDomElement: function (domNode) {
            if (domNode instanceof YBlock) {
                domNode = domNode.getDomNode();
            }
            if (typeof domNode === 'string') {
                var div = $('<div></div>');
                div.html(domNode);
                return div.contents();
            } else {
                return $(domNode);
            }
        },
        html: {
            /**
             * Преобразует сущности HTML-синтаксиса в безопасные эквиваленты.
             *
             * @name yDom.html.escape
             * @param {String} str
             * @returns {String}
             */
            escape: function (str) {
                return str
                    .replace(/&/g, '&amp;')
                    .replace(/</g, '&lt;')
                    .replace(/>/g, '&gt;');
            }
        },
        focus: {
            /**
             * Возвращает `true` если на элемент возможно поставить фокус.
             *
             * @name yDom.focus.isFocusable
             * @param {jQuery|HTMLElement} domNode
             */
            isFocusable: function (domNode) {
                domNode = $(domNode)[0];
                switch (domNode.nodeName.toLowerCase()) {
                    case 'iframe':
                        return true;
                    case 'input':
                    case 'button':
                    case 'textarea':
                    case 'select':
                        return !domNode.hasAttribute('disabled');
                    case 'a':
                        return domNode.hasAttribute('href');
                    default:
                        return domNode.hasAttribute('tabindex');
                }
            },

            /**
             * Возвращает `true` если элемент сфокусирован.
             *
             * @name yDom.focus.hasFocus
             * @param {jQuery|HTMLElement} domNode
             */
            hasFocus: function (domNode) {
                domNode = $(domNode)[0];
                var activeNode = document.activeElement;
                if (activeNode) {
                    var currentNode = activeNode;
                    while (currentNode) {
                        if (currentNode === domNode) {
                            return true;
                        }
                        currentNode = currentNode.parentNode;
                    }
                }
                return false;
            }
        },
        selection: {
            /**
             * Возвращает позицию курсора в поле ввода.
             *
             * @param {jQuery|HTMLElement} input
             * @returns {number}
             */
            getInputCaretPosition: function (input) {
                input = $(input)[0];
                var pos = 0;
                if (document.selection) { // ie
                    input.focus();
                    var selection = document.selection.createRange();
                    selection.moveStart('character', -input.value.length);
                    pos = selection.text.length;
                } else if (input.selectionStart || input.selectionStart === 0) { // firefox
                    pos = input.selectionStart;
                }
                return pos;
            }
        }
    });

});