Changeset 41330

Timestamp:

09/03/2017 04:15:38 PM (7 years ago)

Author:

afercia

Message:

Docs: Update media-audiovideo.js after [41239].

Fixes #41602.

File:

• trunk/src/wp-includes/js/media-audiovideo.js (modified) (10 diffs)

trunk/src/wp-includes/js/media-audiovideo.js

@@ -5 +5 @@
 
 /**
+ *
+ * @summary Defines the wp.media.mixin object.
+ *
  * @mixin
+ *
+ * @since 4.2.0
  */
 wp.media.mixin = {
     mejsSettings: baseSettings,
 
+    /**
+     * @summary Pauses and removes all players.
+     *
+     * @since 4.2.0
+     *
+     * @return {void}
+     */
     removeAllPlayers: function() {
         var p;
@@ -22 +34 @@
 
     /**
+     * @summary Removes the player.
+     *
      * Override the MediaElement method for removing a player.
-     *  MediaElement tries to pull the audio/video tag out of
-     *  its container and re-add it to the DOM.
+     * MediaElement tries to pull the audio/video tag out of
+     * its container and re-add it to the DOM.
+     *
+     * @since 4.2.0
+     *
+     * @return {void}
      */
     removePlayer: function(t) {
@@ -59 +77 @@
 
     /**
+     *
+     * @summary Removes and resets all players.
+     *
      * Allows any class that has set 'player' to a MediaElementPlayer
-     *  instance to remove the player when listening to events.
-     *
-     *  Examples: modal closes, shortcode properties are removed, etc.
+     * instance to remove the player when listening to events.
+     *
+     * Examples: modal closes, shortcode properties are removed, etc.
+     *
+     * @since 4.2.0
      */
     unsetPlayers : function() {
@@ -76 +99 @@
 
 /**
- * Autowire "collection"-type shortcodes
+ * @summary Shortcode modeling for playlists.
+ *
+ * @since 4.2.0
  */
 wp.media.playlist = new wp.media.collection({
@@ -93 +118 @@
 
 /**
- * Shortcode modeling for audio
- *  `edit()` prepares the shortcode for the media modal
- *  `shortcode()` builds the new shortcode after update
+ * @summary Shortcode modeling for audio.
+ *
+ * `edit()` prepares the shortcode for the media modal.
+ * `shortcode()` builds the new shortcode after an update.
  *
  * @namespace
+ *
+ * @since 4.2.0
  */
 wp.media.audio = {
@@ -111 +139 @@
     },
 
+    /**
+     * @summary Instantiates a new media object with the next matching shortcode.
+     *
+     * @since 4.2.0
+     *
+     * @param {string} data The text to apply the shortcode on.
+     * @returns {wp.media} The media object.
+     */
     edit : function( data ) {
         var frame, shortcode = wp.shortcode.next( 'audio', data ).shortcode;
@@ -123 +159 @@
     },
 
+    /**
+     * @summary Generates an audio shortcode.
+     *
+     * @since 4.2.0
+     *
+     * @param {Array} model Array with attributes for the shortcode.
+     * @returns {wp.shortcode} The audio shortcode object.
+     */
     shortcode : function( model ) {
         var content;
@@ -146 +190 @@
 
 /**
- * Shortcode modeling for video
- *  `edit()` prepares the shortcode for the media modal
- *  `shortcode()` builds the new shortcode after update
+ * @summary Shortcode modeling for video.
+ *
+ *  `edit()` prepares the shortcode for the media modal.
+ *  `shortcode()` builds the new shortcode after update.
+ *
+ * @since 4.2.0
  *
  * @namespace
@@ -167 +214 @@
     },
 
+    /**
+     * @summary Instantiates a new media object with the next matching shortcode.
+     *
+     * @since 4.2.0
+     *
+     * @param {string} data The text to apply the shortcode on.
+     * @returns {wp.media} The media object.
+     */
     edit : function( data ) {
         var frame,
@@ -184 +239 @@
     },
 
+    /**
+     * @summary Generates an video shortcode.
+     *
+     * @since 4.2.0
+     *
+     * @param {Array} model Array with attributes for the shortcode.
+     * @returns {wp.shortcode} The video shortcode object.
+     */
     shortcode : function( model ) {
         var content;