[Docs] Add Example For React.Children.map
還沒有人認領這個 Issue。
- 主要語言
- JavaScript
- 星號
- 11.8k
- 分支
- 7.9k
- 平均合併
- 1 天 11 小時
- 30 天內合併 PR
- 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.
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
從 issue 中連結的文件頁面之 React.Children.map 區段開始,檢視現有的 API 說明與範例。新增一個以要求的向 child 注入 prop 情境為基礎的清楚 React 使用範例,並以能說明 callback 引數的文字撰寫;當頁面示範如何使用 React.Children.map 且不再產生目前的困惑時,即可完成。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- javascript, react
- 領域
- documentation
- Issue 類型
- 文件
- 難度
- 2/5
- 預估耗時
- 1-3 小時
- 活躍度
- 停滯
- 描述清晰度
- 基本清楚
- 新手友好度
- 55/100