wp/wp-includes/js/wp-lists.js
changeset 16 a86126ab1dd4
parent 9 177826044cd9
child 18 be944660c56a
--- a/wp/wp-includes/js/wp-lists.js	Tue Oct 22 16:11:46 2019 +0200
+++ b/wp/wp-includes/js/wp-lists.js	Tue Dec 15 13:49:49 2020 +0100
@@ -113,7 +113,7 @@
 		 * @param {object}      settings        Settings for the current list.
 		 * @param {string}      action          The type of action to perform: 'add', 'delete', or 'dim'.
 		 * @param {string}      backgroundColor Background color of the list's DOM element.
-		 * @returns {boolean} Whether to proceed with the action or not.
+		 * @return {boolean} Whether to proceed with the action or not.
 		 */
 		confirm: null,
 
@@ -124,7 +124,7 @@
 		 *
 		 * @callback wpList~addBefore
 		 * @param {object} settings Settings for the Ajax request.
-		 * @returns {object|boolean} Settings for the Ajax request or false to abort.
+		 * @return {object|boolean} Settings for the Ajax request or false to abort.
 		 */
 		addBefore: null,
 
@@ -149,7 +149,7 @@
 		 * @callback wpList~delBefore
 		 * @param {object}      settings Settings for the Ajax request.
 		 * @param {HTMLElement} list     The list DOM element.
-		 * @returns {object|boolean} Settings for the Ajax request or false to abort.
+		 * @return {object|boolean} Settings for the Ajax request or false to abort.
 		 */
 		delBefore: null,
 
@@ -173,7 +173,7 @@
 		 *
 		 * @callback wpList~dimBefore
 		 * @param {object} settings Settings for the Ajax request.
-		 * @returns {object|boolean} Settings for the Ajax request or false to abort.
+		 * @return {object|boolean} Settings for the Ajax request or false to abort.
 		 */
 		dimBefore: null,
 
@@ -202,8 +202,8 @@
 	 * 6. 0 if none can be found.
 	 *
 	 * @param {jQuery} element  Element that triggered the request.
-	 * @param {object} settings Settings for the Ajax request.
-	 * @returns {string|number} Nonce
+	 * @param {Object} settings Settings for the Ajax request.
+	 * @return {string|number} Nonce
 	 */
 	nonce: function( element, settings ) {
 		var url      = wpAjax.unserialize( element.attr( 'href' ) ),
@@ -235,9 +235,9 @@
 	 * data[3] - 66cc66
 	 * data[4] - unspam=1
 	 *
-	 * @param  {HTMLElement} element The DOM element.
-	 * @param  {string}      type    The type of data to look for: 'list', 'add', 'delete', or 'dim'.
-	 * @returns {Array} Extracted list item data.
+	 * @param {HTMLElement} element The DOM element.
+	 * @param {string}      type    The type of data to look for: 'list', 'add', 'delete', or 'dim'.
+	 * @return {Array} Extracted list item data.
 	 */
 	parseData: function( element, type ) {
 		var data = [], wpListsData;
@@ -258,9 +258,9 @@
 	 * Calls a confirm callback to verify the action that is about to be performed.
 	 *
 	 * @param {HTMLElement} list     The DOM element.
-	 * @param {object}      settings Settings for this list.
+	 * @param {Object}      settings Settings for this list.
 	 * @param {string}      action   The type of action to perform: 'add', 'delete', or 'dim'.
-	 * @returns {object|boolean} Settings if confirmed, false if not.
+	 * @return {Object|boolean} Settings if confirmed, false if not.
 	 */
 	pre: function( list, settings, action ) {
 		var $element, backgroundColor, confirmed;
@@ -294,11 +294,11 @@
 	},
 
 	/**
-	 * Adds an item to the list via AJAX.
+	 * Adds an item to the list via Ajax.
 	 *
 	 * @param {HTMLElement} element  The DOM element.
-	 * @param {object}      settings Settings for this list.
-	 * @returns {boolean} Whether the item was added.
+	 * @param {Object}      settings Settings for this list.
+	 * @return {boolean} Whether the item was added.
 	 */
 	ajaxAdd: function( element, settings ) {
 		var list     = this,
@@ -396,11 +396,11 @@
 	},
 
 	/**
-	 * Delete an item in the list via AJAX.
+	 * Delete an item in the list via Ajax.
 	 *
 	 * @param {HTMLElement} element  A DOM element containing item data.
-	 * @param {object}      settings Settings for this list.
-	 * @returns {boolean} Whether the item was deleted.
+	 * @param {Object}      settings Settings for this list.
+	 * @return {boolean} Whether the item was deleted.
 	 */
 	ajaxDel: function( element, settings ) {
 		var list     = this,
@@ -483,11 +483,11 @@
 	},
 
 	/**
-	 * Dim an item in the list via AJAX.
+	 * Dim an item in the list via Ajax.
 	 *
 	 * @param {HTMLElement} element  A DOM element containing item data.
-	 * @param {object}      settings Settings for this list.
-	 * @returns {boolean} Whether the item was dim'ed.
+	 * @param {Object}      settings Settings for this list.
+	 * @return {boolean} Whether the item was dim'ed.
 	 */
 	ajaxDim: function( element, settings ) {
 		var list     = this,
@@ -611,7 +611,7 @@
 	 * Returns the background color of the passed element.
 	 *
 	 * @param {jQuery|string} element Element to check.
-	 * @returns {string} Background color value in HEX. Default: '#ffffff'.
+	 * @return {string} Background color value in HEX. Default: '#ffffff'.
 	 */
 	getColor: function( element ) {
 		return $( element ).css( 'backgroundColor' ) || '#ffffff';
@@ -621,8 +621,8 @@
 	 * Adds something.
 	 *
 	 * @param {HTMLElement} element  A DOM element containing item data.
-	 * @param {object}      settings Settings for this list.
-	 * @returns {boolean} Whether the item was added.
+	 * @param {Object}      settings Settings for this list.
+	 * @return {boolean} Whether the item was added.
 	 */
 	add: function( element, settings ) {
 		var $list    = $( this ),
@@ -835,7 +835,7 @@
  *                                                Default: null.
  * @param {wpList~dimBefore} settings.dimBefore   Callback that's run before an item gets dim'd. Default: null.
  * @param {wpList~dimAfter}  settings.dimAfter    Callback that's run after an item got dim'd. Default: null.
- * @returns {$.fn} wpList API function.
+ * @return {$.fn} wpList API function.
  */
 $.fn.wpList = function( settings ) {
 	this.each( function( index, list ) {