Documentation for special values of key in each template helper · emberjs/ember.js#16719

(5 留言) (0 反應) (0 負責人)JavaScript (22,437 star) (4,216 fork)batch import

DocumentationHelp Wanted

描述

Hello! I'm not sure if this is the right place for this but I wasn't sure where to ask. In the current documentation for the each template helper it talks about specifying keys but makes no mention of the special values for key, namely:

@index - The index of the item in the array. @item - The item in the array itself. This can only be used for arrays of strings or numbers. @guid - Generate a unique identifier for each object (uses Ember.guidFor).

Which I discovered in this comment

Are these special values actually still valid in 3.2? And if they are, is it alright if I write them back into the documentation?

貢獻者指南

技術棧: javascript
領域: documentation
議題類型: documentation
難度: 2
預計時間: under 1 hour
活動狀態: needs maintainer response
清晰度: mostly clear
前置要求: familiarity with Ember.js template helpers
新手友善度: 80
研究方向: The user needs to confirm the validity of special key values (@index, @item, @guid) mentioned in the forum comment (https://discuss.emberjs.com/t/new glimmer consideration each key/8128/9). The documentation should be added to the Ember.js API docs for the each helper. The issue requires a maintainer to respond and approve before proceeding. No linked PRs or files are mentioned.