function ajax_command_append

7.x ajax.inc ajax_command_append($selector, $html, $settings = NULL)

Creates a Drupal Ajax 'insert/append' command.

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.

This command is implemented by Drupal.ajax.prototype.commands.insert() defined in misc/ajax.js.

Parameters

$selector: A jQuery selector string. If the command is a response to a request from an #ajax form element then this value can be NULL.

$html: The data to use with the jQuery append() method.

$settings: An optional array of settings that will be used for this command only.

Return value

An array suitable for use with the ajax_render() function.

See also

http://docs.jquery.com/Manipulation/append#content

Related topics

Ajax framework commands
Functions to create various Ajax commands.
2 calls to ajax_command_append()
ajax_forms_test_advanced_commands_append_callback in drupal-7.x/modules/simpletest/tests/ajax_forms_test.module
Ajax callback for 'append'.
ajax_render in drupal-7.x/includes/ajax.inc
Renders a commands array into JSON.

File

drupal-7.x/includes/ajax.inc, line 941
Functions for use with Drupal's Ajax framework.

Code

function ajax_command_append($selector, $html, $settings = NULL) {
  return array(
    'command' => 'insert',
    'method' => 'append',
    'selector' => $selector,
    'data' => $html,
    'settings' => $settings,
  );
}