@samitouri / QOS-React-2 / commits / 574b906f9b

Translate 2 docs into Japanese

clariroid committed Mar 24, 2015 at 01:42 UTC 574b906f9b43a78fbd4759a25e95b2fd036c749c
2 files changed +817
docs/docs/getting-started.jp.md new
+116
@@ -0,0 +1,116 @@
1 +---
2 +id: getting-started-ja
3 +title: 始めてみましょう
4 +next: tutorial-ja.html
5 +redirect_from: "docs/index-ja.html"
6 +---
7 +
8 +## JSFiddle
9 +
10 +React でのハッキングを始めるにあたり、一番簡単なものとして次の JSFiddle で動いている Hello World の例を取り上げます。
11 +
12 + * **[React JSFiddle](http://jsfiddle.net/reactjs/69z2wepo/)**
13 + * [React JSFiddle without JSX](http://jsfiddle.net/reactjs/5vjqabv3/)
14 +
15 +## スターターキット
16 +
17 +始めるためにスターターキットをダウンロードしましょう。
18 +
19 +<div class="buttons-unit downloads">
20 + <a href="/react/downloads/react-{{site.react_version}}.zip" class="button">
21 + Download Starter Kit {{site.react_version}}
22 + </a>
23 +</div>
24 +
25 +スターターキットのルートディレクトリに `helloworld.html` を作り、次のように書いてみましょう。
26 +```html
27 +<!DOCTYPE html>
28 +<html>
29 + <head>
30 + <script src="build/react.js"></script>
31 + <script src="build/JSXTransformer.js"></script>
32 + </head>
33 + <body>
34 + <div id="example"></div>
35 + <script type="text/jsx">
36 + React.render(
37 + <h1>Hello, world!</h1>,
38 + document.getElementById('example')
39 + );
40 + </script>
41 + </body>
42 +</html>
43 +```
44 +
45 +JavaScript の中に書かれた XML シンタックスは JSX と呼ばれるものです（JSX の詳しいことについては [JSX syntax](/react/docs/jsx-in-depth.html) を読んでください）。ここでは JSX から vanilla JavaScript への変換をブラウザ内で行わせるため、先程のコードには `<script type="text/jsx">` と書いており、加えて `JSXTransformer.js` を読み込ませています。
46 +
47 +### ファイルの分割
48 +
49 +React の JSX コードは別ファイルに分離することができます。 次のような `src/helloworld.js` を作ってみましょう。
50 +
51 +```javascript
52 +React.render(
53 + <h1>Hello, world!</h1>,
54 + document.getElementById('example')
55 +);
56 +```
57 +
58 +それが終わったら、`helloworld.js` への参照を `helloworld.html` に書き込みましょう。
59 +
60 +```html{10}
61 +<script type="text/jsx" src="src/helloworld.js"></script>
62 +```
63 +
64 +### オフラインでの変換
65 +
66 +まずはコマンドラインツールをインストールしましょう（[npm](http://npmjs.org/) が必要です）。
67 +
68 +```
69 +npm install -g react-tools
70 +```
71 +
72 +インストールが終わったら、先程書いた `src/helloworld.js` ファイルを生の JavaScript に変換してみましょう。
73 +
74 +```
75 +jsx --watch src/ build/
76 +
77 +```
78 +
79 +すると、`src/helloword.js` に変更を加えるごとに `build/helloworld.js` が自動で生成されるようになります。
80 +
81 +```javascript{2}
82 +React.render(
83 + React.createElement('h1', null, 'Hello, world!'),
84 + document.getElementById('example')
85 +);
86 +```
87 +
88 +
89 +最後に HTML ファイルを以下のように書き換えましょう。
90 +
91 +```html{6,10}
92 +<!DOCTYPE html>
93 +<html>
94 + <head>
95 + <title>Hello React!</title>
96 + <script src="build/react.js"></script>
97 + <!-- JSXTransformer は必要ありません！ -->
98 + </head>
99 + <body>
100 + <div id="example"></div>
101 + <script src="build/helloworld.js"></script>
102 + </body>
103 +</html>
104 +```
105 +
106 +## CommonJS を使うには
107 +
108 +React を [browserify](http://browserify.org/) や [webpack](http://webpack.github.io/)、または CommonJS 準拠の他のモジュールシステムと一緒に使いたい場合、 [`react` npm package](https://www.npmjs.org/package/react) を使ってみてください。また、`jsx` ビルドツールをパッケージングシステム（CommonJS に限らず）に導入することも非常に簡単です。
109 +
110 +## 次にすること
111 +
112 +[チュートリアル](/react/docs/tutorial.html) や、スターターキットの `examples` ディレクトリに入っている他の例を読んでみてください。
113 +
114 +また、[ワークフロー、UIコンポーネント、ルーティング、データマネジメントなど](https://github.com/facebook/react/wiki/Complementary-Tools)の方面で貢献しているコミュニティの wiki もあります。
115 +
116 +幸運を祈ります！React へようこそ！
docs/docs/tutorial.jp.md new
+701
@@ -0,0 +1,701 @@
1 +---
2 +id: tutorial
3 +title: チュートリアル
4 +prev: getting-started-ja.html
5 +next: thinking-in-react-ja.html
6 +---
7 +
8 +これから、シンプルながらも現実的なコメントボックスを作ってみましょう。ブログにも設置できるようなもので、Disqus や LiveFyre、Facebook comments が採用しているリアルタイムコメントの基本機能を備えたものを想定しています。
9 +
10 +その機能とは次のようなものです。
11 +
12 +* コメント全件の表示欄
13 +* コメントの送信フォーム
14 +* 自作のバックエンドとの連携機能
15 +
16 +ついでに小洒落た機能もいくつか加えましょう。
17 +
18 +* **コメントの先読み:** 送信したコメントをサーバに保存される前に表示させることで、アプリ動作の体感速度をアップさせます。
19 +* **自動更新:** 他のユーザのコメントをリアルタイムで表示させます。
20 +* **Markdown 記法:** ユーザが Markdown 記法でコメントを書けるようにします。
21 +
22 +### 全部飛ばしてソースを見たいんだけど？
23 +
24 +[全部 GitHub にあります。](https://github.com/reactjs/react-tutorial)
25 +
26 +### サーバを動かす
27 +
28 +このチュートリアルを始めるにあたっては必要ないですが、後半ではサーバに POST を投げる機能を追加します。サーバのことは良く知っていて自分でサーバを建てたいのであれば、それでも構いません。そうではないけれども、サーバサイドは考えずに React のことだけに焦点を絞って学びたい方のため、シンプルなサーバのソースコードを書いておきました。言語は JavaScript （Node.js）または Python、Ruby、Go、ないし PHP で用意してあり、すべて GitHub にあります。[ソースを見る](https://github.com/reactjs/react-tutorial/) ことも出来ますし、 [zip ファイルでダウンロード](https://github.com/reactjs/react-tutorial/archive/master.zip)することも出来ます。
29 +
30 +それでは最初のチュートリアルとして、`public/index.html` の編集から始めましょう。
31 +
32 +### 始めてみましょう
33 +
34 +このチュートリアルでは、あらかじめビルドされた JavaScript ファイルを CDN から読み込むことになります。自分の好きなエディタを立ち上げて、次のように新規の HTML ドキュメントを作りましょう。
35 +
36 +```html
37 +<!-- index.html -->
38 +<html>
39 + <head>
40 + <title>Hello React</title>
41 + <script src="https://fb.me/react-{{site.react_version}}.js"></script>
42 + <script src="https://fb.me/JSXTransformer-{{site.react_version}}.js"></script>
43 + <script src="https://code.jquery.com/jquery-1.10.0.min.js"></script>
44 + </head>
45 + <body>
46 + <div id="content"></div>
47 + <script type="text/jsx">
48 + // ここにコードが入ります
49 + </script>
50 + </body>
51 +</html>
52 +```
53 +
54 +このチュートリアルに関しては、JavaScript コードを script タグの中へ書いていくことにします。
55 +
56 +> 確認:
57 +>
58 +> 上のコードで jQuery を読み込んでいますが、これはチュートリアル後半で ajax のコードを簡潔に書きたいだけなので、React を動かすのに必要なものでは**ありません**。
59 +
60 +### 最初のコンポーネント
61 +
62 +React はすべて、モジュール単位で組み立てられる（composable）コンポーネントからなっています。今回取り上げるコメントボックスの例では、以下のようなコンポーネント構造をとります。
63 +
64 +```
65 +- CommentBox
66 + - CommentList
67 + - Comment
68 + - CommentForm
69 +```
70 +
71 +それではまず `CommentBox` コンポーネントから作っていきましょう。とは言っても単なる `<div>` です。
72 +
73 +```javascript
74 +// tutorial1.js
75 +var CommentBox = React.createClass({
76 + render: function() {
77 + return (
78 + <div className="commentBox">
79 + Hello, world! I am a CommentBox.
80 + </div>
81 + );
82 + }
83 +});
84 +React.render(
85 + <CommentBox />,
86 + document.getElementById('content')
87 +);
88 +```
89 +
90 +#### JSX シンタックス
91 +
92 +先程書いた JavaScript の中に、XMLに似たシンタックスがあることに気付いたでしょうか。このシンタックスシュガーは、シンプルなプリコンパイラによって次のような生の JavaScript に変換されます。
93 +
94 +```javascript
95 +// tutorial1-raw.js
96 +var CommentBox = React.createClass({displayName: 'CommentBox',
97 + render: function() {
98 + return (
99 + React.createElement('div', {className: "commentBox"},
100 + "Hello, world! I am a CommentBox."
101 + )
102 + );
103 + }
104 +});
105 +React.render(
106 + React.createElement(CommentBox, null),
107 + document.getElementById('content')
108 +);
109 +```
110 +
111 +どちらを採るかは自由ですが、生の JavaScript よりも JSX シンタックスのほうが扱いやすいと考えています。詳しくは [JSX シンタックスの記事](/react/docs/jsx-in-depth.html) を読んでみてください。
112 +
113 +#### 何をしているのか
114 +
115 +先程のコードでは、とあるメソッドを持った JavaScript オブジェクトを `React.createClass()` に渡しています。これは新しい React コンポーネントを作るためです。このメソッドは `render` と呼ばれており、最終的に HTML へレンダリングされる React コンポーネントのツリーを返す点が肝になります。
116 +
117 +コードに書いた `<div>` タグは実際の DOM ノードではありません。これは React の `div` コンポーネントのインスタンスです。 これらは React が理解できるマーカーやデータの一部だと見なせます。React は **安全** です。デフォルトで XSS 対策を行っているので、HTML 文字列を生成することはありません。
118 +
119 +実際の HTML を返す必要はありません。 自分が（もしくは他の誰かが）組み立てたコンポーネントツリーを返せばいいのです。 これこそ React が **composable**な（組み立てられる）ものである理由であり、この大事なルールを守ればフロントエンドはメンテナンスしやすいものとなります。
120 +
121 +`React.render()` はまずルートコンポーネントのインスタンスを作り、フレームワークを立ち上げます。そして、第2引数で与えられた実際の DOM 要素にマークアップを挿入します。
122 +
123 +## コンポーネントの組み立て
124 +
125 +それでは `CommentList` と `CommentForm` の骨組みを作りましょう。繰り返しになりますが、これらはただの `<div>` です。
126 +
127 +```javascript
128 +// tutorial2.js
129 +var CommentList = React.createClass({
130 + render: function() {
131 + return (
132 + <div className="commentList">
133 + Hello, world! I am a CommentList.
134 + </div>
135 + );
136 + }
137 +});
138 +
139 +var CommentForm = React.createClass({
140 + render: function() {
141 + return (
142 + <div className="commentForm">
143 + Hello, world! I am a CommentForm.
144 + </div>
145 + );
146 + }
147 +});
148 +```
149 +
150 +さて、この新しいコンポーネントを使えるように `CommentBox` コンポーネントを書き直しましょう。
151 +
152 +```javascript{6-8}
153 +// tutorial3.js
154 +var CommentBox = React.createClass({
155 + render: function() {
156 + return (
157 + <div className="commentBox">
158 + <h1>Comments</h1>
159 + <CommentList />
160 + <CommentForm />
161 + </div>
162 + );
163 + }
164 +});
165 +```
166 +
167 +ここで、HTML タグと組み立てているコンポーネントが、どのようにミックスされているかを確認しましょう。 HTML コンポーネントは既定の React コンポーネントですが、自分で定義したもの同士はそれぞれ別物になります。JSX コンパイラは HTML タグを自動的に `React.createElement(tagName)` の式に書き換え、それぞれを別々のものに変換します。これはグローバルの名前空間が汚染させるのを防ぐためです。
168 +
169 +### Props を使う
170 +
171 +次のステップは `Comment` コンポーネントの作成です。このコンポーネントは、自分の親にあたるコンポーネントから渡されたデータを扱います。親から渡されたデータは、子のコンポーネントで「プロパティ」として利用できます。この「プロパティ」には `this.props` を通してアクセスします。props（プロパティ）を使うと `CommentList` から `Comment` に渡されたデータの読み込み、マークアップのレンダリングが可能になります。
172 +
173 +```javascript
174 +// tutorial4.js
175 +var Comment = React.createClass({
176 + render: function() {
177 + return (
178 + <div className="comment">
179 + <h2 className="commentAuthor">
180 + {this.props.author}
181 + </h2>
182 + {this.props.children}
183 + </div>
184 + );
185 + }
186 +});
187 +```
188 +
189 +JSX の内側で（属性値または子要素として）JavaScript の式を波括弧で囲むと、テキストや React コンポーネントをツリーに加えることが出来ます。コンポーネントに渡された属性値には名前が付けられており、`this.props` をキーとしてアクセスできます。また、ネストされた子要素の値は `this.props.children` でアクセスが可能です。
190 +
191 +### コンポーネントのプロパティ
192 +
193 +さて、これまでに `Comment` コンポーネントを定義しました。これからこのコンポーネントに、コメントの著者名と内容を渡せるようにします。これを実装することで、それぞれ別のコメントに対して同じコードを使い回せるようになります。それでは早速 `CommentList` の中にコメントを追加していきましょう。
194 +
195 +```javascript{6-7}
196 +// tutorial5.js
197 +var CommentList = React.createClass({
198 + render: function() {
199 + return (
200 + <div className="commentList">
201 + <Comment author="Pete Hunt">This is one comment</Comment>
202 + <Comment author="Jordan Walke">This is *another* comment</Comment>
203 + </div>
204 + );
205 + }
206 +});
207 +```
208 +
209 +ここで確認してもらいたいのは、親の `CommentList` コンポーネントから、子の `Comment` コンポーネントにデータが渡されている点です。この例ではまず、*Pete Hunt*（属性値を通して）と *This is one comment*（XML のような子ノードを通して）といったデータを `Comment` コンポーネントに渡しています。少し前に確認した通り、`Comment` コンポーネントからこれらの「プロパティ」にアクセスするには、`this.props.author` と `this.props.children` を使います。
210 +
211 +### Markdown の追加
212 +
213 +Markdown はインラインでテキストをフォーマットする簡単な記法です。例えば、テキストをアスタリスクで挟むと強調されて表示されます。
214 +
215 +まず最初に、サードパーティ製の **Showdown** ライブラリをアプリケーションに追加します。 Showdown は Markdown テキストを生の HTML に変換する JavaScript ライブラリです。 既にある head タグの内側に script タグを書き込み、以下のように Showdown を読み込ませます。
216 +
217 +```html{7}
218 +<!-- index.html -->
219 +<head>
220 + <title>Hello React</title>
221 + <script src="https://fb.me/react-{{site.react_version}}.js"></script>
222 + <script src="https://fb.me/JSXTransformer-{{site.react_version}}.js"></script>
223 + <script src="https://code.jquery.com/jquery-1.10.0.min.js"></script>
224 + <script src="https://cdnjs.cloudflare.com/ajax/libs/showdown/0.3.1/showdown.min.js"></script>
225 +</head>
226 +```
227 +
228 +次に、Markdown で書かれたコメントを変換して出力してみましょう。
229 +
230 +```javascript{2,10}
231 +// tutorial6.js
232 +var converter = new Showdown.converter();
233 +var Comment = React.createClass({
234 + render: function() {
235 + return (
236 + <div className="comment">
237 + <h2 className="commentAuthor">
238 + {this.props.author}
239 + </h2>
240 + {converter.makeHtml(this.props.children.toString())}
241 + </div>
242 + );
243 + }
244 +});
245 +```
246 +
247 +このコードでは Showdown のライブラリを呼び出すことしかしていません。`this.props.children` は React によってラップされたテキストですが、これを Showdown が理解できる生の文字列に変換する必要があります。そのため、上のコードでは明示的に `toString()` を呼び出しているのです。
248 +
249 +しかし問題があります！ブラウザがレンダリングしたコメントは次のように表示されているはずです -- "`<p>`This is `<em>`another`</em>` comment`</p>`" このようなタグは実際に HTML としてレンダリングさせたいですね。
250 +
251 +このような現象が起きるのは React が XSS 攻撃に対する防御を行っているからです。これを回避する方法はありますが、それを使うときにはフレームワークが警告をします。
252 +
253 +```javascript{5,11}
254 +// tutorial7.js
255 +var converter = new Showdown.converter();
256 +var Comment = React.createClass({
257 + render: function() {
258 + var rawMarkup = converter.makeHtml(this.props.children.toString());
259 + return (
260 + <div className="comment">
261 + <h2 className="commentAuthor">
262 + {this.props.author}
263 + </h2>
264 + <span dangerouslySetInnerHTML={{"{{"}}__html: rawMarkup}} />
265 + </div>
266 + );
267 + }
268 +});
269 +```
270 +
271 +これは特別な API であり、生の HTML が挿入されにくくなるよう意図的に作ったものです。しかし、ここでは Showdown のためにこのバックドアを利用しています。
272 +
273 +**注意:** この機能を使うことで、Showdown は安全なものと信頼することになります。
274 +
275 +### データモデルとの連携
276 +
277 +これまではソースコードにコメントを直に書き込んでいました。その代わりに、これからは JSON の blob データをコメントリストにレンダリングしてみましょう。サーバからデータを取得するのが最後の目標ですが、とりあえず今はソースコードの中にデータを書いておくことにします。
278 +
279 +```javascript
280 +// tutorial8.js
281 +var data = [
282 + {author: "Pete Hunt", text: "This is one comment"},
283 + {author: "Jordan Walke", text: "This is *another* comment"}
284 +];
285 +```
286 +
287 +このデータはモジュールを使って `CommentList` に取り込む必要があります。`CommentBox` の `React.render()` の部分を手直しして、props を通してデータが `CommentList` へ渡るようにしましょう。
288 +
289 +```javascript{7,15}
290 +// tutorial9.js
291 +var CommentBox = React.createClass({
292 + render: function() {
293 + return (
294 + <div className="commentBox">
295 + <h1>Comments</h1>
296 + <CommentList data={this.props.data} />
297 + <CommentForm />
298 + </div>
299 + );
300 + }
301 +});
302 +
303 +React.render(
304 + <CommentBox data={data} />,
305 + document.getElementById('content')
306 +);
307 +```
308 +
309 +こうして `CommentList` がデータを扱えるようになりました。それでは、コメントを動的にレンダリングしてみましょう。
310 +
311 +```javascript{4-10,13}
312 +// tutorial10.js
313 +var CommentList = React.createClass({
314 + render: function() {
315 + var commentNodes = this.props.data.map(function (comment) {
316 + return (
317 + <Comment author={comment.author}>
318 + {comment.text}
319 + </Comment>
320 + );
321 + });
322 + return (
323 + <div className="commentList">
324 + {commentNodes}
325 + </div>
326 + );
327 + }
328 +});
329 +```
330 +
331 +これだけ！
332 +
333 +### サーバからのデータの取得
334 +
335 +続いて、ハードコーディングしていたデータを、サーバからの動的なデータに置き換えてみましょう。
336 +
337 +```javascript{3}
338 +// tutorial11.js
339 +React.render(
340 + <CommentBox url="comments.json" />,
341 + document.getElementById('content')
342 +);
343 +```
344 +
345 +このコンポーネントは自身を再びレンダリングすることになるので、これまでのコンポーネントとは異なります。レスポンスがサーバから返ってくると、送られてきた新しいコメントをコンポーネントがレンダリングすることになります。ですが、その時点までコンポーネントには何もデータがないはずです。
346 +
347 +### Reactive state
348 +
349 +これまで、それぞれのコンポーネントは自身の props の値を用いて、一度だけレンダリングしていました。`props` はイミュータブルです。つまり、props は親から渡されますが、同時に props は親の「所有物」なのです。データが相互にやり取りされるのを実現するため、ここでミュータブルな **state**（状態）をコンポーネントに取り入れましょう。コンポーネントは `this.state` というプライベートな値を持ち、`this.setState()` を呼び出すことで state を更新することが出来ます。コンポーネントの state が更新されれば、そのコンポーネントは自身を再びレンダリングし直します。
350 +
351 +`render()` メソッドは `this.props` や `this.state` と同じく宣言的に書かれています。このフレームワークによって、UI と入力が常に一致するようになります。
352 +
353 +サーバがデータを集めてくれば、今あるコメントのデータを更新することになるかもしれません。state を表すコメントのデータの配列を `CommentBox` コンポーネントに加えましょう。
354 +
355 +```javascript{3-5,10}
356 +// tutorial12.js
357 +var CommentBox = React.createClass({
358 + getInitialState: function() {
359 + return {data: []};
360 + },
361 + render: function() {
362 + return (
363 + <div className="commentBox">
364 + <h1>Comments</h1>
365 + <CommentList data={this.state.data} />
366 + <CommentForm />
367 + </div>
368 + );
369 + }
370 +});
371 +```
372 +
373 +`getInitialState()` メソッドはコンポーネントのライフサイクル内で一回だけ実行され、コンポーネントの state における初期値を設定します。
374 +
375 +#### State の更新
376 +コンポーネントの作成と同時に、サーバから JSON データを GET で取得し、state を更新して最新のデータを反映させてみましょう。実際のアプリケーションでは動的なエンドポイントになるでしょうが、今回の例では話を簡単にするため、以下の静的な JSON ファイルを使います。
377 +
378 +```javascript
379 +// tutorial13.json
380 +[
381 + {"author": "Pete Hunt", "text": "This is one comment"},
382 + {"author": "Jordan Walke", "text": "This is *another* comment"}
383 +]
384 +```
385 +
386 +サーバへの非同期リクエストを作るため、ここでは jQuery を使います。
387 +
388 +注意: ここからは AJAX アプリケーションを作っていくので、自分のファイルシステム上ではなく Web サーバを使ってアプリを作る必要があります。残りのチュートリアルに必要な機能は [冒頭で紹介した](#running-a-server) サーバに含まれています。ソースコードは [GitHub に](https://github.com/reactjs/react-tutorial/)用意してあります。
389 +
390 +```javascript{6-17}
391 +// tutorial13.js
392 +var CommentBox = React.createClass({
393 + getInitialState: function() {
394 + return {data: []};
395 + },
396 + componentDidMount: function() {
397 + $.ajax({
398 + url: this.props.url,
399 + dataType: 'json',
400 + success: function(data) {
401 + this.setState({data: data});
402 + }.bind(this),
403 + error: function(xhr, status, err) {
404 + console.error(this.props.url, status, err.toString());
405 + }.bind(this)
406 + });
407 + },
408 + render: function() {
409 + return (
410 + <div className="commentBox">
411 + <h1>Comments</h1>
412 + <CommentList data={this.state.data} />
413 + <CommentForm />
414 + </div>
415 + );
416 + }
417 +});
418 +```
419 +
420 +さて、`componentDidMount` はコンポーネントがレンダリングされたときに React が自動的に呼び出すメソッドです。動的な更新の鍵となるのは `this.setState()` の呼び出し方です。ここでは、古いコメントの配列をサーバから取ってきた新しい配列に置き換え、UI を自動的に更新させてみましょう。このような reactivity（反応性・柔軟性）のおかげで、リアルタイム更新を最小限にすることが出来ます。次のコードではシンプルなポーリングをしていますが、WebSockets や他の方法でも簡単に実現できます。
421 +
422 +```javascript{3,14,19-20,34}
423 +// tutorial14.js
424 +var CommentBox = React.createClass({
425 + loadCommentsFromServer: function() {
426 + $.ajax({
427 + url: this.props.url,
428 + dataType: 'json',
429 + success: function(data) {
430 + this.setState({data: data});
431 + }.bind(this),
432 + error: function(xhr, status, err) {
433 + console.error(this.props.url, status, err.toString());
434 + }.bind(this)
435 + });
436 + },
437 + getInitialState: function() {
438 + return {data: []};
439 + },
440 + componentDidMount: function() {
441 + this.loadCommentsFromServer();
442 + setInterval(this.loadCommentsFromServer, this.props.pollInterval);
443 + },
444 + render: function() {
445 + return (
446 + <div className="commentBox">
447 + <h1>Comments</h1>
448 + <CommentList data={this.state.data} />
449 + <CommentForm />
450 + </div>
451 + );
452 + }
453 +});
454 +
455 +React.render(
456 + <CommentBox url="comments.json" pollInterval={2000} />,
457 + document.getElementById('content')
458 +);
459 +
460 +```
461 +
462 +ここまでに、AJAX を呼び出す部分を別のメソッド内に移動させました。加えて、コンポーネントが最初に読み込まれてから2秒ごとに AJAX のメソッドが呼び出されるようにしました。ぜひ自分のブラウザで実行させて、`comments.json` ファイルに変更を加えてみてください。2秒以内に表示が更新されるはずです！
463 +
464 +### 新しいコメントの追加
465 +
466 +いよいよフォームを作る段階に来ました。ここで `CommentForm` コンポーネントは、ユーザに自分の名前とコメントの内容を入力させ、コメントを保存させるためにサーバへリクエストを送る役割を果たすことになります。
467 +
468 +```javascript{5-9}
469 +// tutorial15.js
470 +var CommentForm = React.createClass({
471 + render: function() {
472 + return (
473 + <form className="commentForm">
474 + <input type="text" placeholder="Your name" />
475 + <input type="text" placeholder="Say something..." />
476 + <input type="submit" value="Post" />
477 + </form>
478 + );
479 + }
480 +});
481 +```
482 +
483 +それでは、フォームを使ってデータをやり取りできるようにしましょう。ユーザがフォームから送信したら、フォームをクリアしてサーバにリクエストを送り、コメントリストをリフレッシュすることになります。まず手始めに、フォームからの送信イベントを受け取ってフォームをクリアできるようにしましょう。
484 +
485 +```javascript{3-13,16-19}
486 +// tutorial16.js
487 +var CommentForm = React.createClass({
488 + handleSubmit: function(e) {
489 + e.preventDefault();
490 + var author = React.findDOMNode(this.refs.author).value.trim();
491 + var text = React.findDOMNode(this.refs.text).value.trim();
492 + if (!text || !author) {
493 + return;
494 + }
495 + // TODO: サーバにリクエストを送信
496 + React.findDOMNode(this.refs.author).value = '';
497 + React.findDOMNode(this.refs.text).value = '';
498 + return;
499 + },
500 + render: function() {
501 + return (
502 + <form className="commentForm" onSubmit={this.handleSubmit}>
503 + <input type="text" placeholder="Your name" ref="author" />
504 + <input type="text" placeholder="Say something..." ref="text" />
505 + <input type="submit" value="Post" />
506 + </form>
507 + );
508 + }
509 +});
510 +```
511 +
512 +##### イベント
513 +
514 +React がコンポーネントにイベントハンドラを登録する際は camelCase の命名規則に従います。上のコードではフォームに `onSubmit` ハンドラを登録し、フォームから妥当な入力が送信されたらフォームをクリアするようになっています。
515 +
516 +また `preventDefault()` を呼び出しているので、フォームからの送信に対してブラウザのデフォルト処理が反応することはありません。
517 +
518 +##### Refs
519 +
520 +先程のコードでは `ref` 属性値を使って子のコンポーネントに名前を付けており、`this.ref` でそのコンポーネントを参照しています。`React.findDOMNode(component)` にコンポーネントを指定して呼び出すことで、ブラウザの持つ実際の DOM 要素を取得することが出来ます。
521 +
522 +##### Props としてのコールバック
523 +
524 +ユーザがコメントを送信したら、コメントリストをリフレッシュして新しいリストを読み込むことになります。コメントリストを表す state を保持しているのは `CommentBox` なので、必要なロジックは `CommentBox` の中に書くのが筋でしょう。
525 +
526 +ここでは子のコンポーネントから親に向かって、いつもとは逆方向にデータを返す必要があります。まず、親のコンポーネントに新しいコールバック関数（`handleCommentSubmit`）を定義します。続いて `render` メソッド内にある子のコンポーネントにコールバックを渡すことで、`onCommentSubmit` イベントとコールバックを結び付けています。こうすることで、イベントが発生するたびにコールバックが呼び出されます。
527 +
528 +```javascript{15-17,30}
529 +// tutorial17.js
530 +var CommentBox = React.createClass({
531 + loadCommentsFromServer: function() {
532 + $.ajax({
533 + url: this.props.url,
534 + dataType: 'json',
535 + success: function(data) {
536 + this.setState({data: data});
537 + }.bind(this),
538 + error: function(xhr, status, err) {
539 + console.error(this.props.url, status, err.toString());
540 + }.bind(this)
541 + });
542 + },
543 + handleCommentSubmit: function(comment) {
544 + // TODO: サーバに送信、リストをリフレッシュ
545 + },
546 + getInitialState: function() {
547 + return {data: []};
548 + },
549 + componentDidMount: function() {
550 + this.loadCommentsFromServer();
551 + setInterval(this.loadCommentsFromServer, this.props.pollInterval);
552 + },
553 + render: function() {
554 + return (
555 + <div className="commentBox">
556 + <h1>Comments</h1>
557 + <CommentList data={this.state.data} />
558 + <CommentForm onCommentSubmit={this.handleCommentSubmit} />
559 + </div>
560 + );
561 + }
562 +});
563 +```
564 +
565 +それでは、ユーザがフォームから送信したら `CommentForm` がコールバックを呼び出せるようにしましょう。
566 +
567 +```javascript{10}
568 +// tutorial18.js
569 +var CommentForm = React.createClass({
570 + handleSubmit: function(e) {
571 + e.preventDefault();
572 + var author = React.findDOMNode(this.refs.author).value.trim();
573 + var text = React.findDOMNode(this.refs.text).value.trim();
574 + if (!text || !author) {
575 + return;
576 + }
577 + this.props.onCommentSubmit({author: author, text: text});
578 + React.findDOMNode(this.refs.author).value = '';
579 + React.findDOMNode(this.refs.text).value = '';
580 + return;
581 + },
582 + render: function() {
583 + return (
584 + <form className="commentForm" onSubmit={this.handleSubmit}>
585 + <input type="text" placeholder="Your name" ref="author" />
586 + <input type="text" placeholder="Say something..." ref="text" />
587 + <input type="submit" value="Post" />
588 + </form>
589 + );
590 + }
591 +});
592 +```
593 +
594 +こうしてコールバックが出来たので、あとはサーバにコメントを送信してリストをリフレッシュすれば完璧です。
595 +
596 +```javascript{16-27}
597 +// tutorial19.js
598 +var CommentBox = React.createClass({
599 + loadCommentsFromServer: function() {
600 + $.ajax({
601 + url: this.props.url,
602 + dataType: 'json',
603 + success: function(data) {
604 + this.setState({data: data});
605 + }.bind(this),
606 + error: function(xhr, status, err) {
607 + console.error(this.props.url, status, err.toString());
608 + }.bind(this)
609 + });
610 + },
611 + handleCommentSubmit: function(comment) {
612 + $.ajax({
613 + url: this.props.url,
614 + dataType: 'json',
615 + type: 'POST',
616 + data: comment,
617 + success: function(data) {
618 + this.setState({data: data});
619 + }.bind(this),
620 + error: function(xhr, status, err) {
621 + console.error(this.props.url, status, err.toString());
622 + }.bind(this)
623 + });
624 + },
625 + getInitialState: function() {
626 + return {data: []};
627 + },
628 + componentDidMount: function() {
629 + this.loadCommentsFromServer();
630 + setInterval(this.loadCommentsFromServer, this.props.pollInterval);
631 + },
632 + render: function() {
633 + return (
634 + <div className="commentBox">
635 + <h1>Comments</h1>
636 + <CommentList data={this.state.data} />
637 + <CommentForm onCommentSubmit={this.handleCommentSubmit} />
638 + </div>
639 + );
640 + }
641 +});
642 +```
643 +
644 +### 最適化: 先読み更新
645 +
646 +アプリケーションに必要な機能は一通り実装できました。しかし、フォームからコメントを送信しても、サーバからのレスポンスが来るまで自分のコメントはリストに載らないため、アプリの動作は遅く感じます。ここでは、送信したコメントをリストに先読みさせて、アプリの体感速度をアップさせましょう。
647 +
648 +```javascript{16-18}
649 +// tutorial20.js
650 +var CommentBox = React.createClass({
651 + loadCommentsFromServer: function() {
652 + $.ajax({
653 + url: this.props.url,
654 + dataType: 'json',
655 + success: function(data) {
656 + this.setState({data: data});
657 + }.bind(this),
658 + error: function(xhr, status, err) {
659 + console.error(this.props.url, status, err.toString());
660 + }.bind(this)
661 + });
662 + },
663 + handleCommentSubmit: function(comment) {
664 + var comments = this.state.data;
665 + var newComments = comments.concat([comment]);
666 + this.setState({data: newComments});
667 + $.ajax({
668 + url: this.props.url,
669 + dataType: 'json',
670 + type: 'POST',
671 + data: comment,
672 + success: function(data) {
673 + this.setState({data: data});
674 + }.bind(this),
675 + error: function(xhr, status, err) {
676 + console.error(this.props.url, status, err.toString());
677 + }.bind(this)
678 + });
679 + },
680 + getInitialState: function() {
681 + return {data: []};
682 + },
683 + componentDidMount: function() {
684 + this.loadCommentsFromServer();
685 + setInterval(this.loadCommentsFromServer, this.props.pollInterval);
686 + },
687 + render: function() {
688 + return (
689 + <div className="commentBox">
690 + <h1>Comments</h1>
691 + <CommentList data={this.state.data} />
692 + <CommentForm onCommentSubmit={this.handleCommentSubmit} />
693 + </div>
694 + );
695 + }
696 +});
697 +```
698 +
699 +### おめでとう！
700 +
701 +シンプルな手順を追ううちにコメントボックスを作ることが出来ました。さらに詳しいことは[なぜ React を使うのか](/react/docs/why-react.html)を読んだり、[API リファレンス](/react/docs/top-level-api.html)を開いたりしてハッキングを始めましょう！幸運を祈ります！