Changeset 41313

Timestamp:

08/24/2017 05:54:22 PM (9 years ago)

Author:

wonderboymusic

Message:

Docs: improve JS docs for bookmarklet.js

Props andizer, ireneyoast.
Fixes #41547.

File:

• trunk/src/wp-admin/js/bookmarklet.js (modified) (3 diffs)

trunk/src/wp-admin/js/bookmarklet.js

@@ +1 @@
+/**
+ * @summary Creates a form with a URL, title, and content based on the current opened URL and the content of the associated web page.
+ *
+ * @since 4.2.0
+ *
+ * @param {window} window The window.
+ * @param {document} document The document.
+ * @param {string} href The current opened URL.
+ * @param {string} pt_url The URL to post the content to.
+ *
+ * @returns {void}
+ */
 ( function( window, document, href, pt_url ) {
         var encURI = window.encodeURIComponent,
@@ -14 +26 @@
         if ( href.match( /^https?:/ ) ) {
                 pt_url += '&u=' + encURI( href );
+                // Check whether the unencoded url and the encoded url use the same protocol.
                 if ( href.match( /^https:/ ) && pt_url.match( /^http:/ ) ) {
                         canPost = false;
@@ -53 +66 @@
         }
 
+        /**
+         * @summary Creates a hidden input field and sets its name and value.
+         *
+         * @since 4.2.0
+         *
+         * @param name The input field name.
+         * @param value The input field value.
+         *
+         * @returns {void}
+         */
         function add( name, value ) {
                 if ( typeof value === 'undefined' ) {