Drupal 7 中Tableselect结合Ajax更新字段后手动修改值不生效问题

这个坑我之前踩过！大概率是你的表单构建逻辑里，每次重建表单时都直接用模板值硬覆盖了文本字段，完全没考虑用户已经手动修改过的输入。下面是具体的排查和修复步骤：

1. 修正表单字段的赋值逻辑 #

别再用#value强制设置字段值了！#value会直接忽略用户的任何输入，哪怕你手动改了，表单重建时又会被打回原形。正确的做法是用#default_value，并且优先读取$form_state里已有的值——不管是模板填充的还是用户手动改的。

举个Drupal 8+/9/10的示例：

public function buildForm(array $form, FormStateInterface $form_state) {
    $default_text = '';

    // 优先用用户已经输入/通过模板设置的值
    if ($form_state->hasValue('text')) {
        $default_text = $form_state->getValue('text');
    } 
    // 只有当没有用户输入时，才用选中模板对应的值
    elseif ($selected_template = $form_state->getValue('tableselect_field')) {
        // 这里替换成你获取模板文本的逻辑
        $default_text = $this->getTemplateContent($selected_template);
    }

    $form['text'] = [
        '#type' => 'textfield',
        '#title' => t('自定义文本'),
        '#default_value' => $default_text,
        '#ajax' => [
            'callback' => '::updateTextFromTemplate',
            'wrapper' => 'text-field-container',
        ],
        '#prefix' => '<div id="text-field-container">',
        '#suffix' => '</div>',
    ];

    // 你的tableselect字段和其他表单元素...
    return $form;
}

2. 检查AJAX回调的处理逻辑 #

如果是用AJAX实现选择模板后实时更新文本，千万别在回调里直接给字段赋值#value！回调只需要返回更新后的表单元素，让#default_value的逻辑去处理值的来源：

public function updateTextFromTemplate(array &$form, FormStateInterface $form_state) {
    // 直接返回字段即可，不要在这里硬改值
    return $form['text'];
}

3. 调试验证阶段的实际值 #

如果还是没解决，先在验证钩子里打个调试信息，看看$form_state里到底存了什么：

public function validateForm(array &$form, FormStateInterface $form_state) {
    // 临时调试用，上线记得删掉
    kint($form_state->getValues());
    parent::validateForm($form, $form_state);
}

这样能快速定位是表单构建时覆盖了值，还是提交环节出了问题。

4. 可选：增加用户输入保护（按需） #

如果业务上需要避免用户修改后被模板覆盖，可以加个判断——只有当文本字段为空时，才用模板值填充：

if ($selected_template = $form_state->getValue('tableselect_field')) {
    if (empty($form_state->getValue('text'))) {
        $default_text = $this->getTemplateContent($selected_template);
    }
}

核心思路就是：永远优先尊重用户的输入，模板值只作为初始默认选项，而不是强制覆盖的规则。

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