-
Notifications
You must be signed in to change notification settings - Fork 0
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
translate: translations for components/anatomy-of-components guide #15
Open
ricardochl
wants to merge
1
commit into
main
Choose a base branch
from
translate-anatomy-of-components-guide
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
102 changes: 102 additions & 0 deletions
102
adev-es/src/content/guide/components/anatomy-of-components.en.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,102 @@ | ||
<docs-decorative-header title="Anatomy of a component" imgSrc="adev/src/assets/images/components.svg"> <!-- markdownlint-disable-line --> | ||
</docs-decorative-header> | ||
|
||
Tip: This guide assumes you've already read the [Essentials Guide](essentials). Read that first if you're new to Angular. | ||
|
||
Every component must have: | ||
|
||
* A TypeScript class with _behaviors_ such as handling user input and fetching data from a server | ||
* An HTML template that controls what renders into the DOM | ||
* A [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors) that defines how the component is used in HTML | ||
|
||
You provide Angular-specific information for a component by adding a `@Component` [decorator](https://www.typescriptlang.org/docs/handbook/decorators.html) on top of the TypeScript class: | ||
|
||
<docs-code language="ts" highlight="[1, 2, 3, 4]"> | ||
@Component({ | ||
selector: 'profile-photo', | ||
template: `<img src="profile-photo.jpg" alt="Your profile photo">`, | ||
}) | ||
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
For full details on writing Angular templates, see the [Templates guide](guide/templates). | ||
|
||
The object passed to the `@Component` decorator is called the component's **metadata**. This includes the `selector`, `template`, and other properties described throughout this guide. | ||
|
||
Components can optionally include a list of CSS styles that apply to that component's DOM: | ||
|
||
<docs-code language="ts" highlight="[4]"> | ||
@Component({ | ||
selector: 'profile-photo', | ||
template: `<img src="profile-photo.jpg" alt="Your profile photo">`, | ||
styles: `img { border-radius: 50%; }`, | ||
}) | ||
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
By default, a component's styles only affect elements defined in that component's template. See [Styling Components](guide/components/styling) for details on Angular's approach to styling. | ||
|
||
You can alternatively choose to write your template and styles in separate files: | ||
|
||
<docs-code language="ts" highlight="[3, 4]"> | ||
@Component({ | ||
selector: 'profile-photo', | ||
templateUrl: 'profile-photo.html', | ||
styleUrl: 'profile-photo.css', | ||
}) | ||
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
This can help separate the concerns of _presentation_ from _behavior_ in your project. You can choose one approach for your entire project, or you decide which to use for each component. | ||
|
||
Both `templateUrl` and `styleUrl` are relative to the directory in which the component resides. | ||
|
||
## Using components | ||
|
||
Every component defines a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors): | ||
|
||
<docs-code language="ts" highlight="[2]"> | ||
@Component({ | ||
selector: 'profile-photo', | ||
... | ||
}) | ||
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
See [Component Selectors](guide/components/selectors) for details about which types of selectors Angular supports and guidance on choosing a selector. | ||
|
||
You use a component by creating a matching HTML element in the template of _other_ components: | ||
|
||
<docs-code language="ts" highlight="[4]"> | ||
@Component({ | ||
selector: 'user-profile', | ||
template: ` | ||
<profile-photo /> | ||
<button>Upload a new profile photo</button>`, | ||
..., | ||
}) | ||
export class UserProfile { } | ||
</docs-code> | ||
|
||
See [Importing and using components](guide/components/importing) for details on how to reference and use other components in your template. | ||
|
||
Angular creates an instance of the component for every matching HTML element it encounters. The DOM element that matches a component's selector is referred to as that component's **host element**. The contents of a component's template are rendered inside its host element. | ||
|
||
The DOM rendered by a component, corresponding to that component's template, is called that | ||
component's **view**. | ||
|
||
In composing components in this way, **you can think of your Angular application as a tree of components**. | ||
|
||
```mermaid | ||
flowchart TD | ||
A[AccountSettings]-->B | ||
A-->C | ||
B[UserProfile]-->D | ||
B-->E | ||
C[PaymentInfo] | ||
D[ProfilePic] | ||
E[UserBio] | ||
``` | ||
|
||
|
||
This tree structure is important to understanding several other Angular concepts, including [dependency injection](guide/di) and [child queries](guide/components/queries). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,42 +1,42 @@ | ||
<docs-decorative-header title="Anatomy of a component" imgSrc="adev/src/assets/images/components.svg"> <!-- markdownlint-disable-line --> | ||
<docs-decorative-header title="Anatomía de Componentes" imgSrc="adev/src/assets/images/components.svg"> <!-- markdownlint-disable-line --> | ||
</docs-decorative-header> | ||
|
||
Tip: This guide assumes you've already read the [Essentials Guide](essentials). Read that first if you're new to Angular. | ||
Sugerencia: Esta guía asume que ya has leído [Guía de Esenciales](essentials). Lee eso primero si eres nuevo en Angular. | ||
|
||
Every component must have: | ||
Cada componente debe tener: | ||
|
||
* A TypeScript class with _behaviors_ such as handling user input and fetching data from a server | ||
* An HTML template that controls what renders into the DOM | ||
* A [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors) that defines how the component is used in HTML | ||
* Una clase TypeScript con _comportamientos_ como el manejo de la entrada del usuario y la obtención de datos desde un servidor | ||
* Una plantilla HTML que controla lo que se renderiza en el DOM | ||
* Un [selector CSS](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors) que define cómo se utiliza el componente en HTML | ||
|
||
You provide Angular-specific information for a component by adding a `@Component` [decorator](https://www.typescriptlang.org/docs/handbook/decorators.html) on top of the TypeScript class: | ||
Usted proporciona información específica de Angular para un componente agregando un [decorador](https://www.typescriptlang.org/docs/handbook/decorators.html) `@Component` en la parte superior de la clase TypeScript: | ||
|
||
<docs-code language="ts" highlight="[1, 2, 3, 4]"> | ||
@Component({ | ||
selector: 'profile-photo', | ||
template: `<img src="profile-photo.jpg" alt="Your profile photo">`, | ||
template: `<img src="profile-photo.jpg" alt="Su foto de perfil">`, | ||
}) | ||
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
For full details on writing Angular templates, see the [Templates guide](guide/templates). | ||
Para obtener más información sobre cómo escribir plantillas de Angular, consulte la [Guía de Plantillas](guide/templates). | ||
|
||
The object passed to the `@Component` decorator is called the component's **metadata**. This includes the `selector`, `template`, and other properties described throughout this guide. | ||
El objeto pasado al decorador `@Component` se llama **metadatos** del componente. Éste incluye el `selector`, `template`, y otras propiedades descritas a lo largo de esta guía. | ||
|
||
Components can optionally include a list of CSS styles that apply to that component's DOM: | ||
Los componentes pueden incluir opcionalmente una lista de estilos CSS que se aplican exclusivamente al DOM de ese componente. | ||
|
||
<docs-code language="ts" highlight="[4]"> | ||
@Component({ | ||
selector: 'profile-photo', | ||
template: `<img src="profile-photo.jpg" alt="Your profile photo">`, | ||
template: `<img src="profile-photo.jpg" alt="Su foto de perfil">`, | ||
styles: `img { border-radius: 50%; }`, | ||
}) | ||
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
By default, a component's styles only affect elements defined in that component's template. See [Styling Components](guide/components/styling) for details on Angular's approach to styling. | ||
Por defecto, los estilos de un componente solo afectan a los elementos definidos en la plantilla de ese componente. Consulte [Estilos de Componentes](guide/components/styling) para obtener detalles sobre el enfoque de Angular para el estilo. | ||
|
||
You can alternatively choose to write your template and styles in separate files: | ||
Alternativamente, puede optar por escribir su plantilla y estilos en archivos separados: | ||
|
||
<docs-code language="ts" highlight="[3, 4]"> | ||
@Component({ | ||
|
@@ -47,13 +47,13 @@ You can alternatively choose to write your template and styles in separate files | |
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
This can help separate the concerns of _presentation_ from _behavior_ in your project. You can choose one approach for your entire project, or you decide which to use for each component. | ||
Esto puede ayudar a separar las preocupaciones de la _presentación_ del _comportamiento_ en su proyecto. Puede elegir un enfoque para todo su proyecto, o decidir cuál usar para cada componente. | ||
|
||
Both `templateUrl` and `styleUrl` are relative to the directory in which the component resides. | ||
Tanto `templateUrl` como `styleUrls` son relativos al directorio en el que reside el componente. | ||
|
||
## Using components | ||
## Usando Componentes | ||
|
||
Every component defines a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors): | ||
Cada componente define un [selector CSS](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors): | ||
|
||
<docs-code language="ts" highlight="[2]"> | ||
@Component({ | ||
|
@@ -63,29 +63,29 @@ Every component defines a [CSS selector](https://developer.mozilla.org/en-US/doc | |
export class ProfilePhoto { } | ||
</docs-code> | ||
|
||
See [Component Selectors](guide/components/selectors) for details about which types of selectors Angular supports and guidance on choosing a selector. | ||
Consulte [Selectores de Componentes](guide/components/selectors) para conocer más detalles sobre qué tipos de selectores soporta Angular y orientación para eleguir un selector. | ||
|
||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Un pequeño error de ortográfico aqui. |
||
You use a component by creating a matching HTML element in the template of _other_ components: | ||
Usa componente creando un elemento HTML correspondiente en la plantilla de _otros_ componentes. | ||
|
||
<docs-code language="ts" highlight="[4]"> | ||
@Component({ | ||
selector: 'user-profile', | ||
template: ` | ||
<profile-photo /> | ||
<button>Upload a new profile photo</button>`, | ||
<button>Cargar una nueva foto de perfil</button>`, | ||
..., | ||
}) | ||
export class UserProfile { } | ||
</docs-code> | ||
|
||
See [Importing and using components](guide/components/importing) for details on how to reference and use other components in your template. | ||
Consulte [Importación y Uso de Componentes](guide/components/importing) para conocer más detalles sobre cómo referenciar y usar otros componentes en su template. | ||
|
||
Angular creates an instance of the component for every matching HTML element it encounters. The DOM element that matches a component's selector is referred to as that component's **host element**. The contents of a component's template are rendered inside its host element. | ||
Angular crea una instancia del componente por cada elemento HTML coincidente que encuentre. El elemento DOM que coincide con el selector de un componente se conoce como el **elemento host** de ese componente. El contenido de la plantilla de un componente se renderiza dentro de su elemento host. | ||
|
||
The DOM rendered by a component, corresponding to that component's template, is called that | ||
component's **view**. | ||
El DOM renderizado por un componente, correspondiente a la plantilla de ese componente, | ||
se denomina **vista** de ese componente. | ||
|
||
In composing components in this way, **you can think of your Angular application as a tree of components**. | ||
Al componer componentes de esta manera, **puede pensar en su aplicación Angular como un árbol de componentes**. | ||
|
||
```mermaid | ||
flowchart TD | ||
|
@@ -99,4 +99,4 @@ flowchart TD | |
``` | ||
|
||
|
||
This tree structure is important to understanding several other Angular concepts, including [dependency injection](guide/di) and [child queries](guide/components/queries). | ||
Esta estructura en árbol es importante para comprender varios otros conceptos de Angular, incluyendo la [inyección de dependencias](guide/di) and [consultas de elementos secundarios](guide/components/queries). |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Recomendaria para este punto reemplazar por algo no tal formal. Podria ser en lugar de
Usted proporciona información...
porPuedes proporcionar información...
.