2014-04-15 20 views
3

我有點讀取Angular's orderBy documentation後困惑:是角度orderBy文檔錯誤?還是我困惑?

在HTML模板裝訂:

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

這表明orderBy被與3個附加的參數(反向被列爲可選)使用,但我找不到任何使用超過2個的示例,並且當它的 2時,它看起來是在形式{{ orderBy_expression | orderBy : expression : reverse}}(ommitting array

array被定義爲「要排序的數組」。但是什麼使得orderBy_expression?這不應該是過濾器所作用的數組嗎?

我實際上會去Improve this doc並修改這個(我認爲是一個文檔錯誤),但是我完全不清楚生成模板綁定示例的具體內容(文檔是使用JavaDoc生成的意見就在.js文件)

所以,我希望這是一個有效的SO問題:

其實是在不正確的文件?或者我有點困惑

+2

所有的過濾器都以相同的方式記錄下來,它們對我來說似乎都是錯誤的。我同意文檔看起來不正確。 – Mikke

+1

文檔中的行似乎是在這個文件中生成了741-757左右的行https://github.com/m7r/grunt-ngdocs/blob/master/src/ngdoc.js雖然我不確定這是確切的代碼角使用。 – Mikke

回答

0

過濾器有2種使用模式。以編程方式,作爲一個函數,在這種情況下,第一個參數是要對其執行操作的數組,並且內聯於|其中左側的數組是要作用的數組。因此,雖然可能不會立即清楚發生了什麼,但文檔並不正確。不要說它不應該被清理。如果他們展示兩種模式並且清楚地解釋它,那肯定會更好。但我仍然認爲它是「正確的」。正如Mikke所指出的那樣,目前的解釋方式在文檔中是一致的。

+3

http://docs.angularjs.org/api/ng/filter/filter你的回答是真實的,但文檔似乎表明'orderBy'和'filter'應該總共給出4個參數。 – Mikke

+1

docs * do *提供了兩種使用模式的示例。 *功能*方法看起來是正確的,但我仍然認爲* template *示例看起來不正確。除非你可以這樣做:'{{orderBy_expression | orderBy:array:expression:reverse}}'(用__3__附加參數傳遞':'s),我會說文檔肯定是__「不正確」__ –