Merge pull request #398 from t0yohei/add-migration-build

Author: naokie

src/.vuepress/config.js

@@ -172,6 +172,7 @@ const sidebar = {
   ],
   migration: [
     '/guide/migration/introduction',
+    '/guide/migration/migration-build',
     {
       title: '詳細',
       collapsable: false,

src/guide/migration/array-refs.md

@@ -69,4 +69,11 @@ export default {
 
 - `itemRefs` は配列である必要はありません。 反復キーで参照できるオブジェクトでも構いません。
 
-- これにより、必要に応じて `itemRefs` をリアクティブにして監視することもできます。
+- これにより、必要に応じて `itemRefs` をリアクティブにして監視することもできます。
+
+## 移行の戦略
+
+[移行ビルドのフラグ:](migration-build.html#compat-の設定)
+
+- `V_FOR_REF`
+- `COMPILER_V_FOR_REF`

src/guide/migration/async-components.md

@@ -95,3 +95,4 @@ const asyncComponent = defineAsyncComponent(
 非同期コンポーネントの使い方のさらなる情報は、以下を見てください:
 
 - [ガイド: 動的 & 非同期コンポーネント](/guide/component-dynamic-async.html#動的コンポーネントにおける-keep-alive-の利用)
+- [移行ビルドのフラグ: `COMPONENT_ASYNC`](migration-build.html#compat-の設定)

src/guide/migration/attribute-coercion.md

@@ -125,7 +125,7 @@ badges:
       <td><code>"false"</code></td>
     </tr>
     <tr>
-      <td rowspan="2">その他の非ブール属性<br><small>例えば 
+      <td rowspan="2">その他の非ブール属性<br><small>例えば
       <code>aria-checked</code>、<code>tabindex</code>、<code>alt</code>など</small></td>
       <td><code>undefined</code>, <code>null</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
@@ -138,3 +138,8 @@ badges:
     </tr>
   </tbody>
 </table>
+
+[移行ビルドのフラグ:](migration-build.html#compat-の設定)
+
+- `ATTR_FALSE_VALUE`
+- `ATTR_ENUMERATED_COERSION`

src/guide/migration/attrs-includes-class-style.md

@@ -60,6 +60,8 @@ export default {
 
 `inheritAttrs: false` を使用しているコンポーネントでは、スタイルの適用が意図したとおりに動作することを確認してください。もし以前に `class` や `style` の特別な動作に依存していた場合、これらの属性が別の要素に適用されている可能性があるため、一部の見た目が崩れている可能性があります。
 
+[移行ビルドのフラグ: `INSTANCE_ATTRS_CLASS_STYLE`](migration-build.html#compat-の設定)
+
 ## 参照
 
 - [関連する RFC](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0031-attr-fallthrough.md)

src/guide/migration/children.md

@@ -38,3 +38,7 @@ export default {
 ## 3.x の更新
 
 3.x では、 `$children` プロパティが削除され、サポートされなくなりました。代わりに、もし子コンポーネントのインスタンスにアクセスする必要がある場合は、 [$refs](/guide/component-template-refs.html#template-refs) を使用することをお勧めします。
+
+## 移行の戦略
+
+[移行ビルドのフラグ: `INSTANCE_CHILDREN`](migration-build.html#compat-の設定)

src/guide/migration/custom-directives.md

@@ -37,7 +37,6 @@ Vue.directive('highlight', {
 
 ## 3.x での構文
 
-
 ただし、Vue 3 では、カスタムディレクティブ用のよりまとまりのある API を作成しました。Vue 2 では、似たようなイベントにフックしているにもかかわらず、コンポーネントのライフサイクルメソッドとは大きく異なります。これらを次のように統合しました。
 
 - **created** - 追加されました! これは、要素の属性やイベントリスナーが適用される前に呼び出されます。
@@ -104,3 +103,7 @@ mounted(el, binding, vnode) {
 :::warning
 [fragments](/guide/migration/fragments.html#overview) のサポートにより、コンポーネントは複数のルートノードを持つ可能性があります。マルチルートコンポーネントに適用すると、カスタムディレクティブは無視され、警告がログ出力されます。
 :::
+
+## 移行の戦略
+
+[移行ビルドのフラグ: `CUSTOM_DIR`](migration-build.html#compat-の設定)

src/guide/migration/custom-elements-interop.md

@@ -96,6 +96,8 @@ Vue では、ブラウザで普遍的に利用できるようになる前のネ
     document.createElement('button', { is: 'plastic-button' })
     ```
 
+[移行ビルドのフラグ: `COMPILER_IS_ON_ELEMENT`](migration-build.html#compat-の設定)
+
 ## `v-is` は In-DOM テンプレートパースのための回避策
 
 > 注: このセクションは、Vue テンプレートがページの HTML に直接記述されている場合にのみ影響します。

src/guide/migration/data-option.md

@@ -111,6 +111,8 @@ Vue 2.x での `$data` の結果は:
 }
 ```
 
+[移行ビルドのフラグ: `OPTIONS_DATA_FN`](migration-build.html#compat-の設定)
+
 ## 移行の戦略
 
 オブジェクト宣言を利用しているユーザーには以下を推奨します:
@@ -119,3 +121,8 @@ Vue 2.x での `$data` の結果は:
 - 共有データへの参照、新しい共有オブジェクトを指すようにを書き換える
 
 ミックスインのディープマージに依存しているユーザーには、そのような依存を完全に避けるためにコードをリファクタリングすることをお勧めします。ミックスインのディープマージは非常に暗黙的であり、コードロジックの理解やデバッグがより難しくなる可能性があります。
+
+[移行ビルドのフラグ:](migration-build.html#compat-の設定)
+
+- `OPTIONS_DATA_FN`
+- `OPTIONS_DATA_MERGE`

src/guide/migration/events-api.md

@@ -79,3 +79,5 @@ export default {
 これは Vue 2 と同じような Event Emitter API を提供します。
 
 これらのメソッドは、Vue 3 の将来の互換ビルドでもサポートされる可能性があります。
+
+[移行ビルドのフラグ: `INSTANCE_EVENT_EMITTER`](migration-build.html#compat-の設定)