Drupal 11中为地址字段State选择框添加AJAX的方法求助

问题根源 #

Address模块的administrative_area（State）元素是在表单元素的process阶段动态生成的，你之前挂载#after_build的时机过早，导致修改的AJAX属性被后续模块的构建逻辑覆盖；而#attributes生效是因为该属性不会被模块默认逻辑重置。

可行解决方案 #

方案一：调整#after_build挂载层级

将#after_build从address子元素移到字段widget层级，确保在所有子元素完全生成后再修改administrative_area的属性：

<?php

function my_module_node_page_edit_form_alter(array &$form, FormStateInterface $form_state, $form_id)
{
  // 挂载到widget父元素，等待address子元素完全构建
  $form['field_address']['widget'][0]['#after_build'][] = 'my_module_field_address_widget_after_build';
}

function my_module_field_address_widget_after_build(array $element, FormStateInterface $form_state) {
  if (isset($element['address']['administrative_area'])) {
    $element['address']['administrative_area']['#ajax'] = [
      'callback' => 'address_us_county_update_county_callback',
      'event' => 'change',
      'wrapper' => 'field-b-county-wrapper',
      'progress' => [
        'type' => 'throbber',
        'message' => t('加载区县数据...'),
      ],
    ];
    // 不要直接覆盖属性，避免丢失原有设置
    $element['address']['administrative_area']['#attributes']['style'] = 'background-color: #ffff00;';
  }
  return $element;
}

// 确保AJAX回调函数正确返回目标元素
function address_us_county_update_county_callback(array &$form, FormStateInterface $form_state) {
  // 替换为实际需要更新的区县字段键名
  return $form['field_b_county'];
}

方案二：通过hook_element_info_alter修改address元素的process回调

直接修改address类型表单元素的处理逻辑，在模块默认生成administrative_area后添加AJAX属性：

<?php

function my_module_element_info_alter(array &$types) {
  if (isset($types['address'])) {
    // 将自定义process回调添加到末尾，确保在默认逻辑后执行
    $types['address']['#process'][] = 'my_module_address_element_process';
  }
}

function my_module_address_element_process(array $element, FormStateInterface $form_state, array &$complete_form) {
  if (isset($element['administrative_area'])) {
    $element['administrative_area']['#ajax'] = [
      'callback' => 'address_us_county_update_county_callback',
      'event' => 'change',
      'wrapper' => 'field-b-county-wrapper',
    ];
    $element['administrative_area']['#attributes']['style'] = 'background-color: #ffff00;';
  }
  return $element;
}

// AJAX回调函数示例
function address_us_county_update_county_callback(array &$form, FormStateInterface $form_state) {
  return $form['field_b_county'];
}

额外注意事项 #

• 确认field-b-county-wrapper确实存在于表单中（区县字段的#prefix和#suffix需要包含该ID）；
• 不要直接覆盖#attributes，使用数组合并方式避免丢失模块默认添加的属性（如必填类、数据属性等）；
• 测试时清空Drupal缓存，确保钩子函数生效。

内容的提问来源于stack exchange，提问作者Sevenfish