docs: update docs/ja (#533)

38elements · eddyerburgh · commit 498c2fdfbfba · 2018-04-26T20:40:34.000+02:00
diff --git a/docs/en/api/mount.md b/docs/en/api/mount.md
@@ -1,4 +1,4 @@
-# `mount(component {, options}])`
+# `mount(component [, options])`
 
 - **Arguments:**
 
diff --git a/docs/en/api/shallow.md b/docs/en/api/shallow.md
@@ -1,4 +1,4 @@
-# `shallow(component {, options}])`
+# `shallow(component [, options])`
 
 - **Arguments:**
 
diff --git a/docs/ja/README.md b/docs/ja/README.md
@@ -21,6 +21,7 @@
   * [マウンティングオプション](api/options.md)
     - [context](api/options.md#context)
     - [slots](api/options.md#slots)
+    - [scopedSlots](api/options.md#scopedslots)
     - [stubs](api/options.md#stubs)
     - [mocks](api/options.md#mocks)
     - [localVue](api/options.md#localvue)
@@ -51,7 +52,7 @@
     * [setProps](api/wrapper/setProps.md)
     * [text](api/wrapper/text.md)
     * [trigger](api/wrapper/trigger.md)
-    * [visible](api/wrapper/visible.md)
+    * [isVisible](api/wrapper/isVisible.md)
   * [WrapperArray](api/wrapper-array/README.md)
     * [at](api/wrapper-array/at.md)
     * [contains](api/wrapper-array/contains.md)
@@ -65,7 +66,7 @@
     * [setMethods](api/wrapper-array/setMethods.md)
     * [setProps](api/wrapper-array/setProps.md)
     * [trigger](api/wrapper-array/trigger.md)
-    * [visible](api/wrapper-array/visible.md)
+    * [isVisible](api/wrapper-array/isVisible.md)
   * [コンポーネント](api/components/README.md)
     * [TransitionStub](api/components/TransitionStub.md)
     * [TransitionGroupStub](api/components/TransitionGroupStub.md)
diff --git a/docs/ja/SUMMARY.md b/docs/ja/SUMMARY.md
@@ -19,6 +19,7 @@
   * [マウンティングオプション](api/options.md)
     - [context](api/options.md#context)
     - [slots](api/options.md#slots)
+    - [scopedSlots](api/options.md#scopedslots)
     - [stubs](api/options.md#stubs)
     - [mocks](api/options.md#mocks)
     - [localVue](api/options.md#localvue)
diff --git a/docs/ja/api/README.md b/docs/ja/api/README.md
@@ -7,6 +7,7 @@
 * [マウンティングオプション](./options.md)
   - [context](./options.md#context)
   - [slots](./options.md#slots)
+  - [scopedSlots](./options.md#scopedslots)
   - [stubs](./options.md#stubs)
   - [mocks](./options.md#mocks)
   - [localVue](./options.md#localvue)
@@ -37,7 +38,7 @@
   * [setProps](./wrapper/setProps.md)
   * [text](./wrapper/text.md)
   * [trigger](./wrapper/trigger.md)
-  * [visible](./wrapper/visible.md)
+  * [isVisible](./wrapper/isVisible.md)
 * [WrapperArray](./wrapper-array/README.md)
   * [at](./wrapper-array/at.md)
   * [contains](./wrapper-array/contains.md)
@@ -51,7 +52,7 @@
   * [setMethods](./wrapper-array/setMethods.md)
   * [setProps](./wrapper-array/setProps.md)
   * [trigger](./wrapper-array/trigger.md)
-  * [visible](./wrapper-array/visible.md)
+  * [isVisible](./wrapper-array/isVisible.md)
 * [コンポーネント](./components/README.md)
   * [TransitionStub](./components/TransitionStub.md)
   * [TransitionGroupStub](./components/TransitionGroupStub.md)
diff --git a/docs/ja/api/mount.md b/docs/ja/api/mount.md
@@ -1,4 +1,4 @@
-# mount(component {, options}])
+# mount(component [, options])
 
 - **引数:**
 
diff --git a/docs/ja/api/options.md b/docs/ja/api/options.md
@@ -6,6 +6,7 @@
 
 - [`context`](#context)
 - [`slots`](#slots)
+- [`scopedSlots`](#scopedslots)
 - [`stubs`](#stubs)
 - [`mocks`](#mocks)
 - [`localVue`](#localvue)
@@ -59,13 +60,39 @@ expect(wrapper.find('div')).toBe(true)
 
 テキストを値として `slots` に渡すことはできますが、1つ制限事項があります。  
 PhantomJS をサポートしません。  
-[Puppeteer](https://github.com/karma-runner/karma-chrome-launcher#headless-chromium-with-puppeteer)を使用してください。
+代わりに [Puppeteer](https://github.com/karma-runner/karma-chrome-launcher#headless-chromium-with-puppeteer) を使用してください。
+
+### `scopedSlots`
+
+- 型: `{ [name: string]: string }`
+
+コンポーネントにスコープ付きスロットのコンテンツのオブジェクトを渡します。key はスロット名に対応します。値はテンプレート文字列を指定します。
+
+3つ制限事項があります。
+
+* vue@2.5+ のみをサポートします。
+
+* `<template>` タグを `scopedSlots` オプションのルート要素として使用することはできません。
+
+* PhantomJS をサポートしません。  
+代わりに [Puppeteer](https://github.com/karma-runner/karma-chrome-launcher#headless-chromium-with-puppeteer) を使用してください。
+
+例:
+
+```js
+const wrapper = shallow(Component, {
+  scopedSlots: {
+    foo: '<p slot-scope="props">{{props.index}},{{props.text}}</p>'
+  }
+})
+expect(wrapper.find('#fooWrapper').html()).toBe('<div id="fooWrapper"><p>0,text1</p><p>1,text2</p><p>2,text3</p></div>')
+```
 
 ### `stubs`
 
 - type: `{ [name: string]: Component | boolean } | Array<string>`
 
-子のコンポーネントをスタブします。スタブまたはオブジェクトに対するコンポーネント名の配列になります。`stubs` が配列の場合、すべてのスタブは `<!---->` になります。
+子コンポーネントをスタブします。スタブまたはオブジェクトに対するコンポーネント名の配列になります。`stubs` が配列の場合、すべてのスタブは `<!---->` になります。
 
 例:
 
diff --git a/docs/ja/api/shallow.md b/docs/ja/api/shallow.md
@@ -1,4 +1,4 @@
-# shallow(component {, options}])
+# shallow(component [, options])
 
 - **引数:**
 
diff --git a/docs/ja/api/wrapper-array/trigger.md b/docs/ja/api/wrapper-array/trigger.md
@@ -1,11 +1,12 @@
-# trigger(eventName)
+# trigger(eventName [, options])
 
 `WrapperArray` の DOM ノードのすべての `Wrapper` でイベントを発火します。
 
 **すべての `Wrapper` は Vue インスタンスを含んでいなければならないことに注意してください。**
 
 - **引数:**
-  - `{string} eventName
+  - `{string} eventName` **必須**
+  - `{Object} options` **オプション**
 
 - **例:**
 
diff --git a/docs/ja/api/wrapper/find.md b/docs/ja/api/wrapper/find.md
@@ -17,10 +17,18 @@ import Foo from './Foo.vue'
 import Bar from './Bar.vue'
 
 const wrapper = mount(Foo)
+
 const div = wrapper.find('div')
 expect(div.is('div')).toBe(true)
+
 const bar = wrapper.find(Bar)
 expect(bar.is(Bar)).toBe(true)
+
+const barByName = wrapper.find({ name: 'bar' })
+expect(barByName.is(Bar)).toBe(true)
+
+const fooRef = wrapper.find({ ref: 'foo' })
+expect(fooRef.is(Foo)).toBe(true)
 ```
 
 - **参照:** [Wrapper](./README.md)
diff --git a/docs/ja/api/wrapper/trigger.md b/docs/ja/api/wrapper/trigger.md
@@ -1,12 +1,12 @@
-# trigger(eventName)
+# trigger(eventType [, options ])
 
 `Wrapper` DOM ノードのイベントを発火します。
 
 Triggerは `options` オブジェクト形式で行います。`options` オブジェクトのプロパティがイベントに追加されます。
 
 - **引数:**
-  - `{string} eventName`
-  - `{Object} options`
+  - `{string} eventName` **必須**
+  - `{Object} options` **オプション**
 
 - **例:**
 
diff --git a/docs/ja/guides/testing-SFCs-with-jest.md b/docs/ja/guides/testing-SFCs-with-jest.md
@@ -48,13 +48,12 @@ npm install --save-dev vue-jest
     "transform": {
       // vue-jest で *.vue ファイルを処理する
       ".*\\.(vue)$": "<rootDir>/node_modules/vue-jest"
-    },
-    "mapCoverage": true
+    }
   }
 }
 ```
 
-> **注意:** `vue-jest` は現在、カスタムブロックのサポートやスタイルのロードなど、`vue-loader` のすべての機能をサポートしていません。さらに、コード分割などのWebpack固有の機能はサポートされていません。それらを使用するには、[Mocha + webpackによる単一ファイルコンポーネントのテスト](./testing-SFCs-with-mocha-webpack.md)のガイドをお読みください。
+> **注意:** `vue-jest` は現在、カスタムブロックのサポートやスタイルのロードなど、`vue-loader` のすべての機能をサポートしていません。さらに、コード分割などのWebpack固有の機能はサポートされていません。サポートされていない機能を使用するには、 Jest の代わりに Mocha をテストランナーとして使用します。そして、 Webpack をコンポーネントをコンパイルするために使用します。やり方は [Mocha + webpackによる単一ファイルコンポーネントのテスト](./testing-SFCs-with-mocha-webpack.md)のガイドをお読みください。
 
 ## Webpack エイリアスの処理
 
@@ -158,7 +157,7 @@ Jestは、テスト対象のコードのすぐ隣に`__tests__`ディレクト
 
 Jest は複数のフォーマットでカバレッジを取ることができます。 以下はそれをするための簡単な例です。
 
-`jest` の設定 (普通は `package.json` か `jest.config.js`) に [collectCoverage](https://facebook.github.io/jest/docs/en/configuration.html#collectcoverage-boolean) オプションを加えます。それから、カバレッジを収集する対象のファイルを [collectCoverageFrom](https://facebook.github.io/jest/docs/en/configuration.html#collectcoveragefrom-array) に配列で定義します。 正確なカバレッジデータのために [mapCoverage](https://facebook.github.io/jest/docs/en/configuration.html#mapcoverage-boolean) を `true` にします。
+`jest` の設定 (普通は `package.json` か `jest.config.js`) に [collectCoverage](https://facebook.github.io/jest/docs/en/configuration.html#collectcoverage-boolean) オプションを加えます。それから、カバレッジを収集する対象のファイルを [collectCoverageFrom](https://facebook.github.io/jest/docs/en/configuration.html#collectcoveragefrom-array) に配列で定義します。
 
 ```json
 {
@@ -168,8 +167,7 @@ Jest は複数のフォーマットでカバレッジを取ることができま
     "collectCoverageFrom": [
       "**/*.{js,vue}",
       "!**/node_modules/**"
-    ],
-    "mapCoverage": true
+    ]
   }
 }
 ```
diff --git a/docs/ja/guides/using-with-vuex.md b/docs/ja/guides/using-with-vuex.md
@@ -266,7 +266,7 @@ describe('Modules.vue', () => {
 
 Vuex ストアをテストする方法が2つあります。1つ目はゲッタとミューテーションとアクションを別々に単体テストする方法です。2つ目はストアを生成してそれをテストする方法です。
 
-Vuex ストアをテストする方法を説明するためにシンプルなカウンターストアを用意します。このストアには `increment` ミューテーションと `counter` ゲッタがあります。
+Vuex ストアをテストする方法を説明するためにシンプルなカウンターストアを用意します。このストアには `increment` ミューテーションと `evenOrOdd` ゲッタがあります。
 
 ```js
 // mutations.js
@@ -322,7 +322,7 @@ test('evenOrOdd returns even if state.count is even', () => {
   expect(getters.evenOrOdd(state)).toBe('even')
 })
 
-test('evenOrOdd returns odd if state.count is even', () => {
+test('evenOrOdd returns odd if state.count is odd', () => {
   const state = {
     count: 1
   }

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-# `mount(component {, options}])`
	`1`	+# `mount(component [, options])`
`2`	`2`
`3`	`3`	`- Arguments:`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-# `shallow(component {, options}])`
	`1`	+# `shallow(component [, options])`
`2`	`2`
`3`	`3`	`- Arguments:`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# mount(component {, options}])`
	`1`	`+# mount(component [, options])`
`2`	`2`
`3`	`3`	`- 引数:`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# shallow(component {, options}])`
	`1`	`+# shallow(component [, options])`
`2`	`2`
`3`	`3`	`- 引数:`
`4`	`4`