@samitouri / QOS-React-2 / commits / 72f631b994

Create ref-01-top-level-api.ko-KR.md

Based on 4f50071de0ac1dd6ce6aeda4f3dd9549fb9e36ba

Taeho Kim committed Jan 30, 2015 at 23:19 UTC 72f631b994e5d1f1dde23ec199efe14f65c69edb
1 file changed +162
docs/docs/ref-01-top-level-api.ko-KR.md new
+162
@@ -0,0 +1,162 @@
1 +---
2 +id: top-level-api-ko-KR
3 +title: 최상위 API
4 +permalink: top-level-api.ko-KR.html
5 +next: component-api.ko-KR.html
6 +redirect_from: "/docs/reference.ko-KR.html"
7 +---
8 +
9 +## React
10 +
11 +`React`는 React 라이브러리의 진입점입니다. 미리 빌드된 패키지를 사용하는 경우 전역 변수로 접근할 수 있습니다. CommonJS 모듈을 사용하는 경우에는 `require()`로 불러올 수 있습니다.
12 +
13 +
14 +### React.createClass
15 +
16 +```javascript
17 +ReactClass createClass(object specification)
18 +```
19 +
20 +주어진 명세에 따라 컴포넌트 클래스를 만듭니다. 컴포넌트는 단 하나의 자식만을 리턴하는 `render` 메소드를 구현합니다. 그 자식은 임의 깊이의 자식 구조를 가질 수 있습니다. 컴포넌트가 일반적인 프로토타입 기반의 클래스와 다른 점은 생성할 때 `new` 연산자를 사용하지 않아도 된다는 것입니다. 컴포넌트는 (`new` 연산자를 통해) 내부 인스턴스를 만들어 주는 편의 래퍼(wrapper)입니다.
21 +
22 +명세 객체에 대한 자세한 정보는 [컴포넌트 명세와 생명주기](/react/docs/component-specs.ko-KR.html)를 참고하세요.
23 +
24 +
25 +### React.createElement
26 +
27 +```javascript
28 +ReactElement createElement(
29 + string/ReactClass type,
30 + [object props],
31 + [children ...]
32 +)
33 +```
34 +
35 +주어진 타입의 새 `ReactElement`를 만들고 리턴합니다. `type` 인자는 HTML 태그명 문자열 (예: 'div', 'span' 등) 또는 (`React.createClass`로 만든) `ReactClass`입니다.
36 +
37 +
38 +### React.createFactory
39 +
40 +```javascript
41 +factoryFunction createFactory(
42 + string/ReactClass type
43 +)
44 +```
45 +
46 +주어진 타입의 ReactElement를 만들어주는 함수를 리턴합니다. `React.createElement`와 마찬가지로 `type` 인자는 HTML 태그명 문자열 (예: 'div', 'span' 등) 또는 `ReactClass`입니다.
47 +
48 +
49 +### React.render
50 +
51 +```javascript
52 +ReactComponent render(
53 + ReactElement element,
54 + DOMElement container,
55 + [function callback]
56 +)
57 +```
58 +
59 +주어진 ReactElement를 `container` 인자에 넘어온 DOM 안에 렌더링하고 컴포넌트의 레퍼런스를 리턴합니다.
60 +
61 +어떤 ReactElement가 이미 `container`에 렌더링 된 적이 있다면, 그것을 업데이트한 뒤 React 컴포넌트의 최신 상태를 반영하기 위해 꼭 필요한 만큼만 DOM을 변경합니다.
62 +
63 +콜백 인자를 넘기면 컴포넌트가 렌더링되거나 업데이트 된 다음 호출됩니다.
64 +
65 +> 주의:
66 +>
67 +> `React.render()`는 넘어온 컨테이너 노드의 내용을 교체합니다.
68 +> 추후에 기존 자식들을 덮어쓰지 않고 이미 있는 DOM 노드에 컴포넌트를 삽입하는 것도 지원할 가능성이 있습니다.
69 +
70 +
71 +### React.unmountComponentAtNode
72 +
73 +```javascript
74 +boolean unmountComponentAtNode(DOMElement container)
75 +```
76 +
77 +DOM에 마운트된 React 컴포넌트를 제거하고 이벤트 핸들러 및 state를 정리합니다. 컨테이너에 마운트된 컴포넌트가 없는 경우에는 호출해도 아무 동작을 하지 않습니다. 컴포넌트가 마운트 해제된 경우 `true`를, 마운트 해제할 컴포넌트가 없으면 `false`를 리턴합니다.
78 +
79 +
80 +### React.renderToString
81 +
82 +```javascript
83 +string renderToString(ReactElement element)
84 +```
85 +
86 +주어진 ReactElement의 최초 HTML을 렌더링합니다. 이 함수는 서버에서만 사용해야 합니다. React가 HTML 문자열을 리턴합니다. HTML을 서버에서 생성하고 마크업을 최초 요청에 내려보내서, 페이지 로딩을 빠르게 하거나 검색 엔진이 크롤링할 수 있도록 하는 SEO 목적으로 이 메소드를 사용할 수 있습니다.
87 +
88 +또한 이 메소드로 서버에서 렌더링한 마크업을 포함한 노드에 `React.render()`를 호출하면, React는 마크업을 보존하고 이벤트 핸들러만 붙이므로 최초 로딩을 매우 빠르게 느껴지게 할 수 있습니다.
89 +
90 +
91 +### React.renderToStaticMarkup
92 +
93 +```javascript
94 +string renderToStaticMarkup(ReactElement element)
95 +```
96 +
97 +`renderToString`와 비슷하지만 `data-react-id`처럼 React에서 내부적으로 사용하는 추가적인 DOM 어트리뷰트를 만들지 않습니다. 추가적인 어트리뷰트를 제거하면 생성되는 마크업의 용량을 줄일 수 있기 때문에 React를 단순한 정적 페이지 생성기로 사용할 때 유용합니다.
98 +
99 +
100 +### React.isValidElement
101 +
102 +```javascript
103 +boolean isValidElement(* object)
104 +```
105 +
106 +주어진 객체가 ReactElement인지 확인합니다.
107 +
108 +
109 +### React.DOM
110 +
111 +`React.DOM`은 DOM 컴포넌트에 대해 `React.createElement`의 편의 래퍼(wrapper)를 제공합니다. JSX를 사용하지 않는 경우에만 사용하십시오. 예를 들어, `React.DOM.div(null, 'Hello World!')`와 같이 사용할 수 있습니다.
112 +
113 +
114 +### React.PropTypes
115 +
116 +`React.PropTypes`는 컴포넌트에 넘어오는 props가 올바른지 검사할 수 있는 컴포넌트의 `propTypes` 객체에 들어가는 타입을 가집니다. `propTypes`에 대한 자세한 정보는 [재사용 가능한 컴포넌트](/react/docs/reusable-components.ko-KR.html)를 참고하세요.
117 +
118 +
119 +### React.initializeTouchEvents
120 +
121 +```javascript
122 +initializeTouchEvents(boolean shouldUseTouch)
123 +```
124 +
125 +React의 이벤트 시스템이 모바일 기기의 터치 이벤트를 처리하도록 설정합니다.
126 +
127 +
128 +### React.Children
129 +
130 +`React.Children`은 불투명한 자료 구조인 `this.props.children`를 다룰 수 있는 유틸리티를 제공합니다.
131 +
132 +#### React.Children.map
133 +
134 +```javascript
135 +object React.Children.map(object children, function fn [, object context])
136 +```
137 +
138 +`children`의 바로 밑에 있는 모든 자식에 `fn`을 호출합니다. 이 때 `this`는 `context`로 설정됩니다. `children`이 중첩된 객체나 배열일 경우 그 안의 값을 순회합니다. 따라서 `fn`에 컨테이너 객체가 넘어가는 일은 일어나지 않습니다. `children`이 `null`이거나 `undefined`면 빈 객체 대신 `null` 또는 `undefined`를 리턴합니다.
139 +
140 +#### React.Children.forEach
141 +
142 +```javascript
143 +React.Children.forEach(object children, function fn [, object context])
144 +```
145 +
146 +`React.Children.map()`과 비슷하지만 객체를 리턴하지 않습니다.
147 +
148 +#### React.Children.count
149 +
150 +```javascript
151 +number React.Children.count(object children)
152 +```
153 +
154 +`children`에 들어있는 컴포넌트의 총 갯수를 리턴합니다. 이 갯수는 `map`이나 `forEach`에 넘긴 콜백이 호출되는 횟수와 동일합니다.
155 +
156 +#### React.Children.only
157 +
158 +```javascript
159 +object React.Children.only(object children)
160 +```
161 +
162 +`children`에 단 하나의 자식이 있을 때 그 자식을 리턴합니다. 그 밖의 경우에는 예외를 발생시킵니다.