Skip to content
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

Sync with reactjs.org @ 081bb312 #351

Merged
merged 37 commits into from Oct 29, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
37 commits
Select commit Hold shift + click to select a range
71050d5
Update code-splitting.md
sophiebits Oct 22, 2019
e560f8a
Blog post announcing prerelease channels (#2455)
acdlite Oct 22, 2019
be0cd9f
Typo
acdlite Oct 22, 2019
b4b53b3
Fix double negative
acdlite Oct 22, 2019
2a15e91
Fix double negative on Release Channels page, too
acdlite Oct 22, 2019
6de2fdf
Add app.js Conf to conferences (#2458)
tchayen Oct 23, 2019
9932845
Concurrent Mode Documentation (#2461)
gaearon Oct 24, 2019
f324360
Update links to Relay docs (#2462)
jstejada Oct 24, 2019
62775f3
fix tiny typo on concurrent docs (#2465)
swyxio Oct 24, 2019
ba4b45c
Minor typo fix in concurrent mode overview. (#2464)
Oct 24, 2019
c7c9306
Fix typo in suspense documentation (#2467)
stevehanson Oct 24, 2019
ad3a1d5
Fix typo (#2469)
JB1905 Oct 24, 2019
2e70fb5
Fix minor typo in concurrent mode adoption docs (#2472)
mattfwood Oct 24, 2019
43d8e5f
Fix minor typo in concurrent mode reference docs (#2473)
mattfwood Oct 24, 2019
a89650a
Close missing suspense tags in documentation for concurrent UI… (#2475)
thomasgassmann Oct 24, 2019
1189e19
Fix typo in concurrent-mode-patterns.md (#2478)
ludwigbacklund Oct 24, 2019
cd91e9d
Fix typo
lex111 Oct 24, 2019
6d9467a
added new reactjs hangman game (#2466)
vetrivelcsamy Oct 25, 2019
a57f347
Add "the" in "In long term" (#2481)
joehoyle Oct 25, 2019
f415af7
Update concurrent-mode-patterns.md (#2482)
davidkpiano Oct 25, 2019
9063787
Add missing verb (#2483)
glennreyes Oct 25, 2019
8a374d9
add example project radix converter (#2486)
kumom Oct 25, 2019
85079f4
Fix `createblockingroot` link in concurrent-mode-reference.md (#2485)
stonexer Oct 25, 2019
2231a7c
Fix doc referencing incorrect variable `details` (#2487)
bbonamin Oct 25, 2019
cf578f8
Missing highlighted line in concurrent mode patterns example (#2490)
Drakota Oct 25, 2019
60bfdd6
Update meetups.md adding Nantes (France ) meetup (#2494)
Oct 26, 2019
4f43c0f
update catalan status .. (#2491)
3imed-jaberi Oct 26, 2019
3159be9
Fix typo on concurrent mode api (#2498)
hirofumii Oct 26, 2019
fab0b46
Update concurrent-mode-reference.md
lex111 Oct 26, 2019
cbd3401
Update tools-starter-kits.md (#2497)
winwiz1 Oct 27, 2019
18327d4
Formateed react-v16.9.0 post (#2501)
Oct 27, 2019
e66c25b
Update Conferences (#2503)
TejasQ Oct 27, 2019
e4b737c
[Conferences page] Fix odd title (#2504)
TejasQ Oct 27, 2019
522459c
Add wix-style-react to Free Components list (#2502)
yershalom Oct 27, 2019
081bb31
Fix typo in concurrent-mode-patterns.md (#2507)
TSMMark Oct 28, 2019
b988097
merging all conflicts
reactjs-translation-bot Oct 28, 2019
5303d71
Update code-splitting.md
Oct 29, 2019
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
6 changes: 3 additions & 3 deletions content/blog/2019-08-08-react-v16.9.0.md
Expand Up @@ -211,7 +211,7 @@ Consulte a documentação para [instruções detalhadas de instalação](/docs/i
* Adiciona API do `<React.Profiler>` para reunir medições de desempenho programaticamente. ([@bvaughn](https://github.com/bvaughn) em [#15172](https://github.com/facebook/react/pull/15172))
* Remove `unstable_ConcurrentMode` em favor de `unstable_createRoot`. ([@acdlite](https://github.com/acdlite) em [#15532](https://github.com/facebook/react/pull/15532))

### React DOM
### React DOM {#react-dom}

* Deprecia nomes antigos dos métodos do ciclo de vida para os `UNSAFE_*`. ([@bvaughn](https://github.com/bvaughn) em [#15186](https://github.com/facebook/react/pull/15186) e [@threepointone](https://github.com/threepointone) em [#16103](https://github.com/facebook/react/pull/16103))
* Deprecia URLs `javascript:` como uma superfície de ataque comum. ([@sebmarkbage](https://github.com/sebmarkbage) em [#15047](https://github.com/facebook/react/pull/15047))
Expand All @@ -228,11 +228,11 @@ Consulte a documentação para [instruções detalhadas de instalação](/docs/i
* Corrige a ocultação dos nós de fallback do Suspense quando houver um `!important` no estilo. ([@acdlite](https://github.com/acdlite) em [#15861](https://github.com/facebook/react/pull/15861) e [#15882](https://github.com/facebook/react/pull/15882))
* Melhora ligeiramente o desempenho de hidratação. ([@bmeurer](https://github.com/bmeurer) em [#15998](https://github.com/facebook/react/pull/15998))

### React DOM Server
### React DOM Server {#react-dom-server}

* Corrige a saída incorreta para nomes de propriedades CSS customizadas do camelCase. ([@bedakb](https://github.com/bedakb) em [#16167](https://github.com/facebook/react/pull/16167))

### React Test Utilities e Test Renderer
### React Test Utilities e Test Renderer {#react-test-utilities-and-test-renderer}

* Adiciona `act(async () => ...)` para testar atualizações de estado assíncronas. ([@threepointone](https://github.com/threepointone) em [#14853](https://github.com/facebook/react/pull/14853))
* Adiciona suporte para aninhamento `act` de diferentes renderizadores. ([@threepointone](https://github.com/threepointone) em [#16039](https://github.com/facebook/react/pull/16039) e [#16042](https://github.com/facebook/react/pull/16042))
Expand Down
12 changes: 6 additions & 6 deletions content/blog/2019-08-15-new-react-devtools.md
Expand Up @@ -4,7 +4,7 @@ author: [bvaughn]
---
Nós estamos animados em anunciar uma nova versão do React Developer Tools, disponível hoje para Chrome, Firefox e (Chromium) Edge!

## O que mudou?
## O que mudou? {#whats-changed}

Muito mudou na versão 4!
Resumidamente, esta nova versão deve oferecer ganhos significantes de performance e uma experiência de navegação melhorada.
Expand All @@ -14,7 +14,7 @@ Ela também oferece suporte completo para React Hooks, incluindo a possibilidade

[Visite o tutorial interativo](https://react-devtools-tutorial.now.sh/) para testar a nova versão ou [veja o changelog](https://github.com/facebook/react/blob/master/packages/react-devtools/CHANGELOG.md#400-august-15-2019) para vídeos de demonstração e mais detalhes.

## Quais versões do React são suportadas?
## Quais versões do React são suportadas? {#which-versions-of-react-are-supported}

**`react-dom`**

Expand All @@ -26,7 +26,7 @@ Ela também oferece suporte completo para React Hooks, incluindo a possibilidade
* `0`-`0.61`: Não suportada
* `0.62`: Será suportada (quando a versão 0.62 for lançada)

## Como eu consigo o novo DevTools?
## Como eu consigo o novo DevTools? {#how-do-i-get-the-new-devtools}

O React DevTools está disponível como uma extensão para [Chrome](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en) e [Firefox](https://addons.mozilla.org/en-US/firefox/addon/react-devtools/).
Se você já instalou a extensão, ela deve atualizar automaticamente nas próximas horas.
Expand All @@ -37,14 +37,14 @@ Se você usa a versão independente (por exemplo, no React Native ou Safari), vo
npm install -g react-devtools@^4
```

## Para onde foram todos os elementos do DOM?
## Para onde foram todos os elementos do DOM? {#where-did-all-of-the-dom-elements-go}

O novo DevTools provê uma maneira de filtrar os componentes da árvore para facilitar a navegação de hierarquias profundamente aninhadas.
Host nodes (por exemplo, HTML `<div>`, React Native `<View>`) são *escondidos por padrão*, mas este filtro pode ser desabilitado:

![Filtros de component do DevTools](../images/blog/devtools-component-filters.gif)

## Como eu volto para a versão antiga?
## Como eu volto para a versão antiga? {#how-do-i-get-the-old-version-back}

Se você está trabalhando com React Native na versão 60 (ou anterior), você pode instalar a versão anterior do DevTools a partir do NPM:

Expand All @@ -70,7 +70,7 @@ yarn build:extension
# Siga as instruções da tela para finalizar a instalação
```

## Muito obrigado!
## Muito obrigado! {#thank-you}

Nós gostaríamos de agradecer quem testou a versão antecipada do DevTools versão 4.
Seus feedbacks ajudaram a melhorar significativamente a versão inicial.
Expand Down
102 changes: 102 additions & 0 deletions content/blog/2019-10-22-react-release-channels.md
@@ -0,0 +1,102 @@
---
title: "Preparing for the Future with React Prereleases"
author: [acdlite]
---

To share upcoming changes with our partners in the React ecosystem, we're establishing official prerelease channels. We hope this process will help us make changes to React with confidence, and give developers the opportunity to try out experimental features.

> This post will be most relevant to developers who work on frameworks, libraries, or developer tooling. Developers who use React primarily to build user-facing applications should not need to worry about our prerelease channels.

React relies on a thriving open source community to file bug reports, open pull requests, and [submit RFCs](https://github.com/reactjs/rfcs). To encourage feedback, we sometimes share special builds of React that include unreleased features.

Because the source of truth for React is our [public GitHub repository](https://github.com/facebook/react), it's always been possible to build a copy of React that includes the latest changes. However it's much easier for developers to install React from npm, so we occasionally publish prerelease builds to the npm registry. A recent example is the 16.7 alpha, which included an early version of the Hooks API.

We would like to make it even easier for developers to test prerelease builds of React, so we're formalizing our process with three separate release channels.

## Release Channels

> The information in this post is also available on our [Release Channels](/docs/release-channels.html) page. We will update that document whenever there are changes to our release process.

Each of React's release channels is designed for a distinct use case:

- [**Latest**](#latest-channel) is for stable, semver React releases. It's what you get when you install React from npm. This is the channel you're already using today. **Use this for all user-facing React applications.**
- [**Next**](#next-channel) tracks the master branch of the React source code repository. Think of these as release candidates for the next minor semver release. Use this for integration testing between React and third party projects.
- [**Experimental**](#experimental-channel) includes experimental APIs and features that aren't available in the stable releases. These also track the master branch, but with additional feature flags turned on. Use this to try out upcoming features before they are released.

All releases are published to npm, but only Latest uses [semantic versioning](/docs/faq-versioning.html). Prereleases (those in the Next and Experimental channels) have versions generated from a hash of their contents, e.g. `0.0.0-1022ee0ec` for Next and `0.0.0-experimental-1022ee0ec` for Experimental.

**The only officially supported release channel for user-facing applications is Latest**. Next and Experimental releases are provided for testing purposes only, and we provide no guarantees that behavior won't change between releases. They do not follow the semver protocol that we use for releases from Latest.

By publishing prereleases to the same registry that we use for stable releases, we are able to take advantage of the many tools that support the npm workflow, like [unpkg](https://unpkg.com) and [CodeSandbox](https://codesandbox.io).

### Latest Channel

Latest is the channel used for stable React releases. It corresponds to the `latest` tag on npm. It is the recommended channel for all React apps that are shipped to real users.

**If you're not sure which channel you should use, it's Latest.** If you're a React developer, this is what you're already using.

You can expect updates to Latest to be extremely stable. Versions follow the semantic versioning scheme. Learn more about our commitment to stability and incremental migration in our [versioning policy](/docs/faq-versioning.html).

### Next Channel

The Next channel is a prerelease channel that tracks the master branch of the React repository. We use prereleases in the Next channel as release candidates for the Latest channel. You can think of Next as a superset of Latest that is updated more frequently.

The degree of change between the most recent Next release and the most recent Latest release is approximately the same as you would find between two minor semver releases. However, **the Next channel does not conform to semantic versioning.** You should expect occasional breaking changes between successive releases in the Next channel.

**Do not use prereleases in user-facing applications.**

Releases in Next are published with the `next` tag on npm. Versions are generated from a hash of the build's contents, e.g. `0.0.0-1022ee0ec`.

#### Using the Next Channel for Integration Testing

The Next channel is designed to support integration testing between React and other projects.

All changes to React go through extensive internal testing before they are released to the public. However, there are a myriad of environments and configurations used throughout the React ecosystem, and it's not possible for us to test against every single one.

If you're the author of a third party React framework, library, developer tool, or similar infrastructure-type project, you can help us keep React stable for your users and the entire React community by periodically running your test suite against the most recent changes. If you're interested, follow these steps:

- Set up a cron job using your preferred continuous integration platform. Cron jobs are supported by both [CircleCI](https://circleci.com/docs/2.0/triggers/#scheduled-builds) and [Travis CI](https://docs.travis-ci.com/user/cron-jobs/).
- In the cron job, update your React packages to the most recent React release in the Next channel, using `next` tag on npm. Using the npm cli:

```
npm update react@next react-dom@next
```

Or yarn:

```
yarn upgrade react@next react-dom@next
```
- Run your test suite against the updated packages.
- If everything passes, great! You can expect that your project will work with the next minor React release.
- If something breaks unexpectedly, please let us know by [filing an issue](https://github.com/facebook/react/issues).

A project that uses this workflow is Next.js. (No pun intended! Seriously!) You can refer to their [CircleCI configuration](https://github.com/zeit/next.js/blob/c0a1c0f93966fe33edd93fb53e5fafb0dcd80a9e/.circleci/config.yml) as an example.

### Experimental Channel

Like Next, the Experimental channel is a prerelease channel that tracks the master branch of the React repository. Unlike Next, Experimental releases include additional features and APIs that are not ready for wider release.

Usually, an update to Next is accompanied by a corresponding update to Experimental. They are based on the same source revision, but are built using a different set of feature flags.

Experimental releases may be significantly different than releases to Next and Latest. **Do not use Experimental releases in user-facing applications.** You should expect frequent breaking changes between releases in the Experimental channel.

Releases in Experimental are published with the `experimental` tag on npm. Versions are generated from a hash of the build's contents, e.g. `0.0.0-experimental-1022ee0ec`.

#### What Goes Into an Experimental Release?

Experimental features are ones that are not ready to be released to the wider public, and may change drastically before they are finalized. Some experiments may never be finalized -- the reason we have experiments is to test the viability of proposed changes.

For example, if the Experimental channel had existed when we announced Hooks, we would have released Hooks to the Experimental channel weeks before they were available in Latest.

You may find it valuable to run integration tests against Experimental. This is up to you. However, be advised that Experimental is even less stable than Next. **We do not guarantee any stability between Experimental releases.**

#### How Can I Learn More About Experimental Features?

Experimental features may or may not be documented. Usually, experiments aren't documented until they are close to shipping in Next or Stable.

If a feature is not documented, they may be accompanied by an [RFC](https://github.com/reactjs/rfcs).

We will post to the React blog when we're ready to announce new experiments, but that doesn't mean we will publicize every experiment.

You can always refer to our public GitHub repository's [history](https://github.com/facebook/react/commits/master) for a comprehensive list of changes.
39 changes: 22 additions & 17 deletions content/community/conferences.md
Expand Up @@ -17,21 +17,6 @@ Você sabe de alguma conferência local sobre ReactJS? Adicione-a aqui! (Por fav

[Website](https://reactsummit2019.splashthat.com) - [Twitter](https://twitter.com/react_summit)

### React Conf 2019 {#react-conf-2019}
24 e 25 de outubro de 2019 em Henderson, Nevada USA

[Website](https://conf.reactjs.org/) - [Twitter](https://twitter.com/reactjs)

### React Advanced 2019 {#react-advanced-2019}
15 de outubro de 2019 em London, UK

[Website](https://reactadvanced.com) - [Twitter](http://twitter.com/reactadvanced) - [Facebook](https://www.facebook.com/ReactAdvanced) - [Vídeos](https://youtube.com/c/ReactConferences)

### React Conf Brasil 2019 {#react-conf-2019}
19 de outubro de 2019 em São Paulo, BR

[Website](https://reactconf.com.br/) - [Twitter](https://twitter.com/reactconfbr) - [Facebook](https://www.facebook.com/ReactAdvanced) - [Slack](https://react.now.sh/)

### React Day Berlin 2019 {#react-day-berlin-2019}
6 de dezembro de 2019 em Berlin, Germany

Expand All @@ -47,7 +32,12 @@ Você sabe de alguma conferência local sobre ReactJS? Adicione-a aqui! (Por fav

[Website](https://reactsummit.com) - [Twitter](https://twitter.com/reactamsterdam) - [Facebook](https://www.facebook.com/reactamsterdam) - [Vídeos](https://youtube.com/c/ReactConferences)

### Render-Atlanta 2020 {#render-atlanta-2020}
### App.js Conf 2020 {#appjsonf2020}
23 a 24 de abril de 2020 em Cracóvia, Polônia

[Website](http://appjs.co/react) - [Twitter](https://twitter.com/appjsconf)

### render(ATL) 2020 {#render-atlanta-2020}
4 a 6 de maio de 2020. Atlanta, GA, EUA.

[Website](https://renderatl.com) - [Twitter](https://twitter.com/renderATL) - [Instagram](https://www.instagram.com/renderatl/) - [Facebook](https://www.facebook.com/renderatl/)
Expand All @@ -67,7 +57,7 @@ Você sabe de alguma conferência local sobre ReactJS? Adicione-a aqui! (Por fav

[Website](https://react-next.com/) - [Twitter](https://twitter.com/reactnext) - [Facebook](https://www.facebook.com/ReactNext2016/)

### React Week NY 2020 {#react-week-NY-2020}
### React Week NY 2020 {#react-week-ny-2020}
17 de julho, 2020. Nova Iorque, USA.

[Website](https://reactweek.nyc/) - [Twitter](https://twitter.com/reactweek) - [Facebook](https://www.facebook.com/reactweek)
Expand Down Expand Up @@ -450,3 +440,18 @@ Você sabe de alguma conferência local sobre ReactJS? Adicione-a aqui! (Por fav
26 a 28 de setembro de 2019 em Alicante, Espanha

[Website](http://reactalicante.es/) - [Twitter](https://twitter.com/reactalicante) - [Facebook](https://www.facebook.com/ReactAlicante)

### React Conf 2019 {#react-conf-2019}
24 e 25 de outubro de 2019 em Henderson, Nevada USA

[Website](https://conf.reactjs.org/) - [Twitter](https://twitter.com/reactjs)

### React Advanced 2019 {#react-advanced-2019}
15 de outubro de 2019 em London, UK

[Website](https://reactadvanced.com) - [Twitter](http://twitter.com/reactadvanced) - [Facebook](https://www.facebook.com/ReactAdvanced) - [Vídeos](https://youtube.com/c/ReactConferences)

### React Conf Brasil 2019 {#react-conf-2019}
19 de outubro de 2019 em São Paulo, BR

[Website](https://reactconf.com.br/) - [Twitter](https://twitter.com/reactconfbr) - [Facebook](https://www.facebook.com/ReactAdvanced) - [Slack](https://react.now.sh/)
3 changes: 2 additions & 1 deletion content/community/examples.md
Expand Up @@ -8,7 +8,6 @@ permalink: community/examples.html

Existem vários projetos de exemplos criados pela comunidade do React. Sinta-se a vontade para adicionar seu próprio projeto. Caso você adicione, comprometa-se em mantê-lo atualizado com as versões recentes do React.


* **[Calculator](https://github.com/ahfarmer/calculator)** Implementação da calculadora para iOS construída em React.
* **[Emoji Search](https://github.com/ahfarmer/emoji-search)** App Simples em React para procurar emojis.
* **[Github Battle App](https://tm.dev/react-course-project/)** Batalhe com outro usuário do GitHub e veja os projetos mais populares no GitHub em qualquer linguagem.
Expand All @@ -25,3 +24,5 @@ Existem vários projetos de exemplos criados pela comunidade do React. Sinta-se
* **[Speedy math](https://github.com/pankajladhar/speedy-math)** Um aplicativo que permite que as crianças pratiquem Matemática básica, ou seja, adição, subtração, comparação. É um PWA (Progressive web app) com suporte offline e é instalado como recursos do aplicativo.
* **[Unit Converter](https://github.com/KarthikeyanRanasthala/react-unit-converter)** Conversor de unidade mínimo, porém responsivo construido com React, Material-UI & Convert-Units.
* **[BMI Calculator](https://github.com/GermaVinsmoke/bmi-calculator)** Um aplicativo React Hooks para calcular BMI.
* **[ReactJS Hangman Game](https://github.com/vetrivelcsamy/reactjs-hangman)** Jogo da Forca ReactJS encontre uma linguagem de programação.
* **[Radix Converter](https://github.com/kumom/radix-converter)** Uma pequena ferramenta que converte números no raio 2 a 36 com precisão arbitrária.
1 change: 1 addition & 0 deletions content/community/meetups.md
Expand Up @@ -50,6 +50,7 @@ Você está organizando um Meetup de ReactJS? Adicione-o aqui! (Por favor, mante
* [React.JS Girls London](https://www.meetup.com/ReactJS-Girls-London/)

## França {#france}
* [Nantes](https://www.meetup.com/React-Nantes/)
* [Lille](https://www.meetup.com/ReactBeerLille/)
* [Paris](https://www.meetup.com/ReactJS-Paris/)

Expand Down