ngx-intl-tel-input 不支持 excludeCountries 输入属性；正确做法是使用 onlyCountries 显式声明允许显示的国家列表，通过过滤 CountryISO 枚举动态生成剔除目标国家后的数组。
ngx-intl-tel-input 不支持 `excludecountries` 输入属性；正确做法是使用 `onlycountries` 显式声明允许显示的国家列表，通过过滤 `countryiso` 枚举动态生成剔除目标国家后的数组。
在 ngx-intl-tel-input 中实现“排除某些国家”（例如墨西哥、美国等）的需求时，不能依赖不存在的 excludeCountries 属性——该属性未被库官方支持，直接使用将被忽略且无任何报错提示。
✅ 正确方案是：利用 [onlyCountries] 输入，传入一个仅包含你希望保留的国家 ISO 码的数组。由于 CountryISO 是一个枚举对象（键为字符串，值为 ISO 2 字母码），我们可通过 Object.keys() 遍历并过滤掉不希望出现的国家。
✅ 基础用法：排除单个国家（如墨西哥）
import { Component } from '@angular/core';
import { CountryISO, SearchCountryField } from 'ngx-intl-tel-input';
@Component({
selector: 'app-phone-input',
templateUrl: './phone-input.component.html'
})
export class PhoneInputComponent {
// 排除墨西哥（MX）
onlyCountries: CountryISO[] = Object.keys(CountryISO)
.filter(key => CountryISO[key] !== CountryISO.Mexico)
.map(key => CountryISO[key]);
}✅ 进阶用法：排除多个国家
onlyCountries: CountryISO[] = Object.keys(CountryISO) .filter(key => ![CountryISO.Mexico, CountryISO.UnitedStates, CountryISO.Canada].includes(CountryISO[key])) .map(key => CountryISO[key]);
? 提示：includes() 比 some(y => y === ...) 更简洁可读，且类型安全（TypeScript 会自动推导 CountryISO[key] 类型为 CountryISO）。
✅ 模板中绑定
<ngx-intl-tel-input class="form-control" [enableAutoCountrySelect]="true" [enablePlaceholder]="false" [searchCountryFlag]="true" [searchCountryField]="[SearchCountryField.Iso2, SearchCountryField.Name]" [selectFirstCountry]="false" [selectedCountryISO]="ES" [maxLength]="15" [separateDialCode]="true" [phoneValidation]="true" [onlyCountries]="onlyCountries" [preferredCountries]="[CountryISO.Spain]" > </ngx-intl-tel-input>
⚠️ 注意事项
- onlyCountries 和 preferredCountries 可共存，但所有 preferredCountries 必须是 onlyCountries 的子集，否则首选项可能不生效；
- 若 onlyCountries 为空数组，组件将不渲染国家选择器（行为未定义，应避免）；
- CountryISO 枚举值固定（如 CountryISO.Mexico === 'MX'），确保导入路径正确（通常来自 'ngx-intl-tel-input'）；
- 如需动态更新（如根据用户角色切换白名单），请将 onlyCountries 声明为 getter 或使用 ChangeDetectorRef 触发更新。
通过该方式，你不仅能精准控制国家列表可见性，还能保持代码可维护性与类型安全性——这是 ngx-intl-tel-input 官方推荐且稳定可靠的实践方案。
