Skip to content

fix: 用語の表記の対応 #592

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 29, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/api/basic-reactivity.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
const obj = reactive({ count: 0 })
```

リアクティブの変換は「ディープ」で、ネストされたすべてのプロパティに影響します。[ES2015 Proxy](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Proxy) ベースの実装では、返されたプロキシは元のオブジェクトとは等しく**ありません**。元のオブジェクトに依存せず、リアクティブプロキシのみで作業することをお勧めします
リアクティブの変換は「ディープ」で、ネストされたすべてのプロパティに影響します。[ES2015 Proxy](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Proxy) ベースの実装では、返されたプロキシは元のオブジェクトとは等しく**ありません**。元のオブジェクトに依存せず、リアクティブプロキシのみで作業することをおすすめします

**型:**

Expand Down
2 changes: 1 addition & 1 deletion src/api/directives.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@

このディレクティブは条件が変わったときにトランジションを引き起こします。

一緒に使ったとき、`v-if` は `v-for` よりも優先度が高くなります。これら 2 つのディレクティブを 1 つの要素で同時に使うことはお勧めしません。詳しくは [リストレンダリングのガイド](../guide/list.html#v-for-と-v-if) を参照してください。
一緒に使ったとき、`v-if` は `v-for` よりも優先度が高くなります。これら 2 つのディレクティブを 1 つの要素で同時に使うことはおすすめしません。詳しくは [リストレンダリングのガイド](../guide/list.html#v-for-と-v-if) を参照してください。

- **参照:** [条件付きレンダリング - v-if](../guide/conditional.html#v-if)

Expand Down
2 changes: 1 addition & 1 deletion src/api/instance-properties.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@

コンポーネントインスタンスが管理しているルート DOM 要素です。

[Fragments](../guide/migration/fragments) を使っているコンポーネントでは、`$el` は DOM 内で Vue がコンポーネントの位置を追跡するために使う DOM ノードのプレースホルダになります。DOM 要素に直接アクセスするためには、`$el` に頼る代わりに [テンプレート参照](../guide/component-template-refs.html) を使うことをお勧めします
[Fragments](../guide/migration/fragments) を使っているコンポーネントでは、`$el` は DOM 内で Vue がコンポーネントの位置を追跡するために使う DOM ノードのプレースホルダになります。DOM 要素に直接アクセスするためには、`$el` に頼る代わりに [テンプレート参照](../guide/component-template-refs.html) を使うことをおすすめします

## $options

Expand Down
4 changes: 2 additions & 2 deletions src/api/options-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@

- **詳細:**

コンポーネントインスタンスのデータオブジェクトを返す関数です。 `data` では、ブラウザの API オブジェクトや prototype プロパティのような独自のステートフルな振る舞いをするオブジェクトを監視することはお勧めしません。よい考え方としては、コンポーネントのデータを表すただのプレーンオブジェクトをここで持つべきです。
コンポーネントインスタンスのデータオブジェクトを返す関数です。 `data` では、ブラウザの API オブジェクトや prototype プロパティのような独自のステートフルな振る舞いをするオブジェクトを監視することはおすすめしません。よい考え方としては、コンポーネントのデータを表すただのプレーンオブジェクトをここで持つべきです。

一度監視されると、ルートのデータオブジェクトにリアクティブなプロパティを追加することはできなくなります。そのため、インスタンスを作成する前に、すべてのルートレベルのリアクティブプロパティを前もって宣言しておくことをお勧めします
一度監視されると、ルートのデータオブジェクトにリアクティブなプロパティを追加することはできなくなります。そのため、インスタンスを作成する前に、すべてのルートレベルのリアクティブプロパティを前もって宣言しておくことをおすすめします

インスタンスが作成された後に、`vm.$data` として元のデータオブジェクトアクセスできます。コンポーネントインスタンスは、データオブジェクトのすべてのプロパティをプロキシするため、`vm.a` は `vm.$data.a` と同じになります。

Expand Down
2 changes: 1 addition & 1 deletion src/api/refs-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ const foo = ref<string | number>('foo') // foo の型: Ref<string | number>
foo.value = 123 // ok!
```

ジェネリックの型が不明な場合は、`ref` を `Ref<T>` にキャストすることをお勧めします:
ジェネリックの型が不明な場合は、`ref` を `Ref<T>` にキャストすることをおすすめします:

```ts
function useState<State extends string>(initial: State) {
Expand Down
4 changes: 2 additions & 2 deletions src/cookbook/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@

このクックブックでは、一般的なユースケースや興味深いユースケースを網羅した開発者向けのサンプルを提供したり、より複雑な細かい部分を段階的にに説明していきます。私たちの目標は、単純な入門的な例を超えて、より広く適用可能な概念を示すことと、アプローチの注意点を示すことです。

貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いて issue を提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くお勧めしますが、必須ではありません。
貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いて issue を提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くおすすめしますが、必須ではありません。

レシピは一般的に:

Expand Down Expand Up @@ -65,7 +65,7 @@

### このパターンを回避するケース <Badge text="任意" />

このセクションは必須ではありませんが、書くことを強くお勧めします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixins のようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。
このセクションは必須ではありませんが、書くことを強くおすすめします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixins のようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。

### 代替パターン <Badge text="必須 回避のセクションに付随する" type="warning" />

Expand Down
2 changes: 1 addition & 1 deletion src/guide/a11y-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ export default {


:::tip Tip:
レガシーな [HTML5 のセマンティック要素をサポートしていないブラウザ](https://caniuse.com/#feat=html5semantic)との互換性を最大限に高めるために、冗長なランドマークロール属性を持つランドマーク HTML 要素を使用することをお勧めします
レガシーな [HTML5 のセマンティック要素をサポートしていないブラウザ](https://caniuse.com/#feat=html5semantic)との互換性を最大限に高めるために、冗長なランドマークロール属性を持つランドマーク HTML 要素を使用することをおすすめします
:::

[ランドマークについてもっと読む](https://www.w3.org/TR/wai-aria-1.2/#landmark_roles)
14 changes: 7 additions & 7 deletions src/guide/component-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ app.component('my-component-name', {

グローバルに登録されたコンポーネントは、アプリケーション内のどのコンポーネントのテンプレートでも使うことができます。

とりあえずコンポーネント登録についてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[コンポーネント登録](component-registration.md)の完全なガイドを読むことをお勧めします
とりあえずコンポーネント登録についてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[コンポーネント登録](component-registration.md)の完全なガイドを読むことをおすすめします

## プロパティを用いた子コンポーネントへのデータの受け渡し

Expand Down Expand Up @@ -154,7 +154,7 @@ app.mount('#blog-posts-demo')

上記では、 `v-bind` を用いて動的にプロパティを渡すことができると分かります。これはレンダリングする内容が事前に分からない場合に特に便利です。

とりあえずプロパティについてはこれで以上ですが、 このページを読み終えて十分に理解できたら、後から戻ってきて[プロパティ](component-props.html)の完全なガイドを読むことをお勧めします
とりあえずプロパティについてはこれで以上ですが、 このページを読み終えて十分に理解できたら、後から戻ってきて[プロパティ](component-props.html)の完全なガイドを読むことをおすすめします

## 子コンポーネントのイベントを購読する

Expand Down Expand Up @@ -349,7 +349,7 @@ app.component('custom-input', {
})
```

とりあえずカスタムコンポーネントイベントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[カスタムイベント](component-custom-events.md)の完全なガイドを読むことをお勧めします
とりあえずカスタムコンポーネントイベントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[カスタムイベント](component-custom-events.md)の完全なガイドを読むことをおすすめします

## スロットによるコンテンツ配信

Expand Down Expand Up @@ -380,7 +380,7 @@ app.component('alert-box', {

上で見た通り、コンテンツを配置したいところにプレースホルダとして `<slot>` を使います。それだけです。終わりです!

とりあえずスロットについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[スロット](component-slots.md)の完全なガイドを読むことをお勧めします
とりあえずスロットについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[スロット](component-slots.md)の完全なガイドを読むことをおすすめします

## 動的なコンポーネント

Expand All @@ -404,7 +404,7 @@ app.component('alert-box', {

また、 `is` 属性を使って通常の HTML 要素を作ることもできます。

とりあえず動的なコンポーネントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[動的 & 非同期コンポーネント](./component-dynamic-async.html)の完全なガイドを読むことをお勧めします
とりあえず動的なコンポーネントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[動的 & 非同期コンポーネント](./component-dynamic-async.html)の完全なガイドを読むことをおすすめします

## DOM テンプレートパース時の注意

Expand Down Expand Up @@ -463,6 +463,6 @@ app.component('blog-post', {
<blog-post post-title="hello!"></blog-post>
```

とりあえず DOM テンプレートパース時の警告についてはこれで以上です。そして実は、Vue の _本質_ の最後となります。おめでとうございます!まだまだ学ぶべきことはありますが、まずは一休みして自分で Vue を実際に使って楽しいものを作ってみることをお勧めします
とりあえず DOM テンプレートパース時の警告についてはこれで以上です。そして実は、Vue の _本質_ の最後となります。おめでとうございます!まだまだ学ぶべきことはありますが、まずは一休みして自分で Vue を実際に使って楽しいものを作ってみることをおすすめします

理解したばかりの知識に慣れてきたら、サイドバーのコンポーネントの詳細セクションの他のページと同様に、[動的 & 非同期コンポーネント](component-dynamic-async.html)の完全なガイドを読むために戻ってくることをお勧めします
理解したばかりの知識に慣れてきたら、サイドバーのコンポーネントの詳細セクションの他のページと同様に、[動的 & 非同期コンポーネント](component-dynamic-async.html)の完全なガイドを読むために戻ってくることをおすすめします
4 changes: 2 additions & 2 deletions src/guide/component-custom-events.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ this.$emit('myEvent')
<my-component @my-event="doSomething"></my-component>
```

[プロパティの形式](/guide/component-props.html#プロパティの形式-キャメルケース-vs-ケバブケース) と同じように、DOM 内テンプレートを使っている場合は、ケバブケースのイベントリスナを使うことをお勧めします。文字列テンプレートを使っている場合は、この制約は適用されません。
[プロパティの形式](/guide/component-props.html#プロパティの形式-キャメルケース-vs-ケバブケース) と同じように、DOM 内テンプレートを使っている場合は、ケバブケースのイベントリスナを使うことをおすすめします。文字列テンプレートを使っている場合は、この制約は適用されません。

## カスタムイベントの定義

Expand All @@ -31,7 +31,7 @@ app.component('custom-form', {
ネイティブイベント(例、 `click` など)が `emits` オプションで定義されている場合、ネイティブイベントリスナの **代わりに** コンポーネントのイベントが使われます。

::: tip
コンポーネントの動作を実証するために、全ての発行されたイベントを定義することをお勧めします
コンポーネントの動作を実証するために、全ての発行されたイベントを定義することをおすすめします
:::

### 発行されたイベントを検証する
Expand Down
2 changes: 1 addition & 1 deletion src/guide/component-registration.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ ES2015 以降の場合、`ComponentA` のような変数名をオブジェクト

### モジュールシステム内のローカル登録

もしまだこの記事を読んでいるということは、Webpack や Babel のようなモジュールシステムを利用している可能性が高いでしょう。このような場合は、それぞれのコンポーネントを独自のファイルに持つ `components` ディレクトリを作成することをお勧めします
もしまだこの記事を読んでいるということは、Webpack や Babel のようなモジュールシステムを利用している可能性が高いでしょう。このような場合は、それぞれのコンポーネントを独自のファイルに持つ `components` ディレクトリを作成することをおすすめします

次にローカル登録をする前に、使用するコンポーネントごとにインポートする必要があります。例えば、`ComponentB.js` もしくは `ComponentB.vue` ファイルの場合:

Expand Down
4 changes: 2 additions & 2 deletions src/guide/contributing/doc-style-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ VuePress は、アラートボックスを作成するためのカスタムコ
:::

::: danger DANGER
これはお勧めしません。自己責任で使用してください。
これはおすすめしません。自己責任で使用してください。
:::
```

Expand All @@ -46,7 +46,7 @@ VuePress は、アラートボックスを作成するためのカスタムコ
:::

::: danger DANGER
これはお勧めしません。自己責任で使用してください。
これはおすすめしません。自己責任で使用してください。
:::

## コードブロック
Expand Down
Loading