Modules (188)

InlineWidget

Description

Dependencies

Classes

Constructor

InlineWidget

    function InlineWidget() {
        var self = this;

        // create the outer wrapper div
        this.htmlContent = window.document.createElement("div");
        this.$htmlContent = $(this.htmlContent).addClass("inline-widget").attr("tabindex", "-1");
        this.$htmlContent.append("<div class='shadow top' />")
            .append("<div class='shadow bottom' />")
            .append("<a href='#' class='close no-focus'>&times;</a>");

        // create the close button
        this.$closeBtn = this.$htmlContent.find(".close");
        this.$closeBtn.click(function (e) {
            self.close();
            e.stopImmediatePropagation();
        });

        this.$htmlContent.on("keydown", function (e) {
            if (e.keyCode === KeyEvent.DOM_VK_ESCAPE) {
                self.close();
                e.stopImmediatePropagation();
            }
        });
    }
    InlineWidget.prototype.htmlContent = null;
    InlineWidget.prototype.$htmlContent = null;
    InlineWidget.prototype.id = null;
    InlineWidget.prototype.hostEditor = null;
    EventDispatcher.makeEventDispatcher(InlineWidget.prototype);

Properties Show Private Members

height

Initial height of inline widget in pixels. Can be changed later via hostEditor.setInlineWidgetHeight()

Type: number

    InlineWidget.prototype.height = 0;

Methods Show Private Members

close

Closes this inline widget and all its contained Editors

Returns: $.Promise: A promise that's resolved when the widget is fully closed.

    InlineWidget.prototype.close = function () {
        return EditorManager.closeInlineWidget(this.hostEditor, this);
        // closeInlineWidget() causes our onClosed() handler to be called
    };

hasFocus

Returns: boolean: True if any part of the inline widget is focused

    InlineWidget.prototype.hasFocus = function () {
        var focusedItem = window.document.activeElement,
            htmlContent = this.$htmlContent[0];
        return $.contains(htmlContent, focusedItem) || htmlContent === focusedItem;
    };

load

hostEditor Editor

    InlineWidget.prototype.load = function (hostEditor) {
        this.hostEditor = hostEditor;
    };

onAdded

Called once content is parented in the host editor's DOM. Useful for performing tasks like setting focus or measuring content, which require htmlContent to be in the DOM tree.

IMPORTANT: onAdded() MUST be overridden to call hostEditor.setInlineWidgetHeight() at least once to set the initial height (required to animate it open). The widget will never open otherwise.

    InlineWidget.prototype.onAdded = function () {
        this.trigger("add");
    };

onClosed

Called any time inline is closed, whether manually or automatically.

    InlineWidget.prototype.onClosed = function () {
        this.trigger("close");
    };

onParentShown

Called when the editor containing the inline is made visible.

    InlineWidget.prototype.onParentShown = function () {
        // do nothing - base implementation
    };

refresh

Called when the parent editor does a full refresh--for example, when the font size changes.

    InlineWidget.prototype.refresh = function () {
        // do nothing - base implementation
    };

    exports.InlineWidget = InlineWidget;

});