Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 82 additions & 0 deletions aio/content/guide/updating-to-version-10.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# Updating to Angular version 10

This guide contains information related to updating to version 10 of Angular.

<div class="alert is-helpful">

For information on upgrading to Angular version 9, see [Updating to Angular version 9](https://v9.angular.io/guide/updating-to-version-9).

</div>

## Updating CLI Apps

For step-by-step instructions on how to update to the latest Angular release (and leverage our automated migration tools to do so), use the interactive update guide at [update.angular.io](https://update.angular.io).

If you're curious about the specific migrations being run by the CLI, see the [automated migrations section](#migrations) for details on what code is changing and why.

## Changes and Deprecations in Version 10

<div class="alert is-helpful">

For information about Angular's deprecation and removal practices, see [Angular Release Practices](guide/releases#deprecation-practices "Angular Release Practices: Deprecation practices").

</div>

{@a breaking-changes}
### New Breaking Changes

* Typescript 3.6, 3.7, and 3.8 are no longer supported. Please update to Typescript 3.9.
* Input fields of type `number` fire the `valueChanges` event only once per value change (as opposed to twice in some cases). See [PR 36087](https://github.com/angular/angular/pull/36087).
* The `minLength` and `maxLength` validators only validate values that have a numeric `length` property. See [PR 36157](https://github.com/angular/angular/pull/36157).
* Templates with unknown property bindings or unknown element names now log errors instead of warnings. See [PR 36399](https://github.com/angular/angular/pull/36399).
* `UrlMatcher` can now return `null` values. See [PR 36402](https://github.com/angular/angular/pull/36402).
* Transplanted views now refresh at insertion point only. See [PR 35968](https://github.com/angular/angular/pull/35968).
* Formatting times with the `b` or `B` format codes now supports time periods that cross midnight. See [PR 36611](https://github.com/angular/angular/pull/36611).
* Navigation is canceled for routes with at least one empty resolver. See [PR 24621](https://github.com/angular/angular/pull/24621).

{@a deprecations}
### New Deprecations

| Area | API or Feature | May be removed in |
| ----------------------------- | --------------------------------------------------------------------------- | ----------------- |
| `@angular/core` | [`WrappedValue`](guide/deprecations#wrapped-value) | <!--v10--> v12 |
| browser support | [`IE 9, 10, and IE Mobile`](guide/deprecations#ie-9-10-and-ie-mobile-support) | <!--v10--> v11 |


{@a removals}
### New Removals of Deprecated APIs

The following APIs have been removed starting with version 10.0.0*:

| Package | API | Replacement | Notes |
| ---------------- | -------------- | ----------- | ----- |
| `@angular/core` | Undecorated base classes that use Angular features | Add Angular decorator | See [migration guide](guide/migration-undecorated-classes) for more info |
| `@angular/core` | `ModuleWithProviders` without a generic | `ModuleWithProviders` with a generic | See [migration guide](guide/migration-module-with-providers) for more info |
| `@angular/core` | Style Sanitization | no action needed | See [style sanitization API removal](/guide/deprecations#style-sanitization) for more info
| `@angular/bazel` | [`Bazel builder and schematics`](guide/deprecations#bazelbuilder) | `bazelbuild/rules_nodejs` | [More info](https://github.com/angular/angular/tree/10.0.x/packages/bazel/src/schematics) |


*To see APIs removed in version 9, check out this guide on the [version 9 docs site](https://v9.angular.io/guide/deprecations#removed).

{@a ivy}

## Ivy features and compatibility

Since version 9, Angular Ivy is the default rendering engine. If you haven't heard of Ivy, you can read more about it in the [Angular Ivy guide](guide/ivy).

* Among other features, Ivy introduces more comprehensive type-checking within templates. For details, see [Template Type-checking](guide/template-typecheck).

* For general guidance on debugging and a list of minor changes associated with Ivy, see the [Ivy compatibility guide](guide/ivy-compatibility).

* For help with opting out of Ivy, see the instructions [here](guide/ivy#opting-out-of-angular-ivy).

{@a migrations}
## Automated Migrations for Version 10

Read about the migrations the CLI handles for you automatically:

* [Migrating missing `@Directive()`/`@Component()` decorators](guide/migration-undecorated-classes)
* [Migrating `ModuleWithProviders`](guide/migration-module-with-providers)
* [Solution-style `tsconfig.json` migration](guide/migration-solution-style-tsconfig)
* [`tslib` direct dependency migration](guide/migration-update-libraries-tslib)
* [Update `module` and `target` compiler options migration](guide/migration-update-module-and-target-compiler-options)
80 changes: 40 additions & 40 deletions aio/content/guide/updating-to-version-10.md
Original file line number Diff line number Diff line change
@@ -1,82 +1,82 @@
# Updating to Angular version 10
# Actualizando a Angular versión 10

This guide contains information related to updating to version 10 of Angular.
Esta guía contiene información relacionada con la actualización a la versión 10 de Angular.

<div class="alert is-helpful">

For information on upgrading to Angular version 9, see [Updating to Angular version 9](https://v9.angular.io/guide/updating-to-version-9).
Para obtener información sobre cómo actualizar a la versión 9 de Angular, ver [Actualizando a Angular versión 9](https://v9.angular.io/guide/updating-to-version-9).

</div>

## Updating CLI Apps
## Actualizando CLI Apps

For step-by-step instructions on how to update to the latest Angular release (and leverage our automated migration tools to do so), use the interactive update guide at [update.angular.io](https://update.angular.io).
Para obtener instrucciones paso a paso sobre cómo actualizar a la última versión de Angular (y aproveche nuestras herramientas de migración automatizadas para hacerlo), use la guía de actualización interactiva en [update.angular.io](https://update.angular.io).

If you're curious about the specific migrations being run by the CLI, see the [automated migrations section](#migrations) for details on what code is changing and why.
Si tiene curiosidad acerca de las migraciones específicas que ejecuta la CLI, consulte [sección de migraciones automatizadas](#migrations) para obtener detalles sobre qué código está cambiando y por qué.

## Changes and Deprecations in Version 10
## Cambios y Obsolescencias en Versión 10

<div class="alert is-helpful">

For information about Angular's deprecation and removal practices, see [Angular Release Practices](guide/releases#deprecation-practices "Angular Release Practices: Deprecation practices").
Para obtener información sobre las prácticas de depreciación y eliminación de Angular, consulte [Prácticas de liberación de Angular](guide/releases#deprecation-practices "Prácticas de liberación de Angular: Depreciación practicas").

</div>

{@a breaking-changes}
### New Breaking Changes
### Nuevos cambios importantes

* Typescript 3.6, 3.7, and 3.8 are no longer supported. Please update to Typescript 3.9.
* Input fields of type `number` fire the `valueChanges` event only once per value change (as opposed to twice in some cases). See [PR 36087](https://github.com/angular/angular/pull/36087).
* The `minLength` and `maxLength` validators only validate values that have a numeric `length` property. See [PR 36157](https://github.com/angular/angular/pull/36157).
* Templates with unknown property bindings or unknown element names now log errors instead of warnings. See [PR 36399](https://github.com/angular/angular/pull/36399).
* `UrlMatcher` can now return `null` values. See [PR 36402](https://github.com/angular/angular/pull/36402).
* Transplanted views now refresh at insertion point only. See [PR 35968](https://github.com/angular/angular/pull/35968).
* Formatting times with the `b` or `B` format codes now supports time periods that cross midnight. See [PR 36611](https://github.com/angular/angular/pull/36611).
* Navigation is canceled for routes with at least one empty resolver. See [PR 24621](https://github.com/angular/angular/pull/24621).
* Typescript 3.6, 3.7, y 3.8 ya no son compatibles. Por favor actualice a Typescript 3.9.
* Campos de entrada de tipo `number` dispara el `valueChanges` evento de solo una vez por cambio de valor (en lugar de dos veces en algunos casos). Consulte [PR 36087](https://github.com/angular/angular/pull/36087).
* El `minLength` y `maxLength` los validadores solo validan valores que tienen un valor numérico `length` propiedad. Consulte [PR 36157](https://github.com/angular/angular/pull/36157).
* Las plantillas con enlaces de propiedad desconocidos o nombres de elementos desconocidos ahora registran errores en lugar de advertencias.Consultar [PR 36399](https://github.com/angular/angular/pull/36399).
* `UrlMatcher` ahora puede regresar `null` valores. Consultar [PR 36402](https://github.com/angular/angular/pull/36402).
* Las vistas trasplantadas ahora se actualizan solo en el punto de inserción. Consultar [PR 35968](https://github.com/angular/angular/pull/35968).
* Formateos de tiempos con el `b` o `B` Los códigos de formato ahora admiten períodos de tiempo que cruzan la medianoche. Consultar [PR 36611](https://github.com/angular/angular/pull/36611).
* La navegación se cancela para rutas con al menos un solucionador vacío. Consultar [PR 24621](https://github.com/angular/angular/pull/24621).

{@a deprecations}
### New Deprecations
### Nuevas Obsoletas

| Area | API or Feature | May be removed in |
| Área | API o Característica | Puede ser eliminado |
| ----------------------------- | --------------------------------------------------------------------------- | ----------------- |
| `@angular/core` | [`WrappedValue`](guide/deprecations#wrapped-value) | <!--v10--> v12 |
| browser support | [`IE 9, 10, and IE Mobile`](guide/deprecations#ie-9-10-and-ie-mobile-support) | <!--v10--> v11 |
| navegador soportado | [`IE 9, 10, and IE Mobile`](guide/deprecations#ie-9-10-and-ie-mobile-support) | <!--v10--> v11 |


{@a removals}
### New Removals of Deprecated APIs
### Nuevas Eliminaciones de APIs Obsoletas

The following APIs have been removed starting with version 10.0.0*:
Las siguientes APIs han sido eliminadas a partir de la versión 10.0.0*:

| Package | API | Replacement | Notes |
| Paquete | API | Sustitución | Notas |
| ---------------- | -------------- | ----------- | ----- |
| `@angular/core` | Undecorated base classes that use Angular features | Add Angular decorator | See [migration guide](guide/migration-undecorated-classes) for more info |
| `@angular/core` | `ModuleWithProviders` without a generic | `ModuleWithProviders` with a generic | See [migration guide](guide/migration-module-with-providers) for more info |
| `@angular/core` | Style Sanitization | no action needed | See [style sanitization API removal](/guide/deprecations#style-sanitization) for more info
| `@angular/bazel` | [`Bazel builder and schematics`](guide/deprecations#bazelbuilder) | `bazelbuild/rules_nodejs` | [More info](https://github.com/angular/angular/tree/10.0.x/packages/bazel/src/schematics) |
| `@angular/core` | Clases base no decoradas que utilizan características de Angular | Añadir el decorador Angular | Consultar [guía de migracion](guide/migration-undecorated-classes) Para más información |
| `@angular/core` | `ModuleWithProviders` sin un genérico | `ModuleWithProviders` con un genérico | Consultar [guía de migración](guide/migration-module-with-providers) para más información |
| `@angular/core` | Saneamiento de estilo | no es necesario hacer nada | Consultar [saneamiento de estilo API retirada](/guide/deprecations#style-sanitization) para más información
| `@angular/bazel` | [`Bazel builder and schematics`](guide/deprecations#bazelbuilder) | `bazelbuild/rules_nodejs` | [Para más información](https://github.com/angular/angular/tree/10.0.x/packages/bazel/src/schematics) |


*To see APIs removed in version 9, check out this guide on the [version 9 docs site](https://v9.angular.io/guide/deprecations#removed).
*Para ver APIs eliminadas en la versión 9, consulte esta guía en la [versión 9 sitio de documentos](https://v9.angular.io/guide/deprecations#removed).

{@a ivy}

## Ivy features and compatibility
## Ivy características y compatibilidad

Since version 9, Angular Ivy is the default rendering engine. If you haven't heard of Ivy, you can read more about it in the [Angular Ivy guide](guide/ivy).
Desde la versión 9, Angular Ivy es el motor de renderizado por defecto. Si no ha escuchado hablar de Ivy, puede leer más sobre ello en el [Guía Angular Ivy](guide/ivy).

* Among other features, Ivy introduces more comprehensive type-checking within templates. For details, see [Template Type-checking](guide/template-typecheck).
* Entre otras características, Ivy introduce una mayor amplitud tipo-verificación dentro de las plantillas. Para detalles, Consultar [Plantillas Tipo-verificación](guide/template-typecheck).

* For general guidance on debugging and a list of minor changes associated with Ivy, see the [Ivy compatibility guide](guide/ivy-compatibility).
* Para una orientación general sobre la depuración y una lista de cambios menores asociados a Ivy, consulte en [Ivy guia de compatibilidad](guide/ivy-compatibility).

* For help with opting out of Ivy, see the instructions [here](guide/ivy#opting-out-of-angular-ivy).
* Para obtener ayuda sobre la exclusión de Ivy, ver las instrucciones [aquí](guide/ivy#opting-out-of-angular-ivy).

{@a migrations}
## Automated Migrations for Version 10
## Migraciones Automatizadas para la Versión 10

Read about the migrations the CLI handles for you automatically:
Lea sobre las migraciones que el CLI maneja para usted automáticamente:

* [Migrating missing `@Directive()`/`@Component()` decorators](guide/migration-undecorated-classes)
* [Migrating `ModuleWithProviders`](guide/migration-module-with-providers)
* [Solution-style `tsconfig.json` migration](guide/migration-solution-style-tsconfig)
* [`tslib` direct dependency migration](guide/migration-update-libraries-tslib)
* [Update `module` and `target` compiler options migration](guide/migration-update-module-and-target-compiler-options)
* [Migraciones perdidas `@Directive()`/`@Component()` decoradores](guide/migration-undecorated-classes)
* [Migraciones `ModuleWithProviders`](guide/migration-module-with-providers)
* [Solución-estilos `tsconfig.json` migration](guide/migration-solution-style-tsconfig)
* [`tslib` migración de dependencia directa](guide/migration-update-libraries-tslib)
* [Actualizar `module` y `target` migración de opciones del compilador](guide/migration-update-module-and-target-compiler-options)