Merge branch 'lang-ja' into feature/apply-new-textlint-preset

* lang-ja:
  API Reference > Application API の翻訳を追従 (#371)
  API Reference > Application Config の翻訳を追従 (#367)

Author: naokie

src/api/application-api.md

@@ -88,6 +88,8 @@ const app = createApp({})
 // 登録
 app.directive('my-directive', {
   // ディレクティブはライフサイクルのセットをもちます:
+  // バインドされた要素の属性やイベントリスナが適用される前に呼び出されます。
+  created() {},
   // バインドされた要素の親コンポーネントがマウントされる前に呼び出されます。
   beforeMount() {},
   // バインドされた要素の親コンポーネントがマウントされた後に呼び出されます。
@@ -189,7 +191,7 @@ el にて受け取った実際の DOM 要素の blueprint を表します。
 
 - **使用方法:**
 
-  渡された DOM 要素に対して、アプリケーションインスタンスのルートコンポーネントをマウントします。
+  与えられた DOM 要素の `innerHTML` は、アプリケーションのルートコンポーネントのレンダリングされたテンプレートに置き換えられます。
 
 - **例:**
 
@@ -259,13 +261,9 @@ app.provide('user', 'administrator')
 
 ## unmount
 
-- **引数:**
-
-  - `{Element | string} rootContainer`
-
 - **使用方法:**
 
-  与えられた引数に合致した DOM 要素のアプリケーションインスタンスのルート要素をアンマウントします。
+  アプリケーションインスタンスのルートコンポーネントをアンマウントします。
 
 - **例:**
 
@@ -283,7 +281,7 @@ const app = createApp({})
 app.mount('#my-app')
 
 // アプリケーションは5秒後にアンマウントされます
-setTimeout(() => app.unmount('#my-app'), 5000)
+setTimeout(() => app.unmount(), 5000)
 ```
 
 ## use
@@ -305,4 +303,40 @@ setTimeout(() => app.unmount('#my-app'), 5000)
 
   同じプラグインに対してこのメソッドが複数回呼び出された場合、プラグインは一度だけインストールされます。
 
+- **例:**
+
+  ```js
+  import { createApp } from 'vue'
+  import MyPlugin from './plugins/MyPlugin'
+
+  const app = createApp({})
+
+  app.use(MyPlugin)
+  app.mount('#app')
+  ```
+
 - **参照:** [Plugins](../guide/plugins.html)
+
+## version
+
+- **使用方法:**
+
+  インストールされている Vue のバージョンを文字列で提供します。これはバージョンごとに異なる戦略を使う可能性のあるコミュニティの [プラグイン](/guide/plugins.html) の場合に便利です。
+
+- **例:**
+
+  ```js
+  export default {
+    install(app) {
+      const version = Number(app.version.split('.')[0])
+
+      if (version < 3) {
+        console.warn('This plugin requires Vue 3')
+      }
+
+      // ...
+    }
+  }
+  ```
+
+- **参照**: [Global API - version](/api/global-api.html#version)

src/api/application-config.md

@@ -1,26 +1,14 @@
 # アプリケーション構成
 
-`config` は、 Vue アプリケーションのグローバル設定を含むオブジェクトです。アプリケーションをマウントする前に、以下のプロパティを変更できます:
+すべての Vue アプリケーションは、そのアプリケーションの構成設定を含む `config` オブジェクトを公開します:
 
 ```js
-const app = Vue.createApp({})
+const app = createApp({})
 
-app.config = {...}
+console.log(app.config)
 ```
 
-## devtools
-
-- **型:** `boolean`
-
-- **デフォルト:** `true` (プロダクションビルドでは `false`)
-
-- **使用方法:**
-
-```js
-app.config.devtools = true
-```
-
-[vue-devtools](https://github.com/vuejs/vue-devtools) による検査を許可するかどうかを設定します。このオプションのデフォルト値は、development ビルドでは `true` に、プロダクションビルドでは `false` となります。true にすることで、プロダクションビルドで検査を有効にできます。
+アプリケーションをマウントする前に、以下に列挙したプロパティを変更することができます。
 
 ## errorHandler
 
@@ -78,14 +66,14 @@ app.component('child-component', {
 
 アプリケーション内のあらゆるコンポーネントのインスタンスからアクセスできるグローバルなプロパティを追加します。名称が競合した場合、コンポーネントのプロパティが優先されます。
 
-これは、 Vue 2.x における Vue.prototype` 拡張を置き換えることができます:
+これは、 Vue 2.x における `Vue.prototype` 拡張を置き換えることができます:
 
 ```js
 // Before
 Vue.prototype.$http = () => {}
 
 // After
-const app = Vue.createApp({})
+const app = createApp({})
 app.config.globalProperties.$http = () => {}
 ```
 
@@ -106,6 +94,10 @@ Vue の外部にて定義された(Web Components API を利用した場合な
 
 > この関数では、全てのネイティブの HTML ならびに SVG のタグをマッチさせる必要はありません。Vue のパーサが自動的にこのチェックを行います。
 
+::: tip Important
+この設定オプションは、ランタイムコンパイラを使うときにのみ尊重されます。ランタイム限定ビルドを使う場合、 `isCustomElement` は代わりにビルドの設定で `@vue/compiler-dom` に渡す必要があります。例えば、 [vue-loader の `compilerOptions` オプション](https://vue-loader.vuejs.org/options.html#compileroptions) を経由して渡します。
+:::
+
 ## optionMergeStrategies
 
 - **型:** `{ [key: string]: Function }`
@@ -115,7 +107,7 @@ Vue の外部にて定義された(Web Components API を利用した場合な
 - **使用方法:**
 
 ```js
-const app = Vue.createApp({
+const app = createApp({
   mounted() {
     console.log(this.$options.hello)
   }
@@ -134,9 +126,9 @@ app.mixin({
 
 カスタムオプションのマージ戦略を定義します。
 
-マージ戦略は、親インスタンスと子インスタンスで定義されたオプションの値をそれぞれ第一引数と第二引数として受け取ります。アプリケーションコンテキストのインスタンスは、第三引数として渡されます。
+マージ戦略は、親インスタンスと子インスタンスで定義されたオプションの値をそれぞれ第 1 引数と第 2 引数として受け取ります。アプリケーションコンテキストのインスタンスは、第 3 引数として渡されます。
 
-- **こちらも:** [Custom Option Merging Strategies](../guide/mixins.html#custom-option-merge-strategies)
+- **参照:** [Custom Option Merging Strategies](../guide/mixins.html#custom-option-merge-strategies)
 
 ## performance