Comments (3)
I think the diagram is fine, adding
false
would clutter it and confuse it with too many details. But maybe we could clarify howfalse
is taking up one of the positions. I think if you read deeply and compare the code from the previous example, you can deduce it though.@gaearon is it worth adding a note that explains that
false
takes up one of the positions/slots, and false isn't rendered? Or did you intentionally omit that?
because without the false
, it is conceptually incorrect. My past coworkers tend to have flaky understanding of React. Ask them why and they say, "do this and this will happen", and you ask them the reasoning behind it, they can't say it, or reply with "it is what it is".
If there is an easy way to present things as close as the truth, I think we should do it. Presenting approximation or inaccurate information only deepen tech debt. Person A cannot understand it so well, and then discusses with Person B, and things get more and more vague and inaccurate.
Even the line down below in Option 2: "You might have seen keys when rendering lists. Keys aren’t just for lists!
Explaining thing with exclamation point was never the method in the past or in formal text. It is more proper as "React has a special rule that, the position of the component in the tree, together with the key
, determines whether it is a component that should have its states reset". It was explained as such further down, but explaining things with exclamation point does not seem like a good start.
from reactjs.org.
I think the diagram is fine, adding false
would clutter it and confuse it with too many details. But maybe we could clarify how false
is taking up one of the positions. I think if you read deeply and compare the code from the previous example, you can deduce it though.
@gaearon is it worth adding a note that explains that false
takes up one of the positions/slots, and false isn't rendered? Or did you intentionally omit that?
from reactjs.org.
Related: #6288
from reactjs.org.
Related Issues (20)
- [Suggestion]: Add a search page (not just a modal) HOT 1
- [Mistake]: One of the examples in the docs is performing side effect in render? HOT 2
- [Bug]: Can not access the react.dev website HOT 11
- [Bug]: Issue with Sandpacks HOT 7
- Add language switcher to the design in react.dev HOT 1
- [Suggestion]: Add example for retry with the `use` hook and an error boundary
- [Suggestion]: How to use local language search on a translation website
- [Suggestion]: Clarification on react.cache Usage in Server Requests
- [Typo]: Possible incorrect info HOT 1
- [Suggestion]: Add a new page for how to communicate between components. HOT 4
- [Suggestion]: "falsy" values not in the new documentation HOT 2
- [Bug]: sidepanel is blocking main content HOT 3
- [Suggestion]: Change the error message "Objects are not valid as a React child (found: object with keys {aaa, bbb}). If you meant to render a collection of children, use an array instead.
- [Mistake]: getVisibleTodos() does not re-run (and does not print any logs) when you type into the input to begin with! HOT 2
- 中文文档已经ui变形了 HOT 1
- Class domain layer HOT 5
- Renren_kim86
- te.react.dev Maintainer's Issue HOT 3
- [Bug]: Search functionality not working correctly on react.dev in Safari on iOS real device (iPhone 12 Pro) HOT 4
- [Bug]: Search functionality not working correctly on react.dev in Safari on iOS real device (iPhone 12 Pro) HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from reactjs.org.