JSX: Regras de Sintaxe, Expressões JavaScript e Compilação com Babel
📑 Índice do Conteúdo
1. O Que É JSX e Por Que Ele Não É HTML?
Ao abrir um arquivo de componente React pela primeira vez, muitos desenvolvedores têm a impressão imediata de estar escrevendo HTML dentro do código JavaScript. Essa percepção é tecnicamente incorreta. O que você está escrevendo é JSX (JavaScript XML): uma extensão de sintaxe declarativa criada pelo ecossistema React para descrever como a interface deve se parecer.
Nenhum navegador web do planeta compreende JSX nativamente. Motores como o V8 do Chrome ou o SpiderMonkey do Firefox só conseguem interpretar JavaScript puro. Por isso, compiladores modernos como o Babel, SWC ou ESBuild transpilam cada elemento JSX para chamadas regulares da API do React:
A Transformação do JSX pelo Compilador
// O que você escreve (JSX):
<button className="btn-primary" onClick={handleClick}>
Clique Aqui
</button>
// Para o que o Babel transfila (JavaScript Clássico):
React.createElement('button', {
className: 'btn-primary',
onClick: handleClick
}, 'Clique Aqui');
2. As 4 Regras de Ouro da Sintaxe JSX
Para escrever JSX válido sem que o compilador dispare erros de análise sintática, você deve obedecer a quatro regras fundamentais:
- Retorno de um Único Elemento Pai: Um componente precisa retornar uma única tag raiz. Se você tiver múltiplos elementos irmãos, deve agrupá-los em um elemento contêiner ou em um fragmento vazio (
<>...</>). Isso ocorre porque uma função JavaScript só pode retornar um único valor por vez. - Fechamento Obrigatório de Todas as Tags: Ao contrário do HTML5 clássico onde tags como
<img>,<input>ou<br>não exigiam fechamento, no JSX toda tag sem filhos precisa ser explicitamente auto-fechada:<img src="..." alt="..." />e<input type="text" />. - Nomenclatura em camelCase para Atributos: Como o JSX é transpilado para propriedades de objetos JavaScript, muitos nomes coincidem com palavras reservadas da linguagem:
classvira obrigatoriamenteclassName(evitando conflito com a declaraçãoclassdo ES6).forvira obrigatoriamentehtmlFor(evitando conflito com o laçofor).- Eventos usam camelCase:
onclickviraonClick;onchangeviraonChange.
- Componentes Customizados Devem Começar com Letra Maiúscula: O compilador usa a primeira letra para diferenciar tags HTML nativas de componentes React:
<button>(minúscula): compilado como string para um nó nativo do DOM.<Button>(maiúscula): compilado como referência a uma função ou classe definida no seu código.
3. Interpolação de Expressões JavaScript com Chaves `{}`
Dentro do JSX, o par de chaves {} funciona como um portal mágico para o JavaScript. Qualquer expressão JavaScript válida (algo que avalie para um valor) pode ser executada dentro das chaves:
const user = { name: "Beatriz", role: "Arquiteta Front-End", points: 1420 };
function ProfileBadge() {
return (
<div className="profile-badge">
<h3>{user.name.toUpperCase()}</h3>
<p>Cargo: {user.role}</p>
<span>Nível: {user.points > 1000 ? 'Sênior' : 'Pleno'}</span>
</div>
);
}
Atenção: Você pode usar expressões (ternários, chamadas de métodos, operações matemáticas, template literals), mas não instruções (statements) como laços
forou blocosif/elsebrutos diretamente dentro do JSX. Para condicionais dentro de chaves, utilizamos operadores ternários ou o operador lógico&&.
4. Estilos Inline no JSX: A Sintaxe de Chaves Duplas `{{}}`
Ao definir estilos inline no JSX, você não passa uma string como no HTML. Em vez disso, você passa um objeto JavaScript literal com propriedades em camelCase, o que resulta na famosa sintaxe de chaves duplas (as chaves externas abrem a interpolação; as internas definem o objeto):
// HTML Clássico: style="background-color: #0f172a; font-size: 14px;"
// JSX Moderno:
<div style={{ backgroundColor: '#0f172a', fontSize: '14px', borderRadius: '8px' }}>
Card Estilizado
</div>
5. Conclusão
O JSX une o poder descritivo das linguagens de marcação à flexibilidade total da programação em JavaScript. Dominar suas regras garante que você componha interfaces limpas, sem erros de compilação e prontas para receber estados dinâmicos e propriedades.
Aplique o que você aprendeu nesta lição
Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground Web Online
Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.
⚡ Codificar no Playground IDE