Skip to content

Commit fa83fd2

Browse files
authored
Merge pull request #647 from reactjs/sync-f3baa6d0
Sync with reactjs.org @ f3baa6d
2 parents c26e53f + a286758 commit fa83fd2

18 files changed

+174
-105
lines changed

content/authors.yml

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
# Map of short name to more information. `name` will be used but if you don't
22
# want to use your real name, just use whatever. If url is included, your name
33
# will be a link to the provided url.
4+
abernathyca:
5+
name: Christine Abernathy
6+
url: https://twitter.com/abernathyca
47
acdlite:
58
name: Andrew Clark
69
url: https://twitter.com/acdlite
@@ -70,12 +73,18 @@ petehunt:
7073
rachelnabors:
7174
name: Rachel Nabors
7275
url: https://twitter.com/rachelnabors
76+
rickhanlonii:
77+
name: Rick Hanlon
78+
url: https://twitter.com/rickhanlonii
7379
schrockn:
7480
name: Nick Schrock
7581
url: https://twitter.com/schrockn
7682
sebmarkbage:
7783
name: Sebastian Markbåge
7884
url: https://twitter.com/sebmarkbage
85+
sethwebster:
86+
name: Seth Webster
87+
url: https://twitter.com/sethwebster
7988
sophiebits:
8089
name: Sophie Alpert
8190
url: https://sophiebits.com/

content/blog/2017-09-08-dom-attributes-in-react-16.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ React has always provided a JavaScript-centric API to the DOM. Since React compo
3232
<div tabIndex={-1} />
3333
```
3434

35-
This has not changed. However, the way we enforced it in the past forced us to maintain a allowlist of all valid React DOM attributes in the bundle:
35+
This has not changed. However, the way we enforced it in the past forced us to maintain an allowlist of all valid React DOM attributes in the bundle:
3636

3737
```js
3838
// ...
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: "The Plan for React 18"
3+
author: [acdlite, bvaughn, abernathyca, gaearon, rachelnabors, rickhanlonii, sebmarkbage, sethwebster]
4+
---
5+
6+
The React team is excited to share a few updates:
7+
8+
1. We’ve started work on the React 18 release, which will be our next major version.
9+
2. We’ve created a Working Group to prepare the community for gradual adoption of new features in React 18.
10+
3. We’ve published a React 18 Alpha so that library authors can try it and provide feedback.
11+
12+
These updates are primarily aimed at maintainers of third-party libraries. If you’re learning, teaching, or using React to build user-facing applications, you can safely ignore this post. But you are welcome to follow the discussions in the React 18 Working Group if you're curious!
13+
14+
## What’s coming in React 18
15+
16+
When it’s released, React 18 will include out-of-the-box improvements (like [automatic batching](https://github.com/reactwg/react-18/discussions/21)), new APIs (like [`startTransition`](https://github.com/reactwg/react-18/discussions/41)), and a [new streaming server renderer](https://github.com/reactwg/react-18/discussions/37) with built-in support for `React.lazy`.
17+
18+
These features are possible thanks to a new opt-in mechanism we’re adding in React 18. It’s called “concurrent rendering” and it lets React prepare multiple versions of the UI at the same time. This change is mostly behind-the-scenes, but it unlocks new possibilities to improve both real and perceived performance of your app.
19+
20+
If you've been following our research into the future of React (we don't expect you to!), you might have heard of something called “concurrent mode” or that it might break your app. In response to this feedback from the community, we’ve redesigned the upgrade strategy for gradual adoption. Instead of an all-or-nothing “mode”, concurrent rendering will only be enabled for updates triggered by one of the new features. In practice, this means **you will be able to adopt React 18 without rewrites and try the new features at your own pace.**
21+
22+
## A gradual adoption strategy
23+
24+
Since concurrency in React 18 is opt-in, there are no significant out-of-the-box breaking changes to component behavior. **You can upgrade to React 18 with minimal or no changes to your application code, with a level of effort comparable to a typical major React release**. Based on our experience converting several apps to React 18, we expect that many users will be able to upgrade within a single afternoon.
25+
26+
We successfully shipped concurrent features to tens of thousands of components at Facebook, and in our experience, we've found that most React components “just work” without additional changes. We're committed to making sure this is a smooth upgrade for the entire community, so today we're announcing the React 18 Working Group.
27+
28+
## Working with the community
29+
30+
We’re trying something new for this release: We've invited a panel of experts, developers, library authors, and educators from across the React community to participate in our [React 18 Working Group](https://github.com/reactwg/react-18) to provide feedback, ask questions, and collaborate on the release. We couldn't invite everyone we wanted to this initial, small group, but if this experiment works out, we hope there will be more in the future!
31+
32+
**The goal of the React 18 Working Group is to prepare the ecosystem for a smooth, gradual adoption of React 18 by existing applications and libraries.** The Working Group is hosted on [GitHub Discussions](https://github.com/reactwg/react-18/discussions) and is available for the public to read. Members of the working group can leave feedback, ask questions, and share ideas. The core team will also use the discussions repo to share our research findings. As the stable release gets closer, any important information will also be posted on this blog.
33+
34+
For more information on upgrading to React 18, or additional resources about the release, see the [React 18 announcement post](https://github.com/reactwg/react-18/discussions/4).
35+
36+
## Accessing the React 18 Working Group
37+
38+
Everyone can read the discussions in the [React 18 Working Group repo](https://github.com/reactwg/react-18).
39+
40+
Because we expect an initial surge of interest in the Working Group, only invited members will be allowed to create or comment on threads. However, the threads are fully visible to the public, so everyone has access to the same information. We believe this is a good compromise between creating a productive environment for working group members, while maintaining transparency with the wider community.
41+
42+
As always, you can submit bug reports, questions, and general feedback to our [issue tracker](https://github.com/facebook/react/issues).
43+
44+
## How to try React 18 Alpha today
45+
46+
New alphas are [regularly published to npm using the `@alpha` tag](https://github.com/reactwg/react-18/discussions/9). These releases are built using the most recent commit to our main repo. When a feature or bugfix is merged, it will appear in an alpha the following weekday.
47+
48+
There may be significant behavioral or API changes between alpha releases. Please remember that **alpha releases are not recommended for user-facing, production applications**.
49+
50+
## Projected React 18 release timeline
51+
52+
We don't have a specific release date scheduled, but we expect it will take several months of feedback and iteration before React 18 is ready for most production applications.
53+
54+
* Library Alpha: Available today
55+
* Public Beta: At least several months
56+
* Release Candidate (RC): At least several weeks after Beta
57+
* General Availability: At least several weeks after RC
58+
59+
More details about our projected release timeline are [available in the Working Group](https://github.com/reactwg/react-18/discussions/9). We'll post updates on this blog when we're closer to a public release.

content/community/conferences.md

Lines changed: 24 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,25 +12,20 @@ Do you know of a local React.js conference? Add it here! (Please keep the list c
1212

1313
## Upcoming Conferences {#upcoming-conferences}
1414

15-
### React fwdays’21 {#react-fwdays-2021}
16-
March 27, 2021 - remote event
17-
18-
[Website](https://fwdays.com/en/event/react-fwdays-2021) - [Twitter](https://twitter.com/fwdays) - [Facebook](https://www.facebook.com/events/1133828147054286) - [LinkedIn](https://www.linkedin.com/events/reactfwdays-21onlineconference6758046347334582273) - [Meetup](https://www.meetup.com/ru-RU/Fwdays/events/275764431/)
19-
20-
### React Summit - Remote Edition 2021 {#react-summit-remote-2021}
21-
April 14-16, 2021, 7am PST / 10am EST / 4pm CEST - remote event
15+
### render(ATL) 2021 {#render-atlanta-2021}
16+
September 13-15, 2021. Atlanta, GA, USA
2217

23-
[Website](https://remote.reactsummit.com) - [Twitter](https://twitter.com/reactsummit) - [Facebook](https://www.facebook.com/reactamsterdam) - [Videos](https://youtube.com/c/ReactConferences)
18+
[Website](https://renderatl.com) - [Twitter](https://twitter.com/renderATL) - [Instagram](https://www.instagram.com/renderatl/) - [Facebook](https://www.facebook.com/renderatl/) - [LinkedIn](https://www.linkedin.com/company/renderatl)
2419

25-
### React Case Study Festival 2021 {#react-case-study-festival-2021}
26-
April 27-28, 2021 - remote event
20+
### React Conference Live 2021 {#react-conference-live-2021}
21+
October 7-8, 2021. In-person in Amsterdam, Netherlands + remote (hybrid event)
2722

28-
[Website](https://link.geekle.us/react/offsite) - [LinkedIn](https://www.linkedin.com/events/reactcasestudyfestival6721300943411015680/) - [Facebook](https://www.facebook.com/events/255715435820203)
23+
[Website](https://www.reactlive.nl/) - [Twitter](https://twitter.com/reactlivenl) - [LinkedIn](https://www.linkedin.com/company/frontendlove/)
2924

30-
### render(ATL) 2021 {#render-atlanta-2021}
31-
September 13-15, 2021. Atlanta, GA, USA
25+
### React Advanced 2021 {#react-advanced-2021}
26+
October 22-23, 2021. In-person in London, UK + remote (hybrid event)
3227

33-
[Website](https://renderatl.com) - [Twitter](https://twitter.com/renderATL) - [Instagram](https://www.instagram.com/renderatl/) - [Facebook](https://www.facebook.com/renderatl/) - [LinkedIn](https://www.linkedin.com/company/renderatl)
28+
[Website](https://reactadvanced.com) - [Twitter](https://twitter.com/reactadvanced) - [Facebook](https://www.facebook.com/ReactAdvanced) - [Videos](https://youtube.com/c/ReactConferences)
3429

3530
### React India 2021 {#react-india-2021}
3631
November 12-13, 2021 in Mumbai, India
@@ -39,6 +34,21 @@ November 12-13, 2021 in Mumbai, India
3934

4035
## Past Conferences {#past-conferences}
4136

37+
### React Case Study Festival 2021 {#react-case-study-festival-2021}
38+
April 27-28, 2021 - remote event
39+
40+
[Website](https://link.geekle.us/react/offsite) - [LinkedIn](https://www.linkedin.com/events/reactcasestudyfestival6721300943411015680/) - [Facebook](https://www.facebook.com/events/255715435820203)
41+
42+
### React Summit - Remote Edition 2021 {#react-summit-remote-2021}
43+
April 14-16, 2021, 7am PST / 10am EST / 4pm CEST - remote event
44+
45+
[Website](https://remote.reactsummit.com) - [Twitter](https://twitter.com/reactsummit) - [Facebook](https://www.facebook.com/reactamsterdam) - [Videos](https://youtube.com/c/ReactConferences)
46+
47+
### React fwdays’21 {#react-fwdays-2021}
48+
March 27, 2021 - remote event
49+
50+
[Website](https://fwdays.com/en/event/react-fwdays-2021) - [Twitter](https://twitter.com/fwdays) - [Facebook](https://www.facebook.com/events/1133828147054286) - [LinkedIn](https://www.linkedin.com/events/reactfwdays-21onlineconference6758046347334582273) - [Meetup](https://www.meetup.com/ru-RU/Fwdays/events/275764431/)
51+
4252
### React Next 2020 {#react-next-2020}
4353
December 1-2, 2020 - remote event
4454

content/docs/addons-test-utils.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ var ReactTestUtils = require('react-dom/test-utils'); // ES5 с npm
1919

2020
> Примечание:
2121
>
22-
> Мы рекомендуем использовать библиотеку [React Testing Library](https://testing-library.com/react), которая значительно облегчает написание тестов, имитируя поведение пользователей вашего приложения в браузере, и просто побуждает к хорошим практикам в тестировании.
22+
> Мы рекомендуем использовать инструмент [React Testing Library](https://testing-library.com/react), который значительно облегчает написание тестов, имитируя поведение пользователей вашего приложения в браузере, и просто побуждает к хорошим практикам в тестировании.
2323
>
24-
> В качестве альтернативы, Airbnb выпустил утилиту тестирования [Enzyme](https://airbnb.io/enzyme/), которая легко позволяет делать проверки, управлять, а также просматривать выходные данные React-компонентов.
24+
> В случае использования React <= 16, попробуйте воспользоваться библиотекой [Enzyme](https://airbnb.io/enzyme/), которая позволяет легко проверять, управлять, а также просматривать вывод React-компонентов.
2525
2626
- [`act()`](#act)
2727
- [`mockComponent()`](#mockcomponent)

content/docs/concurrent-mode-adoption.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,11 @@ next: concurrent-mode-reference.html
1717

1818
>Внимание:
1919
>
20-
>На странице описаны **экспериментальные функции, которых еще нет в стабильной версии**. Не используйте экспериментальные сборки React в продакшен-приложениях. Эти функции могут значительно измениться без предупреждения перед тем, как попасть в React.
20+
>Эта страница посвящена **экспериментальным возможностям, которых еще нет в стабильной версии**. Информация предназначена для ранних пользователей и просто интересующихся.
2121
>
22-
>Эта документация предназначена для ранних пользователей и интересующихся. Если вы новичок в React, не беспокойтесь об этих возможностях -- вам не нужно изучать их прямо сейчас.
23-
24-
>Предупреждение:
22+
>Большая часть информации на данной странице уже не актуальна и оставлена для истории. **Актуальная информация приведена в посте блога [React 18 Alpha announcement](/blog/2021/06/08/the-plan-for-react-18.html).**
2523
>
26-
>"Блокирующий режим" и метод `createBlockingRoot` были объявлены устаревшими, их не стоит использовать.
24+
>Перед выходом React 18 информация на этой странице будет обновлена.
2725
2826
</div>
2927

content/docs/concurrent-mode-intro.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,11 @@ next: concurrent-mode-suspense.html
1616

1717
>Внимание:
1818
>
19-
>На странице описаны **экспериментальные функции, которых еще нет в стабильной версии**. Не используйте экспериментальные сборки React в продакшен-приложениях. Эти функции могут значительно измениться без предупреждения перед тем, как попасть в React.
19+
>Эта страница посвящена **экспериментальным возможностям, которых еще нет в стабильной версии**. Информация предназначена для ранних пользователей и просто интересующихся.
2020
>
21-
>Эта документация предназначена для ранних пользователей и интересующихся. **Если вы новичок в React, не беспокойтесь об этих возможностях** -- вам не нужно изучать их прямо сейчас.
21+
>Большая часть информации на данной странице уже не актуальна и оставлена для истории. **Актуальная информация приведена в посте блога [React 18 Alpha announcement](/blog/2021/06/08/the-plan-for-react-18.html).**
22+
>
23+
>Перед выходом React 18 информация на этой странице будет обновлена.
2224
2325
</div>
2426

content/docs/concurrent-mode-patterns.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,12 @@ next: concurrent-mode-adoption.html
1717

1818
>Caution:
1919
>
20-
>This page describes **experimental features that are [not yet available](/docs/concurrent-mode-adoption.html) in a stable release**. Don't rely on experimental builds of React in production apps. These features may change significantly and without a warning before they become a part of React.
20+
>This page was about experimental features that aren't yet available in a stable release. It was aimed at early adopters and people who are curious.
2121
>
22-
>This documentation is aimed at early adopters and people who are curious. **If you're new to React, don't worry about these features** -- you don't need to learn them right now. For example, if you're looking for a data fetching tutorial that works today, read [this article](https://www.robinwieruch.de/react-hooks-fetch-data/) instead.
22+
>Much of the information on this page is now outdated and exists only for archival purposes. **Please refer to the [React 18 Alpha announcement post](/blog/2021/06/08/the-plan-for-react-18.html
23+
) for the up-to-date information.**
24+
>
25+
>Before React 18 is released, we will replace this page with stable documentation.
2326
2427
</div>
2528

content/docs/concurrent-mode-reference.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,11 @@ prev: concurrent-mode-adoption.html
1616

1717
>Внимание:
1818
>
19-
>На странице описаны **экспериментальные функции, которых еще нет в стабильной версии**. Не используйте экспериментальные сборки React в продакшен-приложениях. Эти функции могут значительно измениться без предупреждения перед тем, как попасть в React.
19+
>Эта страница посвящена **экспериментальным возможностям, которых еще нет в стабильной версии**. Информация предназначена для ранних пользователей и просто интересующихся.
2020
>
21-
>Эта документация предназначена для ранних пользователей и интересующихся. Если вы новичок в React, не беспокойтесь об этих возможностях -- вам не нужно изучать их прямо сейчас.
21+
>Большая часть информации на данной странице уже не актуальна и оставлена для истории. **Актуальная информация приведена в посте блога [React 18 Alpha announcement](/blog/2021/06/08/the-plan-for-react-18.html).**
22+
>
23+
>Перед выходом React 18 информация на этой странице будет обновлена.
2224
2325
</div>
2426

0 commit comments

Comments
 (0)