Changeset 50831

Timestamp:

05/08/2021 11:20:02 AM (4 years ago)

Author:

SergeyBiryukov

Message:

Docs: Correct @since tags for new properties and functions related to infinite scrolling in Media Library.

Follow-up to [50829].

See #50105, #40330, #52628.

Location:

trunk/src

Files:

• js/media/models/attachments.js (modified) (5 diffs)
• js/media/models/query.js (modified) (1 diff)
• js/media/views/attachments.js (modified) (1 diff)
• js/media/views/attachments/browser.js (modified) (5 diffs)
• wp-admin/includes/ajax-actions.php (modified) (1 diff)
• wp-includes/media.php (modified) (1 diff)

trunk/src/js/media/models/attachments.js

@@ -351 +351 @@
      * Holds the total number of attachments.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      */
     totalAttachments: 0,
@@ -358 +358 @@
      * Gets the total number of attachments.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @return {number} The total number of attachments.
@@ -369 +369 @@
      * A custom Ajax-response parser.
      *
-     * See trac ticket #24753
+     * See trac ticket #24753.
      *
      * Called automatically by Backbone whenever a collection's models are returned
@@ -376 +376 @@
      * the collection items.
      *
-     * Since WordPress 5.5, the response returns the attachments under `response.attachments`
-     * and `response.totalAttachments` holds the total number of attachments found.
+     * @since 5.8.0 The response returns the attachments under `response.attachments` and
+     *              `response.totalAttachments` holds the total number of attachments found.
      *
      * @param {Object|Array} response The raw response Object/Array.
@@ -385 +385 @@
     parse: function( response, xhr ) {
         if ( ! _.isArray( response.attachments ) ) {
-            response = [response.attachments];
+            response = [ response.attachments ];
         }
 

trunk/src/js/media/models/query.js

@@ -114 +114 @@
 
         return this._more = this.fetch( options ).done( function( response ) {
-            // Since WordPress 5.5, the response returns the attachments under `response.attachments`.
             var attachments = response.attachments;
 

trunk/src/js/media/views/attachments.js

@@ -37 +37 @@
 
         /**
+         * @since 5.8.0 Added the `infiniteScrolling` parameter.
+         *
          * @param infiniteScrolling  Whether to enable infinite scrolling or use
          *                           the default "load more" button.

trunk/src/js/media/views/attachments/browser.js

@@ -457 +457 @@
      * Creates the Attachments wrapper view.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @return {void}
@@ -507 +507 @@
      * Creates the load more button and attachments counter view.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @return {void}
@@ -558 +558 @@
      * We need it to run only once, after all attachments are added or removed.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @return {void}
@@ -611 +611 @@
      * Loads more attachments.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @return {void}
@@ -646 +646 @@
      * Moves focus to the first new added item. .
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @return {void}

trunk/src/wp-admin/includes/ajax-actions.php

@@ -2928 +2928 @@
  *
  * @since 3.5.0
+ * @since 5.8.0 The response returns the attachments under `response.attachments` and
+ *              `response.totalAttachments` holds the total number of attachments found.
  */
 function wp_ajax_query_attachments() {

trunk/src/wp-includes/media.php

@@ -4310 +4310 @@
      * Filters whether the Media Library grid has infinite scrolling. Default `false`.
      *
-     * @since 5.7.0
+     * @since 5.8.0
      *
      * @param bool $value The filtered value, defaults to `false`.