From 23d97375b4cab4baa938f85039b802f9be3acc64 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 20:54:52 +0900 Subject: [PATCH 1/8] feat: added created hook to directives (vuejs/docs-next@c9b8954) --- src/api/application-api.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/api/application-api.md b/src/api/application-api.md index 6c26b068..5a72a6c1 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -88,6 +88,8 @@ const app = createApp({}) // 登録 app.directive('my-directive', { // ディレクティブはライフサイクルのセットをもちます: + // バインドされた要素の属性やイベントリスナが適用される前に呼び出されます。 + created() {}, // バインドされた要素の親コンポーネントがマウントされる前に呼び出されます。 beforeMount() {}, // バインドされた要素の親コンポーネントがマウントされた後に呼び出されます。 From 8ca395b5af7380cf9023c0022a15907a81dfa269 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 20:58:11 +0900 Subject: [PATCH 2/8] fix(api): remove arguments of unmount api (vuejs/docs-next@5192278) --- src/api/application-api.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/src/api/application-api.md b/src/api/application-api.md index 5a72a6c1..918c9888 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -261,13 +261,9 @@ app.provide('user', 'administrator') ## unmount -- **引数:** - - - `{Element | string} rootContainer` - - **使用方法:** - 与えられた引数に合致した DOM 要素のアプリケーションインスタンスのルート要素をアンマウントします。 + アプリケーションインスタンスのルートコンポーネントをアンマウントします。 - **例:** @@ -285,7 +281,7 @@ const app = createApp({}) app.mount('#my-app') // アプリケーションは5秒後にアンマウントされます -setTimeout(() => app.unmount('#my-app'), 5000) +setTimeout(() => app.unmount(), 5000) ``` ## use From 077931b697c774dfd64297db34c02c93e4c8a978 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 20:59:16 +0900 Subject: [PATCH 3/8] feat: added an example to use api (vuejs/docs-next@b740951) --- src/api/application-api.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/src/api/application-api.md b/src/api/application-api.md index 918c9888..05470e15 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -303,4 +303,17 @@ setTimeout(() => app.unmount(), 5000) 同じプラグインに対してこのメソッドが複数回呼び出された場合、プラグインは一度だけインストールされます。 +- **Example:** + +```js +import { createApp } from 'vue' +import MyPlugin from './plugins/MyPlugin' + +const app = createApp({}) +const i18nStrings = { + +app.use(MyPlugin) +app.mount('#app') +``` + - **参照:** [Plugins](../guide/plugins.html) From 81a076c3a53528b4664e8608a1281b8815eeea04 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 21:00:20 +0900 Subject: [PATCH 4/8] fix: fixed an indentation (vuejs/docs-next@9dc86cc) --- src/api/application-api.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/api/application-api.md b/src/api/application-api.md index 05470e15..a75414a3 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -305,15 +305,15 @@ setTimeout(() => app.unmount(), 5000) - **Example:** -```js -import { createApp } from 'vue' -import MyPlugin from './plugins/MyPlugin' + ```js + import { createApp } from 'vue' + import MyPlugin from './plugins/MyPlugin' -const app = createApp({}) -const i18nStrings = { + const app = createApp({}) + const i18nStrings = { -app.use(MyPlugin) -app.mount('#app') -``` + app.use(MyPlugin) + app.mount('#app') + ``` - **参照:** [Plugins](../guide/plugins.html) From 1362dd76b44148674237ef31b91778da123c9f8e Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 21:01:07 +0900 Subject: [PATCH 5/8] fix: fixed use API example (vuejs/docs-next@9eca838) --- src/api/application-api.md | 1 - 1 file changed, 1 deletion(-) diff --git a/src/api/application-api.md b/src/api/application-api.md index a75414a3..65a1e5f2 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -310,7 +310,6 @@ setTimeout(() => app.unmount(), 5000) import MyPlugin from './plugins/MyPlugin' const app = createApp({}) - const i18nStrings = { app.use(MyPlugin) app.mount('#app') From 1710366a0069d5d228994ab6143071b9e74b74b4 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 21:06:48 +0900 Subject: [PATCH 6/8] Mention application mounting changes in migration guide and API (vuejs/docs-next@3147cc5) --- src/api/application-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/api/application-api.md b/src/api/application-api.md index 65a1e5f2..456c5827 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -191,7 +191,7 @@ el にて受け取った実際の DOM 要素の blueprint を表します。 - **使用方法:** - 渡された DOM 要素に対して、アプリケーションインスタンスのルートコンポーネントをマウントします。 + 与えられた DOM 要素の `innerHTML` は、アプリケーションのルートコンポーネントのレンダリングされたテンプレートに置き換えられます。 - **例:** From ad2eebeac9fcb9343d65cb51147bbdf4027ab33c Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 21:08:24 +0900 Subject: [PATCH 7/8] docs: add Vue.version and app.version to the API reference (vuejs/docs-next@4a437b6) --- src/api/application-api.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/src/api/application-api.md b/src/api/application-api.md index 456c5827..63ba49a8 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -316,3 +316,27 @@ setTimeout(() => app.unmount(), 5000) ``` - **参照:** [Plugins](../guide/plugins.html) + +## version + +- **Usage:** + + Provides the installed version of Vue as a string. This is especially useful for community [plugins](/guide/plugins.html), where you might use different strategies for different versions. + +- **Example:** + + ```js + export default { + install(app) { + const version = Number(app.version.split('.')[0]) + + if (version < 3) { + console.warn('This plugin requires Vue 3') + } + + // ... + } + } + ``` + +- **See also**: [Global API - version](/api/global-api.html#version) From d9a7d0efe7d054cb67666a45bec06077cfe16178 Mon Sep 17 00:00:00 2001 From: Naoki Endoh Date: Mon, 31 May 2021 21:15:59 +0900 Subject: [PATCH 8/8] docs: translate api reference > application api --- src/api/application-api.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/api/application-api.md b/src/api/application-api.md index 63ba49a8..ac6a5064 100644 --- a/src/api/application-api.md +++ b/src/api/application-api.md @@ -303,7 +303,7 @@ setTimeout(() => app.unmount(), 5000) 同じプラグインに対してこのメソッドが複数回呼び出された場合、プラグインは一度だけインストールされます。 -- **Example:** +- **例:** ```js import { createApp } from 'vue' @@ -319,11 +319,11 @@ setTimeout(() => app.unmount(), 5000) ## version -- **Usage:** +- **使用方法:** - Provides the installed version of Vue as a string. This is especially useful for community [plugins](/guide/plugins.html), where you might use different strategies for different versions. + インストールされている Vue のバージョンを文字列で提供します。これはバージョンごとに異なる戦略を使う可能性のあるコミュニティの [プラグイン](/guide/plugins.html) の場合に便利です。 -- **Example:** +- **例:** ```js export default { @@ -339,4 +339,4 @@ setTimeout(() => app.unmount(), 5000) } ``` -- **See also**: [Global API - version](/api/global-api.html#version) +- **参照**: [Global API - version](/api/global-api.html#version)