diff --git a/src/content/learn/writing-markup-with-jsx.md b/src/content/learn/writing-markup-with-jsx.md index 62670150a..a983e77bf 100644 --- a/src/content/learn/writing-markup-with-jsx.md +++ b/src/content/learn/writing-markup-with-jsx.md @@ -4,31 +4,31 @@ title: Writing Markup with JSX -*JSX* is a syntax extension for JavaScript that lets you write HTML-like markup inside a JavaScript file. Although there are other ways to write components, most React developers prefer the conciseness of JSX, and most codebases use it. +*JSX* é uma extensão de sintaxe para JavaScript que permite você escrever códigos com marcações tipo HTML dentro de um arquivo Javascript. Embora existam outras maneiras de se escrever componentes, a maioria dos desenvolvedores React preferem a concisão do JSX e a maioria das bases de código o utiliza. -* Why React mixes markup with rendering logic -* How JSX is different from HTML -* How to display information with JSX +* Porque o React mistura marcações com lógica de renderização +* Como o JSX é diferente do HTML +* Como mostrar informações com o JSX -## JSX: Putting markup into JavaScript {/*jsx-putting-markup-into-javascript*/} +## JSX: Colocando marcação em JavaScript {/*jsx-putting-markup-into-javascript*/} -The Web has been built on HTML, CSS, and JavaScript. For many years, web developers kept content in HTML, design in CSS, and logic in JavaScript—often in separate files! Content was marked up inside HTML while the page's logic lived separately in JavaScript: +A Web foi construída em HTML, CSS e JavaScript. Por muitos anos, os desenvolvedores da Web mantiveram o conteúdo em HTML, o design em CSS e a lógica em JavaScript — muitas vezes em arquivos separados! O conteúdo era marcado dentro do HTML enquanto a lógica da página vivia separadamente no JavaScript: - + HTML - + JavaScript @@ -36,81 +36,81 @@ JavaScript -But as the Web became more interactive, logic increasingly determined content. JavaScript was in charge of the HTML! This is why **in React, rendering logic and markup live together in the same place—components.** +Mas à medida que a Web se tornava mais interativa, a lógica determinava cada vez mais o conteúdo. O JavaScript ficou a cargo do HTML! É por isso que **no React, a lógica de renderização e a marcação vivem juntas no mesmo lugar — os componentes.** - + -`Sidebar.js` React component +`Sidebar.js` Componente React - + -`Form.js` React component +`Form.js` Componente React -Keeping a button's rendering logic and markup together ensures that they stay in sync with each other on every edit. Conversely, details that are unrelated, such as the button's markup and a sidebar's markup, are isolated from each other, making it safer to change either of them on their own. +Manter a lógica de renderização e a marcação de um botão juntas garante que eles permaneçam sincronizados entre si em todas as edições. Por outro lado, os detalhes não relacionados, como a marcação do botão e a marcação da barra lateral, são isolados uns dos outros, tornando mais seguro alterar qualquer um deles por conta própria. -Each React component is a JavaScript function that may contain some markup that React renders into the browser. React components use a syntax extension called JSX to represent that markup. JSX looks a lot like HTML, but it is a bit stricter and can display dynamic information. The best way to understand this is to convert some HTML markup to JSX markup. +Cada componente do React é uma função JavaScript que pode conter alguma marcação que o React renderiza no navegador. Os componentes do React usam uma extensão de sintaxe chamada JSX para representar essa marcação. O JSX se parece muito com o HTML, mas é um pouco mais rígido e pode exibir informações dinâmicas. A melhor maneira de entender isso é converter alguma marcação HTML em marcação JSX. -JSX and React are two separate things. They're often used together, but you *can* [use them independently](https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html#whats-a-jsx-transform) of each other. JSX is a syntax extension, while React is a JavaScript library. +JSX e React são duas coisas separadas. Eles são comumente utilizados juntos, mas você *pode* [usá-los independentemente](https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html#whats-a-jsx-transform) um do outro. JSX é uma extensão de sintaxe, enquanto o React é uma biblioteca Javascript. -## Converting HTML to JSX {/*converting-html-to-jsx*/} +## Convertendo HTML em JSX {/*converting-html-to-jsx*/} -Suppose that you have some (perfectly valid) HTML: +Suponha que você possua um HTML (perfeitamente válido): ```html -

Hedy Lamarr's Todos

+

Ferramentas do Hedy Lamarr

Hedy Lamarr ``` -And you want to put it into your component: +E você quer colocar dentro do seu componente: ```js -export default function TodoList() { +export default function ListaDeTarefas() { return ( // ??? ) } ``` -If you copy and paste it as is, it will not work: +Se você copiar e colar como está, não funcionará: ```js -export default function TodoList() { +export default function ListaDeTarefas() { return ( - // This doesn't quite work! -

Hedy Lamarr's Todos

+ // Isso não funciona muito bem! +

Tarefas do Hedy Lamarr

Hedy Lamarr ); } @@ -122,29 +122,29 @@ img { height: 90px }
-This is because JSX is stricter and has a few more rules than HTML! If you read the error messages above, they'll guide you to fix the markup, or you can follow the guide below. +Isso ocorre porque o JSX é mais rígido e possui algumas regras a mais que o HTML! Se você ler as mensagens de erro acima, elas o guiarão para corrigir a marcação ou você poderá seguir o guia abaixo. -Most of the time, React's on-screen error messages will help you find where the problem is. Give them a read if you get stuck! +Na maioria das vezes, as mensagens de erro na tela do React irão ajudá-lo a encontrar onde está o problema. Dê uma lida se você ficar travado! -## The Rules of JSX {/*the-rules-of-jsx*/} +## As Regras do JSX {/*the-rules-of-jsx*/} -### 1. Return a single root element {/*1-return-a-single-root-element*/} +### 1. Retornar um único elemento raiz {/*1-return-a-single-root-element*/} -To return multiple elements from a component, **wrap them with a single parent tag.** +Para retornar vários elementos de um componente, **envolva-os com uma única tag pai.** -For example, you can use a `
`: +Por exemplo, você pode usar uma `
`: ```js {1,11}
-

Hedy Lamarr's Todos

+

Tarefas do Hedy Lamarr

Hedy Lamarr
    ... @@ -153,11 +153,11 @@ For example, you can use a `
    `: ``` -If you don't want to add an extra `
    ` to your markup, you can write `<>` and `` instead: +Se você não quiser adicionar uma `
    ` extra à sua marcação, você pode escrever `<>` e `` em vez disso: ```js {1,11} <> -

    Hedy Lamarr's Todos

    +

    Tarefas do Hedy Lamarr

    Hedy Lamarr` to your markup, you can write `<>` and ``` -This empty tag is called a *[Fragment.](/reference/react/Fragment)* Fragments let you group things without leaving any trace in the browser HTML tree. +Essa tag vazia é chamada de *[Fragmento.](/reference/react/Fragment)* Os fragmentos permitem que você agrupe coisas sem deixar rastros na árvore HTML do navegador. -#### Why do multiple JSX tags need to be wrapped? {/*why-do-multiple-jsx-tags-need-to-be-wrapped*/} +#### Por que várias tags JSX precisam ser agrupadas? {/*why-do-multiple-jsx-tags-need-to-be-wrapped*/} -JSX looks like HTML, but under the hood it is transformed into plain JavaScript objects. You can't return two objects from a function without wrapping them into an array. This explains why you also can't return two JSX tags without wrapping them into another tag or a Fragment. +JSX se parece com HTML, mas por detrás das cortinas é transformado em objetos JavaScript simples. Você não pode retornar dois objetos de uma função sem envolvê-los em uma matriz. Isso explica por que você também não pode retornar duas tags JSX sem envolvê-las em outra tag ou Fragmento. -### 2. Close all the tags {/*2-close-all-the-tags*/} +### 2. Fechar todas as tags {/*2-close-all-the-tags*/} -JSX requires tags to be explicitly closed: self-closing tags like `` must become ``, and wrapping tags like `
  • oranges` must be written as `
  • oranges
  • `. +O JSX requer que as tags sejam explicitamente fechadas: tags de fechamento automático como `` devem se tornar ``, e tags de empacotamento como `
  • laranjas` devem ser escritas como `
  • laranjas
  • `. -This is how Hedy Lamarr's image and list items look closed: +É assim que a imagem e os itens da lista de Hedy Lamarr ficam fechados: ```js {2-6,8-10} <> Hedy Lamarr
      -
    • Invent new traffic lights
    • -
    • Rehearse a movie scene
    • -
    • Improve the spectrum technology
    • +
    • Inventar novos semáforos
    • +
    • Ensaiar uma cena de filme
    • +
    • Melhorar a tecnologia espectral
    ``` -### 3. camelCase all most of the things! {/*3-camelcase-salls-most-of-the-things*/} +### 3. camelCase em todas na maioria das coisas! {/*3-camelcase-salls-most-of-the-things*/} -JSX turns into JavaScript and attributes written in JSX become keys of JavaScript objects. In your own components, you will often want to read those attributes into variables. But JavaScript has limitations on variable names. For example, their names can't contain dashes or be reserved words like `class`. +JSX se transforma em JavaScript e atributos escritos em JSX se tornam chaves de objetos JavaScript. Em seus próprios componentes, muitas vezes você desejará ler esses atributos em variáveis. Mas JavaScript tem limitações em nomes de variáveis. Por exemplo, seus nomes não podem conter hífens ou palavras reservadas como `class`. -This is why, in React, many HTML and SVG attributes are written in camelCase. For example, instead of `stroke-width` you use `strokeWidth`. Since `class` is a reserved word, in React you write `className` instead, named after the [corresponding DOM property](https://developer.mozilla.org/en-US/docs/Web/API/Element/className): +É por isso que, no React, muitos atributos HTML e SVG são escritos em camelCase. Por exemplo, em vez de `stroke-width` você usa `strokeWidth`. Já que `class` é uma palavra reservada, no React você escreve `className`, nomeado após a [propriedade DOM correspondente](https://developer.mozilla.org/en-US/docs/Web/API/Element/className): ```js {4} Hedy Lamarr ``` -You can [find all these attributes in the list of DOM component props.](/reference/react-dom/components/common) If you get one wrong, don't worry—React will print a message with a possible correction to the [browser console.](https://developer.mozilla.org/docs/Tools/Browser_Console) +Você pode [encontrar todos esses atributos na lista de propriedades do componente DOM.](/reference/react-dom/components/common) Se você errar, não se preocupe — o React imprimirá uma mensagem com uma possível correção para o [console do navegador.](https://developer.mozilla.org/docs/Tools/Browser_Console) -For historical reasons, [`aria-*`](https://developer.mozilla.org/docs/Web/Accessibility/ARIA) and [`data-*`](https://developer.mozilla.org/docs/Learn/HTML/Howto/Use_data_attributes) attributes are written as in HTML with dashes. +Por razões históricas, [`aria-*`](https://developer.mozilla.org/docs/Web/Accessibility/ARIA) e [`data-*`](https://developer.mozilla.org/docs/Learn/HTML/Howto/Use_data_attributes) são escritos como em HTML com hífens. -### Pro-tip: Use a JSX Converter {/*pro-tip-use-a-jsx-converter*/} +### Dica: use um conversor JSX {/*pro-tip-use-a-jsx-converter*/} -Converting all these attributes in existing markup can be tedious! We recommend using a [converter](https://transform.tools/html-to-jsx) to translate your existing HTML and SVG to JSX. Converters are very useful in practice, but it's still worth understanding what is going on so that you can comfortably write JSX on your own. +Converter todos esses atributos em marcação pode ser tedioso! Recomendamos o uso de um [conversor](https://transform.tools/html-to-jsx) para traduzir seu HTML e SVG existentes para JSX. Os conversores são muito úteis na prática, mas ainda vale a pena entender o que está acontecendo para que você possa escrever JSX confortavelmente por conta própria. -Here is your final result: +Aqui está seu resultado final: ```js -export default function TodoList() { +export default function ListaDeTarefas() { return ( <> -

    Hedy Lamarr's Todos

    +

    Tarefas do Hedy Lamarr

    Hedy Lamarr
      -
    • Invent new traffic lights
    • -
    • Rehearse a movie scene
    • -
    • Improve the spectrum technology
    • +
    • Inventar novos semáforos
    • +
    • Ensaiar uma cena de filme
    • +
    • Melhorar a tecnologia espectral
    ); @@ -258,11 +258,11 @@ img { height: 90px } -Now you know why JSX exists and how to use it in components: +Agora você sabe porque o JSX existe e como usá-lo em componentes: -* React components group rendering logic together with markup because they are related. -* JSX is similar to HTML, with a few differences. You can use a [converter](https://transform.tools/html-to-jsx) if you need to. -* Error messages will often point you in the right direction to fixing your markup. +* Os componentes do React agrupam a lógica de renderização junto com a marcação porque estão relacionados. +* O JSX é semelhante ao HTML, com algumas diferenças. Se necessário, pode utilizar um [conversor] (https://transform.tools/html-to-jsx). +* As mensagens de erro geralmente indicam a direção certa para corrigir sua marcação. @@ -270,9 +270,9 @@ Now you know why JSX exists and how to use it in components: -#### Convert some HTML to JSX {/*convert-some-html-to-jsx*/} +#### Converta um HTML para JSX {/*convert-some-html-to-jsx*/} -This HTML was pasted into a component, but it's not valid JSX. Fix it: +Este HTML foi colado em um componente, mas não é um JSX válido. Conserte-o: @@ -280,12 +280,12 @@ This HTML was pasted into a component, but it's not valid JSX. Fix it: export default function Bio() { return (
    -

    Welcome to my website!

    +

    Bem-vindo ao meu site!

    -

    - You can find my thoughts here. +

    + Você pode encontrar meus pensamentos aqui.

    - And pictures of scientists! + E fotos de cientistas!

    ); } @@ -300,7 +300,7 @@ export default function Bio() { -webkit-text-fill-color: transparent; } -.summary { +.resumo { padding: 20px; border: 10px solid gold; } @@ -308,7 +308,7 @@ export default function Bio() {
    -Whether to do it by hand or using the converter is up to you! +Se vai fazê-lo manualmente ou utilizando um conversor, você decide! @@ -319,12 +319,12 @@ export default function Bio() { return (
    -

    Welcome to my website!

    +

    Bem vindo ao meu site!

    -

    - You can find my thoughts here. +

    + Você pode encontrar meus pensamentos aqui.

    - And pictures of scientists! + E fotos de cientistas!

    ); @@ -340,7 +340,7 @@ export default function Bio() { -webkit-text-fill-color: transparent; } -.summary { +.resumo { padding: 20px; border: 10px solid gold; }