class DataCommand in Zircon Profile 8

An AJAX command for implementing jQuery's data() method.

This instructs the client to attach the name=value pair of data to the selector via jQuery's data cache.

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

Hierarchy

• class \Drupal\Core\Ajax\DataCommand implements CommandInterface

Related topics

Ajax API

Overview for Drupal's Ajax API.

4 files declare their use of DataCommand

AjaxCommandsTest.php in core/tests/Drupal/Tests/Core/Ajax/AjaxCommandsTest.php

Contains \Drupal\Tests\Core\Ajax\AjaxCommandsTest.

Callbacks.php in core/modules/system/tests/modules/ajax_forms_test/src/Callbacks.php

Contains \Drupal\ajax_forms_test\Callbacks.

CommandsTest.php in core/modules/system/src/Tests/Ajax/CommandsTest.php

Contains \Drupal\system\Tests\Ajax\CommandsTest.

FormValuesTest.php in core/modules/system/src/Tests/Ajax/FormValuesTest.php

Contains \Drupal\system\Tests\Ajax\FormValuesTest.

File

core/lib/Drupal/Core/Ajax/DataCommand.php, line 21

Contains \Drupal\Core\Ajax\DataCommand.

Namespace

Drupal\Core\Ajax

class DataCommand implements CommandInterface {

  /**
   * A CSS selector string for elements to which data will be attached.
   *
   * If the command is a response to a request from an #ajax form element then
   * this value can be NULL.
   *
   * @var string
   */
  protected $selector;

  /**
   * The key of the data attached to elements matched by the selector.
   *
   * @var string
   */
  protected $name;

  /**
   * The value of the data to be attached to elements matched by the selector.
   *
   * The data is not limited to strings; it can be any format.
   *
   * @var mixed
   */
  protected $value;

  /**
   * Constructs a DataCommand object.
   *
   * @param string $selector
   *   A CSS selector for the elements to which the data will be attached.
   * @param string $name
   *   The key of the data to be attached to elements matched by the selector.
   * @param type $value
   *   The value of the data to be attached to elements matched by the selector.
   */
  public function __construct($selector, $name, $value) {
    $this->selector = $selector;
    $this->name = $name;
    $this->value = $value;
  }

  /**
   * Implements Drupal\Core\Ajax\CommandInterface:render().
   */
  public function render() {
    return array(
      'command' => 'data',
      'selector' => $this->selector,
      'name' => $this->name,
      'value' => $this->value,
    );
  }

}

Members

Name	Modifiers	Type	Description	Overrides
DataCommand::$name	protected	property	The key of the data attached to elements matched by the selector.
DataCommand::$selector	protected	property	A CSS selector string for elements to which data will be attached.
DataCommand::$value	protected	property	The value of the data to be attached to elements matched by the selector.
DataCommand::render	public	function	Implements Drupal\Core\Ajax\CommandInterface:render(). Overrides CommandInterface::render
DataCommand::__construct	public	function	Constructs a DataCommand object.