Changeset 50831

Timestamp:

05/08/2021 11:20:02 AM (5 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`.