Issue #2758915 by mdupont, darvanen, -enzo-, Amber Himes Matz, smustgrave: AJAX commands documentation is misleading when working with render arrays

core/lib/Drupal/Core/Ajax/AfterCommand.php

@@ -6,8 +6,8 @@ namespace Drupal\Core\Ajax;
  * An AJAX command for calling the jQuery after() method.
  *
  * The 'insert/after' command instructs the client to use jQuery's after()
- * method to insert the given HTML content after each element matched by the
- * given selector.
+ * method to insert the given render array or HTML content after each element
+ * matched by the given selector.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.

core/lib/Drupal/Core/Ajax/AppendCommand.php

@@ -6,8 +6,8 @@ namespace Drupal\Core\Ajax;
  * An AJAX command for calling the jQuery append() method.
  *
  * The 'insert/append' command instructs the client to use jQuery's append()
- * method to append the given HTML content to the inside of each element matched
- * by the given selector.
+ * method to append the given render array or HTML content to the inside of each
+ * element matched by the given selector.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.

core/lib/Drupal/Core/Ajax/BeforeCommand.php

@@ -6,8 +6,8 @@ namespace Drupal\Core\Ajax;
  * An AJAX command for calling the jQuery before() method.
  *
  * The 'insert/before' command instructs the client to use jQuery's before()
- * method to insert the given HTML content before each of elements matched by
- * the given selector.
+ * method to insert the given render array or HTML content before each of
+ * elements matched by the given selector.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.

core/lib/Drupal/Core/Ajax/HtmlCommand.php

@@ -7,7 +7,7 @@ namespace Drupal\Core\Ajax;
  *
  * The 'insert/html' command instructs the client to use jQuery's html() method
  * to set the HTML content of each element matched by the given selector while
- * leaving the outer tags intact.
+ * leaving the outer tags intact using a given render array or HTML markup.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.

core/lib/Drupal/Core/Ajax/InsertCommand.php

@@ -5,9 +5,9 @@ namespace Drupal\Core\Ajax;
 /**
  * Generic AJAX command for inserting content.
  *
- * This command instructs the client to insert the given HTML using whichever
- * jQuery DOM manipulation method has been specified in the #ajax['method']
- * variable of the element that triggered the request.
+ * This command instructs the client to insert the given render array or HTML
+ * using whichever jQuery DOM manipulation method has been specified in the
+ * #ajax['method'] variable of the element that triggered the request.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.

core/lib/Drupal/Core/Ajax/PrependCommand.php

@@ -6,8 +6,8 @@ namespace Drupal\Core\Ajax;
  * AJAX command for calling the jQuery insert() method.
  *
  * The 'insert/prepend' command instructs the client to use jQuery's prepend()
- * method to prepend the given HTML content to the inside each element matched
- * by the given selector.
+ * method to prepend the given render array or HTML content to the inside each
+ * element matched by the given selector.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.

core/lib/Drupal/Core/Ajax/ReplaceCommand.php

@@ -7,7 +7,7 @@ namespace Drupal\Core\Ajax;
  *
  * The 'insert/replaceWith' command instructs the client to use jQuery's
  * replaceWith() method to replace each element matched by the given selector
- * with the given HTML.
+ * with the given render array or HTML.
  *
  * This command is implemented by Drupal.AjaxCommands.prototype.insert()
  * defined in misc/ajax.js.