本文介绍如何在 Angular 响应式表单中，根据 payable_frequency_ref_id 下拉框的选择状态，动态控制 min_payable_commission 和 max_payable_commission 两个字段的必填性——仅当有有效选项被选中时，二者中至少一个为必填，并支持 mat-error 提示。

本文介绍如何在 angular 响应式表单中，根据 `payable_frequency_ref_id` 下拉框的选择状态，动态控制 `min_payable_commission` 和 `max_payable_commission` 两个字段的必填性——仅当有有效选项被选中时，二者中**至少一个为必填**，并支持 `mat-error` 提示。

在 Angular 表单开发中，常见的“条件必填”需求（如：某下拉框有值时，关联字段才需填写）不能简单依赖静态 Validators.required，而需通过动态响应式验证逻辑实现。本文提供一种简洁、可维护、符合 Angular 最佳实践的解决方案：使用跨控件自定义验证器（cross-field custom validator），它不修改模板中的 required 属性，也不在 ngOnInit 中硬编码初始验证规则，而是让验证逻辑感知整个表单状态。

✅ 推荐方案：跨控件自定义验证器（推荐）

核心思想是：将 min_payable_commission 和 max_payable_commission 的验证逻辑统一收口到一个表单级验证器中，该验证器检查 payable_frequency_ref_id 是否有值；若有，则确保二者中至少一个非空。

⚠️ 注意：原问题中尝试对单个字段（如 min_payable_commission）单独加 validator 是无效的，因为单字段 validator 无法访问其他字段值（this 上下文受限）。正确做法是将验证器绑定到整个 FormGroup，或使用 FormBuilder.group() 的第二个参数传入 validators。

步骤 1：定义表单并注入跨字段验证器

// component.ts
import { Component, OnInit, OnDestroy } from '@angular/core';
import { FormBuilder, FormGroup, Validators, AbstractControl, ValidationErrors, FormGroupDirective } from '@angular/forms';
import { Subscription } from 'rxjs';

@Component({
  // ...
})
export class YourComponent implements OnInit, OnDestroy {
  couauiChargesForm: FormGroup;
  private sub: Subscription;

  constructor(
    private formBuilder: FormBuilder
  ) {}

  ngOnInit(): void {
    this.couauiChargesForm = this.formBuilder.group({
      id: [''],
      payable_frequency_ref_id: [''],
      min_payable_commission: [''],
      max_payable_commission: ['']
    }, {
      validators: this.atLeastOneCommissionRequired // ? 绑定到整个 FormGroup
    });
  }

  // ✅ 跨字段验证器：确保当 frequency 有值时，min 或 max 至少一个非空
  atLeastOneCommissionRequired(formGroup: AbstractControl): ValidationErrors | null {
    const freqCtrl = formGroup.get('payable_frequency_ref_id');
    const minCtrl = formGroup.get('min_payable_commission');
    const maxCtrl = formGroup.get('max_payable_commission');

    // 仅当 frequency 已选择（非空字符串/非 null/非 undefined）时触发校验
    if (freqCtrl && freqCtrl.value && freqCtrl.value !== '') {
      const hasMin = minCtrl?.value !== null && minCtrl?.value !== '';
      const hasMax = maxCtrl?.value !== null && maxCtrl?.value !== '';

      if (!hasMin && !hasMax) {
        // ❌ 两者均为空 → 整个表单组标记为无效，并为两个字段设置错误
        // 注意：此处返回错误对象作用于 FormGroup，需在模板中用 get() 检查具体字段
        return { 'atLeastOneRequired': true };
      }
    }

    return null; // ✅ 校验通过
  }

  ngOnDestroy(): void {
    this.sub?.unsubscribe();
  }
}

步骤 2：更新 HTML 模板，正确显示错误信息

关键点：

• mat-error 需绑定到 具体字段，但错误来源是 FormGroup 级别；
• 因此我们利用 formGroup.hasError() + formControl.hasError() 组合判断；
• 同时，为提升用户体验，建议仅当字段已触碰（touched）或已提交时再显示错误（避免初始空白即报错）。

<!-- Payable Frequency -->
<div class="col-lg-4 col-md-4 col-sm-4 col-xs-12">
  <mat-label>Payable Frequency</mat-label>
  <mat-form-field class="example-full-width" appearance="outline">
    <mat-select formControlName="payable_frequency_ref_id">
      <mat-option value="">Select Payable Frequency</mat-option>
      <mat-option [value]="data.id" *ngFor="let data of billingFrequencyData">
        {{ data.master_key }}
      </mat-option>
    </mat-select>
  </mat-form-field>
</div>

<!-- Min Payable Commission -->
<div class="col-lg-4 col-md-4 col-sm-4 col-xs-12">
  <div class="form-group">
    <mat-label>Min Payable Commission</mat-label>
    <mat-form-field class="example-full-width" appearance="outline">
      <input matInput 
             formControlName="min_payable_commission" 
             type="number" 
             placeholder="0">
      <!-- ✅ 错误显示逻辑：当 FormGroup 有 atLeastOneRequired 错误，且当前字段为空，且已 touched -->
      <mat-error *ngIf="couauiChargesForm.hasError('atLeastOneRequired') && 
                        !couauiChargesForm.get('min_payable_commission')?.value && 
                        couauiChargesForm.get('min_payable_commission')?.touched">
        At least one of Min or Max Payable Commission is required.
      </mat-error>
    </mat-form-field>
  </div>
</div>

<!-- Max Payable Commission -->
<div class="col-lg-4 col-md-4 col-sm-4 col-xs-12">
  <div class="form-group">
    <mat-label>Max Payable Commission</mat-label>
    <mat-form-field class="example-full-width" appearance="outline">
      <input matInput 
             formControlName="max_payable_commission" 
             type="number" 
             min="0" 
             placeholder="0">
      <mat-error *ngIf="couauiChargesForm.hasError('atLeastOneRequired') && 
                        !couauiChargesForm.get('max_payable_commission')?.value && 
                        couauiChargesForm.get('max_payable_commission')?.touched">
        At least one of Min or Max Payable Commission is required.
      </mat-error>
    </mat-form-field>
  </div>
</div>

✅ 进阶优化（可选）

• 自动标记 touched：可在 payable_frequency_ref_id 变更时，主动调用 markAsTouched()，使错误提示更及时：

  ngOnInit() {
    // ... 创建表单后
    this.sub = this.couauiChargesForm.get('payable_frequency_ref_id')!.valueChanges.subscribe(() => {
      this.couauiChargesForm.get('min_payable_commission')?.markAsTouched();
      this.couauiChargesForm.get('max_payable_commission')?.markAsTouched();
      this.couauiChargesForm.updateValueAndValidity(); // 触发重新校验
    });
  }

• 支持数字类型校验：若字段需严格为数字，可额外添加 Validators.pattern(/^\d*\.?\d+$/) 或自定义数字 validator，避免输入 "" 或 "abc" 导致逻辑误判。

? 总结与注意事项

• ✅ 不要对单字段绑定依赖其他字段的 validator（如 min_payable_commission: ['', commissionValidator]），因其 this 不指向 FormGroup，无法读取 payable_frequency_ref_id。
• ✅ 优先使用 FormGroup 级 validator，语义清晰、逻辑集中、易于测试。
• ✅ mat-error 的显示条件必须包含 .touched 或结合提交状态（如 form.submitted），避免用户未操作即看到错误提示。
• ⚠️ 避免在模板中使用 *ngIf="form.hasError(...)" 时不加字段空值判断，否则可能因 null 值引发运行时错误。
• ? 若业务要求更复杂（如：选 A 时 min 必填、选 B 时 max 必填），可扩展 atLeastOneCommissionRequired 函数，增加 switch(freqCtrl.value) 分支逻辑。

该方案完全满足原始需求：零侵入模板 required 属性、不手动调用 setValidators()、不依赖 (selectionChange) 事件回调，符合 Angular 响应式表单的设计哲学，具备高可读性与可维护性。