{"componentChunkName":"component---src-templates-docs-js","path":"/docs/introducing-jsx.html","result":{"data":{"markdownRemark":{"html":"

Considere esta declaração de variável:

\n
const element = <h1>Hello, world!</h1>;
\n

Esta sintaxe estranha de tags não é uma string, nem HTML.

\n

É chamada JSX e é uma extensão de sintaxe para JavaScript. Recomendamos usar JSX com o React para descrever como a UI deveria parecer. JSX pode lembrar uma linguagem de template, mas que vem com todo o poder do JavaScript.

\n

JSX produz “elementos” do React. Nós iremos explorar a renderização para o DOM na próxima seção. Abaixo você descobrirá o básico de JSX necessário para começar.

\n

Por que JSX?

\n

O React adota o fato de que a lógica de renderização é inerentemente acoplada com outras lógicas de UI: como eventos são manipulados, como o state muda com o tempo e como os dados são preparados para exibição.

\n

Ao invés de separar tecnologias artificialmente colocando markup e lógica em arquivos separados, o React separa conceitos com unidades pouco acopladas chamadas “componentes” que contém ambos. Voltaremos aos componentes em\noutra seção. Mas, se você ainda não está confortável em usar markup em JS, esta palestra pode convencer você do contrário.

\n

O React não requer o uso do JSX. Porém, a maioria das pessoas acha prático como uma ajuda visual quando se está trabalhando com uma UI dentro do código em JavaScript. Ele permite ao React mostrar mensagens mais úteis de erro e aviso.

\n

Com isso fora do caminho, vamos começar!

\n

Incorporando Expressões em JSX

\n

No exemplo abaixo, declaramos uma variável chamada name e então a usamos dentro do JSX ao envolvê-la com chaves:

\n
const name = 'Josh Perez';const element = <h1>Hello, {name}</h1>;\nReactDOM.render(\n  element,\n  document.getElementById('root')\n);
\n

Você pode inserir qualquer expressão JavaScript válida dentro das chaves em JSX. Por exemplo, 2 + 2, user.firstName, ou formatName(user) são todas expressões JavaScript válidas.

\n

No exemplo abaixo, incorporamos o resultado da chamada de uma função JavaScript, formatName(user), dentro de um elemento <h1>.

\n
function formatName(user) {\n  return user.firstName + ' ' + user.lastName;\n}\n\nconst user = {\n  firstName: 'Harper',\n  lastName: 'Perez'\n};\n\nconst element = (\n  <h1>\n    Hello, {formatName(user)}!  </h1>\n);\n\nReactDOM.render(\n  element,\n  document.getElementById('root')\n);
\n

Try it on CodePen

\n

Separamos o JSX em múltiplas linhas para melhorar a legibilidade. Mesmo que não seja obrigatório, quando fizer isso, também recomendamos colocar dentro de parênteses para evitar as armadilhas da inserção automática de ponto-e-vírgula.

\n

JSX Também é uma Expressão

\n

Depois da compilação, as expressões em JSX se transformam em chamadas normais de funções que retornam objetos JavaScript.

\n

Isto significa que você pode usar JSX dentro de condições if e laços for, atribuí-lo a variáveis, aceitá-lo como argumentos e retorná-los de funções:

\n
function getGreeting(user) {\n  if (user) {\n    return <h1>Hello, {formatName(user)}!</h1>;  }\n  return <h1>Hello, Stranger.</h1>;}
\n

Especificando Atributos com JSX

\n

Você pode usar aspas para especificar strings literais como atributos:

\n
const element = <div tabIndex={0}></div>;
\n

Você também pode usar chaves para incorporar uma expressão JavaScript em um atributo:

\n
const element = <img src={user.avatarUrl}></img>;
\n

Não envolva chaves com aspas quando estiver incorporando uma expressão JavaScript em um atributo. Você deveria ou usar aspas (para valores em string) ou chaves (para expressões), mas não ambos no mesmo atributo.

\n
\n

Atenção:

\n

Como JSX é mais próximo de JavaScript que do HTML, o React DOM usa camelCase como convenção para nomes de propriedades ao invés dos nomes de atributos do HTML.

\n

Por exemplo, class se transforma em className em JSX, e tabindex se transforma em tabIndex.

\n
\n

Especificando Elementos Filhos com JSX

\n

Se uma tag está vazia, você pode fechá-la imediatamente com />, como XML:

\n
const element = <img src={user.avatarUrl} />;
\n

Tags JSX podem conter elementos filhos:

\n
const element = (\n  <div>\n    <h1>Hello!</h1>\n    <h2>Good to see you here.</h2>\n  </div>\n);
\n

JSX Previne Ataques de Injeção

\n

É seguro incorporar entradas de usuário em JSX:

\n
const title = response.potentiallyMaliciousInput;\n// This is safe:\nconst element = <h1>{title}</h1>;
\n

Por padrão, o React DOM escapa quaisquer valores incorporados no JSX antes de renderizá-los. Assim, assegura que você nunca injete algo que não esteja explicitamente escrito na sua aplicação. Tudo é convertido para string antes de ser renderizado. Isso ajuda a prevenir ataques XSS (cross-site-scripting).

\n

JSX Representa Objetos

\n

O Babel compila JSX para chamadas React.createElement().

\n

Estes dois exemplos são idênticos:

\n
const element = (\n  <h1 className=\"greeting\">\n    Hello, world!\n  </h1>\n);
\n
const element = React.createElement(\n  'h1',\n  {className: 'greeting'},\n  'Hello, world!'\n);
\n

React.createElement() realiza algumas verificações para ajudar você a criar um código sem bugs, mas, essencialmente, cria um objeto como este:

\n
// Nota: esta estrutura está simplificada\nconst element = {\n  type: 'h1',\n  props: {\n    className: 'greeting',\n    children: 'Hello, world!'\n  }\n};
\n

Estes objetos são chamados “Elementos React”. Você pode imaginá-los como descrições do que você quer ver na tela. O React lê esses objetos e os usa para construir o DOM e deixá-lo atualizado.

\n

Exploraremos a renderização de elementos React no DOM na próxima seção.

\n
\n

Dica:

\n

Recomendamos o uso da definição de linguagem “Babel” no seu editor preferido para que ambos os códigos em ES6 e JSX sejam devidamente realçados.

\n
","frontmatter":{"title":"Introduzindo JSX","next":"rendering-elements.html","prev":"hello-world.html"},"fields":{"path":"content/docs/introducing-jsx.md","slug":"docs/introducing-jsx.html"}}},"pageContext":{"slug":"docs/introducing-jsx.html"}},"staticQueryHashes":[]}