Merge pull request vuejs#21 from luin/lang-zh

Jinjiang · Jinjiang · commit cebec20aecca · 2015-01-30T09:33:41.000+08:00
翻译 api/filters.md
diff --git a/source/api/filters.md b/source/api/filters.md
@@ -17,19 +17,19 @@ order: 7
 
 ### currency
 
-- this filter takes one optional argument
+- 这个 filter 接受一个可选参数
 
 *12345 => $12,345.00*
 
-You can pass an optional argument which will be used as the currency symbol (default is $).
+你可以传递一个可选参数来表示货币符号
 
 ### pluralize
 
-- this filter takes at least one argument
+- 这个 filter 接受至少一个参数
 
-Pluralizes the argument based on the filtered value. When there is exactly one arg, plural forms simply add an "s" at the end. When there are more than one argument, the arguments will be used as array of strings corresponding to the single, double, triple ... forms of the word to be pluralized. When the number to be pluralized exceeds the length of the args, it will use the last entry in the array.
+根据要处理的值来将参数转换为复数。当只有一个参数时，其复数形式就是在参数末尾加上“s”。当参数多于一个时，所有的参数将会以字符串数组的形式对应要被转换为复数的单词的“一倍”、“两倍”、“三倍”......形式。当复数的数量超过参数个数时，会使用最后一个参数。
 
-**Example:**
+**例子：**
 
 ``` html
 {&#123;count&#125;} {&#123;count | pluralize item&#125;}
@@ -42,7 +42,7 @@ Pluralizes the argument based on the filtered value. When there is exactly one a
 {&#123;date&#125;}{&#123;date | pluralize st nd rd th&#125;}
 ```
 
-Will result in:
+结果为:
 
 *1 => '1st'*  
 *2 => '2nd'*
@@ -52,20 +52,20 @@ Will result in:
 
 ### json
 
-- this filter takes one optional argument
+- 这个 filter 接受一个可选参数
 
-JSON.stringify() incoming value rather than outputting the string representation (i.e. `[object Object]`). It also takes one optional argument which is the indent level (defaults to 2):
+使用 `JSON.stringify()` 来处理值而不是直接将其字符串化（如 `[object Object]`)。这个 filter 接受一个可选参数来指定缩进级别（默认是 2）。
 
 ``` html
 <pre>{&#123;$data | json 4&#125;}</pre>
 ```
 
 ### key
 
-- this filter only works in `v-on`
-- this filter takes exactly one argument
+- 这个 filter 只工作于 `v-on`
+- 这个 filter 接收一个参数
 
-Wrap the handler so it only gets called when the keyCode matches the argument. You can also use string aliases for a few commonly-used keys:
+包裹 handler 使得其仅在 keyCode 是指定的参数时才被调用。你也可以使用几个常用键值的别名：
 
 - enter
 - tab
@@ -76,22 +76,22 @@ Wrap the handler so it only gets called when the keyCode matches the argument. Y
 - left
 - right
 
-**Example:**
+**例子：**
 
 ``` html
 <input v-on="keyup:doSomething | key enter">
 ```
 
-`doSomething` will only be called when the Enter key is pressed.
+只有按回车键（enter）时才会调用 `doSomething` 。
 
 ### filterBy
 
-**Syntax:** `filterBy searchKey [in dataKey]`.
+**语法：** `filterBy searchKey [in dataKey]`.
 
-- this filter only works in `v-repeat`
-- this is a computed filter
+- 这个 filter 只工作于 `v-repeat`
+- 这是一个 computed filter
 
-Make `v-repeat` only display a filtered version of the source Array. The `searchKey` argument is a property key on the context ViewModel. The value of that property will be used as the string to search for:
+使得 `v-repeat` 只显示数组过滤后的结果。`searchKey` 参数是当前 ViewModel 的一个属性名。这个属性的值会被用作查找的目标：
 
 ``` html
 <input v-model="searchText">
@@ -100,9 +100,9 @@ Make `v-repeat` only display a filtered version of the source Array. The `search
 </ul>
 ```
 
-When the filter is applied, it will filter the `users` Array by recursively searching for the current value of `searchText` on each item in the Array. For example, if an item is `{ name: 'Jack', phone: '555-123-4567' }` and `searchText` has value `'555'`, the item will be considered a match.
+当使用这个 filter 时，将递归遍历 `users` 数组的每一个元素来寻找 `searchText` 的当前值从而过滤该数组。举例来说，如果一个条目是 `{ name: 'Jack', phone: '555-123-4567' }`，而 `searchText` 的值是 `'555'`，这个条目就被认为是符合条件。
 
-Optionally, you can narrow down which specific property to search in with the optional `in dataKey` argument:
+可选地，你可以通过 `in dataKey` 参数来指定具体要查找哪个属性：
 
 ``` html
 <input v-model="searchText">
@@ -111,9 +111,9 @@ Optionally, you can narrow down which specific property to search in with the op
 </ul>
 ```
 
-Now the item will only match if the value of `searchText` is found in its `name` property. So `searchText` with value `'555'` will no longer match this item, but `'Jack'` will.
+现在只有当 `name` 属性包含 `searchText` 时这个条目才符合条件。所以当 `searchText` 的值是 `'555'` 时这个条目将不符合条件，而当值是 `'Jack'` 时即符合。
 
-Finally, you can use quotes to indicate literal arguments:
+最后，你可以使用引号来表示字面量参数：
 
 ``` html
 <ul>
@@ -123,12 +123,12 @@ Finally, you can use quotes to indicate literal arguments:
 
 ### orderBy
 
-**Syntax:** `orderBy sortKey [reverseKey]`.
+**语法：** `orderBy sortKey [reverseKey]`.
 
-- this filter only works in `v-repeat`
-- this is a computed filter
+- 这个 filter 只工作于 `v-repeat`
+- 这是一个 computed filter
 
-Sort `v-repeat`'s displayed result. The `sortKey` argument is a property key on the context ViewModel. The value of that property will be used as the key to sort the Array items with. The optional `reverseKey` argument is also a property key on the context ViewModel, but the value's truthiness will determine whether the result should be reversed.
+将 `v-repeat` 的结果排序。`sortKey`参数是当前 ViewModel 的一个属性名。这个属性的值表示用来排序的键名。可选的 `reverseKey` 参数也是当前 ViewModel 的一个属性名，如果这个属性值为真则数组会被倒序排列。
 
 ``` html
 <ul>
@@ -146,7 +146,7 @@ new Vue({
 })
 ```
 
-You can also use quotes for literal sort key. To indicate a literal reverse, use `-1`:
+你可以使用引号来表示字面量的排序键名。使用 `-1` 来表示字面量的 `reverse` 参数。
 
 ``` html
 <ul>
