emberjs/ember.js

Documentation for special values of key in each template helper

Open

#16,719 创建于 2018年6月6日

在 GitHub 查看
 (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
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
2
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
under 1 hour
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
needs maintainer response
清晰度议题是否清楚说明期望改动、验收标准和下一步。
mostly clear
前置要求
familiarity with Ember.js template helpers
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
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.