Skip to content

Commit 024a14e

Browse files
authored
update ja docs (#870)
* update injector explanation NOTE: pick up from 0b4fe90 * bring from en docs * translate previous commit * use phantomjs-prebuilt * add guide for global scss loading * translate previous commit * fix translation of review comments
1 parent 3f803b0 commit 024a14e

File tree

4 files changed

+53
-3
lines changed

4 files changed

+53
-3
lines changed

Diff for: docs/ja/configurations/pre-processors.md

+34
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,40 @@ npm install sass-loader node-sass --save-dev
3737

3838
vue-loader を構成する方法の詳細については、[高度な loader の設定](./advanced.md)セクションを参照してください。
3939

40+
#### グローバル設定ファイルの読み込み
41+
42+
一般的な要求は、毎回明示的にインポートする必要なく、各コンポーネントに設定ファイルを読み込み可能であることです。例としてすべてのコンポーネントで scss 変数をグローバルに使用することです。これを成し遂げるためには:
43+
44+
``` bash
45+
npm install sass-resources-loader --save-dev
46+
```
47+
48+
のように `sass-resources-loader` をインストールし、以下の webpack のルールを追加します:
49+
50+
``` js
51+
{
52+
loader: 'sass-resources-loader',
53+
options: {
54+
resources: path.resolve(__dirname, '../src/style/_variables.scss')
55+
}
56+
}
57+
```
58+
59+
例として、[vuejs-templates/webpack](https://github.com/vuejs-templates/webpack) を使用している場合、 `build/util.js` を以下のように変更してください:
60+
61+
``` js
62+
scss: generateLoaders('sass').concat(
63+
{
64+
loader: 'sass-resources-loader',
65+
options: {
66+
resources: path.resolve(__dirname, '../src/style/_variables.scss')
67+
}
68+
}
69+
),
70+
```
71+
72+
最終的にコンパイルされたファイルに CSS が重複しないように、変数、ミックスインなどのみをこのファイルに含めることをお勧めします。
73+
4074
### JavaScript
4175

4276
全ての Vue コンポーネントの JavaScript はデフォルトで `babel-loader` によって処理されます。しかしもちろんそれは変更することが可能です:

Diff for: docs/ja/features/scoped-css.md

+16
Original file line numberDiff line numberDiff line change
@@ -49,3 +49,19 @@
4949
4. **スコープされたスタイルは class の必要性を排除しません**。ブラウザが様々な CSS セレクタをレンダリングするため、`p { color: red }` はスコープされているとき何倍も遅くなります(すなわち属性セレクタと組み合わせた場合)。もし `.example { color: red }` のように class か id を使用するなら、パフォーマンスヒットは事実上なくなります。[この例](http://stevesouders.com/efws/css-selectors/csscreate.php)で違いをテストすることが出来ます。
5050

5151
5. **再帰されたコンポーネントの子孫セレクタには気をつけてください!** セレクタ `.a .b` を持つ CSS ルールの場合、`.a` にマッチする要素に再帰的な子コンポーネントが含まれている場合、その子コンポーネントのすべての `.b` はルールにマッチします。
52+
53+
6. `scoped` スタイルで入れ子のセレクタが必要なら、CSS に対して `>>>` オペレータを、そして `scss` に対しては `/deep/` を使用する必要があります:
54+
55+
``` html
56+
<style scoped>
57+
.a >>> .b {
58+
59+
}
60+
</style>
61+
62+
<style lang="scss" scoped>
63+
.a /deep/ .b {
64+
65+
}
66+
</style>
67+
```

Diff for: docs/ja/workflow/testing-with-mocks.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,13 @@ npm install inject-loader@^2.0.0 --save-dev
3636

3737
``` js
3838
// example.spec.js
39-
const ExampleInjector = require('!!vue?inject!./example.vue')
39+
const ExampleInjector = require('!!vue-loader?inject!./example.vue')
4040
```
4141

4242
注意。狂気じみた文字列を必要とします - ここではいくつかのインライン [webpack loader](https://webpack.github.io/docs/loaders.html) を使用しています。簡単な説明としては:
4343

4444
- `!!`は "グローバル設定からすべてのローダを無効にする"ことを意味します;
45-
- `vue?inject!`"`vue` loader を使い、`?inject` クエリを渡す"ことを意味します。 これは `vue-loader` に、依存性注入モードでコンポーネントをコンパイルするように指示します。
45+
- `vue-loader?inject!``vue-loader` を使い、`?inject` クエリを渡す"ことを意味します。 これは `vue-loader` に、依存性注入モードでコンポーネントをコンパイルするように指示します。
4646

4747
返される `ExampleInjector` は、`example.vue` モジュールのインスタンスを生成するために呼び出すことができるファクトリ関数です:
4848

Diff for: docs/ja/workflow/testing.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Karma はブラウザを起動してテストを実行するテストランナ
1010
npm install\
1111
karma karma-webpack\
1212
karma-jasmine jasmine-core\
13-
karma-phantomjs-launcher phantomjs\
13+
karma-phantomjs-launcher phantomjs--prebuilt\
1414
--save-dev
1515
```
1616

0 commit comments

Comments
 (0)