Skip to content

Overall Fixes #174

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 39 commits into from
Feb 21, 2019
Merged
Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
e3994c9
Fixing links for getting started page
Darking360 Feb 18, 2019
0e2b807
Updating correct link to JS overview
Darking360 Feb 18, 2019
4518e73
Changing some words according to the style guide, and fixing a link
Darking360 Feb 18, 2019
07babea
Translating back to english some code, and also fixing translation fo…
Darking360 Feb 18, 2019
a72b088
Translating back to english, and also adding IU full words
Darking360 Feb 18, 2019
d7cf412
Changing UI or IU for correct translation
Darking360 Feb 18, 2019
56aab1a
Fixing list and keys page, and also adding @tesseralis feedback
Darking360 Feb 18, 2019
8607332
Translating back form code examples
Darking360 Feb 18, 2019
70548ea
Adding translation for UI
Darking360 Feb 18, 2019
428f8b4
Translating code examples comments, and also fixing a typo inside ref…
Darking360 Feb 18, 2019
539830d
Fix a link in fragments page
Darking360 Feb 18, 2019
9239512
Enhancing HOCs page, and also translating a little part that was not …
Darking360 Feb 18, 2019
c8625c4
Fixing links and un-translated part in jsx in depth page
Darking360 Feb 18, 2019
340c27c
Fixing links and typo in portals
Darking360 Feb 18, 2019
2865e3e
Enhancing reconciliation page
Darking360 Feb 18, 2019
02d97bd
Removing typos
Darking360 Feb 18, 2019
ddb6b0b
Fixing strict mode and also adding spanish links
Darking360 Feb 18, 2019
459f885
Fixing typos and some links, and also more UI translation
Darking360 Feb 18, 2019
1855b3f
Fixing typos and also link to spanish docs
Darking360 Feb 18, 2019
f0a973b
Fixing links to portals and fragments
Darking360 Feb 18, 2019
1193493
Fixing half of react.component
Darking360 Feb 18, 2019
18cc4c5
Translating code example comments, and also state based on style guide
Darking360 Feb 19, 2019
baa5aee
Finishing translation fixes for React.Component
Darking360 Feb 19, 2019
a0aac7c
Fixing false friends translations, and some untranslated comments as …
Darking360 Feb 19, 2019
3963610
Finishing enhancing glossary
Darking360 Feb 19, 2019
3b2fb0f
Update content/docs/lists-and-keys.md
carburo Feb 20, 2019
687e6db
Update content/docs/reference-react-component.md
carburo Feb 20, 2019
a3d8174
Update content/docs/state-and-lifecycle.md
carburo Feb 20, 2019
e2618ae
Update content/docs/reference-react-component.md
carburo Feb 20, 2019
df3f97e
Update examples/react-component-reference/get-snapshot-before-update.js
carburo Feb 20, 2019
00a747e
Update examples/react-component-reference/get-snapshot-before-update.js
carburo Feb 20, 2019
7839375
Update content/docs/reference-react-component.md
carburo Feb 20, 2019
f1ad63f
Update content/docs/reference-react-component.md
carburo Feb 20, 2019
bdc4eaf
Update examples/forwarding-refs/fancy-button-simple-ref.js
carburo Feb 20, 2019
1bb963b
Update code-splitting.md
Darking360 Feb 20, 2019
61bc46b
Update lifting-state-up.md
Darking360 Feb 20, 2019
7da5350
Update reference-react-component.md
Darking360 Feb 20, 2019
f3c5288
Update lifting-state-up.md
Darking360 Feb 20, 2019
06aff0c
Update code-splitting.md
Darking360 Feb 20, 2019
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
4 changes: 2 additions & 2 deletions content/docs/add-react-to-a-website.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Lo siguiente es agregar tres etiquetas `<script>` a la página HTML justo antes
<script src="https://unpkg.com/react@16/umd/react.development.js" crossorigin></script>
<script src="https://unpkg.com/react-dom@16/umd/react-dom.development.js" crossorigin></script>

<!-- Carguemos nuestro componente de React. -->
<!-- Cargamos nuestro componente de React. -->
<script src="like_button.js"></script>

</body>
Expand Down Expand Up @@ -147,7 +147,7 @@ return (
);
```

Estos dos fragmentos de código son equivalentes. Mientras **JSX es [completamente opcional](/docs/react-without-jsx.html)**, muchas personas lo encuentran útil para escribir código relacionado con la IU -- ya sea usando React o con otras bibliotecas.
Estos dos fragmentos de código son equivalentes. Mientras **JSX es [completamente opcional](/docs/react-without-jsx.html)**, muchas personas lo encuentran útil para escribir código relacionado con la interfaz de ssuario -- ya sea usando React o con otras bibliotecas.

Puedes experimentar con JSX usando [este conversor en línea](http://babeljs.io/repl#?babili=false&browsers=&build=&builtIns=false&spec=false&loose=false&code_lz=Q&debug=false&forceAllTransforms=false&shippedProposals=false&circleciRepo=&evaluate=false&fileSize=false&sourceType=module&lineWrap=true&presets=es2015%2Creact%2Cstage-2%2Cstage-3&prettier=true&targets=Node-6.12&version=6.26.0&envVersion=).

Expand Down
12 changes: 6 additions & 6 deletions content/docs/components-and-props.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ redirect_from:
prev: rendering-elements.html
next: state-and-lifecycle.html
---
Los componentes permiten separar la UI en piezas independientes, reutilizables y pensar en cada pieza de forma aislada.Esta página proporciona una introducción a la idea de los componentes.
Los componentes permiten separar la interfaz de usuario en piezas independientes, reutilizables y pensar en cada pieza de forma aislada.Esta página proporciona una introducción a la idea de los componentes.
Puedes encontrar una [API detallada sobre componentes aquí](/docs/react-component.html).

Conceptualmente, los componentes son como las funciones de JavaScript. Aceptan entradas arbitrarias (llamadas "props") y devuelven a React elementos que describen lo que debe aparecer en la pantalla.
Expand Down Expand Up @@ -61,7 +61,7 @@ Sin embargo, los elementos también pueden representar componentes definidos por
const element = <Welcome name="Sara" />;
```

Cuando React ve representando un componente definido por el usuario, pasa atributos JSX a este componente como un solo objeto. Llamamos a este objeto "props".
Cuando React ve un elemento representando un componente definido por el usuario, pasa atributos JSX a este componente como un solo objeto. Llamamos a este objeto "props".

Por ejemplo, este código muestra "Hello, Sara" en la página:

Expand All @@ -88,7 +88,7 @@ Recapitulemos lo que sucede en este ejemplo:

> **Nota:** Comienza siempre los nombres de componentes con una letra mayúscula.
>
>React trata los componentes que empiezan con letras minúsculas como etiquetas del DOM. Por ejemplo, `<div />` representa una etiqueta div HTML pero `<Welcome />` representa un componente y requiere que `Welcome` esté en scope.
>React trata los componentes que empiezan con letras minúsculas como etiquetas del DOM. Por ejemplo, `<div />` representa una etiqueta div HTML pero `<Welcome />` representa un componente y requiere que `Welcome` esté definido.
>
> Para saber más sobre el razonamiento detrás de esta convención, puedes consultar [JSX en profundidad](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized).

Expand Down Expand Up @@ -234,7 +234,7 @@ function Comment(props) {

[](codepen://components-and-props/extracting-components-continued)

Extraer componentes puede parecer un trabajo pesado al principio, pero tener una paleta de componentes reutilizables vale la pena en aplicaciones más grandes. Una buena regla en general es que si una parte de su UI se usa varias veces (`Button`, `Panel`, `Avatar`), o es lo suficientemente compleja por sí misma (`App`, `FeedStory`, `Comment`), es buen candidato para ser un componente reutilizable.
Extraer componentes puede parecer un trabajo pesado al principio, pero tener una paleta de componentes reutilizables vale la pena en aplicaciones más grandes. Una buena regla en general es que si una parte de su interfaz de usuario se usa varias veces (`Button`, `Panel`, `Avatar`), o es lo suficientemente compleja por sí misma (`App`, `FeedStory`, `Comment`), es buen candidato para ser un componente reutilizable.

## Las props son de solo lectura {#props-are-read-only}

Expand All @@ -246,7 +246,7 @@ function sum(a, b) {
}
```

Tales funciones son llamadas ["puras"](https://en.wikipedia.org/wiki/Pure_function) por que no tratan de cambiar sus entradas, y siempre devuelven el mismo resultado para las mismas entradas.
Tales funciones son llamadas ["puras"](https://es.wikipedia.org/wiki/Programaci%C3%B3n_funcional#Funciones_puras) por que no tratan de cambiar sus entradas, y siempre devuelven el mismo resultado para las mismas entradas.

En contraste, esta función es impura por que cambia su propia entrada:

Expand All @@ -260,4 +260,4 @@ React es bastante flexible pero tiene una sola regla estricta:

**Todos los componentes de React deben actuar como funciones puras con respecto a sus props.**

Por supuesto, las UI de las aplicaciones son dinámicas y cambian con el tiempo. En la [siguiente sección](/docs/state-and-lifecycle.html), introduciremos un nuevo concepto de "estado". El estado le permite a los componentes de React cambiar su salida a lo largo del tiempo en respuesta a acciones del usuario, respuestas de red y cualquier otra cosa, sin violar esta regla.
Por supuesto, las interfaces de usuario de las aplicaciones son dinámicas y cambian con el tiempo. En la [siguiente sección](/docs/state-and-lifecycle.html), introduciremos un nuevo concepto de "estado". El estado le permite a los componentes de React cambiar su salida a lo largo del tiempo en respuesta a acciones del usuario, respuestas de red y cualquier otra cosa, sin violar esta regla.
6 changes: 3 additions & 3 deletions content/docs/create-a-new-react-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ El equipo de React principalmente recomienda las siguientes soluciones:
- Si estás **aprendiendo React** o **creando una nueva [aplicación de página única](/docs/glossary.html#single-page-application),** usa [Create React App](#create-react-app).
- Si estás construyendo un **sito web renderizado en servidor con Node.js,** prueba [Next.js](#nextjs).
- Si estás construyendo un **sitio web orientado a contenido estático,** prueba [Gatsby](#gatsby).
- Si estás construyendo una **biblioteca de componentes** o **integrando una base de código existente**, prueba [Cadenas de Herramientas más Flexibles](#cadenas-de-herramientas-ms-flexibles).
- Si estás construyendo una **biblioteca de componentes** o **integrando una base de código existente**, prueba [Cadenas de Herramientas más Flexibles](#more-flexible-toolchains).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch!


### Create React App {#create-react-app}

Expand All @@ -49,7 +49,7 @@ npm start

>Nota
>
>En la primera línea `npx` no es una errata: Es una [herramienta de ejecución de paquetes que viene con npm 5.2+](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b).
>En la primera línea `npx` no es un error de escritura: Es una [herramienta de ejecución de paquetes que viene con npm 5.2+](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b).

Create React App no se encarga de la lógica de `backend` o de bases de datos; tan solo crea un flujo de construcción para `frontend`, de manera que lo puedes usar con cualquier `backend`. Para ello internamente usa [Babel](http://babeljs.io/) y [webpack](https://webpack.js.org/), pero no necesitas saber nada de estas herramientas para usar Create React App.

Expand Down Expand Up @@ -77,7 +77,7 @@ Las siguientes cadenas de herramientas ofrecen más opciones y flexibilidad. Las

- **[Parcel](https://parceljs.org/)** es un empaquetador de aplicaciones web rápido y de cero configuración que [funciona con React](https://parceljs.org/recipes.html#react).

- **[Razzle](https://github.com/jaredpalmer/razzle)** es un marco de trabajo de renderizado en servidor que no requiere ninguna configuración, pero ofrece más flexibilidad que Next.js.
- **[Razzle](https://github.com/jaredpalmer/razzle)** es un framework de renderizado en servidor que no requiere ninguna configuración, pero ofrece más flexibilidad que Next.js.

## Creando una cadena de herramientas desde cero {#creating-a-toolchain-from-scratch}

Expand Down
12 changes: 6 additions & 6 deletions content/docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,11 +24,11 @@ Esta página es un resumen de la documentación de React y recursos relacionados

---

- [Prueba React](#prueba-react)
- [Aprende React](#aprende-react)
- [Mantente Informado](#mantente-informado)
- [Documentación por Versiones](#documentación-por-versiones)
- [¿Algo hace falta?](#¿algo-hace-falta)
- [Prueba React](#try-react)
- [Aprende React](#learn-react)
- [Mantente Informado](#staying-informed)
- [Documentación por Versiones](#versioned-documentation)
- [¿Algo hace falta?](#something-missing)

## Prueba React {#try-react}

Expand Down Expand Up @@ -76,7 +76,7 @@ Si vienes con experiencia como diseñador, [estos recursos](http://reactfordesig

La documentación de React asume cierta familiaridad con la programación en Javascript. No necesitas ser un experto, pero es más difícil aprender React y Javascript al mismo tiempo.

Recomendamos pasar por este [resumen de Javascript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript) para medir tu nivel de conocimiento. Te tomará entre 30 minutos a 1 hora, pero te sentirás más seguro aprendiendo React.
Recomendamos pasar por este [resumen de Javascript](https://developer.mozilla.org/es-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript) para medir tu nivel de conocimiento. Te tomará entre 30 minutos a 1 hora, pero te sentirás más seguro aprendiendo React.

>Consejo
>
Expand Down
6 changes: 3 additions & 3 deletions content/docs/handling-events.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,15 +93,15 @@ ReactDOM.render(

[**Pruébalo en CodePen**](http://codepen.io/gaearon/pen/xEmzGg?editors=0010)

Tienes que tener mucho cuidado en cuanto al significado de `this` en los callbacks de JSX. En JavaScript, los métodos de clase no están [ligados](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_objects/Function/bind) por defecto. Si olvidas ligar `this.handleClick` y lo pasas a `onClick`, `this` sera `undefined` cuando se llame la función.
Tienes que tener mucho cuidado en cuanto al significado de `this` en los callbacks de JSX. En JavaScript, los métodos de clase no están [ligados](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_objects/Function/bind) por defecto. Si olvidas ligar `this.handleClick` y lo pasas a `onClick`, `this` será `undefined` cuando se llame la función.

Esto no es un comportamiento especifico de React; esto hace parte de [como operan las funciones JavaScript](https://www.smashingmagazine.com/2014/01/understanding-javascript-function-prototype-bind/). Generalmente, si refieres un método sin usar `()` después de este, tal como `onClick={this.handleClick}`, deberías ligar ese método.

Si te molesta llamar `bind`, existen dos maneras de evitarlo. Si usas la sintaxis experimental [campos públicos de clases](https://babeljs.io/docs/plugins/transform-class-properties/), puedes usar los campos de clases para ligar los callbacks correctamente:

```js{2-6}
class LoggingButton extends React.Component {
// Esta sintaxis nos asegura que `this` esta ligado dentro de handleClick
// Esta sintaxis nos asegura que `this` está ligado dentro de handleClick
// Peligro: esto es una sintaxis *experimental*
handleClick = () => {
console.log('this is:', this);
Expand All @@ -119,7 +119,7 @@ class LoggingButton extends React.Component {

Esta sintaxis está habilitada por defecto en [Create React App](https://github.com/facebookincubator/create-react-app).

Si no estas usando la sintaxis de campos públicos de clases, puedes usar una [función flecha](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Functions/Arrow_functions) en el callback:
Si no estas usando la sintaxis de campos públicos de clases, puedes usar una [función flecha](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Functions/Arrow_functions) en el callback:

```js{7-9}
class LoggingButton extends React.Component {
Expand Down
8 changes: 4 additions & 4 deletions content/docs/hello-world.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ El más pequeño de los ejemplos de React se ve así:

```js
ReactDOM.render(
<h1>¡Hola mundo!</h1>,
<h1>Hello, world!</h1>,
document.getElementById('root')
);
```

Este muestra un encabezado con el texto "¡Hola mundo!" en la página.
Este muestra un encabezado con el texto "Hello, world!" en la página.

[](codepen://hello-world)

Expand All @@ -27,11 +27,11 @@ En esta guía, examinaremos los componentes básicos de las aplicaciones React:

>Tip
>
>Esta guía está diseñada para personas que prefieren **aprender los conceptos paso a paso**. Si prefieres aprender haciendo, revisa nuestro [tutorial práctico](/tutorial/tutorial.html). Encontrarás que esta guía y el tutorial se complementan el uno al otro.
>Esta guía está diseñada para personas que prefieren **aprender los conceptos paso a paso**. Si prefieres aprender mediante práctica, revisa nuestro [tutorial práctico](/tutorial/tutorial.html). Encontrarás que esta guía y el tutorial se complementan el uno al otro.

Este es el primer capítulo en una guía paso a paso sobre los principales conceptos de React. Puedes encontrar una lista de todos los capítulos en la barra de navegación lateral. Si estás leyendo esto desde un dispositivo móvil, puedes acceder a la navegación presionando el botón en la esquina inferior derecha de tu pantalla.

Cada capítulo en esta guía se construye en base al conocimiento presentado en capítulos anteriores. **Tú puedes aprender la mayoría de React leyendo la guía de conceptos "Conceptos Principales" en el orden que aparecen en la barra lateral.** Por ejemplo, ["Introducción a JSX”](/docs/introducing-jsx.html) es el siguiente capítulo después de este.
Cada capítulo en esta guía se construye en base al conocimiento presentado en capítulos anteriores. **Puedes aprender la mayoría de React leyendo la guía de conceptos "Conceptos Principales" en el orden que aparecen en la barra lateral.** Por ejemplo, ["Introducción a JSX”](/docs/introducing-jsx.html) es el siguiente capítulo después de este.

## Suposiciones del nivel de conocimiento {#knowledge-level-assumptions}

Expand Down
8 changes: 4 additions & 4 deletions content/docs/introducing-jsx.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,9 +103,9 @@ const element = <img src={user.avatarUrl}></img>;

No pongas comillas rodeando llaves cuando insertes una expresión JavaScript en un atributo. Debes utilizar comillas (para los valores de los strings) o llaves (para las expresiones), pero no ambas en el mismo atributo.

>**Warning:**
>**Advertencia:**
>
>Dado que JSX está más cercano a JavaScript que a HTML, React DOM usa la convención de nomenclatura `camelCase` en vez de nombres de atributos HTML.
>Dado que JSX es más cercano a JavaScript que a HTML, React DOM usa la convención de nomenclatura `camelCase` en vez de nombres de atributos HTML.
>
>Por ejemplo, `class` se vuelve [`className`](https://developer.mozilla.org/es/docs/Web/API/Element/className) en JSX, y `tabindex` se vuelve [`tabIndex`](https://developer.mozilla.org/es/docs/Web/API/HTMLElement/tabIndex).

Expand Down Expand Up @@ -142,9 +142,9 @@ Por defecto, React DOM [escapa](http://stackoverflow.com/questions/7381974/which

### JSX representa objetos {#jsx-represents-objects}

Babel compila JSX bajo llamados a `React.createElement()`.
Babel compila JSX a llamadas de `React.createElement()`.

Estos dos ejemplos son identicos:
Estos dos ejemplos son idénticos:

```js
const element = (
Expand Down
12 changes: 6 additions & 6 deletions content/docs/rendering-elements.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Los elementos son los bloques más pequeños de las aplicaciones de React.
Un elemento describe lo que quieres ver en la pantalla:

```js
const element = <h1>Hola, mundo</h1>;
const element = <h1>Hello, world</h1>;
```

A diferencia de los elementos del DOM de los navegadores, los elementos de React son objetos planos, y su creación es de bajo costo. React DOM se encarga de actualizar el DOM para igualar los elementos de React.
Expand Down Expand Up @@ -44,17 +44,17 @@ Esto muestra "Hello, world" en la página.

## Actualizando el elemento renderizado {#updating-the-rendered-element}

Los elementos de React son [inmutables](https://en.wikipedia.org/wiki/Immutable_object). Una vez creas un elemento, no puedes cambiar sus hijos o atributos. Un elemento es como un fotograma solitario en una película: este representa la IU en cierto punto en el tiempo.
Los elementos de React son [inmutables](https://es.wikipedia.org/wiki/Objeto_inmutable). Una vez creas un elemento, no puedes cambiar sus hijos o atributos. Un elemento es como un fotograma solitario en una película: este representa la interfaz de usuario en cierto punto en el tiempo.

Con nuestro conocimiento hasta este punto, la única manera de actualizar la IU es creando un nuevo elemento, y pasarlo a `ReactDOM.render()`.
Con nuestro conocimiento hasta este punto, la única manera de actualizar la interfaz de usuario es creando un nuevo elemento, y pasarlo a `ReactDOM.render()`.

Considera este ejemplo de un reloj en marcha:

`embed:rendering-elements/update-rendered-element.js`

[](codepen://rendering-elements/update-rendered-element)

Este llama a `ReactDOM.render()` cada segundo desde un [`setInterval()`](https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/setInterval) callback.
Este llama a `ReactDOM.render()` cada segundo desde un callback del [`setInterval()`](https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/setInterval).

>**Nota:**
>
Expand All @@ -70,6 +70,6 @@ Puedes verificar esto inspeccionando el [último ejemplo](codepen://rendering-el

![inspector del DOM mostrando actualizaciones diminutas](../images/docs/granular-dom-updates.gif)

Aunque creamos un elemento que describe el árbol de la IU en su totalidad en cada instante, React DOM solo actualiza el texto del nodo cuyo contenido cambió.
Aunque creamos un elemento que describe el árbol de la interfaz de usuario en su totalidad en cada instante, React DOM solo actualiza el texto del nodo cuyo contenido cambió.

En nuestra experiencia, pensar en cómo la IU debería verse en un momento dado y no en cómo cambiarla en el tiempo, elimina toda una clase de errores.
En nuestra experiencia, pensar en cómo la interfaz de usuario debería verse en un momento dado y no en cómo cambiarla en el tiempo, elimina toda una clase de errores.
Loading