Skip to content

Fix inconsistencies #167

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 6 commits into from
Feb 17, 2019
Merged
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
20 changes: 10 additions & 10 deletions content/docs/add-react-to-a-website.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,15 +19,15 @@ La mayoría de sitios web no son, y no necesitan ser, aplicaciones de una sóla
- [Agrega React en Un Minuto](#add-react-in-one-minute)
- [Opcional: Prueba React con JSX](#optional-try-react-with-jsx) (sin necesidad de usar bundler!)

## Agrega React en Un Minuto {#add-react-in-one-minute}
## Agrega React en un minuto {#add-react-in-one-minute}

En esta sección, vamos a mostrarte como agregar un componente de React a una página HTML existente. Puedes seguir los pasos en tu sitio web, o crear un nuevo archivo HTML para practicar.

No habrá necesidad de usar herramientas complicadas u otros requerimientos para instalar -- **para completar esta sección, sólo necesitas de una conexión a internet y un minuto de tu tiempo.**

Opcional: [Descargar el ejemplo completo (2KB comprimido)](https://gist.github.com/gaearon/6668a1f6986742109c00a581ce704605/archive/f6c882b6ae18bde42dcf6fdb751aae93495a2275.zip)

### Paso 1: Agrega un Contenedor del DOM al HTML {#step-1-add-a-dom-container-to-the-html}
### Paso 1: Agrega un contenedor del DOM al HTML {#step-1-add-a-dom-container-to-the-html}

Para iniciar, abre la página HTML que deseas editar. Agrega una etiqueta `<div>` vacía para marcar el lugar donde deseas visualizar algo con React. Por ejemplo:

Expand All @@ -45,7 +45,7 @@ A este `<div>` le agregamos un atributo HTML `id` que es único. Esto nos permit
>
>Puedes agregar un "contenedor" `<div>` como este en **cualquier sitio** dentro de la etiqueta `<body>`. Puedes tener la cantidad de contenedores independientes en el DOM que desees. Por lo general éstos están vacíos -- React reemplazará cualquier contenido existente dentro de los contenedores del DOM.

### Paso 2: Agrega las etiquetas de Script {#step-2-add-the-script-tags}
### Paso 2: Agrega las etiquetas de script {#step-2-add-the-script-tags}

Lo siguiente es agregar tres etiquetas `<script>` a la página HTML justo antes de cerrar la etiqueta `</body>`:

Expand All @@ -65,7 +65,7 @@ Lo siguiente es agregar tres etiquetas `<script>` a la página HTML justo antes

Las primeras dos etiquetas cargan React. La tercera carga tu código del componente.

### Paso 3: Crea un Componente de React {#step-3-create-a-react-component}
### Paso 3: Crea un componente de React {#step-3-create-a-react-component}

Crea un archivo llamado `like_button.js` en el mismo lugar donde tienes tu archivo HTML.

Expand Down Expand Up @@ -96,7 +96,7 @@ Dale un vistazo a las siguientes secciones para más consejos sobre como integra

**[Descargar el ejemplo completo (2KB comprimido)](https://gist.github.com/gaearon/6668a1f6986742109c00a581ce704605/archive/f6c882b6ae18bde42dcf6fdb751aae93495a2275.zip)**

### Consejo: Reusar un Componente {#tip-reuse-a-component}
### Consejo: Reusar un componente {#tip-reuse-a-component}

Por lo general, es deseado mostrar componentes de React en múltiples lugares de una página HTML. Aquí hay un ejemplo que muestra el botón de "Like" tres veces y le pasa algunos datos al mismo:

Expand All @@ -108,7 +108,7 @@ Por lo general, es deseado mostrar componentes de React en múltiples lugares de
>
>Esta estrategía es útil cuando las partes de la página que funcionan en React están aisladas entre sí. En código de React, es mucho más fácil usar [composición de componentes](/docs/components-and-props.html#composing-components) en su lugar.

### Consejo: Compactar JavaScript para Producción {#tip-minify-javascript-for-production}
### Consejo: Compactar JavaScript para producción {#tip-minify-javascript-for-production}

Antes de desplegar tu sitio web a producción, debes ser consciente que no compactar tu JavaScript puede disminuir de forma considerable la carga de tu página.

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 librerías.
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.

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 All @@ -165,7 +165,7 @@ Este enfoque está bien mientras aprendes o creas demostraciones simples. Sin em

### Agregar JSX a un proyecto {#add-jsx-to-a-project}

Agregar JSX a un proyecto no necesita de herramientas complicadas como un bundler o un servidor de desarrollo. Básicamente, agregar JSX **es muy parecido a agregar un preprocesador de CSS.** El único requsito es que tengas [Node.js](https://nodejs.org/) instalado en tu computador.
Agregar JSX a un proyecto no necesita de herramientas complicadas como un bundler o un servidor de desarrollo. Básicamente, agregar JSX **es muy parecido a agregar un preprocesador de CSS.** El único requisito es que tengas [Node.js](https://nodejs.org/) instalado en tu computador.

En tu terminal, ve a la carpeta que contiene tu proyecto y pega estos dos comandos:

Expand All @@ -179,7 +179,7 @@ En tu terminal, ve a la carpeta que contiene tu proyecto y pega estos dos comand
¡Felicitaciones! Acabas de agregar una **configuración de JSX lista para producción** a tu proyecto.


### Ejecuta el Preprocesador de JSX {#run-jsx-preprocessor}
### Ejecuta el preprocesador de JSX {#run-jsx-preprocessor}

Crea una carpeta llamada `src` y ejecuta este comando en la terminal:

Expand All @@ -197,6 +197,6 @@ No esperes hasta que termine -- este comando inicia un observador automático pa

Si ahora creas un archivo llamado `src/like_button.js` con este **[código inicial de JSX](https://cdn.rawgit.com/gaearon/c8e112dc74ac44aac4f673f2c39d19d1/raw/09b951c86c1bf1116af741fa4664511f2f179f0a/like_button.js)**, el observador va a crear un `like_button.js` preprocesado con el código JavaScript original que es apto para el navegador. Cuando edites el código del archivo que tiene JSX, el transformador va a volver a ejecutarse de forma automática.

Como un bonus, esto también te permite utilizar características nuevas de la sintáxis de JavaScript, como las clases, sin que te preocupes de que no funcionen en navegadores antiguos. La herramienta que hemos usado se llamda Babel, y puedes leer más sobre ella en [su documentación](http://babeljs.io/docs/en/babel-cli/).
Como un bonus, esto también te permite utilizar características nuevas de la sintaxis de JavaScript, como las clases, sin que te preocupes de que no funcionen en navegadores antiguos. La herramienta que hemos usado se llama Babel, y puedes leer más sobre ella en [su documentación](http://babeljs.io/docs/en/babel-cli/).

Si notas que se te está haciendo más cómodo manejar las herramientas de configuración y quieres sacarle mayor provecho, [en la próxima sección](/docs/create-a-new-react-app.html) se describen unas de las cadenas de herramientas más populares y accesibles. Dado el caso que no te sientas así -- esas etiquetas de script serán suficiente.
4 changes: 2 additions & 2 deletions content/docs/addons-shallow-renderer.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,10 +59,10 @@ Las pruebas superficiales tienen algunas limitaciones, es decir, no soportan ref

Puedes ver el shallowRenderer como un "lugar" para renderizar el componente que quieres probar, y del cual quieres extraer el resultado del componente.

`shallowRenderer.render()` es parecido a [`ReactDOM.render()`](/docs/react-dom.html#render) pero no necesita DOM y solamente rendeirza un único nivel de profundidad. Esto quiere decir que se pueden probar componentes sin tener en cuenta como sus hijos son implementados.
`shallowRenderer.render()` es parecido a [`ReactDOM.render()`](/docs/react-dom.html#render) pero no necesita DOM y solamente renderiza un único nivel de profundidad. Esto quiere decir que se pueden probar componentes sin tener en cuenta como sus hijos son implementados.

### `shallowRenderer.getRenderOutput()` {#shallowrenderergetrenderoutput}

Despues que `shallowRenderer.render()` es llamado, se puede usar `shallowRenderer.getRenderOutput()` para obtener el resultado superficialmente renderizado.
Después que `shallowRenderer.render()` es llamado, se puede usar `shallowRenderer.getRenderOutput()` para obtener el resultado superficialmente renderizado.

Entonces ya se pueden empezar a comprobar hechos sobre el resultado.
8 changes: 4 additions & 4 deletions content/docs/addons-test-utils.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ it('can render and update a counter', () => {
});
```

No olvides que la ejecución de eventos del DOM sólo funciona cuando el contenedor del DOM es agregado al `document`. Puedes utilizar un ayudante como [`react-testing-library`](https://github.com/kentcdodds/react-testing-library) para reducir todo el código repetitivo.
No olvides que la ejecución de eventos del DOM solo funciona cuando el contenedor del DOM es agregado al `document`. Puedes utilizar un ayudante como [`react-testing-library`](https://github.com/kentcdodds/react-testing-library) para reducir todo el código repetitivo.

* * *

Expand Down Expand Up @@ -234,7 +234,7 @@ findRenderedDOMComponentWithClass(
)
```

Igual a [`scryRenderedDOMComponentsWithClass()`](#scryrendereddomcomponentswithclass) pero espera que sólo haya un resultado, y retorna ese único resultado, de lo contrario lanza una excepción si hay algún otro número de coincidencias diferentes a una.
Igual a [`scryRenderedDOMComponentsWithClass()`](#scryrendereddomcomponentswithclass) pero espera que solo haya un resultado, y retorna ese único resultado, de lo contrario lanza una excepción si hay algún otro número de coincidencias diferentes a una.

* * *

Expand All @@ -260,7 +260,7 @@ findRenderedDOMComponentWithTag(
)
```

Igual a [`scryRenderedDOMComponentsWithTag()`](#scryrendereddomcomponentswithtag) pero espera que sólo haya un resultado y retorna ese único resultado, de lo contario lanza una excepción si hay algún otro número de coincidencias diferentes a una.
Igual a [`scryRenderedDOMComponentsWithTag()`](#scryrendereddomcomponentswithtag) pero espera que solo haya un resultado y retorna ese único resultado, de lo contario lanza una excepción si hay algún otro número de coincidencias diferentes a una.

* * *

Expand All @@ -286,7 +286,7 @@ findRenderedComponentWithType(
)
```

Igual a [`scryRenderedComponentsWithType()`](#scryrenderedcomponentswithtype) pero espera que sólo haya un resultado y retorna ese único resultado, de lo contrario lanza una excepción si hay algún otro número de coincidencias diferentes a una.
Igual a [`scryRenderedComponentsWithType()`](#scryrenderedcomponentswithtype) pero espera que solo haya un resultado y retorna ese único resultado, de lo contrario lanza una excepción si hay algún otro número de coincidencias diferentes a una.

***

Expand Down
2 changes: 1 addition & 1 deletion content/docs/code-splitting.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ const MyComponent = () => (

Decidir en qué parte de tu aplicación introducir la división de código puede ser un poco complicado. Quieres asegurarte de elegir lugares que dividan los *bundles* de manera uniforme, sin interrumpir la experiencia del usuario.

Un buen lugar para comenzar es con las rutas. La mayoría de la gente en la web está acostumbrada a que las transiciones entre páginas se tomen cierto tiempo en cargar. También tiendes a rerenderizar toda de una vez, así que es improbable que tus usuarios interactúen con otros elementos en la página al mismo tiempo.
Un buen lugar para comenzar es con las rutas. La mayoría de la gente en la web está acostumbrada a que las transiciones entre páginas se tomen cierto tiempo en cargar. También tiendes a rerenderizar todo de una vez, así que es improbable que tus usuarios interactúen con otros elementos en la página al mismo tiempo.

Este es un ejemplo de cómo configurar la división de código basada en rutas en tu aplicación usando
bibliotecas como [React Router](https://reacttraining.com/react-router/) con `React.lazy`.
Expand Down
14 changes: 7 additions & 7 deletions content/docs/components-and-props.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,11 @@ 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.
Puedes encontrar una [API detallada sobre componentes aqui](/docs/react-component.html).
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.

## Componentes Funcionales y de Clase {#function-and-class-components}
## Componentes funcionales y de clase {#function-and-class-components}

La forma más sencilla de definir un componente es escribir una función de JavaScript:

Expand All @@ -47,7 +47,7 @@ Los dos componentes anteriores son equivalentes desde el punto de vista de React

Las clases tienen algunas características adicionales que veremos en las [próximas secciones](/docs/state-and-lifecycle.html). Hasta entonces, usaremos componentes funcionales por su brevedad.

## Renderizando un Componente {#rendering-a-component}
## Renderizando un componente {#rendering-a-component}

Anteriormente, sólo encontramos elementos de React que representan las etiquetas del DOM:

Expand Down Expand Up @@ -92,9 +92,9 @@ Recapitulemos lo que sucede en este ejemplo:
>
> 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).

## Composición de Componentes {#composing-components}
## Composición de componentes {#composing-components}

Los componentes pueden referirse a otros componentes en su salida. Esto nos permite utilizar la misma abstracción de componente para cualquier nivel de detalle. Un botón, un cuadro de diálogo, un formulario, una pantalla: en aplicaciones de React, todos son expresados comunmente como componentes.
Los componentes pueden referirse a otros componentes en su salida. Esto nos permite utilizar la misma abstracción de componente para cualquier nivel de detalle. Un botón, un cuadro de diálogo, un formulario, una pantalla: en aplicaciones de React, todos son expresados comúnmente como componentes.

Por ejemplo, podemos crear un componente `App` que renderiza `Welcome` muchas veces:

Expand Down Expand Up @@ -123,7 +123,7 @@ ReactDOM.render(

Por lo general, las aplicaciones de React nuevas tienen un único componente `App` en lo más alto. Sin embargo, si se integra React en una aplicación existente, se podría empezar de abajo hacia arriba con un pequeño componente como `Button` y poco a poco trabajar el camino a la cima de la jerarquía de la vista.

## Extracción de Componentes {#extracting-components}
## Extracción de componentes {#extracting-components}

No tengas miedo de dividir los componentes en otros más pequeños.

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

Acepta `author` (un objeto), `text` (un string), y `date` (una fecha) como props, y describe un comentario en una web de redes sociales.

Este componente puede ser difícil de cambiar debido a todo el anidamiento, y támbien es difícil reusar partes individuales de él. Vamos a extraer algunos componentes del mismo.
Este componente puede ser difícil de cambiar debido a todo el anidamiento, y también es difícil reutilizar partes individuales de él. Vamos a extraer algunos componentes del mismo.

Primero, vamos a extraer `Avatar`:

Expand Down
8 changes: 4 additions & 4 deletions content/docs/create-a-new-react-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,13 @@ Esta página describe algunas de las cadenas de herramientas de React más popul

Las cadenas de herramientas que se recomiendan en esta página **no requieren ninguna configuración para empezar**.

## Puede que no necesites una Cadena de Herramientas {#you-might-not-need-a-toolchain}
## Puede que no necesites una cadena de herramientas {#you-might-not-need-a-toolchain}

Si no experimentas los problemas descritos arriba, o aún no te sientes cómodo usando herramientas de Javascript, considera [añadir React como una etiqueta `<script>` en una página HTML](/docs/add-react-to-a-website.html), opcionalmente [con JSX](/docs/add-react-to-a-website.html#optional-try-react-with-jsx).

Esta es también **la manera más fácil de integrar React en un sitio web existente.** Siempre puedes añadir una cadena de herramientas más grande si lo consideras útil!

## Cadenas de Herramientas Recomendadas {#recommended-toolchains}
## Cadenas de herramientas recomendadas {#recommended-toolchains}

El equipo de React principalmente recomienda las siguientes soluciones:

Expand Down Expand Up @@ -67,7 +67,7 @@ Aprende Next.js de [su guía oficial](https://nextjs.org/learn/).

Aprende Gatsby de [su guía oficial](https://www.gatsbyjs.org/docs/) y de [la galería de kits de inicio](https://www.gatsbyjs.org/docs/gatsby-starters/).

### Cadenas de Herramientas más Flexibles {#more-flexible-toolchains}
### Cadenas de herramientas más flexibles {#more-flexible-toolchains}

Las siguientes cadenas de herramientas ofrecen más opciones y flexibilidad. Las recomendamos para los usuarios con más experiencia:

Expand All @@ -79,7 +79,7 @@ Las siguientes cadenas de herramientas ofrecen más opciones y flexibilidad. Las

- **[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.

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

Una cadena de herramientas para construir Javascript generalmente consiste de:

Expand Down
Loading