Skip to content

Commit faf50ee

Browse files
authored
translate: update Signal Forms tutorial steps (#218)
Apply only the English delta (Angular v22.1) to the Spanish translation, without retranslating: - `Field` directive renamed to `FormField`, and `[field]` to `[formField]` in prose, step titles and examples - Drop `changeDetection: ChangeDetectionStrategy.OnPush` from the component example in step 2 - Template fences `html` -> `angular-html` where the original changed - Code formatting aligned with the original (no spaces inside braces, single-line `<form>` and `<button>` elements) The .en.md files already hold the new English since 1b24621 and are unchanged. Fixes #202
1 parent 3afe558 commit faf50ee

5 files changed

Lines changed: 30 additions & 33 deletions

File tree

adev-es/src/content/tutorials/signal-forms/steps/1-set-up-form-model/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@ Agrega esta interfaz sobre el decorador `@Component`.
3636
Importa la función `signal` desde `@angular/core` y la función `form` desde `@angular/forms/signals`:
3737

3838
```ts
39-
import { Component, signal } from '@angular/core';
40-
import { form } from '@angular/forms/signals';
39+
import {Component, signal} from '@angular/core';
40+
import {form} from '@angular/forms/signals';
4141
```
4242

4343
</docs-step>
Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# Conectar tu formulario a la plantilla
22

3-
Ahora, necesitas conectar tu formulario a la plantilla usando la directiva `[field]`. Esto crea un enlace bidireccional de datos entre tu modelo de formulario y los elementos de entrada.
3+
Ahora, necesitas conectar tu formulario a la plantilla usando la directiva `[formField]`. Esto crea un enlace bidireccional de datos entre tu modelo de formulario y los elementos de entrada.
44

55
En esta lección, aprenderás cómo:
66

7-
- Importar la directiva `Field`
8-
- Usar la directiva `[field]` para enlazar campos del formulario a inputs
7+
- Importar la directiva `FormField`
8+
- Usar la directiva `[formField]` para enlazar campos del formulario a inputs
99
- Conectar inputs de texto y checkboxes a tu formulario
1010
- Mostrar los valores de los campos del formulario en la plantilla
1111

@@ -15,55 +15,54 @@ En esta lección, aprenderás cómo:
1515

1616
<docs-workflow>
1717

18-
<docs-step title="Importa la directiva Field">
19-
Importa la directiva `Field` desde `@angular/forms/signals` y agrégala al arreglo imports de tu componente:
18+
<docs-step title="Importa la directiva FormField">
19+
Importa la directiva `FormField` desde `@angular/forms/signals` y agrégala al arreglo imports de tu componente:
2020

2121
```ts
22-
import { form, Field } from '@angular/forms/signals';
22+
import { form, FormField } from '@angular/forms/signals';
2323

2424
@Component({
2525
selector: 'app-root',
2626
templateUrl: './app.html',
2727
styleUrl: './app.css',
28-
imports: [Field],
29-
changeDetection: ChangeDetectionStrategy.OnPush,
28+
imports: [FormField],
3029
})
3130
```
3231

3332
</docs-step>
3433

3534
<docs-step title="Enlaza el campo email">
36-
En tu plantilla, agrega la directiva `[field]` al input de email:
35+
En tu plantilla, agrega la directiva `[formField]` al input de email:
3736

3837
```html
39-
<input type="email" [field]="loginForm.email" />
38+
<input type="email" [formField]="loginForm.email" />
4039
```
4140

4241
La expresión `loginForm.email` accede al campo email desde tu formulario.
4342
</docs-step>
4443

4544
<docs-step title="Enlaza el campo password">
46-
Agrega la directiva `[field]` al input de password:
45+
Agrega la directiva `[formField]` al input de password:
4746

4847
```html
49-
<input type="password" [field]="loginForm.password" />
48+
<input type="password" [formField]="loginForm.password" />
5049
```
5150

5251
</docs-step>
5352

5453
<docs-step title="Enlaza el campo checkbox">
55-
Agrega la directiva `[field]` al input checkbox:
54+
Agrega la directiva `[formField]` al input checkbox:
5655

5756
```html
58-
<input type="checkbox" [field]="loginForm.rememberMe" />
57+
<input type="checkbox" [formField]="loginForm.rememberMe" />
5958
```
6059

6160
</docs-step>
6261

6362
<docs-step title="Muestra los valores del formulario">
6463
Debajo del formulario, hay una sección de depuración para mostrar los valores actuales del formulario. Muestra cada valor de campo usando `.value()`:
6564

66-
```html
65+
```angular-html
6766
<p>Email: {{ loginForm.email().value() }}</p>
6867
<p>Password: {{ loginForm.password().value() ? '••••••••' : '(empty)' }}</p>
6968
<p>Remember me: {{ loginForm.rememberMe().value() ? 'Yes' : 'No' }}</p>
@@ -74,6 +73,6 @@ Los valores de los campos del formulario son signals, por lo que los valores mos
7473

7574
</docs-workflow>
7675

77-
¡Excelente trabajo! Has conectado tu formulario a la plantilla y mostrado los valores del formulario. La directiva `[field]` maneja el enlace bidireccional de datos automáticamente — mientras escribes, el signal `loginModel` se actualiza, y los valores mostrados se actualizan inmediatamente.
76+
¡Excelente trabajo! Has conectado tu formulario a la plantilla y mostrado los valores del formulario. La directiva `[formField]` maneja el enlace bidireccional de datos automáticamente — mientras escribes, el signal `loginModel` se actualiza, y los valores mostrados se actualizan inmediatamente.
7877

7978
A continuación, aprenderás [cómo agregar validación a tu formulario](/tutorials/signal-forms/3-add-validation)!

adev-es/src/content/tutorials/signal-forms/steps/3-add-validation/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ En esta actividad, aprenderás cómo:
1818
Importa los validadores `required` y `email` desde `@angular/forms/signals`:
1919

2020
```ts
21-
import { form, Field, required, email } from '@angular/forms/signals';
21+
import {form, FormField, required, email} from '@angular/forms/signals';
2222
```
2323

2424
</docs-step>
@@ -39,8 +39,8 @@ Dentro de la función de esquema, agrega validación para el campo email. Usa am
3939

4040
```ts
4141
loginForm = form(this.loginModel, (fieldPath) => {
42-
required(fieldPath.email, { message: 'Email is required' });
43-
email(fieldPath.email, { message: 'Enter a valid email address' });
42+
required(fieldPath.email, {message: 'Email is required'});
43+
email(fieldPath.email, {message: 'Enter a valid email address'});
4444
});
4545
```
4646

@@ -52,9 +52,9 @@ Agrega validación para el campo password usando el validador `required()`:
5252

5353
```ts
5454
loginForm = form(this.loginModel, (fieldPath) => {
55-
required(fieldPath.email, { message: 'Email is required' });
56-
email(fieldPath.email, { message: 'Enter a valid email address' });
57-
required(fieldPath.password, { message: 'Password is required' });
55+
required(fieldPath.email, {message: 'Email is required'});
56+
email(fieldPath.email, {message: 'Enter a valid email address'});
57+
required(fieldPath.password, {message: 'Password is required'});
5858
});
5959
```
6060

adev-es/src/content/tutorials/signal-forms/steps/4-display-errors/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,10 @@ En esta actividad, aprenderás cómo:
1818
<docs-step title="Agrega visualización de errores para el campo email">
1919
Debajo del input de email, agrega visualización condicional de errores. Esto solo mostrará errores cuando el campo sea tanto inválido como touched:
2020

21-
```html
21+
```angular-html
2222
<label>
2323
Email
24-
<input type="email" [field]="loginForm.email" />
24+
<input type="email" [formField]="loginForm.email" />
2525
</label>
2626
@if (loginForm.email().invalid() && loginForm.email().touched()) {
2727
<div class="error">
@@ -38,10 +38,10 @@ La llamada `loginForm.email()` accede al signal de estado del campo. El método
3838
<docs-step title="Agrega visualización de errores para el campo password">
3939
Debajo del input de password, agrega el mismo patrón para errores de password:
4040

41-
```html
41+
```angular-html
4242
<label>
4343
Password
44-
<input type="password" [field]="loginForm.password" />
44+
<input type="password" [formField]="loginForm.password" />
4545
</label>
4646
@if (loginForm.password().invalid() && loginForm.password().touched()) {
4747
<div class="error">

adev-es/src/content/tutorials/signal-forms/steps/5-add-submission/README.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ En esta actividad, aprenderás cómo:
1919
Importa la función `submit` desde `@angular/forms/signals`:
2020

2121
```ts
22-
import { form, Field, required, email, submit } from '@angular/forms/signals';
22+
import {form, FormField, required, email, submit} from '@angular/forms/signals';
2323
```
2424

2525
</docs-step>
@@ -45,7 +45,7 @@ La función `submit()` solo ejecuta tu callback asíncrono si el formulario es v
4545
En tu plantilla, enlaza el método `onSubmit()` al evento submit del formulario:
4646

4747
```html
48-
<form (submit)="onSubmit($event)">
48+
<form (submit)="onSubmit($event)"></form>
4949
```
5050

5151
</docs-step>
@@ -54,9 +54,7 @@ En tu plantilla, enlaza el método `onSubmit()` al evento submit del formulario:
5454
Actualiza el botón de envío para que esté deshabilitado cuando el formulario sea inválido:
5555

5656
```html
57-
<button type="submit" [disabled]="loginForm().invalid()">
58-
Log in
59-
</button>
57+
<button type="submit" [disabled]="loginForm().invalid()">Log in</button>
6058
```
6159

6260
Esto previene el envío cuando el formulario tiene errores de validación.

0 commit comments

Comments
 (0)