diff --git a/aio/content/guide/cheatsheet.md b/aio/content/guide/cheatsheet.md index f3e55928d3..87e57d4e5f 100644 --- a/aio/content/guide/cheatsheet.md +++ b/aio/content/guide/cheatsheet.md @@ -10,7 +10,7 @@ platformBrowserDynamic().bootstrapModule(AppModule); -

Bootstraps the app, using the root component from the specified NgModule.

+

Empaqueta la app, usando el componente raíz del NgModule especificado.

@@ -24,370 +24,372 @@ @NgModule({ declarations: ..., imports: ...,
exports: ..., providers: ..., bootstrap: ...})
class MyModule {}
-

Defines a module that contains components, directives, pipes, and providers.

+

Define un módulo que contiene componentes, directivas, tuberías y proveedores.

declarations: [MyRedComponent, MyBlueComponent, MyDatePipe] -

List of components, directives, and pipes that belong to this module.

+

Lista de componentes, directivas y tuberías que pertenecen a este módulo.

imports: [BrowserModule, SomeOtherModule] -

List of modules to import into this module. Everything from the imported modules -is available to declarations of this module.

+

Lista de módulos para importar en este módulo. Todo, desde los módulos importados, +está disponible para las declaraciones (declarations) de este módulo. exports: [MyRedComponent, MyDatePipe] -

List of components, directives, and pipes visible to modules that import this module.

+

Lista de componentes, directivas y tuberías visibles a los módulos que importan este módulo.

providers: [MyService, { provide: ... }] -

List of dependency injection providers visible both to the contents of this module and to importers of this module.

+

Lista de proveedores de inyección de dependencias visibles tanto para los contenidos de este módulo como para los importadores de este módulo.

entryComponents: [SomeComponent, OtherComponent] -

List of components not referenced in any reachable template, for example dynamically created from code.

+

Lista de componentes no referenciados en cualquier plantilla accesible, por ejemplo, creada dinámicamente a partir de código.

bootstrap: [MyAppComponent] -

List of components to bootstrap when this module is bootstrapped.

+

Lista de componentes a empaquetar cuando este módulo se inicia.

- + - - - - - - + + - - + - - - - - - -
Template syntaxSintaxis de plantilla
<input [value]="firstName">

Binds property value to the result of expression firstName.

+

Vincula la propiedad value al resultado de la expresión firstName.

<div [attr.role]="myAriaRole">

Binds attribute role to the result of expression myAriaRole.

+

Vincula el atributo role al resultado de la expresión myAriaRole.

<div [class.extra-sparkle]="isDelightful">

Binds the presence of the CSS class extra-sparkle on the element to the truthiness of the expression isDelightful.

+

Vincula la presencia de la clase CSS extra-sparkle sobre el elemento a la veracidad de la expresión isDelightful.

<div [style.width.px]="mySize">

Binds style property width to the result of expression mySize in pixels. Units are optional.

+

Vincula la propiedad de estilo width al resultado de la expresión mySize en píxeles. La unidad de medida es opcional.

<button (click)="readRainbow($event)">

Calls method readRainbow when a click event is triggered on this button element (or its children) and passes in the event object.

+

Llama al método readRainbow cuando se lanza un evento clic en este elemento botón (o sus hijos) y pasa por argumento el objeto evento.

<div title="Hello {{ponyName}}"><div title="Hola {{ponyName}}">

Vincula una propiedad a una cadena interpolada, por ejemplo, "Hola Seabiscuit". Equivalente a:

Binds a property to an interpolated string, for example, "Hello Seabiscuit". Equivalent to: -<div [title]="'Hello ' + ponyName">

+<div [title]="'Hola ' + ponyName">

<p>Hello {{ponyName}}</p>

Binds text content to an interpolated string, for example, "Hello Seabiscuit".

+
<p>Hola {{ponyName}}</p>

Vincula el contenido de texto a una cadena interpolada, por ejemplo, "Hola Seabiscuit".

<my-cmp [(title)]="name">

Sets up two-way data binding. Equivalent to: <my-cmp [title]="name" (titleChange)="name=$event">

+

Establece el two-way data binding. Equivalente a: <my-cmp [title]="name" (titleChange)="name=$event">

<video #movieplayer ...>
<button (click)="movieplayer.play()">
</video>

Creates a local variable movieplayer that provides access to the video element instance in data-binding and event-binding expressions in the current template.

+

Crea una variable local movieplayer que provee acceso a la instancia del elemento video en las expresiones de data-binding y event-binding de la actual plantilla.

<p *myUnless="myExpression">...</p>

The * symbol turns the current element into an embedded template. Equivalent to: +

El símbolo * convierte el elemento actual en una plantilla incrustada. Equivalente a: <ng-template [myUnless]="myExpression"><p>...</p></ng-template>

<p>Card No.: {{cardNumber | myCardNumberFormatter}}</p>

Transforms the current value of expression cardNumber via the pipe called myCardNumberFormatter.

+

Transforma el valor actual de la expresión cardNumber a través de la tubería myCardNumberFormatter.

<p>Employer: {{employer?.companyName}}</p>

The safe navigation operator (?) means that the employer field is optional and if undefined, the rest of the expression should be ignored.

+

El operador de navegación seguro (?) significa que el campo employer es opcional y que si es undefined, el resto de la expresión debería ser ignorado.

<svg:rect x="0" y="0" width="100" height="100"/>

An SVG snippet template needs an svg: prefix on its root element to disambiguate the SVG element from an HTML component.

+

Una plantilla de fragmento SVG necesita un prefijo svg: en su elemento raíz para distinguir el elemento SVG de un componente HTML.

<svg>
<rect x="0" y="0" width="100" height="100"/>
</svg>

An <svg> root element is detected as an SVG element automatically, without the prefix.

+

Un elemento raíz <svg> es detectado como un elemento SVG automáticamente, sin el prefijo.

- + - - - - -
Built-in directivesDirectivas incorporadas

import { CommonModule } from '@angular/common';

<section *ngIf="showSection">

Removes or recreates a portion of the DOM tree based on the showSection expression.

+

Elimina o recrea una parte del árbol DOM basado en la expresión showSection.

<li *ngFor="let item of list">

Turns the li element and its contents into a template, and uses that to instantiate a view for each item in list.

+

Convierte el elemento li y su contenido en una plantilla, y lo utiliza para crear una vista por cada elemento de la lista.

<div [ngSwitch]="conditionExpression">
<ng-template [ngSwitchCase]="case1Exp">...</ng-template>
<ng-template ngSwitchCase="case2LiteralString">...</ng-template>
<ng-template ngSwitchDefault>...</ng-template>
</div>

Conditionally swaps the contents of the div by selecting one of the embedded templates based on the current value of conditionExpression.

+

Intercambia condicionalmente el contenido del div seleccionando una de las plantillas incrustadas en función del valor actual de conditionExpression.

<div [ngClass]="{'active': isActive, 'disabled': isDisabled}">

Binds the presence of CSS classes on the element to the truthiness of the associated map values. The right-hand expression should return {class-name: true/false} map.

+

Vincula la presencia de clases CSS en el elemento a la veracidad de los valores de mapa asociados. La expresión de la derecha debería devolver el mapa {class-name: true/false}.

<div [ngStyle]="{'property': 'value'}">
<div [ngStyle]="dynamicStyles()">

Allows you to assign styles to an HTML element using CSS. You can use CSS directly, as in the first example, or you can call a method from the component.

+

Le permite asignar estilos a un elemento HTML usando CSS. Puede usar CSS directamente, como en el primer ejemplo, o puede llamar a un método desde el componente.

- + -
FormsFormularios

import { FormsModule } from '@angular/forms';

<input [(ngModel)]="userName">

Provides two-way data-binding, parsing, and validation for form controls.

+

Provee two-way data-binding, conversión y validación para controles de formulario.

- + - - - -
Class decoratorsDecoradores de clases

import { Directive, ... } from '@angular/core';

@Component({...})
class MyComponent() {}

Declares that a class is a component and provides metadata about the component.

+

Declara que una clase es un componente y proporciona metadatos sobre el componente.

@Directive({...})
class MyDirective() {}

Declares that a class is a directive and provides metadata about the directive.

+

Declara que una clase es una directiva y proporciona metadatos sobre la directiva.

@Pipe({...})
class MyPipe() {}

Declares that a class is a pipe and provides metadata about the pipe.

+

Declara que una clase es una tubería and y proporciona metadatos sobre la tubería.

@Injectable()
class MyService() {}

Declares that a class can be provided and injected by other classes. Without this decorator, the compiler won't generate enough metadata to allow the class to be created properly when it's injected somewhere.

+

Declara que una clase puede ser proporcionada e inyectada por otras clases. Sin este decorador, el compilador no generará suficientes metadatos para permitir que la clase se cree correctamente cuando se inyecta en alguna parte.

- + - -
Directive configurationConfiguración de Directiva

@Directive({ property1: value1, ... })

selector: '.cool-button:not(a)'

Specifies a CSS selector that identifies this directive within a template. Supported selectors include element, +

Especifica un selector CSS que identifica esta directiva dentro de una plantilla. Los selectores compatibles incluyen element, [attribute], .class, and :not().

-

Does not support parent-child relationship selectors.

+

No soporta selectores de relación padre-hijo.

providers: [MyService, { provide: ... }]

List of dependency injection providers for this directive and its children.

+

Lista de proveedores de inyección de dependencia para esta directiva y sus hijos.

- + - - - - + -
Component configurationConfiguración de Componente

-@Component extends @Directive, -so the @Directive configuration applies to components as well

+@Component extiende @Directive, +entonces la configuración de @Directive se aplica también a los componentes

moduleId: module.id

If set, the templateUrl and styleUrl are resolved relative to the component.

+

Si está presente, el templateUrl y styleUrl se resuelven en relación con el componente.

viewProviders: [MyService, { provide: ... }]

List of dependency injection providers scoped to this component's view.

+

Lista de proveedores de inyección de dependencias en la vista de este componente.

template: 'Hello {{name}}'
templateUrl: 'my-component.html'

Inline template or external template URL of the component's view.

+
template: 'Hola {{name}}'
templateUrl: 'my-component.html'

Plantilla en línea o URL de plantilla externa de la vista del componente.

styles: ['.primary {color: red}']
styleUrls: ['my-component.css']

List of inline CSS styles or external stylesheet URLs for styling the component’s view.

+

Lista de estilos CSS en línea o URL de hojas de estilo externas para estilar la vista del componente.

- + - - - - - - - -
Class field decorators for directives and componentsDecoradores para los campos de la clase para directivas y componentes.

import { Input, ... } from '@angular/core';

@Input() myProperty;

Declares an input property that you can update via property binding (example: +

Declara una propiedad de entrada (input) que puede actualizar mediante el enlace de propiedad (property binding) (ejemplo: <my-cmp [myProperty]="someExpression">).

@Output() myEvent = new EventEmitter();

Declares an output property that fires events that you can subscribe to with an event binding (example: <my-cmp (myEvent)="doSomething()">).

+

Declara una propiedad de salida (output) que dispara eventos a los que puede suscribirse con un enlace de evento (event binding) (ejemplo: <my-cmp (myEvent)="doSomething()">).

@HostBinding('class.valid') isValid;

Binds a host element property (here, the CSS class valid) to a directive/component property (isValid).

+

Vincula una propiedad del elemento anfitrión (aquí, la clase CSS valid) a una propiedad de directiva/componente (isValid).

@HostListener('click', ['$event']) onClick(e) {...}

Subscribes to a host element event (click) with a directive/component method (onClick), optionally passing an argument ($event).

+

Se suscribe a un evento del elemento anfitrión (click) con un método de directiva/componente (onClick), opcionalmente, pasando un argumento ($event).

@ContentChild(myPredicate) myChildComponent;

Binds the first result of the component content query (myPredicate) to a property (myChildComponent) of the class.

+

Vincula el primer resultado de la consulta de contenido del componente (myPredicate) a una propiedad (myChildComponent) de la clase.

@ContentChildren(myPredicate) myChildComponents;

Binds the results of the component content query (myPredicate) to a property (myChildComponents) of the class.

+

Vincula los resultados de la consulta de contenido del componente (myPredicate) a una propiedad (myChildComponents) de la clase.

@ViewChild(myPredicate) myChildComponent;

Binds the first result of the component view query (myPredicate) to a property (myChildComponent) of the class. Not available for directives.

+

Vincula el primer resultado de la consulta de vista del componente (myPredicate) a una propiedad (myChildComponent) de la clase. No disponible para directivas.

@ViewChildren(myPredicate) myChildComponents;

Binds the results of the component view query (myPredicate) to a property (myChildComponents) of the class. Not available for directives.

+

Vincula los resultados de la consulta de vista del componente (myPredicate) a una propiedad (myChildComponents) de la clase. No disponible para directivas.

- - + - - - - - - - - -
Directive and component change detection and lifecycle hooks

(implemented as class methods) + +

Detección de cambios (change detection) y ciclos de vida (lifecycle hooks) en directivas y componentes

(implementado como métodos de clase)

constructor(myService: MyService, ...) { ... }

Called before any other lifecycle hook. Use it to inject dependencies, but avoid any serious work here.

+

Se llama antes que cualquier ciclo de vida. Úselo para inyectar dependencias, pero evite cualquier trabajo serio aquí.

ngOnChanges(changeRecord) { ... }

Called after every change to input properties and before processing content or child views.

+

Se llama después de cada cambio en las propiedades de entrada (input) y antes de procesar contenido o vistas de hijos.

ngOnInit() { ... }

Called after the constructor, initializing input properties, and the first call to ngOnChanges.

+

Se llama después del constructor, inicializando propiedades de entrada (input), y la primera llamada a ngOnChanges.

ngDoCheck() { ... }

Called every time that the input properties of a component or a directive are checked. Use it to extend change detection by performing a custom check.

+

Se llama cada vez que se verifican las propiedades de entrada (input) de un componente o una directiva. Úselo para extender la detección de cambios (change detection) realizando una verificación personalizada.

ngAfterContentInit() { ... }

Called after ngOnInit when the component's or directive's content has been initialized.

+

Se llama después de ngOnInit cuando el contenido del componente o directiva ha sido inicializado.

ngAfterContentChecked() { ... }

Called after every check of the component's or directive's content.

+

Se llama después de cada verificación del contenido del componente o directiva.

ngAfterViewInit() { ... }

Called after ngAfterContentInit when the component's views and child views / the view that a directive is in has been initialized.

+

Se llama después de ngAfterContentInit cuando las vistas del componente y las vistas hijas / la vista en la que se encuentra una directiva ha sido inicializado.

ngAfterViewChecked() { ... }

Called after every check of the component's views and child views / the view that a directive is in.

+

Se llama después de cada verificación de las vistas del componentes y las vistas hijas / la vista en la que se encuentra una directiva.

ngOnDestroy() { ... }

Called once, before the instance is destroyed.

+

Se llama una vez, antes de que la instancia se destruya.

- + - - -
Dependency injection configurationConfiguración de inyección de dependencia
{ provide: MyService, useClass: MyMockService }

Sets or overrides the provider for MyService to the MyMockService class.

+

Establece o sobre-escribe el proveedor para MyService en la clase MyMockService.

{ provide: MyService, useFactory: myFactory }

Sets or overrides the provider for MyService to the myFactory factory function.

+

Establece o sobre-escribe el proveedor para MyService en la factoría de función myFactory.

{ provide: MyValue, useValue: 41 }

Sets or overrides the provider for MyValue to the value 41.

+

Establece o sobre-escribe el proveedor para MyValue al valor 41.

- + - - - - - - - - -
Routing and navigationEnrutamiento y navegación

import { Routes, RouterModule, ... } from '@angular/router';

const routes: Routes = [
{ path: '', component: HomeComponent },
{ path: 'path/:routeParam', component: MyComponent },
{ path: 'staticPath', component: ... },
{ path: '**', component: ... },
{ path: 'oldPath', redirectTo: '/staticPath' },
{ path: ..., component: ..., data: { message: 'Custom' } }
]);

const routing = RouterModule.forRoot(routes);

Configures routes for the application. Supports static, parameterized, redirect, and wildcard routes. Also supports custom route data and resolve.

+

Configura rutas para la aplicación. Soporta rutas estáticas, parametrizadas, de redireccionamiento y comodines. También soporta datos de ruta personalizados y los resuelve.


<router-outlet></router-outlet>
<router-outlet name="aux"></router-outlet>

Marks the location to load the component of the active route.

+

Marca la ubicación para cargar el componente de la ruta activa.


<a routerLink="/path">
<a [routerLink]="[ '/path', routeParam ]">
<a [routerLink]="[ '/path', { matrixParam: 'value' } ]">
<a [routerLink]="[ '/path' ]" [queryParams]="{ page: 1 }">
<a [routerLink]="[ '/path' ]" fragment="anchor">

Creates a link to a different view based on a route instruction consisting of a route path, required and optional parameters, query parameters, and a fragment. To navigate to a root route, use the / prefix; for a child route, use the ./prefix; for a sibling or parent, use the ../ prefix.

+

Crea un enlace a una vista diferente basada en una instrucción de ruta que consta de un camino de de ruta, parámetros obligatorios y opcionales, parámetros de consulta y un fragmento. Para navegar a un camino de ruta, usa el prefijo /; para una ruta hija, usa el prefijo ./; para un padre o hermano, usa el prefijo ../.

<a [routerLink]="[ '/path' ]" routerLinkActive="active">

The provided classes are added to the element when the routerLink becomes the current active route.

+

Las clases proporcionadas se agregan al elemento cuando el routerLink se convierte en la ruta activa actual.

class CanActivateGuard implements CanActivate {
canActivate(
route: ActivatedRouteSnapshot,
state: RouterStateSnapshot
): Observable<boolean|UrlTree>|Promise<boolean|UrlTree>|boolean|UrlTree { ... }
}

{ path: ..., canActivate: [CanActivateGuard] }

An interface for defining a class that the router should call first to determine if it should activate this component. Should return a boolean|UrlTree or an Observable/Promise that resolves to a boolean|UrlTree.

+

Una interfaz para definir una clase que el enrutador debe llamar primero para determinar si debe activar este componente. Debe devolver un boolean|UrlTree o un Observable/Promise que se resuelba en un boolean|UrlTree.

class CanDeactivateGuard implements CanDeactivate<T> {
canDeactivate(
component: T,
route: ActivatedRouteSnapshot,
state: RouterStateSnapshot
): Observable<boolean|UrlTree>|Promise<boolean|UrlTree>|boolean|UrlTree { ... }
}

{ path: ..., canDeactivate: [CanDeactivateGuard] }

An interface for defining a class that the router should call first to determine if it should deactivate this component after a navigation. Should return a boolean|UrlTree or an Observable/Promise that resolves to a boolean|UrlTree.

+

Una interfaz para definir una clase que el enrutador debería llamar primero para determinar si debería desactivar este componente después de una navegación. Debe devolver un boolean|UrlTree o un Observable/Promise que se resuelva a boolean|UrlTree.

class CanActivateChildGuard implements CanActivateChild {
canActivateChild(
route: ActivatedRouteSnapshot,
state: RouterStateSnapshot
): Observable<boolean|UrlTree>|Promise<boolean|UrlTree>|boolean|UrlTree { ... }
}

{ path: ..., canActivateChild: [CanActivateGuard],
children: ... }

An interface for defining a class that the router should call first to determine if it should activate the child route. Should return a boolean|UrlTree or an Observable/Promise that resolves to a boolean|UrlTree.

+

Una interfaz para definir una clase que el enrutador debe llamar primero para determinar si debe activar la ruta hija. Debe devolver un boolean|UrlTree o un Observable/Promise que se resuelva en un boolean|UrlTree.

class ResolveGuard implements Resolve<T> {
resolve(
route: ActivatedRouteSnapshot,
state: RouterStateSnapshot
): Observable<any>|Promise<any>|any { ... }
}

{ path: ..., resolve: [ResolveGuard] }

An interface for defining a class that the router should call first to resolve route data before rendering the route. Should return a value or an Observable/Promise that resolves to a value.

+

Una interfaz para definir una clase que el enrutador debe llamar primero para resolver los datos de la ruta antes de representar la ruta. Debe devolver un valor o un Observable/Promise que se resuelva en un valor.

class CanLoadGuard implements CanLoad {
canLoad(
route: Route
): Observable<boolean|UrlTree>|Promise<boolean|UrlTree>|boolean|UrlTree { ... }
}

{ path: ..., canLoad: [CanLoadGuard], loadChildren: ... }

An interface for defining a class that the router should call first to check if the lazy loaded module should be loaded. Should return a boolean|UrlTree or an Observable/Promise that resolves to a boolean|UrlTree.

+

Una interfaz para definir una clase a la que el enrutador debe llamar primero para verificar si el módulo perezoso cargado (lazy loaded module) debe cargarse. Debe devolver un boolean|UrlTree o un Observable/Promise que se resuelva en un boolean|UrlTree.