According to the documentation of #ajax['callback'], the callback function defined by this property "can return HTML, a renderable array, or an array of AJAX Commands."
This issue is about that last statement, that the callback function can return an array of AJAX commands. This would mean the following:
return array(
ajax_command_replace($selector1, $html1),
ajax_command_html($selector2, $html2),
);
This, in fact, doesn't work, and no error message is produced. After hours of debugging and reading documentation, I found the solution in the source code of ajax_prepare_response(). The code of the callback function should do this:
return array(
'#type' => 'ajax',
'#commands' => array(
ajax_command_replace($selector1, $html1),
ajax_command_html($selector2, $html2),
),
);
How can we reflect this in the documentation? I'm not sure if it is appropriate to put this information in that same paragraph.
Closed: won't fix
API documentation files
Not all content is available!
It's likely this issue predates Contrib.social: some issue and comment data are missing.
This is for the Drupal 7 Form API reference. Since Drupal 7 is past end-of-life this is now a "won't fix".
Work on documentation for form elements for supported versions of Drupal is at
📌
[meta] Move/Create Form Element Documentation
Active
and
🌱
[Meta] Improve documentation for Render and Form Elements
Active
.