Skip to content

Commit 25c6021

Browse files
authored
Corrections Sync with react.dev commit @ a472775 (#860)
1 parent 05f76ab commit 25c6021

File tree

6 files changed

+18
-19
lines changed

6 files changed

+18
-19
lines changed

src/content/reference/react-dom/client/hydrateRoot.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ Al llamar a `root.unmount` se desmontarán todos los componentes de la raíz y s
107107
108108
#### Devuelve {/*root-unmount-returns*/}
109109
110-
`render` devuelve `undefined`.
110+
`root.unmount` devuelve `undefined`.
111111
112112
#### Advertencias {/*root-unmount-caveats*/}
113113

src/content/reference/react-dom/components/common.md

+1-4
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Estas propiedades DOM estándar también son compatibles con todos los component
9696
* `onDragStartCapture`: Una versión de `onDragStart` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
9797
* [`onDrop`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/drop_event): Una función controladora de evento [`DragEvent`](#dragevent-handler). Se dispara cuando se suelta algo en un objetivo de soltar válido.
9898
* `onDropCapture`: Una versión de `onDrop` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
99-
* `onFocus`: A [`FocusEvent`](#focusevent-handler). Se dispara cuando un elemento pierde el foco. A diferencia del evento de [`focus`](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event) integrado del navegador, en React el evento `onFocus` se propaga.
99+
* `onFocus`: A [`FocusEvent`](#focusevent-handler). Se dispara cuando un elemento recibe el foco. A diferencia del evento de [`focus`](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event) integrado del navegador, en React el evento `onFocus` se propaga.
100100
* `onFocusCapture`: Una versión de `onFocus` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
101101
* [`onGotPointerCapture`](https://developer.mozilla.org/es/docs/Web/API/Element/gotpointercapture_event): Una función controladora de evento [`PointerEvent`](#pointerevent-handler). Se dispara cuando un elemento captura un puntero.
102102
* `onGotPointerCaptureCapture`: Una versión de `onGotPointerCapture` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
@@ -149,7 +149,6 @@ Estas propiedades DOM estándar también son compatibles con todos los component
149149
* [`onWheel`](https://developer.mozilla.org/es/docs/Web/API/Element/wheel_event): Una función controladora de evento [`WheelEvent`](#wheelevent-handler). Se dispara cuando el usuario gira un botón de rueda en un dispositivo señalador.
150150
* `onWheelCapture`: Una versión de `onWheel` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
151151
* [`role`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles): Un string. Especifica el rol del elemento explícitamente para las tecnologías de asistencia.
152-
153152
* [`slot`](https://developer.mozilla.org/en-US/docs/Web/API/Element/slot): Un string. Especifica el nombre del slot cuando se utiliza shadow DOM. En React, normalmente se logra un patrón equivalente al pasar JSX como props, por ejemplo `<Layout left={<Sidebar />} right={<Content />} />`.
154153
* [`spellCheck`](https://developer.mozilla.org/es/docs/Web/HTML/Global_attributes/spellcheck): Un booleano o `null`. Si explícitamente se establece en `true` o `false`, habilita o deshabilita la corrección ortográfica.
155154
* [`tabIndex`](https://developer.mozilla.org/es/docs/Web/HTML/Global_attributes/tabindex): Un número. Anula el comportamiento por defecto del botón Tab. [Evita utilizar valores distintos de -1 y 0.](https://www.tpgi.com/using-the-tabindex-attribute/)
@@ -169,7 +168,6 @@ Estos eventos se disparan sólo para los elementos [`<dialog>`](https://develope
169168

170169
* [`onCancel`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/cancel_event): Una función controladora de evento [`Event`](#event-handler). Se dispara cuando el usuario intenta cerrar el diálogo.
171170
* `onCancelCapture`: Una versión de `onCancel` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
172-
173171
* [`onClose`](https://developer.mozilla.org/es/docs/Web/API/HTMLDialogElement/close_event): Una función controladora de evento [`Event`](#event-handler). Se dispara cuando un diálogo ha sido cerrado.
174172
* `onCloseCapture`: Una versión de `onClose` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
175173

@@ -178,7 +176,6 @@ Estos eventos sólo se disparan para los elementos [`<details>`](https://develop
178176
* [`onToggle`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDetailsElement/toggle_event): Una función controladora de evento [`Event`](#event-handler). Se dispara cuando el usuario cambia el estado de los detalles.
179177
* `onToggleCapture`: Una versión de `onToggle` que se dispara en la [fase de captura.](/learn/responding-to-events#capture-phase-events)
180178

181-
182179
Estos eventos se disparan para los elementos [`<img>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/img), [`<iframe>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/iframe), [`<object>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/object), [`<embed>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/embed), [`<link>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/link), and [SVG `<image>`](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/SVG_Image_Tag). A diferencia de los eventos del navegador, se propagan en React:
183180

184181
* `onLoad`: Una función controladora de evento [`Event`](#event-handler). Se dispara cuando el recurso ha sido cargado.

src/content/reference/react-dom/index.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -39,5 +39,4 @@ Las siguientes APIs se eliminarán en una próxima versión mayor de React.
3939
* [`findDOMNode`](/reference/react-dom/findDOMNode) busca el nodo de DOM más cercano correspondiente a una instancia de componente de clase.
4040
* [`hydrate`](/reference/react-dom/hydrate) monta un árbol en el DOM creado a partir de HTML generado en el servidor. En su lugar, se recomienda usar [`hydrateRoot`](/reference/react-dom/client/hydrateRoot).
4141
* [`render`](/reference/react-dom/render) monta un árbol en el DOM. En su lugar, se recomienda usar [`createRoot`](/reference/react-dom/client/createRoot).
42-
* [`unmountComponentAtNode`](/reference/react-dom/unmountComponentAtNode) desmonta un árbol del DOM. En su lugar, se recomienda usar [`root.unmount()`.](/reference/react-dom/client/createRoot#root-unmount)
43-
42+
* [`unmountComponentAtNode`](/reference/react-dom/unmountComponentAtNode) desmonta un árbol del DOM. En su lugar, se recomienda usar [`root.unmount()`](/reference/react-dom/client/createRoot#root-unmount).

src/content/reference/react/Component.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1010,7 +1010,7 @@ Recomendamos utilizar [TypeScript](https://www.typescriptlang.org/) en lugar de
10101010

10111011
Si defines `static getDerivedStateFromError`, React lo llamará cuando un componente hijo (incluyendo componentes hijos distantes) arroje un error durante el rendering. Esto te permite mostrar un mensaje de error en lugar de limpiar la interfaz de usuario.
10121012

1013-
Por lo general, se utiliza junto con [`componentDidCatch`](#componentDidCatch), que te permite enviar el informe de errores a algún servicio de análisis. Un componente con estos métodos se llama una *línea de error*.
1013+
Por lo general, se utiliza junto con [`componentDidCatch`](#componentdidcatch), que te permite enviar el informe de errores a algún servicio de análisis. Un componente con estos métodos se llama una *línea de error*.
10141014

10151015
[Mira un ejemplo.](#catching-rendering-errors-with-an-error-boundary)
10161016

src/content/reference/react/Suspense.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -2513,7 +2513,8 @@ Sin embargo, imagina ahora que estás navegando entre dos perfiles de usuario di
25132513
25142514
---
25152515
2516-
### Proporcionar un *fallback* para los errores del servidor y el contenido exclusivo del servidor {/*providing-a-fallback-for-server-errors-and-client-only-content*/}
2516+
### Proporcionar un _fallback_ para errores de servidor y contenido solo-cliente {/*providing-a-fallback-for-server-errors-and-client-only-content*/}
2517+
25172518
25182519
Si utilizas una de las [APIs de renderizado en el servidor con *streaming*](/reference/react-dom/server) (o un *framework* que depende de ellas), React también utilizará tus barreras de `<Suspense>` para manejar errores en el servidor. Si un componente lanza un error en el servidor, React no abortará el renderizado en el servidor. Lo que hará será encontrar el componente `<Suspense>` más cercano encima de este e incluirá su *fallback* (un *spinner*, por ejemplo) dentro del HTML generado en el servidor. El usuario verá un *spinner* en lugar de un error.
25192520

src/content/reference/react/useInsertionEffect.md

+12-10
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ title: useInsertionEffect
1010

1111
<Intro>
1212

13-
`useInsertionEffect` permite insertar elementos en el DOM antes de que se disparen los efectos de diseño.
13+
`useInsertionEffect` permite insertar elementos en el DOM antes de que se dispare cualquier efecto de diseño.
1414

1515
```js
1616
useInsertionEffect(setup, dependencies?)
@@ -26,7 +26,7 @@ useInsertionEffect(setup, dependencies?)
2626
2727
### `useInsertionEffect(setup, dependencies?)` {/*useinsertioneffect*/}
2828
29-
Llama a `useInsertionEffect` para insertar los estilos antes de cualquier mutación en el DOM:
29+
Llama a `useInsertionEffect` para insertar estilos antes de que se dispare cualquier efecto que pueda necesitar leer el diseño:
3030
3131
```js
3232
import { useInsertionEffect } from 'react';
@@ -44,19 +44,21 @@ function useCSS(rule) {
4444
4545
#### Parámetros {/*parameters*/}
4646
47-
* `setup`: La función con la lógica de tu Efecto. Tu función setup puede opcionalmente devolver una función de *limpieza*. Antes de que tu componente sea añadido primero al DOM, React ejecutará tu función setup. Después de cada re-renderizado con dependencias modificadas, React ejecutará primero la función de limpieza (si es que la habías incluido) con los valores antiguos y entonces ejecutará tu función setup con los nuevos valores. Antes de que tu componente sea eliminado del DOM, React ejecutará tu función de limpieza una última vez.
47+
* `setup`: La función con la lógica de tus Efectos. Tu función _setup_ también puede devolver opcionalmente una función de *limpieza*. Cuando tu componente es añadido al DOM, pero antes de que se dispare cualquier efecto de diseño, React ejecutará tu función _setup_. Después de cada re-renderizado con dependencias modificadas, React ejecutará primero la función de limpieza (si la has proporcionado) con los valores antiguos, y luego ejecutará tu función _setup_ con los nuevos valores. Cuando tu componente es removido del DOM, React ejecutará tu función de limpieza.
4848
4949
* ***opcional** `dependencias`: La lista de todos los valores reactivos referenciados dentro del el código de `setup`. Los valores reactivos incluyen props, estado y todas las variables y funciones declaradas directamente dentro del cuerpo de tu componente. Si tu linter está [configurado para React](/learn/editor-setup#linting), verificará que cada valor reactivo esté correctamente especificado como dependencia. La lista de dependencias tienen que tener un número constante de elementos y que sean escritos en línea como `[dep1, dep2, dep3]`. React comparará cada dependencia con su valor previo usando el algoritmo de comparación [`Object.is`](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Object/is). Si no especificas ninguna dependencia, tu Efecto se volverá a ejecutar después de cada renderizado del componente.
5050
5151
#### Devuelve {/*returns*/}
5252
5353
`useInsertionEffect` devuelve `undefined`.
5454
55-
* Effects only run on the client. They don't run during server rendering.
56-
* You can't update state from inside `useInsertionEffect`.
57-
* By the time `useInsertionEffect` runs, refs are not attached yet.
58-
* `useInsertionEffect` may run either before or after the DOM has been updated. You shouldn't rely on the DOM being updated at any particular time.
59-
* Unlike other types of Effects, which fire cleanup for every Effect and then setup for every Effect, `useInsertionEffect` will fire both cleanup and setup one component at a time. This results in an "interleaving" of the cleanup and setup functions.
55+
#### Advertencias {/*caveats*/}
56+
57+
* Los Efectos sólo se ejecutan en el cliente. No se ejecutan durante el renderizado del servidor.
58+
* No puedes actualizar el estado desde dentro de `useInsertionEffect`.
59+
* En el momento en que se ejecuta `useInsertionEffect`, las referencias aún no se han adjuntado.
60+
* `useInsertionEffect` puede ejecutarse antes o después de que el DOM haya sido actualizado. No debes confiar en que el DOM se actualice en un momento determinado.
61+
* A diferencia de otros tipos de Efectos, que disparan la limpieza por cada Efecto y luego el _setup_ por cada Efecto, `useInsertionEffect` disparará ambos, limpieza y _setup_, un componente a la vez. El resultado es un "intercalado" de funciones de limpieza y _setup_.
6062
---
6163
6264
## Uso {/*usage*/}
@@ -86,7 +88,7 @@ Si usas CSS-en-JS, recomendamos la combinación de los dos primeros enfoques (ar
8688
8789
El primer problema no se puede resolver, pero `useInsertionEffect` te ayuda a solucionar el segundo problema.
8890
89-
Llama a `useInsertionEffect` para insertar los estilos antes de cualquier mutación del DOM:
91+
Llama a `useInsertionEffect` para insertar los estilos antes de que se disparen los efectos de diseño:
9092
9193
```js {4-11}
9294
// En tu biblioteca CSS-en-JS
@@ -135,4 +137,4 @@ Si insertas los estilos durante el renderizado y React está procesando una [act
135137
136138
`useInsertionEffect` es mejor que insertar estilos durante [`useLayoutEffect`](/reference/react/useLayoutEffect) o [`useEffect`](/reference/react/useEffect) porque asegura que en el tiempo en que otros Efectos se ejecuten en tus componentes, las etiquetas `<style>` ya han sido añadidas. De otro modo, los cálculos de layout en Efectos regulares podrían ser incorrectos por los estilos desactualizados.
137139
138-
</DeepDive>
140+
</DeepDive>

0 commit comments

Comments
 (0)