reactjs / reactjs/react.dev

[Docs] Add Example For React.Children.map

オープン
#2,027 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
JavaScript
スター
11.8k
フォーク
7.9k
平均マージ
1日 11時間
マージ済み PR(30日)
11

説明

For https://reactjs.org/docs/react-api.html#reactchildrenmap to help illustrate as to what it does, can we kindly add an example for something like this.

const Value = ({ value }) => <p>{value}</p>

const PropsInjector = ({ children }) => React.Children.map(children, child => {
  return React.cloneElement(child, { value: 'some_value'  });
});

const App = () => (
   <PropsInjector>
        <Value />
        <Value />
    </PropsInjector>
)

I don't know if this might be an acceptable example for React.Children.map, but I would love to hear some feedback if possible.

The current documentation doesn't have a an example on how React.Children.map can be used & it doesn't make sense for someone like me

As per docs: React.Children.map(children, function[(thisArg)])

For someone like me I got very confused function[(thisArg)] when I read this & didn't know on how I could use it.

I am more then happy to make a PR for adding this example & or any better example if someone can suggest.

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

Issue でリンクされているドキュメントページの React.Children.map セクションから始め、既存の API の説明と例を確認してください。要求されている child への prop 注入のシナリオに基づく、明確な React の使用例を追加し、callback の引数を説明する文言にしてください。ページで、現在の混乱を招くことなく React.Children.map を使用する方法が示されれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
javascript, react
領域
documentation
issue の種類
ドキュメント
難易度
2/5
見積もり時間
1〜3時間
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
55/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。