MDL-41241 atto: YUIDoc cleanup for link plugin.
authorDamyon Wiese <damyon@moodle.com>
Fri, 20 Sep 2013 06:50:17 +0000 (14:50 +0800)
committerDamyon Wiese <damyon@moodle.com>
Fri, 20 Sep 2013 07:22:50 +0000 (15:22 +0800)
lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button-debug.js
lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button-min.js
lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button.js
lib/editor/atto/plugins/link/yui/src/button/js/button.js

index c352f07..b41a1b1 100644 (file)
Binary files a/lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button-debug.js and b/lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button-debug.js differ
index 6454678..06b6b58 100644 (file)
Binary files a/lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button-min.js and b/lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button-min.js differ
index c352f07..b41a1b1 100644 (file)
Binary files a/lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button.js and b/lib/editor/atto/plugins/link/yui/build/moodle-atto_link-button/moodle-atto_link-button.js differ
index b719e9a..9ed2eba 100644 (file)
  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
 M.atto_link = M.atto_link || {
+    /**
+     * The window used to get the link details.
+     *
+     * @property dialogue
+     * @type M.core.dialogue
+     * @default null
+     */
     dialogue : null,
+
+    /**
+     * The selection object returned by the browser.
+     *
+     * @property selection
+     * @type Range
+     * @default null
+     */
     selection : null,
-    init : function(params) {
-        var display_chooser = function(e, elementid) {
-            e.preventDefault();
-            if (!M.editor_atto.is_active(elementid)) {
-                M.editor_atto.focus(elementid);
-            }
-            M.atto_link.selection = M.editor_atto.get_selection();
-            if (M.atto_link.selection !== false && (!M.atto_link.selection.collapsed)) {
-                var dialogue;
-                if (!M.atto_link.dialogue) {
-                    dialogue = new M.core.dialogue({
-                        visible: false,
-                        modal: true,
-                        close: true,
-                        draggable: true
-                    });
-                } else {
-                    dialogue = M.atto_link.dialogue;
-                }
-
-                dialogue.render();
-                dialogue.set('bodyContent', M.atto_link.get_form_content(elementid));
-                dialogue.set('headerContent', M.util.get_string('createlink', 'atto_link'));
-
-                M.atto_link.resolve_anchors();
-
-                dialogue.show();
-                M.atto_link.dialogue = dialogue;
+
+    /**
+     * Display the chooser dialogue.
+     *
+     * @method init
+     * @param Event e
+     * @param string elementid
+     */
+    display_chooser : function(e, elementid) {
+        e.preventDefault();
+        if (!M.editor_atto.is_active(elementid)) {
+            M.editor_atto.focus(elementid);
+        }
+        M.atto_link.selection = M.editor_atto.get_selection();
+        if (M.atto_link.selection !== false && (!M.atto_link.selection.collapsed)) {
+            var dialogue;
+            if (!M.atto_link.dialogue) {
+                dialogue = new M.core.dialogue({
+                    visible: false,
+                    modal: true,
+                    close: true,
+                    draggable: true
+                });
+            } else {
+                dialogue = M.atto_link.dialogue;
             }
-        };
 
-        M.editor_atto.add_toolbar_button(params.elementid, 'link', params.icon, display_chooser, this);
+            dialogue.render();
+            dialogue.set('bodyContent', M.atto_link.get_form_content(elementid));
+            dialogue.set('headerContent', M.util.get_string('createlink', 'atto_link'));
+
+            M.atto_link.resolve_anchors();
+
+            dialogue.show();
+            M.atto_link.dialogue = dialogue;
+        }
     },
+
+    /**
+     * Add this button to the form.
+     *
+     * @method init
+     * @param {Object} params
+     */
+    init : function(params) {
+        M.editor_atto.add_toolbar_button(params.elementid, 'link', params.icon, this.display_chooser, this);
+    },
+
+    /**
+     * If there is selected text and it is part of an anchor link,
+     * extract the url (and target) from the link (and set them in the form).
+     *
+     * @method resolve_anchors
+     */
     resolve_anchors : function() {
         // Find the first anchor tag in the selection.
         var selectednode = M.editor_atto.get_selection_parent_node(),
@@ -77,12 +113,26 @@ M.atto_link = M.atto_link || {
             }
         }
     },
+
+    /**
+     * Open the repository file picker.
+     *
+     * @method open_filepicker
+     * @param Event e
+     */
     open_filepicker : function(e) {
         var elementid = this.getAttribute('data-editor');
         e.preventDefault();
 
         M.editor_atto.show_filepicker(elementid, 'link', M.atto_link.filepicker_callback);
     },
+
+    /**
+     * Called by the file picker when a link has been chosen.
+     *
+     * @method filepicker_callback
+     * @param {Object} params - contains selected url.
+     */
     filepicker_callback : function(params) {
         M.atto_link.dialogue.hide();
         if (params.url !== '') {
@@ -91,6 +141,13 @@ M.atto_link = M.atto_link || {
             document.execCommand('createLink', false, params.url);
         }
     },
+
+    /**
+     * The OK button has been pressed - make the changes to the source.
+     *
+     * @method set_link
+     * @param Event e
+     */
     set_link : function(e) {
         e.preventDefault();
         M.atto_link.dialogue.hide();
@@ -104,6 +161,14 @@ M.atto_link = M.atto_link || {
             document.execCommand('createLink', false, value);
         }
     },
+
+    /**
+     * Return the HTML of the form to show in the dialogue.
+     *
+     * @method get_form_content
+     * @param string elementid
+     * @return string
+     */
     get_form_content : function(elementid) {
         var content = Y.Node.create('<form>' +
                              '<label for="atto_link_urlentry">' + M.util.get_string('enterurl', 'atto_link') +