Todos los conceptos fundamentales de React.js, incluidos en este artículo

Actualización: este artículo ahora es parte de mi libro "React.js Beyond The Basics". Lee la versión actualizada de este contenido y más sobre React en jscomplete.com/react-beyond-basics .

Este artículo no cubrirá qué es React o por qué debería aprenderlo. En cambio, esta es una introducción práctica a los fundamentos de React.js para aquellos que ya están familiarizados con JavaScript y conocen los fundamentos de la API DOM.

Todos los ejemplos de código a continuación están etiquetados como referencia. Están destinados exclusivamente a proporcionar ejemplos de conceptos. La mayoría de ellos se pueden escribir de una manera mucho mejor.

Fundamental # 1: React se trata de componentes

React está diseñado en torno al concepto de componentes reutilizables. Usted define componentes pequeños y los junta para formar componentes más grandes.

Todos los componentes, pequeños o grandes, son reutilizables, incluso en diferentes proyectos.

Un componente de React, en su forma más simple, es una función de JavaScript simple y antigua:

// Example 1 // //jscomplete.com/repl?j=Sy3QAdKHW function Button (props) { // Returns a DOM element here. For example: return {props.label}; } // To render the Button component to the browser ReactDOM.render(, mountNode)

Las llaves utilizadas para la etiqueta del botón se explican a continuación. No se preocupe por ellos ahora. ReactDOMtambién se explicará más adelante, pero si desea probar este ejemplo y todos los siguientes ejemplos de código, la renderfunción anterior es lo que necesita.

El segundo argumento ReactDOM.renderes el elemento DOM de destino que React se hará cargo y controlará. En jsComplete React Playground, puede usar la variable especial mountNode.

JavaScript REPL y Playground para React.js

Pruebe el código JavaScript y React.js moderno en el navegador sin ninguna configuración jscomplete.com/react

Tenga en cuenta lo siguiente sobre el Ejemplo 1:

  • El nombre del componente comienza con una letra mayúscula. Esto es necesario ya que trataremos con una combinación de elementos HTML y elementos React. Los nombres en minúsculas están reservados para elementos HTML. De hecho, siga adelante e intente nombrar el componente React simplemente “botón” y vea cómo ReactDOM ignorará la función y mostrará un botón HTML vacío normal.
  • Cada componente recibe una lista de atributos, al igual que los elementos HTML. En React, esta lista se llama props . Sin embargo, con un componente de función, puedes nombrarlo como quieras.
  • Extrañamente escribimos lo que parece HTML en la salida devuelta del Buttoncomponente de función anterior. Esto no es JavaScript ni HTML, y ni siquiera es React.js. Pero es tan popular que se convirtió en el predeterminado en las aplicaciones React. Se llama JSX y es una extensión de JavaScript. JSX también es un compromiso . Continúe e intente devolver cualquier otro elemento HTML dentro de la función anterior y vea cómo todos son compatibles (por ejemplo, devolver un elemento de entrada de texto).

Fundamental # 2: ¿Cuál es el flujo de JSX?

El ejemplo 1 anterior se puede escribir en React.js puro sin JSX de la siguiente manera:

// Example 2 - React component without JSX // //jscomplete.com/repl?j=HyiEwoYB- function Button (props) { return React.createElement( "button", { type: "submit" }, props.label ); } // To use Button, you would do something like ReactDOM.render( React.createElement(Button, { label: "Save" }), mountNode );

La createElementfunción es la función principal en la API de nivel superior de React. Es 1 de un total de 8 cosas en ese nivel que necesitas aprender. Así de pequeña es la API de React.

Al igual que el DOM en sí mismo tiene una document.createElementfunción para crear un elemento especificado por un nombre de etiqueta, la createElementfunción de React es una función de nivel superior que puede hacer lo que document.createElementhace, pero también se puede usar para crear un elemento para representar un componente de React. Hicimos lo último cuando usamos el Buttoncomponente en el Ejemplo 2 anterior.

A diferencia document.createElement, React createElementacepta un número dinámico de argumentos después del segundo para representar a los hijos del elemento creado. Entonces en createElementrealidad crea un árbol .

He aquí un ejemplo de eso:

// Example 3 - React’s createElement API // //jscomplete.com/repl?j=r1GNoiFBb const InputForm = React.createElement( "form", { target: "_blank", action: "//google.com/search" }, React.createElement("div", null, "Enter input and click Search"), React.createElement("input", { name: "q", className: "input" }), React.createElement(Button, { label: "Search" }) ); // InputForm uses the Button component, so we need that too: function Button (props) { return React.createElement( "button", { type: "submit" }, props.label ); } // Then we can use InputForm directly with .render ReactDOM.render(InputForm, mountNode);

Tenga en cuenta algunas cosas sobre el ejemplo anterior:

  • InputFormno es un componente de React; es solo un elemento de React . Es por eso que lo usamos directamente en la ReactDOM.renderllamada y no con />.
  • The React.createElement function accepted multiple arguments after the first two. Its list of arguments starting from the 3rd one comprises the list of children for the created element.
  • We were able to nest React.createElement calls because it’s all JavaScript.
  • The second argument to React.createElement can be null or an empty object when no attributes or props are needed for the element.
  • We can mix HTML element with React elements.
  • React’s API tries to be as close to the DOM API as possible, that’s why we use className instead of class for the input element. Secretly, we all wish the React’s API would become part of the DOM API itself. Because, you know, it’s much much better.

The code above is what the browser understands when you include the React library. The browser does not deal with any JSX business. However, we humans like to see and work with HTML instead of these createElement calls (imagine building a website with just document.createElement, which you can!). This is why the JSX compromise exists. Instead of writing the form above with React.createElement calls, we can write it with a syntax very similar to HTML:

// Example 4 - JSX (compare with Example 3) // //jscomplete.com/repl?j=SJWy3otHW const InputForm = Enter input and click Search ; // InputForm "still" uses the Button component, so we need that too. // Either JSX or normal form would do function Button (props) { // Returns a DOM element here. For example: return {props.label}; } // Then we can use InputForm directly with .render ReactDOM.render(InputForm, mountNode);

Note a few things about the above:

  • It’s not HTML. For example, we’re still doing className instead of class.
  • We’re still considering what looks like HTML above as JavaScript. See how I added a semicolon at the end.

What we wrote above (Example 4) is JSX. Yet, what we took to the browser is the compiled version of it (Example 3). To make that happen, we need to use a pre-processor to convert the JSX version into the React.createElement version.

That is JSX. It’s a compromise that allows us to write our React components in a syntax similar to HTML, which is a pretty good deal.

The word “Flux” in the header above was chosen to rhyme, but it’s also the name of a very popular application architecture popularized by Facebook. The most famous implementation of which is Redux. Flux fits the React reactive pattern perfectly.

JSX, by the way, can be used on its own. It’s not a React-only thing.

Fundamental #3: You can use JavaScript expressions anywhere in JSX

Inside a JSX section, you can use any JavaScript expression within a pair of curly braces.

// To use it:ReactDOM.render(, mountNode);// Example 5 - Using JavaScript expressions in JSX // //jscomplete.com/repl?j=SkNN3oYSW const RandomValue = () => { Math.floor(Math.random() * 100) } ; // To use it: ReactDOM.render(, mountNode);

Any JavaScript expression can go inside those curly braces. This is equivalent to the ${} interpolation syntax in JavaScript template literals.

This is the only constraint inside JSX: only expressions. So, for example, you can’t use a regular if statement, but a ternary expression is ok.

JavaScript variables are also expressions, so when the component receives a list of props (the RandomValue component didn’t, props are optional), you can use these props inside curly braces. We did this in the Button component above (Example 1).

JavaScript objects are also expressions. Sometimes we use a JavaScript object inside curly braces, which makes it look like double curly braces, but it’s really just an object inside curly braces. One use case of that is to pass a CSS style object to the special style attribute in React:

// Example 6 - An object passed to the special React style prop // //jscomplete.com/repl?j=S1Kw2sFHb const ErrorDisplay = ({message}) => {message} ; // Use it: ReactDOM.render( , mountNode );

Note how I destructured only the message out of the props argument. Also note how the style attribute above is a special one (again, it’s not HTML, it’s closer to the DOM API). We use an object as the value of the style attribute. That object defines the styles as if we’re doing so with JavaScript (because we are).

You can even use a React element inside JSX, because that too is an expression. Remember, a React element is essentially a function call:

// Example 7 - Using a React element within {} // //jscomplete.com/repl?j=SkTLpjYr- const MaybeError = ({errorMessage}) => {errorMessage && } ; // The MaybeError component uses the ErrorDisplay component: const ErrorDisplay = ({message}) => {message} ; // Now we can use the MaybeError component: ReactDOM.render(  0.5 ? 'Not good' : ''} />, mountNode );

The MaybeError component above would only display the ErrorDisplay component if there is an errorMessage string passed to it and an empty div. React considers {true}, {false}, {undefined}, and {null} to be valid element children, which do not render anything.

You can also use all of JavaScript functional methods on collections (map, reduce, filter, concat, and so on) inside JSX. Again, because they return expressions:

// Example 8 - Using an array map inside {} // //jscomplete.com/repl?j=SJ29aiYH- const Doubler = ({value=[1, 2, 3]}) => {value.map(e => e * 2)} ; // Use it ReactDOM.render(, mountNode);

Note how I gave the value prop a default value above, because it’s all just Javascript. Note also that I outputted an array expression inside the div. React is okay with that; It will place every doubled value in a text node.

Fundamental #4: You can write React components with JavaScript classes

Simple function components are great for simple needs, but sometimes we need more. React supports creating components through the JavaScript class syntax as well. Here’s the Button component (in Example 1) written with the class syntax:

// Example 9 - Creating components using JavaScript classes // //jscomplete.com/repl?j=ryjk0iKHb class Button extends React.Component { render() { return {this.props.label}; } } // Use it (same syntax) ReactDOM.render(, mountNode);

The class syntax is simple. Define a class that extends React.Component (another top-level React API thing that you need to learn). The class defines a single instance function render(), and that render function returns the virtual DOM element. Every time we use the Button class-based component above (for example, by doing