From b54646d763bd889f39e0280d46962be429d0da5c Mon Sep 17 00:00:00 2001 From: Ricardo Chavarria Date: Tue, 26 May 2026 16:24:47 -0600 Subject: [PATCH] translate: translations for version compatibility guide Fixes #147 --- adev-es/src/content/reference/versions.en.md | 165 +++++++++++++++++++ adev-es/src/content/reference/versions.md | 112 ++++++------- 2 files changed, 221 insertions(+), 56 deletions(-) create mode 100644 adev-es/src/content/reference/versions.en.md diff --git a/adev-es/src/content/reference/versions.en.md b/adev-es/src/content/reference/versions.en.md new file mode 100644 index 0000000..ddfa52c --- /dev/null +++ b/adev-es/src/content/reference/versions.en.md @@ -0,0 +1,165 @@ +# Version compatibility + +The following tables describe the versions of Node.js, TypeScript, and RxJS that each version of +Angular requires. + +## Actively supported versions + +This table covers [Angular versions under active support](reference/releases#actively-supported-versions). + +| Angular | Node.js | TypeScript | RxJS | +| ------------------ | ----------------------------------- | -------------- | ------------------ | +| 21.0.x | ^20.19.0 \|\| ^22.12.0 \|\| ^24.0.0 | >=5.9.0 <6.0.0 | ^6.5.3 \|\| ^7.4.0 | +| 20.2.x \|\| 20.3.x | ^20.19.0 \|\| ^22.12.0 \|\| ^24.0.0 | >=5.8.0 <6.0.0 | ^6.5.3 \|\| ^7.4.0 | +| 20.0.x \|\| 20.1.x | ^20.19.0 \|\| ^22.12.0 \|\| ^24.0.0 | >=5.8.0 <5.9.0 | ^6.5.3 \|\| ^7.4.0 | +| 19.2.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.9.0 | ^6.5.3 \|\| ^7.4.0 | +| 19.1.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.8.0 | ^6.5.3 \|\| ^7.4.0 | +| 19.0.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.7.0 | ^6.5.3 \|\| ^7.4.0 | + +## Unsupported Angular versions + +This table covers Angular versions that are no longer under long-term support (LTS). This +information was correct when each version went out of LTS and is provided without any further +guarantees. It is listed here for historical reference. + +| Angular | Node.js | TypeScript | RxJS | +| ------------------ | ------------------------------------ | -------------- | ------------------ | +| 18.1.x \|\| 18.2.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.4.0 <5.6.0 | ^6.5.3 \|\| ^7.4.0 | +| 18.0.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.4.0 <5.5.0 | ^6.5.3 \|\| ^7.4.0 | +| 17.3.x | ^18.13.0 \|\| ^20.9.0 | >=5.2.0 <5.5.0 | ^6.5.3 \|\| ^7.4.0 | +| 17.1.x \|\| 17.2.x | ^18.13.0 \|\| ^20.9.0 | >=5.2.0 <5.4.0 | ^6.5.3 \|\| ^7.4.0 | +| 17.0.x | ^18.13.0 \|\| ^20.9.0 | >=5.2.0 <5.3.0 | ^6.5.3 \|\| ^7.4.0 | +| 16.1.x \|\| 16.2.x | ^16.14.0 \|\| ^18.10.0 | >=4.9.3 <5.2.0 | ^6.5.3 \|\| ^7.4.0 | +| 16.0.x | ^16.14.0 \|\| ^18.10.0 | >=4.9.3 <5.1.0 | ^6.5.3 \|\| ^7.4.0 | +| 15.1.x \|\| 15.2.x | ^14.20.0 \|\| ^16.13.0 \|\| ^18.10.0 | >=4.8.2 <5.0.0 | ^6.5.3 \|\| ^7.4.0 | +| 15.0.x | ^14.20.0 \|\| ^16.13.0 \|\| ^18.10.0 | ~4.8.2 | ^6.5.3 \|\| ^7.4.0 | +| 14.2.x \|\| 14.3.x | ^14.15.0 \|\| ^16.10.0 | >=4.6.2 <4.9.0 | ^6.5.3 \|\| ^7.4.0 | +| 14.0.x \|\| 14.1.x | ^14.15.0 \|\| ^16.10.0 | >=4.6.2 <4.8.0 | ^6.5.3 \|\| ^7.4.0 | +| 13.3.x \|\| 13.4.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | >=4.4.3 <4.7.0 | ^6.5.3 \|\| ^7.4.0 | +| 13.1.x \|\| 13.2.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | >=4.4.3 <4.6.0 | ^6.5.3 \|\| ^7.4.0 | +| 13.0.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | ~4.4.3 | ^6.5.3 \|\| ^7.4.0 | +| 12.2.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 \|\| ^7.0.0 | +| 12.1.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 | +| 12.0.x | ^12.14.0 \|\| ^14.15.0 | ~4.2.3 | ^6.5.3 | +| 11.2.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 | +| 11.1.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 | +| 11.0.x | ^10.13.0 \|\| ^12.11.0 | ~4.0.0 | ^6.5.3 | +| 10.2.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 | +| 10.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 | +| 10.0.x | ^10.13.0 \|\| ^12.11.0 | ~3.9.0 | ^6.5.3 | +| 9.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.9.0 | ^6.5.3 | +| 9.0.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.8.0 | ^6.5.3 | + +### Before v9 + +Until Angular v9, Angular and Angular CLI versions were not synced. + +| Angular | Angular CLI | Node.js | TypeScript | RxJS | +| --------------------------- | --------------------------- | ------------------- | -------------- | ------ | +| 8.2.x | 8.2.x \|\| 8.3.x | ^10.9.0 | >=3.4.2 <3.6.0 | ^6.4.0 | +| 8.0.x \|\| 8.1.x | 8.0.x \|\| 8.1.x | ^10.9.0 | ~3.4.2 | ^6.4.0 | +| 7.2.x | 7.2.x \|\| 7.3.x | ^8.9.0 \|\| ^10.9.0 | >=3.1.3 <3.3.0 | ^6.0.0 | +| 7.0.x \|\| 7.1.x | 7.0.x \|\| 7.1.x | ^8.9.0 \|\| ^10.9.0 | ~3.1.3 | ^6.0.0 | +| 6.1.x | 6.1.x \|\| 6.2.x | ^8.9.0 | >=2.7.2 <3.0.0 | ^6.0.0 | +| 6.0.x | 6.0.x | ^8.9.0 | ~2.7.2 | ^6.0.0 | +| 5.2.x | 1.6.x \|\| 1.7.x | ^6.9.0 \|\| ^8.9.0 | >=2.4.2 <2.7.0 | ^5.5.0 | +| 5.0.x \|\| 5.1.x | 1.5.x | ^6.9.0 \|\| ^8.9.0 | ~2.4.2 | ^5.5.0 | +| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.4.x | ^6.9.0 \|\| ^8.9.0 | >=2.1.6 <2.5.0 | ^5.0.1 | +| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.3.x | ^6.9.0 | >=2.1.6 <2.5.0 | ^5.0.1 | +| 4.0.x \|\| 4.1.x | 1.0.x \|\| 1.1.x \|\| 1.2.x | ^6.9.0 | >=2.1.6 <2.4.0 | ^5.0.1 | +| 2.x | - | ^6.9.0 | >=1.8.0 <2.2.0 | ^5.0.1 | + +## Browser support + +Angular uses the ["widely available" Baseline](https://web.dev/baseline) to define browser +support. For each major version, Angular supports browsers included in the Baseline of a +chosen date near the release date for that major. + +The "widely available" Baseline includes browsers released less than 30 months (2.5 years) +of the chosen date within Baseline's core browser set (Chrome, Edge, Firefox, Safari) and +targets supporting approximately 95% of web users. + +| Angular | Baseline Date | Browser Set | +| ------- | ------------- | --------------------------- | +| v21 | 2025-10-20 | [Browser Set][browsers-v21] | +| v20 | 2025-04-30 | [Browser Set][browsers-v20] | + +[browsers-v21]: https://web-platform-dx.github.io/web-features/supported-browsers/?widelyAvailableOnDate=2025-10-20&includeDownstream=false +[browsers-v20]: https://web-platform-dx.github.io/web-features/supported-browsers/?widelyAvailableOnDate=2025-04-30&includeDownstream=false + +Angular versions prior to v20 support the following specific browser versions: + +| Browser | Supported versions | +| :------ | :------------------------------------------ | +| Chrome | 2 most recent versions | +| Firefox | latest and extended support release \(ESR\) | +| Edge | 2 most recent major versions | +| Safari | 2 most recent major versions | +| iOS | 2 most recent major versions | +| Android | 2 most recent major versions | + +## Polyfills + +Angular is built on the latest standards of the web platform. +Targeting such a wide range of browsers is challenging because they do not support all features of modern browsers. +You compensate by loading polyfill scripts \("polyfills"\) for the browsers that you must support. +See instructions on how to include polyfills into your project below. + +IMPORTANT: The suggested polyfills are the ones that run full Angular applications. +You might need additional polyfills to support features not covered by this list. + +HELPFUL: Polyfills cannot magically transform an old, slow browser into a modern, fast one. + +## Enabling polyfills with CLI projects + +The [Angular CLI](tools/cli) provides support for polyfills. +If you are not using the CLI to create your projects, see [Polyfill instructions for non-CLI users](#polyfills-for-non-cli-users). + +The `polyfills` options of the [browser and test builder](tools/cli/cli-builder) can be a full path for a file \(Example: `src/polyfills.ts`\) or, +relative to the current workspace or module specifier \(Example: `zone.js`\). + +If you create a TypeScript file, make sure to include it in the `files` property of your `tsconfig` file. + +```json + +{ + "extends": "./tsconfig.json", + "compilerOptions": { + ... + }, + "files": [ + "src/main.ts", + "src/polyfills.ts" + ] + ... +} +``` + +## Polyfills for non-CLI users + +If you are not using the CLI, add your polyfill scripts directly to the host web page \(`index.html`\). + +For example: + + + + + + + + + diff --git a/adev-es/src/content/reference/versions.md b/adev-es/src/content/reference/versions.md index ddfa52c..4c0b9e0 100644 --- a/adev-es/src/content/reference/versions.md +++ b/adev-es/src/content/reference/versions.md @@ -1,11 +1,11 @@ -# Version compatibility +# Compatibilidad de versiones -The following tables describe the versions of Node.js, TypeScript, and RxJS that each version of -Angular requires. +Las siguientes tablas describen las versiones de Node.js, TypeScript y RxJS que cada versión de +Angular requiere. -## Actively supported versions +## Versiones con soporte activo -This table covers [Angular versions under active support](reference/releases#actively-supported-versions). +Esta tabla cubre [versiones de Angular con soporte activo](reference/releases#actively-supported-versions). | Angular | Node.js | TypeScript | RxJS | | ------------------ | ----------------------------------- | -------------- | ------------------ | @@ -16,11 +16,11 @@ This table covers [Angular versions under active support](reference/releases#act | 19.1.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.8.0 | ^6.5.3 \|\| ^7.4.0 | | 19.0.x | ^18.19.1 \|\| ^20.11.1 \|\| ^22.0.0 | >=5.5.0 <5.7.0 | ^6.5.3 \|\| ^7.4.0 | -## Unsupported Angular versions +## Versiones de Angular sin soporte -This table covers Angular versions that are no longer under long-term support (LTS). This -information was correct when each version went out of LTS and is provided without any further -guarantees. It is listed here for historical reference. +Esta tabla cubre versiones de Angular que ya no están bajo soporte a largo plazo (LTS). Esta +información era correcta cuando cada versión salió de LTS y se proporciona sin ninguna garantía +adicional. Se incluye aquí como referencia histórica. | Angular | Node.js | TypeScript | RxJS | | ------------------ | ------------------------------------ | -------------- | ------------------ | @@ -50,9 +50,9 @@ guarantees. It is listed here for historical reference. | 9.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.9.0 | ^6.5.3 | | 9.0.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.8.0 | ^6.5.3 | -### Before v9 +### Antes de v9 -Until Angular v9, Angular and Angular CLI versions were not synced. +Hasta Angular v9, las versiones de Angular y Angular CLI no estaban sincronizadas. | Angular | Angular CLI | Node.js | TypeScript | RxJS | | --------------------------- | --------------------------- | ------------------- | -------------- | ------ | @@ -69,56 +69,56 @@ Until Angular v9, Angular and Angular CLI versions were not synced. | 4.0.x \|\| 4.1.x | 1.0.x \|\| 1.1.x \|\| 1.2.x | ^6.9.0 | >=2.1.6 <2.4.0 | ^5.0.1 | | 2.x | - | ^6.9.0 | >=1.8.0 <2.2.0 | ^5.0.1 | -## Browser support +## Soporte de navegadores -Angular uses the ["widely available" Baseline](https://web.dev/baseline) to define browser -support. For each major version, Angular supports browsers included in the Baseline of a -chosen date near the release date for that major. +Angular usa el criterio ["widely available" Baseline](https://web.dev/baseline) para definir el soporte +de navegadores. Para cada versión principal, Angular soporta los navegadores incluidos en el Baseline de una +fecha elegida cercana a la fecha de lanzamiento de esa versión principal. -The "widely available" Baseline includes browsers released less than 30 months (2.5 years) -of the chosen date within Baseline's core browser set (Chrome, Edge, Firefox, Safari) and -targets supporting approximately 95% of web users. +El Baseline "widely available" incluye navegadores lanzados hace menos de 30 meses (2.5 años) +de la fecha elegida dentro del conjunto de navegadores principales de Baseline (Chrome, Edge, Firefox, Safari) y +apunta a soportar aproximadamente el 95% de los usuarios web. -| Angular | Baseline Date | Browser Set | +| Angular | Fecha de Baseline | Conjunto de navegadores | | ------- | ------------- | --------------------------- | -| v21 | 2025-10-20 | [Browser Set][browsers-v21] | -| v20 | 2025-04-30 | [Browser Set][browsers-v20] | +| v21 | 2025-10-20 | [Conjunto de navegadores][browsers-v21] | +| v20 | 2025-04-30 | [Conjunto de navegadores][browsers-v20] | [browsers-v21]: https://web-platform-dx.github.io/web-features/supported-browsers/?widelyAvailableOnDate=2025-10-20&includeDownstream=false [browsers-v20]: https://web-platform-dx.github.io/web-features/supported-browsers/?widelyAvailableOnDate=2025-04-30&includeDownstream=false -Angular versions prior to v20 support the following specific browser versions: +Las versiones de Angular anteriores a v20 soportan las siguientes versiones específicas de navegadores: -| Browser | Supported versions | +| Navegador | Versiones compatibles | | :------ | :------------------------------------------ | -| Chrome | 2 most recent versions | -| Firefox | latest and extended support release \(ESR\) | -| Edge | 2 most recent major versions | -| Safari | 2 most recent major versions | -| iOS | 2 most recent major versions | -| Android | 2 most recent major versions | +| Chrome | 2 versiones más recientes | +| Firefox | última y versión de soporte extendido \(ESR\) | +| Edge | 2 versiones principales más recientes | +| Safari | 2 versiones principales más recientes | +| iOS | 2 versiones principales más recientes | +| Android | 2 versiones principales más recientes | ## Polyfills -Angular is built on the latest standards of the web platform. -Targeting such a wide range of browsers is challenging because they do not support all features of modern browsers. -You compensate by loading polyfill scripts \("polyfills"\) for the browsers that you must support. -See instructions on how to include polyfills into your project below. +Angular está construido sobre los estándares más recientes de la plataforma web. +Apuntar a una gama tan amplia de navegadores es un desafío porque no todos soportan todas las características de los navegadores modernos. +Puedes compensar esto cargando scripts polyfill ("polyfills") para los navegadores que debes soportar. +A continuación, encontrarás instrucciones sobre cómo incluir polyfills en tu proyecto. -IMPORTANT: The suggested polyfills are the ones that run full Angular applications. -You might need additional polyfills to support features not covered by this list. +IMPORTANTE: Los polyfills sugeridos son los que ejecutan aplicaciones Angular completas. +Es posible que necesites polyfills adicionales para soportar características no cubiertas por esta lista. -HELPFUL: Polyfills cannot magically transform an old, slow browser into a modern, fast one. +ÚTIL: Los polyfills no pueden transformar mágicamente un navegador antiguo y lento en uno moderno y rápido. -## Enabling polyfills with CLI projects +## Habilitando polyfills en proyectos CLI -The [Angular CLI](tools/cli) provides support for polyfills. -If you are not using the CLI to create your projects, see [Polyfill instructions for non-CLI users](#polyfills-for-non-cli-users). +El [Angular CLI](tools/cli) proporciona soporte para polyfills. +Si no estás usando el CLI para crear tus proyectos, consulta las [Instrucciones de polyfills para usuarios sin CLI](#polyfills-para-usuarios-sin-cli). -The `polyfills` options of the [browser and test builder](tools/cli/cli-builder) can be a full path for a file \(Example: `src/polyfills.ts`\) or, -relative to the current workspace or module specifier \(Example: `zone.js`\). +La opción `polyfills` del [builder de navegador y pruebas](tools/cli/cli-builder) puede ser una ruta completa de un archivo \(Ejemplo: `src/polyfills.ts`\) o, +relativa al espacio de trabajo actual o especificador de módulo \(Ejemplo: `zone.js`\). -If you create a TypeScript file, make sure to include it in the `files` property of your `tsconfig` file. +Si creas un archivo TypeScript, asegúrate de incluirlo en la propiedad `files` de tu archivo `tsconfig`. ```json @@ -135,31 +135,31 @@ If you create a TypeScript file, make sure to include it in the `files` property } ``` -## Polyfills for non-CLI users +## Polyfills para usuarios sin CLI -If you are not using the CLI, add your polyfill scripts directly to the host web page \(`index.html`\). +Si no estás usando el CLI, agrega tus scripts polyfill directamente a la página web host \(`index.html`\). -For example: + Por ejemplo: - + - + - +