118.系统AJAX（一）：概述与示例
这是很多读者期待的一个激动人心的时刻，从本篇起，本系列将分多集连续全面介绍Drupal系统的AJAX实现，在阅读前需要掌握一些必须的前置知识，请先阅读本系列以下主题：
《全局设置与前端API》
《jQuery表单库jquery.form.js详解》
此外需要读者熟悉jQuery，如果JS编程不熟悉，云客为你准备了以下教程：
《PHP开发者的JavaScript快速教程（phper简明js教程）》
Drupal AJAX概述：
AJAX是在不刷新整个页面的前提下，基于服务器端返回的数据动态更新页面中部分内容或JS变量的过程；在drupal世界中从开发角度看AJAX，可分为两大类：
自定义AJAX：
和通常项目一样的由开发者自定义前端js代码，再从后端拉取数据实现的AJAX，这要求开发者自定义资源库，为了方便通常会依赖核心jquery库，用jquery提供的诸多方法进行AJAX通讯；这一类AJAX灵活自由，可以实现开发者想要的任意功能，是一种任意项目通用的底层操作，而不局限于drupal，缺点是需要开发者处理所有细节，不够简单和便捷，即便一个小功能也需要实现自定义库。
Drupal AJAX API：
为弥补第一类的不足，系统提供了AJAX API，非常便捷、简单，无需写JS代码，只需要依据API的要求为要应用AJAX行为的元素指定一个AJAX配置即可，无需涉及底层细节，系统会自动完成AJAX功能，这是一种更高层级的封装，支持任意元素。
通常最常见的AJAX操作是从服务器拉取html片段并替换页面元素，但也有很多其他操作，比如依据服务器返回的数据更新某个js变量、弹出一个警告框、设置一个css属性、移除一个元素等等，Drupal将各种操作进行了统一，透过现象直达本质，在实现上，将不同种类的操作抽象成一个个不同的命令，每个命令由一个对应的js函数来完成该种操作，比如替换html就是一个“insert”命令，参数是替换的html片段以及如何替换、替换谁等；这样一来，后端仅需以json方式返回一个纯数据对象即可，对象中包含了命令的名字，以及完成命令需要的参数数据，在前端该对象称为AJAX命令对象，后端仅返回AJAX命令对象，且在一次AJAX请求中可以返回多个命令，从而一次性进行多种操作，关于命令会在后续主题详细解释。
API的缺点是如果系统提供的AJAX命令不能满足需求，那么需要新增命令，但很棒的是系统默认提供的命令足够丰富且扩展简单。
在设计上AJAX API主要用于以下元素：
渲染数组中具备“#ajax”属性的表单元素
具备“use-ajax”类属性的链接元素
具备“use-ajax-submit” 类属性的表单按钮
但这并不是说仅能用于这些元素，准确的说法是最常用于这些元素，AJAX API是可以用于任意元素的，见下文示例三的说明。
准备：
为演示本篇的示例，需要一个模块来运行相关代码，这里以“yunke_help”模块为列，该模块是本系列的配套模块，专门用于研究学习drupal，有非常多的辅助功能，请先到云客的博客下载安装，须注意这里只是为了起演示作用，并不依赖特定模块，以下以“yunke_help”模块来说明示例步骤。
示例一：在表单非提交元素上运用AJAX
目的：一个表单元素输入改变，从服务器获取数据联动改变其他元素
第一步：
建立文件：yunke_help/src/Form/YunkeForm.php
内容如下：
<?php
/**
* 演示表单AJAX操作
*/
namespace Drupal\yunke_help\Form;
use Drupal\Core\Form\FormBase;
use Drupal\Core\Form\FormStateInterface;
class YunkeForm extends FormBase
{
public function getFormId()
{
return 'yunke_help_form';
}
public function buildForm(array $form, FormStateInterface $form_state)
{
$form['content_one'] = [
'#type' => 'html_tag',
'#tag' => 'div',
'#value' => 'ajax获取的内容将显示在这里：',
'#attributes' => ['id' => 'content_one'],
];
$form['input'] = [
'#type' => 'textfield',
'#title' => '任意输入字符：',
'#description' => '输入的内容将通过ajax发送到服务器',
'#size' => '60',
'#ajax' => [
'callback' => '::yunkeTest',
'event' => 'blur',
'wrapper' => 'content_one',
'method' => 'append',
'effect' => 'slide',
'speed' => 1000,
'prevent' => 'click',
'progress' => [
'type' => 'throbber',
'message' => '正在进行ajax...',
],
],
];
$form['#attributes']['target'] = "_blank";
$form['actions']['#type'] = 'actions';
$form['actions']['submit'] = array(
'#type' => 'submit',
'#value' => $this->t('Submit'),
'#button_type' => 'primary',
);
return $form;
}
public function yunkeTest(array &$form, FormStateInterface $form_state)
{
//\Drupal::messenger()->addStatus('AJAX消息测试'); //默认也会发生消息管理器中的内容
$markup = '你的输入是：' . $form_state->getValue('input') . '<br>';
return ['#markup' => $markup];
}
public function validateForm(array & $form, FormStateInterface $form_state)
{
}
public function submitForm(array & $form, FormStateInterface $form_state)
{
$form_state->cleanValues();
print_r($form_state->getValues());
die;
}
}
第二步：
然后在控制器：\Drupal\yunke_help\Controller\Test::test中执行以下代码：
return \Drupal::formBuilder()->getForm("\Drupal\yunke_help\Form\YunkeForm");
访问连接：http://www.你的域名.com/yunke-help/test
或点击“yunke_help”模块主页的测试按钮
说明：
在该例中关键在于表单元素的“#ajax”项设置，她为前端提供了一个AJAX配置，前端系统会据此为具备该属性的元素附加AJAX行为，AJAX配置可用的设置项及解释见下文的AJAX配置说明。
示例二：在dialog弹框显示链接内容
目的：点击页面中的链接，然后将链接内容通过AJAX获取后显示到页面dialog弹框中：
第一步：
先在控制器：\Drupal\yunke_help\Controller\Test::test_1中放入以下内容供AJAX获取：
$msg = '<div>我是ajax获取的内容' . time() . '</div>';
return array(
'#markup' => $msg,
);
第二步：
然后在控制器：\Drupal\yunke_help\Controller\Test::test中执行以下示例代码：
$elements['#title'] = '示例二：用dialog显示链接目标';
$url = \Drupal\Core\Url::fromUri('internal:/yunke-help/test-1');
$elements['link'] = [
'#type' => 'link',
'#title' => '点击本链接将以dialog方式打开',
'#url' => $url,
'#attributes' => ['class' => ['use-ajax'],
'data-dialog-type' => 'dialog',
],
];
return $elements;
第三步：
这样就可以点击“yunke_help”模块主页的测试按钮查看示例效果了
说明：
该例没有像示例一那样用到“#ajax”属性，没有AJAX配置传递到前端，但是前端系统发现链接具备类属性“use-ajax”就会结合 “data-dialog-type” 属性、href属性自动产生AJAX配置并附加AJAX行为
示例三：点击链接后在任意位置显示
目的：示例二以dialog显示AJAX获取的内容，本例将获取的内容显示到特定的页面元素中
第一步：
示例二中控制器：\Drupal\yunke_help\Controller\Test::test_1中所放AJAX获取的内容不变
然后在控制器：\Drupal\yunke_help\Controller\Test::test中执行以下示例代码：
$elements['#title'] = '示例三：在特定元素中显示链接目标';
$elements['content_one'] = array(
'#type' => 'html_tag',
'#tag' => 'div',
'#value' => '容器元素',
'#attributes' => ['id' => 'content_one'],
);
$url = \Drupal\Core\Url::fromUri('internal:/yunke-help/test-1');
$elements['link'] = [
'#type' => 'link',
'#title' => '点击本链接将在容器元素中呈现目标内容',
'#url' => $url,
'#attributes' => ['id' => 'yunkeID'],
];
$elements['link']['#attached']['drupalSettings']['ajax']['yunkeID'] = [ //以链接ID做键名
'event' => 'click',
'wrapper' => 'content_one', //赋值容器元素ID，以使得显示位置指向容器元素
'method' => 'append',
'effect' => 'slide',
'speed' => 1000,
'prevent' => 'click',
'progress' => [
'type' => 'throbber',
'message' => '正在进行ajax...',
],
];
$elements['link']['#attached']['drupalSettings']['ajaxTrustedUrl'][$url->toString()] = TRUE;
$elements['link']['#attached']['library'][] = 'core/jquery.form';
$elements['link']['#attached']['library'][] = 'core/drupal.ajax';
return $elements;
第二步：
这样就可以点击“yunke_help”模块主页的测试按钮查看示例效果了
说明：
在该例中关键在于通过系统前端设置机制传递了一个AJAX配置，这以触发AJAX事件元素的id做键名（这里是yunkeID），键值是AJAX配置，该配置和示例一中的“#ajax”是一样的，实际上在内部，示例一中的“#ajax”也会被转化成这种形式，这里使用了更加底层的操作，由于没有采用自动处理，因此必须手动附加相关的库和可信AJAX请求链接设置
以示例三这种方法可以为任意前端元素指定AJAX行为，如图片、按钮、文字等等，只需要元素具备ID属性，并以ID属性值做AJAX配置的键名即可，但需要注意由于本例中触发AJAX的元素是一个链接元素（a标签），AJAX请求url可以被前端系统从链接上自动获取，因此可以省略，如果是其他元素，那么必须在配置中指定url项，其值必须是一个字符串值，不能是url对象，如果是url对象必须用“$url->toString()”进行转化
示例四：在任意元素上设置AJAX行为
目的：在任意元素上设置AJAX行为，并将结果显示在对话框中，这里以span元素为列
第一步：
前例控制器：\Drupal\yunke_help\Controller\Test::test_1中所放AJAX获取的内容不变
然后在控制器：\Drupal\yunke_help\Controller\Test::test中执行以下示例代码：
$elements['#title'] = '示例四：任意元素触发AJAX，并在dialog中显示内容';
$url = \Drupal\Core\Url::fromUri('internal:/yunke-help/test-1');
$elements['span'] = [
'#type' => 'html_tag',
'#tag' => 'span',
'#value' => '点击这里将在dialog中呈现ajax内容',
'#attributes' => ['id' => 'yunkeID'],
];
$elements['link']['#attached']['drupalSettings']['ajax']['yunkeID'] = [ //以触发元素ID做键名
'event' => 'click',
'dialogType' => 'dialog', //该项使得显示位置在对话框中
'url' => $url->toString(),
'method' => 'append',
'effect' => 'slide',
'speed' => 1000,
'prevent' => 'click',
'progress' => [
'type' => 'throbber',
'message' => '正在进行ajax...',
],
];
$elements['link']['#attached']['drupalSettings']['ajaxTrustedUrl'][$url->toString()] = TRUE;
$elements['link']['#attached']['library'][] = 'core/jquery.form';
$elements['link']['#attached']['library'][] = 'core/drupal.ajax';
return $elements;
第二步：
这样就可以点击“yunke_help”模块主页的测试按钮查看示例效果了
说明：
该例的目的是让读者明白drupal的AJAX API可以用于任意元素，这里仅以span元素的点击事件为例
示例五：通过AJAX提交表单
目的：在表单提交元素上设置AJAX行为，这将执行提交处理器，并将结果显示在特定位置
和示例一完全相同，仅将表单类替换如下：
<?php
/**
* 演示表单AJAX操作
*/
namespace Drupal\yunke_help\Form;
use Drupal\Core\Form\FormBase;
use Drupal\Core\Form\FormStateInterface;
class YunkeForm extends FormBase
{
public function getFormId()
{
return 'yunke_help_form';
}
public function buildForm(array $form, FormStateInterface $form_state)
{
$form['title'] = array(
'#type' => 'textfield',
'#title' => '标题，仅能输入数字',
'#pattern' => '[0-9]+',
);
$form['input'] = [
'#type' => 'textfield',
'#title' => '输入任意字符：',
'#id' => 'yunkeID',
'#required' => TRUE,
];
$form['actions']['#type'] = 'actions';
$form['actions']['content_one'] = [ //用于显示AJAX提交反馈
'#type' => 'html_tag',
'#tag' => 'div',
'#attributes' => ['id' => 'content_one'],
];
$form['actions']['submit'] = array(
'#type' => 'submit',
'#value' => 'AJAX提交',
'#button_type' => 'primary',
'#ajax' => [
'callback' => '::yunkeTest',
'event' => 'click',
'disable-refocus' => true,
'wrapper' => 'content_one',
'method' => 'html',
'effect' => 'fade',
'speed' => 1000,
'prevent' => 'click',//阻止非ajax提交,其实不需要这行，默认已阻止
'progress' => [
'type' => 'throbber',
'message' => '表单正在提交中...',
],
],
);
return $form;
}
public function yunkeTest(array &$form, FormStateInterface $form_state)
{
/*
//返回渲染数组，该方式将返回消息服务中的数据，以此显示错误
if($errors=$form_state->getErrors()){
return ['#markup' => '表单已成功提交'];
}else{
return ['#markup' => '提交失败，请检查错误'];
}
*/
//如果不想反回消息数据，则使用以下代码返回json响应：
if ($errors = $form_state->getErrors()) {
$message = ['提交失败，请检查错误:'];
foreach ($errors as $error) {
$message[] = $error;
}
//错误会沉积在消息系统中，体验不好故删除，但不要删除非表单错误的消息
$errorMessages = \Drupal::messenger()->deleteByType('error');
foreach ($errors as $key => $error) {
$errors[$key] = (string)$error;//可能是翻译对象
}
foreach ($errorMessages as $key => $error) {
if (!in_array((string)$error, $errors)) {
\Drupal::messenger()->addMessage($error, 'error');
}
}
} else {
$message = ['表单已成功提交'];
}
$response = new \Drupal\Core\Ajax\AjaxResponse();
$html = ['#markup' => implode('<br>', $message)];
$command = new \Drupal\Core\Ajax\InsertCommand(NULL, $html);
$response->addCommand($command);
return $response;
}
public function validateForm(array & $form, FormStateInterface $form_state)
{
if (empty($form_state->getValue('title'))) {
$form_state->setErrorByName('title', '标题不能为空');
}
file_put_contents('yunkeAJAX.txt', __CLASS__ . "验证器\n", FILE_APPEND);
//在根目录写入信息以便测试
}
public function submitForm(array & $form, FormStateInterface $form_state)
{
file_put_contents('yunkeAJAX.txt', __CLASS__ . "提交器\n", FILE_APPEND);
$form_state->cleanValues();
$d = print_r($form_state->getValues(), true);
file_put_contents('yunkeAJAX.txt', "提交内容\n:{$d}\n", FILE_APPEND);
}
}
说明：
该列演示了在提交元素上采用“#ajax”属性设置表单ajax提交，这和示例一不同之处在于该列会执行提交处理器
示例六：
目的：在提交元素上采用类属性“use-ajax-submit”进行提交与显示
很遗憾，目前（V8.7，2019.7）系统在该功能上存在BUG，如下：
1、在该种情况下，系统本应自动添加“core/jquery.form”和“core/drupal.ajax”库，但其并没有，该bug已经被社区成员提交，现处于修复阶段
2、在该种情况下，提交处理器需在表单状态对象中设置一个ajax响应，这在成功提交的情况下将工作的很好，但是如果验证失败（此时不会执行提交处理器），控制器将返回表单数组，接着由AJAX主内容渲染器将其渲染成AJAX响应，由于该响应中，insert命令缺乏指向错误显示元素的选择器，因此页面并不显示错误，这虽然可以在验证器中将表单数组的元素类型设置成“ajax”以在前端通过警告框进行错误提示，但显然这并不优雅
由于以上bug尚未修复，建议目前以示例五代替
AJAX配置：
AJAX配置是前端系统所需的用来为页面元素设置一个AJAX行为的信息（在下集原理篇中会有更深入的体会），在后端以数组形式存在，在前端以数据对象形式存在，通常通过JS配置设置机制传递到前端全局变量drupalSettings中，但有些情况为了更加便捷，系统支持部分元素只需要设置少许属性即可实现AJAX，此时不需要传递AJAX配置，典型的是设置了类属性“use-ajax”的链接和设置了类属性“use-ajax-submit”的表单按钮，前端系统会为它们自动产生AJAX配置并设置AJAX行为。
从系统流程角度看，AJAX配置在系统中有三种存在形式（或存在位置）：
元素“#ajax”属性值：
也就是元素渲染数组的“#ajax”属性值，需要注意的是并不是所有元素都能使用“#ajax”属性，仅在渲染过程中能调用到以下方法的元素才可以：
\Drupal\Core\Render\Element\RenderElement::preRenderAjaxForm
这通常是表单元素，该方法会将“#ajax”属性值处理成JS设置中的AJAX配置后传递到前端（准确说是传递到附属物中）
JS设置值：
在后端这也称为位于渲染附属物中，也就是渲染数组中以下项的值：
$element ['#attached']['drupalSettings']['ajax']['元素ID']
渲染数组的$element ['#attached']['drupalSettings']用于给前端传递设置信息，位于这里的AJAX配置称为标准AJAX配置，或最终AJAX配置，不会再被处理，将直接传递给前端，在前端位于以下全局变量中：
drupalSettings.ajax.元素ID
注意：以JS设置值这种方式直接传递AJAX配置，看起来更加底层，但并不能完全代替表单元素的“#ajax”属性值方式传递，主要原因在于回调参数并不通过前端传递，在内部系统会先找到触发元素，再通过其：['#ajax']['callback']属性找到回调，这种机制要求回调仅设置在“#ajax”属性中
前端自动产生：
为一些特殊元素设置AJAX行为时，由前端自动产生，如前文提到的设置了类属性“use-ajax”的链接和设置了类属性“use-ajax-submit”的表单按钮
AJAX配置项说明：
AJAX配置可用键名及其解释如下（部分选项根据存在位置不同，可能会有所不同）：
callback：
表单AJAX请求时服务器端的回调，仅用于表单元素，且仅用于表单元素的“#ajax”属性中，在该属性中是必须的，用在JS设置值的AJAX配置中无效（因为该项并不通过前端传递），和设置提交处理器或验证器方法一样，如“::yunkeTest”，可以是任意有效php回调，按次序接收三个参数：&$form、$form_state和请求对象，可以用他们获取用户当前的输入，回调应该返回渲染数组，字符串需用['#markup' => $markup]包装成渲染数组，此时除返回值外，消息管理器（\Drupal::messenger()）中的全部内容也会被返回；回调也可以返回json响应对象：
\Drupal\Core\Ajax\AjaxResponse
此时不会自动返回消息管理器中的内容，但可以明确通过命令的方式添加。
注意：回调在表单流程之后执行，如果AJAX用在非提交元素中，在回调执行前，表单验证器会执行，但验证错误被镇压，提交处理器不会被执行，如果用在提交元素中，验证器会执行，错误不会镇压，验证通过时提交器已执行，提交器返回的响应被忽略，最后执行回调，响应以回调的返回值为准
url：
AJAX请求地址，如果AJAX配置是在#ajax属性中指定，那么表明元素是表单元素，那么该项可以省略，内部会采用当前表单地址，如果不省略的话，则必须是url对象（\Drupal\Core\Url），如果AJAX配置是在附属物中指定，那么该项是必须的，且必须是一个字符串值，在前端以此项作为AJAX请求地址，并不关注callback
options：
仅当AJAX配置是在#ajax属性中指定时才有用，在url为url对象时，用于url对象的选项参数，在附属物中，AJAX配置的url项已经被转变成字符串，此时该项已经不需要存在了
在AJAX请求返回html内容时，用来放置内容的元素的id属性值，将来会用“selector”代替，以便可使用任意选择器来指定元素，目前只支持id，注意其值不要有“#”前缀
dialogType：
可选值为dialog、modal，表示以这些方式之一显示AJAX内容，优先级高于wrapper，在渲染数组的“#ajax”属性中设置无效，因为内部实际上据此包装格式会有不同的主内容渲染器，而“#ajax”属性仅支持AJAX主内容渲染器
method：
在使用wrapper 放置内容时，采用的jQuery放置方法，可选值有：replaceWith（替换整个id元素，这是默认值）、html（替换子内容）、append（在里面尾部追加）、prepend（在里面头部追加）、before（在外部前面追加）、after（在外面后面追加）
effect：
在放置内容时，采用的jQuery动画效果，可选值有：none （默认值，无效果）、slide（下拉显示）、fade（慢慢淡出）
speed：
在使用放置动画时的动画速度，可选值有：slow（慢）、fast（快）、none（默认值，jQuery默认速度）或者一个以毫秒为单位的数字
event：
在该元素上触发AJAX的js事件（后称AJAX事件），有默认值时是可选的，默认会依据表单元素的类型自动选择，见下文，如果提供了值将以提供值为准，如果没有默认值则必须指定，不带on前缀，如change、keyup、input等，当有多个时使用空格分隔，最终将传递给jquery的on方法，可带名字空间
prevent：
当触发AJAX的js事件发生时要阻止的其他事件，比如触发事件是mousedown，此时你可能会想阻止click事件，当有多个时使用空格分隔，最终将传递给jquery的on方法，可带名字空间，事件传播和默认动作都会被阻止；可与AJAX事件相同，不会影响AJAX，仅会阻止该事件的传播和默认动作，但这没有必要，因为AJAX行为默认会阻止事件的传播和默认动作
progress：
用于配置进度指示器，当不需要显示进度指示时，可以设置为false，一个数组值，各子键为：
type：进度指示器的类型，可选值有：throbber（在元素后边显示一个转圈的等待动画图片，默认值）、bar（结合其他选项以进度条方式显示）、fullscreen（全屏居中显示一个等待动画图标）、false（禁用指示器，布尔值）
message：提示消息，字符串值，如“请稍后…”，应该是被翻译过的，默认为Drupal.t('Please wait...')
url：使用进度条时，获取进度数据的url，字符串值，在#ajax属性中也可以是url对象
method：请求进度条更新url时使用的http方法，get或post，默认为get
interval：使用进度条时，多长时间更新一次，单位毫秒，默认1500毫秒
当数组中仅有type时，该项可简写为type表示的字符串值
disable-refocus：
布尔值，指示ajax调用后，是否禁止重新获得焦点，默认为false，也就是会重新获得焦点，很多时候需要被设置为true，否则焦点会被反复拉回到元素导致用户无法使用
keypress：
布尔值，是否在元素上监听键盘事件，以便可以通过按压空格或回车键触发AJAX事件，默认为true，将在元素上监听“keypress”事件，注意有四种类型的表单元素：text、textarea、tel、number即便设置了该项，也不会通过空格触发AJAX事件，但回车可以
submit：
额外提交到服务器的数据，一个数组值，键名为name，键值为value；前端系统默认的并不会设置是哪一个元素触发了ajax请求（也可以理解成不会设置是哪个元素触发了表单AJAX提交），如果AJAX配置是在#ajax属性中指定，为了告诉后端触发元素，系统在该项添加了以下变量：
_triggering_element_name：触发元素名
_triggering_element_value：触发元素值，可选
如果AJAX配置是在附属物中指定，需要用户来设定触发元素，如果没有设置，那么后端在不知道触发元素的情况，会以第一个按钮元素当做触发元素
trigger_as：
是一个数组，用于指定一个表单提交元素（让后端知道是哪个元素触发了表单提交），键名name为触发元素名，value为触发元素值，该项是可选的，默认以本元素的name和value作为触发元素名和值，仅在#ajax属性中有效，该项在附属物中的AJAX配置里会被删除（信息已经提取到submit项中）
setClick：
布尔值，仅用于表单提交元素，如提交按钮，指示将当前元素当做触发表单提交的元素，并传递其名值到服务器，在内部普通表单元素该项默认为false，使用“.use-ajax-submit”类的表单元素默认为true ，因为普通表单元素本就会被传递，且“.use-ajax-submit”类的表单元素会自动设置为true，因此该项用户无需理会，这里列出仅供程序研究参考，注：不要将该项和trigger_as项混淆，任何表单元素的AJAX操作都会提交整个表单，trigger_as项常用在当前元素为非提交元素时，指定提交元素，而该项仅用于提交元素，如按钮，指示是否将本元素当做提交元素，当发生冲突时，该项优先级高于trigger_as项。
AJAX配置默认事件：
在没有指定事件名时，以下元素类型（渲染数组类型）将采用默认事件：
submit、button、image_button
默认事件名：mousedown，同时在没有设置阻止事情的情况下阻止click事件
password、textfield、number、tel、textarea
默认事件名：blur
radio、checkbox、select、date
默认事件名：change
link
默认事件名：click
注意：除以上这些元素类型外，其他元素类型必须设置事件名，否则不被设置ajax行为
官网参考文档：
AJAX API概述：
https://api.drupal.org/api/drupal/core!core.api.php/group/ajax/
创建Ajax菜单链接：
https://www.drupal.org/docs/8/api/menu-api/making-ajax-menu-links
AJAX表单示例：
https://www.drupal.org/docs/8/api/javascript-api/ajax-forms
命令：
https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Ajax%21C…
补充：
1、如果在具备#ajax属性的元素上设置#ajax_processed，那么不论何值（NULL除外），只要设置了，那么就不会被附加AJAX行为，相当于没有给元素添加#ajax属性，调试时比较有用，被附加#ajax的元素处理后，会附加该属性，值为true。
2、在AJAX API中表单元素的AJAX操作总是提交整个表单值到后端，所有AJAX均以POST方式发起