[Suggestion]: Providing formal definition of equality of two JSX values or giving a clarity if there is no formal definition possible.
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- JavaScript
- Estrelas
- 11.8k
- Forks
- 7.9k
- Merge médio
- 1d 11h
- PRs com merge (30d)
- 11
Descrição
Summary
Formal Definition of Equality of two JSX values. If there is no formal definition possible then give practical guidelines.
Page
https://react.dev/learn/keeping-components-pure
Details
React documentation on "Keeping Components Pure" says that
React assumes that every component you write is a pure function. This means that React components you write must always return the same JSX given the same inputs.
It also mentions:
React offers a “Strict Mode” in which it calls each component’s function twice during development. By calling the component functions twice, Strict Mode helps find components that break these rules.
However, the page does not provide a formal definition of what it means for two JSX values to be "equal."
we can easily say 4 === 4 or "foo" === "foo",
But, To give a simple example, how do we define the equality of two JSX values like: "<Child {childConfig}="object1"> and <Child {childConfig}="object2">"
If object1 and object2 are deeply equal, does that imply that both JSX elements are considered equal as well? Or is equality based on referential identity of object1 and object2?
I think, This distinction is important to understand what it truly means of two JSX values being same.
If such a definition exists elsewhere in the React documentation, it would be helpful to reference it explicitly from this page to clarify expectations around JSX equality and purity.
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Direção de pesquisa
Comece pela página “Keeping Components Pure” vinculada no issue e revise sua explicação sobre entradas iguais e resultados JSX. Esclareça se a igualdade de JSX deve ser definida formalmente ou substituída por orientações práticas sobre identidade de objetos e igualdade profunda, e adicione uma referência ou explicação explícita para que os leitores saibam o que significa “o mesmo JSX”.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- javascript, react
- Domínio
- documentation
- Tipo de issue
- Documentação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Status de atividade
- Estagnada
- Clareza
- Razoavelmente clara
- Facilidade para iniciantes
- 35/100