Angular orderBy文档是错误的吗？还是我困惑？

Question

阅读Angular's orderBy documentation后，我有点困惑：

  

在HTML模板绑定中：

  {{ orderBy_expression | orderBy : array : expression : reverse}}`

这显示orderBy正在使用3个附加参数（反向列为可选项），但我找不到任何超过2的示例，以及 时2，它似乎采用{{ orderBy_expression | orderBy : expression : reverse}}形式（省略array）

array被定义为“要排序的数组。”但是这会使orderBy_expression做什么？那不应该是过滤器所依赖的数组吗？

我实际上要去Improve this doc并修改它（我假设是一个文档错误），但我一点都不清楚生成模板绑定示例到底是什么（文档是用类似JavaDoc的注释就在.js）

中

所以，希望这是一个有效的SO问题：

文档实际上是不正确的？或者我感到困惑

Answer 1

过滤器有两种使用模式。以编程方式，作为一个函数，在这种情况下，第一个参数是要对其进行操作并与|内联的数组左侧的数组是要作用的数组。因此，虽然可能不会立即清楚发生了什么，但文档并非不正确。不是说它不应该被清理干净。如果他们展示两种模式并清楚地解释它肯定会更好。但我仍然坚持认为它是“正确的”。而且，正如Mikke指出的那样，目前的解释方式是通过文档保持一致的。