You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
>This page describes**experimental features that are not yet available in a stable release**. Don't rely on experimental builds of React in production apps. These features may change significantly and without a warning before they become a part of React.
21
-
>
22
-
>This documentation is aimed at early adopters and people who are curious. **If you're new to React, don't worry about these features**-- you don't need to learn them right now.
20
+
>Esta página describe**funcionalidades experimentales que [aún no están disponibles](/docs/concurrent-mode-adoption.html) en una versión estable**. No dependas de compilados experimentales de React en aplicaciones en producción. Estas funcionalidades pueden cambiar significativamente y sin advertencia antes de formar parte de React.
21
+
>
22
+
>Esta documentación está dirigida a usuarios pioneros y personas que sienten curiosidad. **Si te estás iniciando en React, no te preocupes por estas funcionalidades,**no necesitas aprenderlas inmediatamente.
23
23
24
24
</div>
25
25
26
-
-[Installation](#installation)
27
-
-[Who Is This Experimental Release For?](#who-is-this-experimental-release-for)
-[¿Para quién es esta versión experimental?](#who-is-this-experimental-release-for)
28
+
-[Habilitar el modo concurrente](#enabling-concurrent-mode)
29
+
-[¿Qué esperar?](#what-to-expect)
30
+
-[Paso de migración: modo de bloqueo](#migration-step-blocking-mode)
31
+
-[¿Por qué tantos modos?](#why-so-many-modes)
32
+
-[Comparación de características](#feature-comparison)
33
33
34
-
## Installation {#installation}
34
+
## Instalación {#installation}
35
35
36
-
Concurrent Mode is only available in the [experimental builds](/blog/2019/10/22/react-release-channels.html#experimental-channel)of React. To install them, run:
36
+
El Modo Concurrente solo está disponible en [compilados experimentales](/blog/2019/10/22/react-release-channels.html#experimental-channel)de React. Para instalarlos, ejecuta:
You can try these builds on personal projects or in a branch, but we don't recommend running them in production. At Facebook, we *do* run them in production, but that's because we're also there to fix bugs when something breaks. You've been warned!
47
+
Puedes probar estos compilados en proyectos personales o en una rama, pero no recomendamos ejecutarlos en producción. En Facebook, *sí* los ejecutamos en producción, pero solo porque también estamos ahí para solucionar los errores cuando algo se rompe. ¡Has sido advertido!
48
48
49
-
### Who Is This Experimental Release For? {#who-is-this-experimental-release-for}
49
+
### ¿Para quién es la versión experimental? {#who-is-this-experimental-release-for}
50
50
51
-
This release is primarily aimed at early adopters, library authors, and curious people.
51
+
Esta versión está dirigida principalmente a los pioneros, autores de bibliotecas y gente curiosa.
52
52
53
-
We're using this code in production (and it works for us) but there are still some bugs, missing features, and gaps in the documentation. We'd like to hear more about what breaks in Concurrent Mode so we can better prepare it for an official stable release in the future.
53
+
Estamos usando este código en producción (y nos funciona), pero aún existen algunos errores, funcionalidades que faltan, y lagunas en la documentación. Nos gustaría escuchar más acerca de qué se rompe en el Modo Concurrente para que lo podamos preparar mejor para una versión oficial estable en el futuro.
### Habilitar el Modo Concurrente {#enabling-concurrent-mode}
56
56
57
-
Normally, when we add features to React, you can start using them immediately. Fragments, Context, and even Hooks are examples of such features. You can use in new code without making any changes to the existing code.
57
+
Normalmente, cuando añadimos nuevas funcionalidades a React, puedes comenzar a usarlas inmediantamente. Los Fragmentos, el contexto, e incluso los Hooks son ejemplos de tales funcionalidades. Las puedes usar en código nuevo sin hacer ningún cambio al código existente.
58
58
59
-
Concurrent Mode is different. It introduces semantic changes to how React works. Otherwise, the [new features](/docs/concurrent-mode-patterns.html)enabled by it *wouldn't be possible*. This is why they're grouped into a new "mode" rather than released one by one in isolation.
59
+
El Modo Concurrente es diferente. Introduce cambios semánticos a cómo React funciona. De otra forma, las [nuevas funcionalidades](/docs/concurrent-mode-patterns.html)que se habilitan *no serían posibles*. Es por eso que están agrupadas en un nuevo "modo" en lugar de ser lanzadas una por una por separado.
60
60
61
-
You can't opt into Concurrent Mode on a per-subtree basis. Instead, to opt in, you have to do it in the place where today you call`ReactDOM.render()`.
61
+
No puedes optar por el Modo Concurrente en base a subárboles. En cambio, para optar por él, tienes que hacerlo en el lugar donde hoy llamas a`ReactDOM.render()`.
62
62
63
-
**This will enable Concurrent Mode for the whole `<App />`tree:**
63
+
**Esto habilitará el Modo Concurrente para todo el árbol `<App />` :**
//Puedes optar por el modo concurrente escribiendo:
73
73
74
74
ReactDOM.createRoot(
75
75
document.getElementById('root')
76
76
).render(<App />);
77
77
```
78
78
79
-
>Note:
79
+
>Nota:
80
80
>
81
-
>Concurrent Mode APIs such as `createRoot`only exist in the experimental builds of React.
81
+
>Las API del Modo Concurrente como `createRoot`solo existen en los compilados experimentadles de React.
82
82
83
-
In Concurrent Mode, the lifecycle methods [previously marked](https://reactjs.org/blog/2018/03/27/update-on-async-rendering.html)as "unsafe" actually *are* unsafe, and lead to bugs even more than in today's React. We don't recommend trying Concurrent Mode until your app is [Strict Mode](https://reactjs.org/docs/strict-mode.html)-compatible.
83
+
En el Modo Concurrente, los métodos de ciclo de vida [previamente marcados](https://reactjs.org/blog/2018/03/27/update-on-async-rendering.html)como "inseguros" de hecho son inseguros, y conducen aún a más errores que en React hoy en día. No recomendamos intentar el Modo Concurrente hasta que tu aplicación sea compatible con el [Modo estricto](https://reactjs.org/docs/strict-mode.html).
84
84
85
-
## What to Expect {#what-to-expect}
85
+
## ¿Qué esperar? {#what-to-expect}
86
86
87
-
If you have a large existing app, or if your app depends on a lot of third-party packages, please don't expect that you can use the Concurrent Mode immediately. **For example, at Facebook we are using Concurrent Mode for the new website, but we're not planning to enable it on the old website.**This is because our old website still uses unsafe lifecycle methods in the product code, incompatible third-party libraries, and patterns that don't work well with the Concurrent Mode.
87
+
Si tienes una aplicación grande existente, o si tu aplicación depende de muchos paquetes de terceros, por favor no esperes que seas capaz de usar el Modo Concurrente de forma inmediata. **Por ejemplo, en Facebook estamos usando el Modo concurrente para el nuevo sitio web, pero no tenemos planeado habilitarlo en el sitio antiguo.**Esto ocurre porque nuestro antiguo sitio web aún utiliza métodos de ciclo de vida inseguros en el código del producto, bibliotecas de terceros incompatibles y patrones que no funcionan bien en el Modo Concurrente.
88
88
89
-
In our experience, code that uses idiomatic React patterns and doesn't rely on external state management solutions is the easiest to get running in the Concurrent Mode. We will describe common problems we've seen and the solutions to them separately in the coming weeks.
89
+
En nuestra experiencia, el código que usa patrones idiomáticos de React y que no depende de soluciones del manejo de estado de forma externa es el más fácil de conseguir que se ejecute en el Modo Concurrente. Describiremos los problemas comunes que hemos visto y las soluciones a ellas de forma separada en las próximas semanas.
### Paso de migración: Modo de bloqueo {#migration-step-blocking-mode}
92
92
93
-
For older codebases, Concurrent Mode might be a step too far. This is why we also provide a new "Blocking Mode" in the experimental React builds. You can try it by substituting `createRoot`with`createBlockingRoot`. It only offers a *small subset* of the Concurrent Mode features, but it is closer to how React works today and can serve as a migration step.
93
+
Para bases de código más antiguas, el Modo Concurrente pueden ser un paso que vaya demasiado lejos. Por eso es que también proporcionamos un nuevo "Modo de bloqueo" en los compilados experimentales de React. Puedes probarlos sustituyendo`createRoot`con`createBlockingRoot`. Solo ofrece un *pequeño subconjunto* de la funcionalidades del Modo Concurrente, pero es más cercano a como React funciona hoy y puede servir como un paso de migración.
94
94
95
-
To recap:
95
+
Para recapitular:
96
96
97
-
***Legacy Mode:**`ReactDOM.render(<App />, rootNode)`. This is what React apps use today. There are no plans to remove the legacy mode in the observable future — but it won't be able to support these new features.
98
-
***Blocking Mode:**`ReactDOM.createBlockingRoot(rootNode).render(<App />)`. It is currently experimental. It is intended as a first migration step for apps that want to get a subset of Concurrent Mode features.
99
-
***Concurrent Mode:**`ReactDOM.createRoot(rootNode).render(<App />)`. It is currently experimental. In the future, after it stabilizes, we intend to make it the default React mode. This mode enables *all* the new features.
97
+
***Modo legado:**`ReactDOM.render(<App />, rootNode)`. Es el que las aplicaciones de React utilizan hoy en día. No hay planes para eliminar el modo legado en el futuro cercano, pero no será capaz de incluir estas nuevas funcionalidades.
98
+
***Modo de bloqueo:**`ReactDOM.createBlockingRoot(rootNode).render(<App />)`. Actualmente es experimental. Su intención es ser un primer paso para la migración de las aplicaciones que quieran obtener un subconjunto de las funcionalidades del Modo Concurrente.
99
+
***Modo Concurrente:**`ReactDOM.createRoot(rootNode).render(<App />)`. . Actualmente es experimental. En el futuro, luego de que se estabilice, esperamos convertirlo en el modo predeterminado para React. Este modo habilita *todas* las nuevas funcionalidades.
100
100
101
-
### Why So Many Modes? {#why-so-many-modes}
101
+
### ¿Por qúe tantos modos? {#why-so-many-modes}
102
102
103
-
We think it is better to offer a [gradual migration strategy](/docs/faq-versioning.html#commitment-to-stability)than to make huge breaking changes — or to let React stagnate into irrelevance.
103
+
Pensamos que es mejor ofrecer una [estrategia gradual de migración](/docs/faq-versioning.html#commitment-to-stability)que hacer grandes cambios disruptivos, o dejar que React se estanque hasta la irrelevancia.
104
104
105
-
In practice, we expect that most apps using Legacy Mode today should be able to migrate at least to the Blocking Mode (if not Concurrent Mode). This fragmentation can be annoying for libraries that aim to support all Modes in the short term. However, gradually moving the ecosystem away from the Legacy Mode will also *solve* problems that affect major libraries in the React ecosystem, such as [confusing Suspense behavior when reading layout](https://github.com/facebook/react/issues/14536)and [lack of consistent batching guarantees](https://github.com/facebook/react/issues/15080). There's a number of bugs that can't be fixed in Legacy Mode without changing semantics, but don't exist in Blocking and Concurrent Modes.
105
+
En la práctica, esperamos que la mayoría de las aplicaciones que usan el Modo Legado hoy sean capaces de migrar al menos al Modo de bloqueo (si no al Modo Concurrente). Esta fragmentación puede ser molesta para las bibliotecas que se propongan ser compatibles con todos los modos a corto plazo. Sin embargo, mover gradualmente al ecosistema lejos del Modo Legado, también *resolverá* problemas que afectan a bibliotecas importantes en el ecosistema, como el [comportamiento confuso de Suspense al leer una disposición de elementos](https://github.com/facebook/react/issues/14536)y la [falta de garantías consistentes en el procesamiento por lotes](https://github.com/facebook/react/issues/15080). Existen un número de errores que no pueden ser solucionados en el Modo Legado sin cambiar semánticas, pero que no existen en el Modo de bloqueo o el Concurrente.
106
106
107
-
You can think of the Blocking Mode as a "gracefully degraded" version of the Concurrent Mode. **As a result, in longer term we should be able to converge and stop thinking about different Modes altogether.**But for now, Modes are an important migration strategy. They let everyone decide when a migration is worth it, and upgrade at their own pace.
107
+
Puedes hacerte la idea del Modo de bloqueo como una versión "graciosamente degradada" del Modo Concurrente. **Como resultado, a largo plazo debemos ser capaces de converger y parar de pensar de una vez por todas acerca de los distintos Modos.**Pero por ahora, los modos son una estrategia importante de migración. Le permiten a todos decidir cuándo vale la pena migrar, y realizar las actualizaciones a su propio paso.
108
108
109
-
### Feature Comparison {#feature-comparison}
109
+
### Comparación de funcionalidades {#feature-comparison}
@@ -116,7 +116,7 @@ You can think of the Blocking Mode as a "gracefully degraded" version of the Con
116
116
117
117
<divid="feature-table">
118
118
119
-
||Legacy Mode |Blocking Mode |Concurrent Mode |
119
+
||Modo Heredado|Modo Bloqueo |Modo Concurrente|
120
120
|--- |--- |--- |--- |
121
121
|String Refs |✅ |🚫**|🚫**|
122
122
|Legacy Context |✅ |🚫**|🚫**|
@@ -136,6 +136,6 @@ You can think of the Blocking Mode as a "gracefully degraded" version of the Con
136
136
137
137
</div>
138
138
139
-
\*: Legacy mode has automatic batching in React-managed events but it's limited to one browser task. Non-React events must opt-in using `unstable_batchedUpdates`. In Blocking Mode and Concurrent Mode, all `setState`s are batched by default.
139
+
\*: El modo legado tiene procesamiento por lotes automático en los eventos manejados por React, pero está limitado a una tarea del navegador. Los eventos que no son de React deben optar por ese comportamiento usando `unstable_batchedUpdates`. En el Modo de bloqueo y el concurrente, todos los `setState` son procesados en lote de forma predeterminada.
0 commit comments