function ajax_command_prepend

Creates a Drupal Ajax 'insert/prepend' command.

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.

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 prepend() 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/prepend#content

Related topics

5 calls to ajax_command_prepend()
ajax_forms_test_advanced_commands_prepend_callback in modules/simpletest/tests/ajax_forms_test.module
Ajax callback for 'prepend'.
ajax_prepare_response in includes/ajax.inc
Converts the return value of a page callback into an Ajax commands array.
ajax_render in includes/ajax.inc
Renders a commands array into JSON.
file_ajax_upload in modules/file/file.module
Menu callback; Shared Ajax callback for file uploads and deletions.
hook_ajax_render_alter in modules/system/system.api.php
Alter the commands that are sent to the user through the Ajax framework.

File

includes/ajax.inc, line 968

Code

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

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.