diff --git a/aio/content/translations/cn/api-plan.md b/aio/content/translations/cn/api-plan.md index 973db45ed2..0c54f4fd44 100644 --- a/aio/content/translations/cn/api-plan.md +++ b/aio/content/translations/cn/api-plan.md @@ -94,8 +94,8 @@ [x] | core/SimpleChange | 0.18 [x] | core/SimpleChanges | 0.18 [x] | forms/NgSelectOption | 0.17 -[ ] | common/PercentPipe | 0.17 -[ ] | forms/ValidatorFn | 0.17 +[x] | common/PercentPipe | 0.17 +[x] | forms/ValidatorFn | 0.17 [ ] | http/RequestOptionsArgs | 0.17 [ ] | animations/animation | 0.17 [x] | common/NgSwitchCase | 0.16 diff --git a/packages/forms/src/directives/validators.ts b/packages/forms/src/directives/validators.ts index 2297c42b58..c64a6b8e4a 100644 --- a/packages/forms/src/directives/validators.ts +++ b/packages/forms/src/directives/validators.ts @@ -21,8 +21,12 @@ export type ValidationErrors = { /** * An interface that can be implemented by classes that can act as validators. * + * 一个接口,实现了它的类可以扮演验证器的角色。 + * * ## Usage * + * ## 用法 + * * ```typescript * @Directive({ * selector: '[custom-validator]', @@ -64,8 +68,12 @@ export const CHECKBOX_REQUIRED_VALIDATOR: StaticProvider = { * A Directive that adds the `required` validator to any controls marked with the * `required` attribute, via the `NG_VALIDATORS` binding. * + * 该指令会借助 `NG_VALIDATORS` 绑定把 `required` 验证器添加到任何带 `required` 属性的控件上。 + * * ### Example * + * ### 例子 + * * ``` * * ``` @@ -104,8 +112,12 @@ export class RequiredValidator implements Validator { * A Directive that adds the `required` validator to checkbox controls marked with the * `required` attribute, via the `NG_VALIDATORS` binding. * + * 该指令会借助 `NG_VALIDATORS` 绑定把 `required` 验证器添加到任何带有 `required` 属性的检查框控件上。 + * * ### Example * + * ### 例子 + * * ``` * * ``` @@ -126,6 +138,8 @@ export class CheckboxRequiredValidator extends RequiredValidator { /** * Provider which adds `EmailValidator` to `NG_VALIDATORS`. + * + * 该提供商用于把 `EmailValidator` 添加到 `NG_VALIDATORS` 中。 */ export const EMAIL_VALIDATOR: any = { provide: NG_VALIDATORS, @@ -137,8 +151,12 @@ export const EMAIL_VALIDATOR: any = { * A Directive that adds the `email` validator to controls marked with the * `email` attribute, via the `NG_VALIDATORS` binding. * + * 该指令会借助 `NG_VALIDATORS` 绑定把 `email` 验证器添加到任何带有 `email` 属性的控件上。 + * * ### Example * + * ### 例子 + * * ``` * * @@ -179,8 +197,12 @@ export interface AsyncValidatorFn { /** * Provider which adds `MinLengthValidator` to `NG_VALIDATORS`. * + * 该提供商用于把 `MinLengthValidator` 添加到 `NG_VALIDATORS` 中。 + * * ## Example: * + * ## 例子 + * * {@example common/forms/ts/validators/validators.ts region='min'} */ export const MIN_LENGTH_VALIDATOR: any = { @@ -194,6 +216,8 @@ export const MIN_LENGTH_VALIDATOR: any = { * `formControl`, or control with `ngModel` that also has a `minlength` attribute. * * + * 该指令会把 `MinLengthValidator` 验证器安装到任何具有 `minlength` 属性的 `formControlName`、 + * `formControl` 或带 `ngModel` 的控件上。 */ @Directive({ selector: '[minlength][formControlName],[minlength][formControl],[minlength][ngModel]', @@ -231,8 +255,12 @@ export class MinLengthValidator implements Validator, /** * Provider which adds `MaxLengthValidator` to `NG_VALIDATORS`. * + * 该提供商用于把 `MaxLengthValidator` 添加到 `NG_VALIDATORS` 中。 + * * ## Example: * + * ## 例子: + * * {@example common/forms/ts/validators/validators.ts region='max'} */ export const MAX_LENGTH_VALIDATOR: any = { @@ -246,6 +274,8 @@ export const MAX_LENGTH_VALIDATOR: any = { * `formControl`, or control with `ngModel` that also has a `maxlength` attribute. * * + * 该指令会把 `MaxLengthValidator` 验证器安装到任何具有 `minlength` 属性的 `formControlName`、 + * `formControl` 或带 `ngModel` 的控件上。 */ @Directive({ selector: '[maxlength][formControlName],[maxlength][formControl],[maxlength][ngModel]', @@ -294,8 +324,14 @@ export const PATTERN_VALIDATOR: any = { * as the regex to validate Control value against. Follows pattern attribute * semantics; i.e. regex must match entire Control value. * + * 该指令会借助 `NG_VALIDATORS` 绑定来把 `pattern` 验证器添加到任何带有 `pattern` 属性的控件上。 + * 它会使用该属性的值作为正则表达式来验证控件的值。 + * 它会遵循 `pattern` 属性的语义,也就是说,该正则表达式必须匹配整个控件值。 + * * ### Example * + * ### 例子 + * * ``` * * ```