@samitouri / QOS-React-2 / commits / b13b9975b8

Translate 10.7-update.md to Japanese

Kohei TAKATA committed Jul 24, 2015 at 17:52 UTC b13b9975b88c9524f9d3a0a2649626811e5edaca
1 file changed +101
docs/docs/10.7-update.ja-JP.md new
+101
@@ -0,0 +1,101 @@
1 +---
2 +id: update
3 +title: 不変性のヘルパ
4 +permalink: update-ja-JP.html
5 +prev: create-fragment-ja-JP.html
6 +next: pure-render-mixin-ja-JP.html
7 +---
8 +
9 +Reactは変化を含む、使用したいデータマネジメントのスタイルであればどういったものであっても使用することができます。しかし、アプリケーションの、パフォーマンスが重要な部分において不変なデータを使用できる場合は、速い `shouldComponentUpdate()` メソッドを実行して、簡単にアプリケーションのスピードを著しく速くすることができます。
10 +
11 +[Clojure](http://clojure.org/)のような、不変なデータの扱いのためにデザインされた言語よりも、JavaScriptでそれを行うことは難しいです。しかし、単純な不変性のヘルパである、 `update()` が提供されています。それは、データがどのように表されるかということを基本的には変更すること *なく* データのタイプを扱うことを簡単にします。Immutable-jsについての詳細は、Facebookの[Immutable-js](https://facebook.github.io/immutable-js/docs/#/)や[進歩したパフォーマンス](/react/docs/advanced-performance.html)をご覧ください。
12 +
13 +## 主要な考え
14 +
15 +もし変更する予定のデータが以下のようなものであれば、
16 +
17 +```js
18 +myData.x.y.z = 7;
19 +// または...
20 +myData.a.b.push(9);
21 +```
22 +
23 +以前のコピーが上書きされるので、どのデータが変更されたか判断する方法はありません。代わりに、 `myData` の新しいコピーを作成する必要があり、変更される必要がある部分のみを変更します。それから、 `myData` の古いコピーと新しいコピーを `shouldComponentUpdate()` の中で以下のように、3つのイコールを使用して比較することができます。
24 +
25 +```js
26 +var newData = deepCopy(myData);
27 +newData.x.y.z = 7;
28 +newData.a.b.push(9);
29 +```
30 +
31 +不幸なことに、ディープコピーはコストがかかり、不可能なときもあります。変更される必要があるオブジェクトをコピーすることと、変更されていないオブジェクトを再利用することによってのみ、これを代替することができます。不幸なことに、今日のJavaScriptでは、こういったことは面倒です。
32 +
33 +```js
34 +var newData = extend(myData, {
35 + x: extend(myData.x, {
36 + y: extend(myData.x.y, {z: 7}),
37 + }),
38 + a: extend(myData.a, {b: myData.a.b.concat(9)})
39 +});
40 +```
41 +
42 +動きが速い一方で( `log n` オブジェクトのシャローコピーを作成し、残りを再利用するため)、記述するのには多くのコストがかかります。全てのコードの繰り返しを見てください。それらはつまらないものではなく、多くのバグの表面を提供します。
43 +
44 +`update()` はこのようなパターンにおいて、コードを簡単に記述するための単純な糖衣構文を提供します。そのコードは以下のようになります。
45 +
46 +```js
47 +var newData = React.addons.update(myData, {
48 + x: {y: {z: {$set: 7}}},
49 + a: {b: {$push: [9]}}
50 +});
51 +```
52 +
53 +シンタックスは少し慣れが必要ですが([MongoDBのクエリ言語](http://docs.mongodb.org/manual/core/crud-introduction/#query)にインスパイアされているため)、冗長性はありません。静的に分析し、変更ができるバージョンと比べてタイプする量がすごく増えているわけではありません。
54 +
55 +`$` から始まるキーは *コマンド* と呼ばれます。それらが「変更する」データ構造は *ターゲット* と呼ばれます。
56 +
57 +## 使用できるコマンド
58 +
59 + * `{$push: array}` ターゲットに `array` の全ての要素を `push()` します。
60 + * `{$unshift: array}` ターゲットの `array` の全ての要素を `unshift()` します。
61 + * `{$splice: array of arrays}` `arrays` の全ての要素について、その要素によって提供されるパラメータのターゲットにおいて、 `splice()` を呼び出します。
62 + * `{$set: any}` ターゲットを完全に置き換えます。
63 + * `{$merge: object}` `object` のキーをターゲットとマージします。
64 + * `{$apply: function}` 現在の値を関数に渡し、返された新しい値によってそれを更新します。
65 +
66 +## 例
67 +
68 +### 単純なプッシュ
69 +
70 +```js
71 +var initialArray = [1, 2, 3];
72 +var newArray = update(initialArray, {$push: [4]}); // => [1, 2, 3, 4]
73 +```
74 +`initialArray` は `[1, 2, 3]` のままです。
75 +
76 +### ネストしたコレクション
77 +
78 +```js
79 +var collection = [1, 2, {a: [12, 17, 15]}];
80 +var newCollection = update(collection, {2: {a: {$splice: [[1, 1, 13, 14]]}}});
81 +// => [1, 2, {a: [12, 13, 14, 15]}]
82 +```
83 +
84 +これは、 `collection` のインデックスが `2` である要素にアクセスし、インデックスが `1` である要素に( `17` を削除し)`13` と `14` を挿入することで繋ぎ合わせます。
85 +
86 +### 現在の値に基づいて値を更新すること
87 +
88 +```js
89 +var obj = {a: 5, b: 3};
90 +var newObj = update(obj, {b: {$apply: function(x) {return x * 2;}}});
91 +// => {a: 5, b: 6}
92 +// 以下は上と同義ですが、ネストが深いコレクションにとっては冗長になります。
93 +var newObj2 = update(obj, {b: {$set: obj.b * 2}});
94 +```
95 +
96 +### (シャロー)マージ
97 +
98 +```js
99 +var obj = {a: 5, b: 3};
100 +var newObj = update(obj, {$merge: {b: 6, c: 7}}); // => {a: 5, b: 6, c: 7}
101 +```