` 태그들은 실제 DOM 노드가 아니라 React `div` 컴포넌트의 인스턴스입니다. 이것은 React가 다룰 수 있는 데이터의 표지자(markers)나 조각이라 생각하셔도 됩니다. React는 **안전합니다**. 생(raw) HTML 문자열을 생성하는것이 아니기 때문에 XSS을 기본적으로 방지합니다.
+
+일반적인 HTML만 리턴할 수 있는 것은 아닙니다. 여러분이 직접 만든 (또는 다른 사람들이 만들어 놓은) 컴포넌트의 트리를 리턴할 수도 있습니다. 이것이 React를 **조합가능(composable)하게 만듭니다**: 유지보수 가능한 프론트엔드를 위한 핵심교리(key tenet)지요.
+
+`React.render()`는 최상위 컴포넌트의 인스턴스를 만들고, 두 번째 인수로 전달받은 DOM 엘리먼트에 마크업을 삽입해 프레임워크를 시작합니다.
+
+## 컴포넌트 조합하기
+
+이제 `CommentList`와 `CommentForm`을 위한 뼈대를 구축해 봅시다. 이전과 마찬가지로 단순히 `
` 태그 하나 입니다.
+
+```javascript
+// tutorial2.js
+var CommentList = React.createClass({
+ render: function() {
+ return (
+
+ 안녕! 난 댓글목록이야.
+
+ );
+ }
+});
+
+var CommentForm = React.createClass({
+ render: function() {
+ return (
+
+ 안녕! 난 댓글폼이야.
+
+ );
+ }
+});
+```
+
+다음은 `CommentBox` 컴포넌트가 새로 만든 컴포넌트들을 사용하도록 수정합니다.
+
+```javascript{6-8}
+// tutorial3.js
+var CommentBox = React.createClass({
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+```
+
+방금 만든 컴포넌트들을 어떤방식으로 HTML 태그들과 섞어 사용하는지 살펴보세요. HTML 컴포넌트들도 한가지 차이만 제외한다면 우리가 정의한 것과 같은 표준적인 React 컴포넌트입니다. JSX 컴파일러가 자동으로 HTML 태그들을 `React.createElement(tagName)` 표현식으로 재작성하고 나머지는 그대로 둘 것입니다. 이는 전역 네임스페이스가 오염되는 것을 막아줍니다.
+
+### 컴포넌트 프로퍼티 (Component Properties)
+
+이제 세 번째 컴포넌트인 `Comment`를 만들어 봅시다. 개별 댓글마다 글쓴이와 내용을 포함하게 될 것입니다. 먼저 댓글 몇 개를 `CommentList`에 추가해 봅시다:
+
+```javascript{6-7}
+// tutorial4.js
+var CommentList = React.createClass({
+ render: function() {
+ return (
+
+ 댓글입니다
+ *또 다른* 댓글입니다
+
+ );
+ }
+});
+```
+
+부모 컴포넌트인 `CommentList`에서 자식 컴포넌트인 `Comment`에 데이터들을 전달하고 있는것을 확인할 수 있습니다. 예를 들어, 우리는 어트리뷰트로 *Pete Hunt*를, XML 형식의 자식 노드로 *댓글입니다*를 첫 번째 `Comment`로 넘겼습니다. 부모에서 자식 컴포넌트로 전달되는 데이터는 **props**라 합니다. properties의 축약어지요.
+
+### props 사용하기
+
+Comment 컴포넌트를 만들어 봅시다. **props**를 사용해 `CommentList`에서 전달받은 데이터를 읽어들이고, 마크업을 렌더할 수 있을 것입니다.
+
+```javascript
+// tutorial5.js
+var Comment = React.createClass({
+ render: function() {
+ return (
+
+
+ {this.props.author}
+
+ {this.props.children}
+
+ );
+ }
+});
+```
+
+JSX 내부의 중괄호로 둘러싸인 JavaScript 표현식(어트리뷰트나 엘리먼트의 자식으로 사용된)을 통해 텍스트나 React 컴포넌트를 트리에 더할 수 있습니다. `this.props`를 통해 컴포넌트에 전달된 특정한 어트리뷰트들에, `this.props.children`을 통해 중첩된 엘리먼트들에 접근할 수 있습니다.
+
+### Markdown 추가하기
+
+Markdown은 텍스트를 포맷팅하는 간단한 방식입니다. 예를 들어, 별표(`*`)로 텍스트를 둘러싸는 것은 강조의 의미입니다.
+
+먼저 서드파티 라이브러리인 **Showdown**을 애플리케이션에 추가합니다. 이 JavaScript 라이브러리는 Markdown 텍스트를 HTML 문법으로 변환해줍니다. head 태그안에 스크립트 태그를 추가해 주세요. (React playground에는 이미 포함되어 있습니다):
+
+```html{7}
+
+
+
Hello React
+
+
+
+
+
+```
+
+다음은, 댓글 텍스트를 Markdown으로 전환하고 출력해 봅시다.
+
+```javascript{2,10}
+// tutorial6.js
+var converter = new Showdown.converter();
+var Comment = React.createClass({
+ render: function() {
+ return (
+
+
+ {this.props.author}
+
+ {converter.makeHtml(this.props.children.toString())}
+
+ );
+ }
+});
+```
+
+우리가 한 일이라고는 Showdown 라이브러리를 호출한 것 뿐입니다. Showdown이 `this.props.children`에서 텍스트를 읽어들여 처리할 수 있도록 React 형식의 텍스트(React's wrapped text)를 단순 텍스트(raw string)으로 전환하기 위해 명시적으로 `toString()`을 호출했습니다.
+
+하지만 여기엔 문제가 있습니다! 우리는 HTML 태그들이 정상적으로 렌더되길 원하지만 브라우저에 출력된 결과물은 "`
```또 다른`` 댓글입니다`
`"처럼 태그가 그대로 보일것입니다.
+
+React는 이런 식으로 XSS 공격을 예방합니다. 우회할 방법이 있긴 하지만 프레임워크는 사용하지 않도록 경고하고 있습니다:
+
+```javascript{5,11}
+// tutorial7.js
+var converter = new Showdown.converter();
+var Comment = React.createClass({
+ render: function() {
+ var rawMarkup = converter.makeHtml(this.props.children.toString());
+ return (
+
+
+ {this.props.author}
+
+
+
+ );
+ }
+});
+```
+
+이는 의도적으로 생(raw) HTML을 넣기 힘들게 하려고 만든 특별한 API지만 Showdown을 사용하기 위해 이 백도어를 활용합시다.
+
+**잊지 마세요:** 이 기능은 Showdown이 안전한 것으로 믿고 사용하는 것입니다.
+
+### 데이터 모델 연결하기
+
+지금까지는 소스코드에 직접 댓글을 넣었습니다. 이제부터는 JSON 데이터 덩어리를 댓글 목록에 렌더해보겠습니다. 최종적으로는 서버에서 데이터가 내려오겠지만, 지금은 소스에 직접 데이터를 넣어봅시다:
+
+```javascript
+// tutorial8.js
+var data = [
+ {author: "Pete Hunt", text: "댓글입니다"},
+ {author: "Jordan Walke", text: "*또 다른* 댓글입니다"}
+];
+```
+
+이 데이터를 모듈화된 방식으로 `CommentList`에 넣어야 합니다. props을 이용해 데이터를 넘기도록 `CommentBox`와 `React.render()` 호출을 수정합시다.
+
+```javascript{7,15}
+// tutorial9.js
+var CommentBox = React.createClass({
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+
+React.render(
+
,
+ document.getElementById('content')
+);
+```
+
+이제 `CommentList`에서 데이터를 다룰 수 있습니다. 댓글을 동적으로 렌더해봅시다:
+
+```javascript{4-10,13}
+// tutorial10.js
+var CommentList = React.createClass({
+ render: function() {
+ var commentNodes = this.props.data.map(function (comment) {
+ return (
+
+ {comment.text}
+
+ );
+ });
+ return (
+
+ {commentNodes}
+
+ );
+ }
+});
+```
+
+이게 답니다!
+
+### 서버에서 가져오기(Fetching)
+
+이제 데이터를 소스에 직접 넣는 방식에서 서버에서 동적으로 받아서 처리하는 방식으로 바꿔봅시다. 데이터 prop을 삭제하고 처리할 URL로 변경해 줍시다.
+
+```javascript{3}
+// tutorial11.js
+React.render(
+
,
+ document.getElementById('content')
+);
+```
+
+이 컴포넌트는 이전 것과 다르게, 스스로 다시 렌더링해야 합니다. 컴포넌트는 서버에서 요청이 들어올때까지는 아무 데이터도 가지고 있지 않다가, 특정한 시점에서 새로운 댓글을 렌더할 필요가 있을 것입니다.
+
+### 반응적 state
+
+지금까지, 각각의 구성요소는 props를 기반으로 한번 렌더되었습니다. `props`는 불변성을 갖습니다: 그것들은 부모에서 전달되어 부모에게 "소유" 되어 있습니다. 컴포넌트에 상호작용을 구현하기 위해서, 가변성을 갖는 **state**를 소개합니다. `this.state`는 컴포넌트에 한정(private)되며 `this.setState()`를 통해 변경할 수 있습니다. state가 업데이트 되면, 컴포넌트는 자신을 스스로 다시 렌더링합니다.
+
+`render()` 메소드는 `this.props`와 `this.state`를 위한 함수로 선언적으로 작성됩니다. 프레임워크에서 입력값에 따른 UI가 항상 일관성 있음을 보장해줍니다.
+
+서버가 데이터를 가져오면 댓글 데이터가 변경될 것입니다. 댓글 데이터의 배열을 `CommentBox`의 state로 추가해봅시다:
+
+```javascript{3-5,10}
+// tutorial12.js
+var CommentBox = React.createClass({
+ getInitialState: function() {
+ return {data: []};
+ },
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+```
+
+`getInitialState()` 는 컴포넌트의 생명주기동안 한 번만 실행되며 컴포넌트의 초기 state를 설정합니다.
+
+### state 업데이트하기
+
+컴포넌트의 최초 생성 시에, 서버에서 GET 방식으로 JSON을 넘겨받아 최신의 데이터가 state에 반영되길 원했습니다. 실제 애플리케이션에선 이것이 동적인 엔드포인트이지만, 이 예제에서는 정적 JSON 파일을 사용해서 간단하게 만들어보겠습니다.
+
+```javascript
+// tutorial13.json
+[
+ {"author": "Pete Hunt", "text": "댓글입니다"},
+ {"author": "Jordan Walke", "text": "*또 다른* 댓글입니다"}
+]
+```
+
+서버에 비동기 요청을 위해 jQuery를 사용합니다.
+
+주의: 우리의 앱이 AJAX 애플리케이션으로 변화하고 있기 때문에, 이제 파일 시스템의 파일을 참조하는 대신 웹서버를 사용하도록 앱을 개발해야 합니다. [위에서 언급한 바와 같이](#running-a-server), 우리는 튜토리얼의 나머지 부분에 필요한 기능을 제공하는 서버를 몇 가지 준비해 놓았습니다. [GitHub에 올려놓았으니](https://github.com/reactjs/react-tutorial) 확인해 보세요.
+
+```javascript{6-17}
+// tutorial13.js
+var CommentBox = React.createClass({
+ getInitialState: function() {
+ return {data: []};
+ },
+ componentDidMount: function() {
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+```
+
+여기서 `componentDidMount`는 컴포넌트가 렌더링 된 다음 React에 의해 자동으로 호출되는 메소드입니다. 동적 업데이트의 핵심은 `this.setState()`의 호출입니다. 우리가 이전의 댓글 목록을 서버에서 넘어온 새로운 목록으로 변경하면 자동으로 UI가 업데이트 될 것입니다. 이 반응성 덕분에 실시간 업데이트에 아주 작은 수정만 가해집니다. 우리는 여기선 간단한 폴링을 사용할 것이지만 웹소켓등의 다른 기술도 쉽게 사용할 수 있습니다.
+
+```javascript{3,14,19-20,34}
+// tutorial14.js
+var CommentBox = React.createClass({
+ loadCommentsFromServer: function() {
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ getInitialState: function() {
+ return {data: []};
+ },
+ componentDidMount: function() {
+ this.loadCommentsFromServer();
+ setInterval(this.loadCommentsFromServer, this.props.pollInterval);
+ },
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+
+React.render(
+
,
+ document.getElementById('content')
+);
+
+```
+
+우리가 여기서 한것은 AJAX 호출을 별도의 메소드로 분리하고 컴포넌트가 처음 로드된 시점부터 2초 간격으로 계속 호출되도록 한 것입니다. 브라우저에서 직접 돌려보고 `comments.json`파일을 수정해보세요; 2초 간격으로 변화되는 모습이 보일 것입니다!
+
+### 새로운 댓글 추가하기
+
+이제 폼을 만들어볼 시간입니다. 우리의 `CommentForm` 컴포넌트는 사용자에게 이름과 내용을 입력받고 댓글을 저장하기 위해 서버에 요청을 전송해야 합니다.
+
+```javascript{5-9}
+// tutorial15.js
+var CommentForm = React.createClass({
+ render: function() {
+ return (
+
+ );
+ }
+});
+```
+
+이제 폼의 상호작용을 만들어 보겠습니다. 사용자가 폼을 섭밋하는 시점에 우리는 폼을 초기화하고 서버에 요청을 전송하고 댓글목록을 갱신해야 합니다. 폼의 섭밋 이벤트를 감시하고 초기화 해주는 부분부터 시작해 보죠.
+
+```javascript{3-14,17-20}
+// tutorial16.js
+var CommentForm = React.createClass({
+ handleSubmit: function(e) {
+ e.preventDefault();
+ var author = this.refs.author.getDOMNode().value.trim();
+ var text = this.refs.text.getDOMNode().value.trim();
+ if (!text || !author) {
+ return;
+ }
+ // TODO: 서버에 요청을 전송합니다
+ this.refs.author.getDOMNode().value = '';
+ this.refs.text.getDOMNode().value = '';
+ return;
+ },
+ render: function() {
+ return (
+
+ );
+ }
+});
+```
+
+##### 이벤트
+
+React는 카멜케이스 네이밍 컨벤션으로 컴포넌트에 이벤트 핸들러를 등록합니다. 폼이 유효한 값으로 섭밋되었을 때 폼필드들을 초기화하도록 `onSubmit` 핸들러를 등록합니다.
+
+폼 섭밋에 대한 브라우저의 기본동작을 막기 위해 이벤트시점에 `preventDefault()`를 호출합니다.
+
+##### Refs
+
+우리는 자식 컴포넌트의 이름을 지정하기 위해 `ref` 어트리뷰트를, 컴포넌트를 참조하기 위해 `this.refs`를 사용합니다. 고유한(native) 브라우저 DOM 엘리먼트를 얻기 위해 `getDOMNode()`를 호출할 수 있습니다.
+
+##### props으로 콜백 처리하기
+
+사용자가 댓글을 등록할 때, 새로운 댓글을 추가하기 위해 댓글목록을 갱신해주어야 합니다. `CommentBox`가 댓글목록의 state를 소유하고 있기 때문에 이 로직 또한 `CommentBox`에 있는것이 타당합니다.
+
+자식 컴포넌트가 그의 부모에게 데이터를 넘겨줄 필요가 있습니다. 부모의 `render` 메소드에서 새로운 콜백(`handleCommentSubmit`)을 자식에게 넘겨주고, 자식의 `onCommentSubmit` 이벤트에 그것을 바인딩해주는 식으로 구현합니다. 이벤트가 작동될때(triggerd)마다, 콜백이 호출됩니다:
+
+```javascript{15-17,30}
+// tutorial17.js
+var CommentBox = React.createClass({
+ loadCommentsFromServer: function() {
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ handleCommentSubmit: function(comment) {
+ // TODO: 서버에 요청을 수행하고 목록을 갱신한다
+ },
+ getInitialState: function() {
+ return {data: []};
+ },
+ componentDidMount: function() {
+ this.loadCommentsFromServer();
+ setInterval(this.loadCommentsFromServer, this.props.pollInterval);
+ },
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+```
+
+사용자가 폼을 섭밋할 때, `CommentForm`에서 콜백을 호출해 봅시다:
+
+```javascript{10}
+// tutorial18.js
+var CommentForm = React.createClass({
+ handleSubmit: function(e) {
+ e.preventDefault();
+ var author = this.refs.author.getDOMNode().value.trim();
+ var text = this.refs.text.getDOMNode().value.trim();
+ if (!text || !author) {
+ return;
+ }
+ this.props.onCommentSubmit({author: author, text: text});
+ this.refs.author.getDOMNode().value = '';
+ this.refs.text.getDOMNode().value = '';
+ return;
+ },
+ render: function() {
+ return (
+
+ );
+ }
+});
+```
+
+이제 콜백이 제자리를 찾았습니다. 우리가 할일은 서버에 요청을 날리고 목록을 갱신하는 것 뿐입니다:
+
+```javascript{16-27}
+// tutorial19.js
+var CommentBox = React.createClass({
+ loadCommentsFromServer: function() {
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ handleCommentSubmit: function(comment) {
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ type: 'POST',
+ data: comment,
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ getInitialState: function() {
+ return {data: []};
+ },
+ componentDidMount: function() {
+ this.loadCommentsFromServer();
+ setInterval(this.loadCommentsFromServer, this.props.pollInterval);
+ },
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+```
+
+### 최적화: 낙관적 업데이트
+
+우리의 애플리케이션은 이제 모든 기능을 갖추었습니다. 하지만 댓글이 목록에 갱신되기 전에 완료요청을 기다리는 게 조금 느린듯한 느낌이 드네요. 우리는 낙관적 업데이트를 통해 댓글이 목록에 추가되도록 함으로써 앱이 좀 더 빨라진 것처럼 느껴지도록 할 수 있습니다.
+
+```javascript{16-18}
+// tutorial20.js
+var CommentBox = React.createClass({
+ loadCommentsFromServer: function() {
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ handleCommentSubmit: function(comment) {
+ var comments = this.state.data;
+ var newComments = comments.concat([comment]);
+ this.setState({data: newComments});
+ $.ajax({
+ url: this.props.url,
+ dataType: 'json',
+ type: 'POST',
+ data: comment,
+ success: function(data) {
+ this.setState({data: data});
+ }.bind(this),
+ error: function(xhr, status, err) {
+ console.error(this.props.url, status, err.toString());
+ }.bind(this)
+ });
+ },
+ getInitialState: function() {
+ return {data: []};
+ },
+ componentDidMount: function() {
+ this.loadCommentsFromServer();
+ setInterval(this.loadCommentsFromServer, this.props.pollInterval);
+ },
+ render: function() {
+ return (
+
+
댓글
+
+
+
+ );
+ }
+});
+```
+
+### 축하합니다!
+
+몇 단계를 거쳐 간단하게 댓글상자를 만들어 보았습니다. [왜 React인가](/react/docs/why-react.html)에서 더 알아보거나, 혹은 [API 레퍼런스](/react/docs/top-level-api.html)에 뛰어들어 해킹을 시작하세요! 행운을 빕니다!