diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:17 -0500 |
commit | da78a9e329e272dedb2400b79a3bdeebff387d47 (patch) | |
tree | e6ef8aa7c43556f55ddfe031a01cf0a8fa271bfe /files/ko/web/api/formdata | |
parent | 1109132f09d75da9a28b649c7677bb6ce07c40c0 (diff) | |
download | translated-content-da78a9e329e272dedb2400b79a3bdeebff387d47.tar.gz translated-content-da78a9e329e272dedb2400b79a3bdeebff387d47.tar.bz2 translated-content-da78a9e329e272dedb2400b79a3bdeebff387d47.zip |
initial commit
Diffstat (limited to 'files/ko/web/api/formdata')
-rw-r--r-- | files/ko/web/api/formdata/append/index.html | 90 | ||||
-rw-r--r-- | files/ko/web/api/formdata/delete/index.html | 70 | ||||
-rw-r--r-- | files/ko/web/api/formdata/entries/index.html | 70 | ||||
-rw-r--r-- | files/ko/web/api/formdata/formdata/index.html | 92 | ||||
-rw-r--r-- | files/ko/web/api/formdata/get/index.html | 74 | ||||
-rw-r--r-- | files/ko/web/api/formdata/getall/index.html | 74 | ||||
-rw-r--r-- | files/ko/web/api/formdata/has/index.html | 73 | ||||
-rw-r--r-- | files/ko/web/api/formdata/index.html | 82 | ||||
-rw-r--r-- | files/ko/web/api/formdata/keys/index.html | 70 | ||||
-rw-r--r-- | files/ko/web/api/formdata/set/index.html | 79 | ||||
-rw-r--r-- | files/ko/web/api/formdata/values/index.html | 70 |
11 files changed, 844 insertions, 0 deletions
diff --git a/files/ko/web/api/formdata/append/index.html b/files/ko/web/api/formdata/append/index.html new file mode 100644 index 0000000000..0f6ec0d5c8 --- /dev/null +++ b/files/ko/web/api/formdata/append/index.html @@ -0,0 +1,90 @@ +--- +title: FormData.append() +slug: Web/API/FormData/append +translation_of: Web/API/FormData/append +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p>{{domxref("FormData")}} 인터페이스의 <code><strong>append()</strong></code> 메서드는 <code>FormData</code> 객체의 기존 키에 새 값을 추가하거나, 키가 없는 경우 키를 추가합니다.</p> + +<p>{{domxref("FormData.set")}} 과 <code>append()</code> 의 차이점은 지정된 키가 이미 있으면, {{domxref("FormData.set")}} 은 모든 기존 값을 새 값으로 덮어쓰기를 합니다. 반면 <code>append()</code> 는 기존 값 집합의 끝에 새로운 값을 추가합니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<p>이 메서드에는 두 가지 버전이 있습니다: 매개변수가 두 개인 버전과 세 개인 버전입니다:</p> + +<pre class="brush: js">formData.append(name, value); +formData.append(name, value, filename);</pre> + +<h3 id="append()_Parameters" name="append()_Parameters">Parameters</h3> + +<dl> + <dt><code>name</code></dt> + <dd><code>value</code> 에 포함되는 데이터 필드의 이름입니다.</dd> + <dt><code>value</code></dt> + <dd>필드의 값입니다. {{domxref("USVString")}} 또는 {{domxref("Blob")}} ({{domxref("File")}}과 같은 sublcass를 포함하여) 일 수 있습니다.</dd> + <dt><code>filename </code>{{optional_inline}}</dt> + <dd>{{domxref("Blob")}} 또는 {{domxref("File")}} 이 두 번째 매개 변수로 전달될 때, 서버에 리포트하는 파일 이름(a {{domxref("USVString")}})입니다. {{domxref("Blob")}} 객체의 기본 파일 이름은 "blob" 입니다. {{domxref("File")}} 객체의 기본 파일 이름은 파일의 이름이 됩니다.</dd> +</dl> + +<div class="note"> +<p><strong>메모:</strong> {{domxref("Blob")}} 을 <code>FormData</code> 객체에 추가 할 데이터로 지정하면, "Content-Disposition" 헤더에서 서버에 리포트하는 파일 이름이 브라우저마다 다를 수 있습니다.</p> +</div> + +<h3 id="Returns">Returns</h3> + +<p>Void.</p> + +<h2 id="Example">Example</h2> + +<p>다음 코드를 따라 빈 <code>FormData</code> 객체를 만듭니다:</p> + +<pre class="brush: js">var formData = new FormData(); // Currently empty</pre> + +<p>{{domxref("FormData.append")}}를 사용하여 key/value 쌍을 추가할 수 있습니다:</p> + +<pre class="brush: js">formData.append('username', 'Chris'); +formData.append('userpic', myFileInput.files[0], 'chris.jpg');</pre> + +<p>일반 form 데이터와 마찬가지로 동일한 이름의 여러 값을 추가할 수 있습니다. 예를들면 (그리고 이름에 []를 추가하여 PHP의 명명 규칙과 호환이 가능합니다):</p> + +<pre class="brush: js">formData.append('userpic[]', myFileInput.files[0], 'chris1.jpg'); +formData.append('userpic[]', myFileInput.files[1], 'chris2.jpg');</pre> + +<p>이 기술을 사용하면 서버에 올라간 결과 데이터가 루프를 도는데 도움이 되는 구조이기 때문에, 이 기술을 사용하면 다중 -파일 업로드를 보다 쉽게 처리할 수 있습니다.</p> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata-append','append()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.append")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/delete/index.html b/files/ko/web/api/formdata/delete/index.html new file mode 100644 index 0000000000..c5f20c8d02 --- /dev/null +++ b/files/ko/web/api/formdata/delete/index.html @@ -0,0 +1,70 @@ +--- +title: FormData.delete() +slug: Web/API/FormData/delete +translation_of: Web/API/FormData/delete +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p>{{domxref("FormData")}} 인터페이스의 <code><strong>delete()</strong></code> 메서드는 <code>FormData</code> 객체에서 key와 그 값에 해당하는 것을 지웁니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="brush: js">formData.delete(name);</pre> + +<h3 id="append()_Parameters" name="append()_Parameters">Parameters</h3> + +<dl> + <dt><code>name</code></dt> + <dd>삭제할 key의 이름 입니다.</dd> +</dl> + +<h3 id="Returns">Returns</h3> + +<p>Void.</p> + +<h2 id="Example">Example</h2> + +<p>다음 코드를 따라 빈 <code>FormData</code> 객체를 만들고, form의 key/value 쌍을 미리 채웁니다:</p> + +<pre class="brush: js">var formData = new FormData(myForm);</pre> + +<p><code>delete()</code>를 사용하여 키와 값을 삭제할 수 있습니다:</p> + +<pre class="brush: js">formData.delete('username'); +</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata-delete','delete()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.delete")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/entries/index.html b/files/ko/web/api/formdata/entries/index.html new file mode 100644 index 0000000000..6f4f5b29d3 --- /dev/null +++ b/files/ko/web/api/formdata/entries/index.html @@ -0,0 +1,70 @@ +--- +title: FormData.entries() +slug: Web/API/FormData/entries +translation_of: Web/API/FormData/entries +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p><code><strong>FormData.entries()</strong></code> 메서드는 이 객체에 포함된 모든 key/value 쌍을 통과하는 {{jsxref("Iteration_protocols",'iterator')}} 를 반환합니다. 각 쌍의 key는 {{domxref("USVString")}} 객체입니다; value는 {{domxref("USVString")}} 또는 {{domxref("Blob")}} 중 하나입니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox">formData.entries();</pre> + +<h3 id="Return_value">Return value</h3> + +<p>{{jsxref("Iteration_protocols","iterator")}}를 리턴합니다.</p> + +<h2 id="Example">Example</h2> + +<pre class="brush: js;highlight:[7]">// Create a test FormData object +var formData = new FormData(); +formData.append('key1', 'value1'); +formData.append('key2', 'value2'); + +// Display the key/value pairs +for(var pair of formData.entries()) { + console.log(pair[0]+ ', '+ pair[1]); +} +</pre> + +<p>결과는 다음과 같습니다:</p> + +<pre>key1, value1 +key2, value2</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata','entries() (as iterator<>)')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.entries")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/formdata/index.html b/files/ko/web/api/formdata/formdata/index.html new file mode 100644 index 0000000000..5201383a98 --- /dev/null +++ b/files/ko/web/api/formdata/formdata/index.html @@ -0,0 +1,92 @@ +--- +title: FormData() +slug: Web/API/FormData/FormData +translation_of: Web/API/FormData/FormData +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p><code><strong>FormData()</strong></code> 생성자(Constructor)는 새로운 {{domxref("FormData")}}객체를 만듭니다.</p> + +<div class="note"> +<p><strong>메모</strong>: <a href="/ko/docs/Web/API/Web_Workers_API">웹워커(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="brush: js"><code>var formData = new FormData(</code><code>form</code><code>)</code></pre> + +<h3 id="Parameters" name="Parameters">Parameters</h3> + +<dl> + <dt><code>form </code>{{optional_inline}}</dt> + <dd>HTML {{HTMLElement("form")}} 요소 — 지정된 경우 {{domxref("FormData")}} 객체는 form의 현재 key/value 들로 채워집니다. key/value는 submit한 각 요소의 name property와 value를 사용합니다. 또한 파일 입력 내용을 인코딩합니다.</dd> +</dl> + +<h2 id="Example">Example</h2> + +<p>다음 코드는 빈 <code>FormData</code> 객체를 만듭니다:</p> + +<pre class="brush: js">var formData = new FormData(); // Currently empty</pre> + +<p>{{domxref("FormData.append")}}을 사용하여 key/value 쌍을 추가할 수 있습니다:</p> + +<pre class="brush: js">formData.append('username', 'Chris'); +</pre> + +<p>또는 <code>FormData</code> 객체를 만들 때 선택적으로 <code><em>form</em></code> argument를 지정할 수 있는데, 지정된 양식대로 value를 미리 채우는 것입니다:</p> + +<pre class="brush: html"><form id="myForm" name="myForm"> + <div> + <label for="username">Enter name:</label> + <input type="text" id="username" name="username"> + </div> + <div> + <label for="useracc">Enter account number:</label> + <input type="text" id="useracc" name="useracc"> + </div> + <div> + <label for="userfile">Upload file:</label> + <input type="file" id="userfile" name="userfile"> + </div> +<input type="submit" value="Submit!"> +</form> +</pre> + +<div class="note"> +<p><strong>메모</strong>: 모든 입력 요소는 'name' 속성(attribute) 을 갖고 있습니다. 나중에 value에 접근하는데 필요합니다.</p> +</div> + +<pre class="brush: js">var myForm = document.getElementById('myForm'); +formData = new FormData(myForm);</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata','FormData()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.FormData")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/get/index.html b/files/ko/web/api/formdata/get/index.html new file mode 100644 index 0000000000..b90a006387 --- /dev/null +++ b/files/ko/web/api/formdata/get/index.html @@ -0,0 +1,74 @@ +--- +title: FormData.get() +slug: Web/API/FormData/get +translation_of: Web/API/FormData/get +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p>{{domxref("FormData")}} 인터페이스의 <code><strong>get()</strong></code> 메서드는 <code>FormData</code> 객체에서 지정한 키와 연관된 첫 번째 값을 반환합니다. 값이 여러개이고, 모든 값을 원하면 이 메서드 대신 {{domxref("FormData.getAll()","getAll()")}} 메서드를 사용하십시오.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox">formData.get(name);</pre> + +<h3 id="append()_Parameters" name="append()_Parameters">Parameters</h3> + +<dl> + <dt><code>name</code></dt> + <dd>검색하고 싶은 키의 이름을 나타내는 {{domxref("USVString")}} 입니다.</dd> +</dl> + +<h3 id="Return_value">Return value</h3> + +<p>값을 포함하는 {{domxref("FormDataEntryValue")}} 입니다.</p> + +<h2 id="Example">Example</h2> + +<p>다음 코드를 따라 빈 <code>FormData</code> 객체를 만듭니다:</p> + +<pre class="brush: js">var formData = new FormData();</pre> + +<p>{{domxref("FormData.append")}}를 사용하여 <code>username</code> 에 두 개의 값을 추가합니다:</p> + +<pre class="brush: js">formData.append('username', 'Chris'); +formData.append('username', 'Bob');</pre> + +<p><code>get()</code> 함수를 사용하면 <code>username</code> 의 첫 번째 value만 반환합니다:</p> + +<pre class="brush: js">formData.get('username'); // Returns "Chris"</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata-get','get()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.get")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/getall/index.html b/files/ko/web/api/formdata/getall/index.html new file mode 100644 index 0000000000..6de19365e5 --- /dev/null +++ b/files/ko/web/api/formdata/getall/index.html @@ -0,0 +1,74 @@ +--- +title: FormData.getAll() +slug: Web/API/FormData/getAll +translation_of: Web/API/FormData/getAll +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p>{{domxref("FormData")}} 인터페이스의 <code><strong>getAll()</strong></code> 메서드는 <code>FormData</code> 객체에서 지정된 키와 연관된 모든 값을 반환합니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="brush: js">formData.getAll(name);</pre> + +<h3 id="append()_Parameters" name="append()_Parameters">Parameters</h3> + +<dl> + <dt><code>name</code></dt> + <dd>검색하고 싶은 키의 이름을 나타내는 {{domxref("USVString")}} 입니다.</dd> +</dl> + +<h3 id="Returns">Returns</h3> + +<p>{{domxref("FormDataEntryValue")}}의 배열입니다.</p> + +<h2 id="Example">Example</h2> + +<p>다음 코드를 따라 빈 <code>FormData</code> 객체를 만듭니다:</p> + +<pre class="brush: js">var formData = new FormData();</pre> + +<p>{{domxref("FormData.append")}}를 사용하여 <code>username</code> 에 두 개의 값을 추가합니다:</p> + +<pre class="brush: js">formData.append('username', 'Chris'); +formData.append('username', 'Bob');</pre> + +<p><code>getAll()</code> 함수는 <code>username</code> 의 값들을 배열로 반환합니다:</p> + +<pre class="brush: js">formData.getAll('username'); // Returns ["Chris", "Bob"]</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata-getall','getAll()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.getAll")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/has/index.html b/files/ko/web/api/formdata/has/index.html new file mode 100644 index 0000000000..8340fee6af --- /dev/null +++ b/files/ko/web/api/formdata/has/index.html @@ -0,0 +1,73 @@ +--- +title: FormData.has() +slug: Web/API/FormData/has +translation_of: Web/API/FormData/has +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p>{{domxref("FormData")}} 인터페이스의 <code><strong>has()</strong></code> 메서드는 <code>FormData</code> 객체에 특정 키가 들어 있는지 여부를 나타내는 boolean 을 반환합니다.</p> + +<div class="note"> +<p><strong>Note</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="brush: js">formData.has(name);</pre> + +<h3 id="append()_Parameters" name="append()_Parameters">Parameters</h3> + +<dl> + <dt><code>name</code></dt> + <dd>테스트 하려는 키의 이름을 나타내는 {{domxref("USVString")}} 입니다.</dd> +</dl> + +<h3 id="Returns">Returns</h3> + +<p>{{domxref("Boolean")}}.</p> + +<h2 id="Example">Example</h2> + +<p>다음 코드를 따라 빈 <code>FormData</code> 객체를 만듭니다:</p> + +<pre class="brush: js">var formData = new FormData();</pre> + +<p>다음 스니펫(코드 조각)은 <code>FormData</code> 객체안에 <code>username</code> 이 존재하는지 테스트한 결과와, {{domxref("FormData.append")}}를 사용하여 <code>username</code> 에 값을 추가한 이후의 결과를 보여줍니다 :</p> + +<pre class="brush: js">formData.has('username'); // Returns false +formData.append('username', 'Chris'); +formData.has('username'); // Returns true + +</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata-has','has()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.has")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/index.html b/files/ko/web/api/formdata/index.html new file mode 100644 index 0000000000..212d19e6c2 --- /dev/null +++ b/files/ko/web/api/formdata/index.html @@ -0,0 +1,82 @@ +--- +title: FormData +slug: Web/API/FormData +tags: + - API + - 인터페이스 + - 폼 데이터 +translation_of: Web/API/FormData +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p><code><strong>FormData</strong></code><strong> </strong>인터페이스는 form 필드와 그 값을 나타내는 일련의 key/value 쌍을 쉽게 생성할 수 있는 방법을 제공합니다. 또한 {{domxref("XMLHttpRequest.send()")}} 메서드를 사용하여 쉽게 전송할 수 있습니다. 인코딩 타입이 <code>"multipart/form-data"</code>로 설정된 경우, form에서 사용하는 것과 동일한 포맷을 사용해야 합니다.</p> + +<p>간단한 <code>GET</code> 전송을 사용하는 경우에는 {{HTMLElement("form")}} 이 수행하는 방식으로 쿼리 매개 변수를 생성할 수 있습니다. 이 경우 {{domxref("URLSearchParams")}} 생성자에 직접 전달할 수 있습니다.</p> + +<p><code>FormData</code> 를 구현하는 객체는 {{domxref('FormData.entries()', 'entries()')}} 대신 {{jsxref("Statements/for...of", "for...of")}} 구조를 직접 사용할 수 있습니다. <code>for (var p of myFormData)</code> 는 <code>for (var p of myFormData.entries())</code> 와 같습니다.</p> + +<div class="note"> +<p><strong>주의</strong>: 이 기능은 <a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="생성자">생성자</h2> + +<dl> + <dt>{{domxref("FormData.FormData","FormData()")}}</dt> + <dd>새로운 <code>FormData</code> 객체를 생성합니다.</dd> +</dl> + +<h2 id="메소드">메소드</h2> + +<dl> + <dt>{{domxref("FormData.append()")}}</dt> + <dd>FormData 객체안에 이미 키가 존재하면 그 키에 새로운 값을 추가하고, 키가 없으면 추가합니다.</dd> + <dt>{{domxref("FormData.delete()")}}</dt> + <dd>FormData 객체로부터 키/밸류 쌍을 삭제합니다.</dd> + <dt>{{domxref("FormData.entries()")}}</dt> + <dd>이 객체에 담긴 모든 키/밸류 쌍을 순회할 수 있는 {{jsxref("Iteration_protocols","iterator")}}를 반환합니다.</dd> + <dt>{{domxref("FormData.get()")}}</dt> + <dd><code>FormData</code> 객체 내의 값들 중 주어진 키와 연관된 첫번째 값을 반환합니다.</dd> + <dt>{{domxref("FormData.getAll()")}}</dt> + <dd><code>FormData</code> 객체 내의 값들 중 주어진 키와 연관된 모든 값이 담긴 배열을 반환합니다.</dd> + <dt>{{domxref("FormData.has()")}}</dt> + <dd><code>FormData</code> 객체에 특정 키가 포함되어 있는지 여부를 나타내는 boolean 을 반환합니다.</dd> + <dt>{{domxref("FormData.keys()")}}</dt> + <dd>이 객체에 담긴 모든 키/벨류 쌍들의 모든 키들을 순회 할 수 있는 {{jsxref("Iteration_protocols", "iterator")}}를 반환합니다.</dd> + <dt>{{domxref("FormData.set()")}}</dt> + <dd><code>FormData</code> 객체 내에 있는 기존 키에 새 값을 설정하거나, 존재하지 않을 경우 키/밸류 쌍을 추가합니다.</dd> + <dt>{{domxref("FormData.values()")}}</dt> + <dd>이 객체에 포함된 모든 밸류를 통과하는 {{jsxref("Iteration_protocols", "iterator")}}를 반환합니다.</dd> +</dl> + +<h2 id="명세">명세</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#interface-formdata','FormData')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td>FormData defined in XHR spec</td> + </tr> + </tbody> +</table> + +<h2 id="브라우저_호환성">브라우저 호환성</h2> + + + +<p>{{Compat("api.FormData")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/ko/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/ko/docs/Web/API/FormData/Using_FormData_Objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/keys/index.html b/files/ko/web/api/formdata/keys/index.html new file mode 100644 index 0000000000..f2f1111e4d --- /dev/null +++ b/files/ko/web/api/formdata/keys/index.html @@ -0,0 +1,70 @@ +--- +title: FormData.keys() +slug: Web/API/FormData/keys +translation_of: Web/API/FormData/keys +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p><code><strong>FormData.keys()</strong></code> 메서드는 이 객체에 포함된 모든 키를 통과하는 {{jsxref("Iteration_protocols",'iterator')}} 를 반환합니다. 키는 {{domxref("USVString")}} 객체입니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/en-US/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox">formData.keys();</pre> + +<h3 id="Return_value">Return value</h3> + +<p>{{jsxref("Iteration_protocols","iterator")}}를 반환합니다.</p> + +<h2 id="Example">Example</h2> + +<pre class="brush: js;highlight:[7]">// Create a test FormData object +var formData = new FormData(); +formData.append('key1', 'value1'); +formData.append('key2', 'value2'); + +// Display the keys +for (var key of formData.keys()) { + console.log(key); +} +</pre> + +<p>결과는 다음과 같습니다:</p> + +<pre>key1 +key2</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata','keys() (as iterator<>)')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.keys")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/set/index.html b/files/ko/web/api/formdata/set/index.html new file mode 100644 index 0000000000..1f95283af5 --- /dev/null +++ b/files/ko/web/api/formdata/set/index.html @@ -0,0 +1,79 @@ +--- +title: FormData.set() +slug: Web/API/FormData/set +translation_of: Web/API/FormData/set +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p>{{domxref("FormData")}} 인터페이스의 <code><strong>set()</strong></code> 메서드는 <code>FormData</code> 객체 내에 있는 기존 키에 새 값을 설정하거나, 존재하지 않을 경우 key/value을 추가합니다.</p> + +<p><code>set()</code> 과 {{domxref("FormData.append")}} 의 차이점은 지정된 키가 이미 존재할 경우에, <code>set()</code> 은 모든 기존 값들을 새로운 값으로 덮어쓰기하는 반면, {{domxref("FormData.append")}} 는 기존 값의 끝에 새 값을 추가합니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/en-US/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<p>이 메서드에는 두 가지 버전이 있습니다: 매개변수가 두 개인 버전과 세 개인 버전입니다:</p> + +<pre class="brush: js">formData.set(name, value); +formData.set(name, value, filename);</pre> + +<h4 id="append()_Parameters" name="append()_Parameters">Parameters</h4> + +<dl> + <dt><code>name</code></dt> + <dd><code>value</code> 에 포함되는 데이터 필드의 이름입니다.</dd> + <dt><code>value</code></dt> + <dd>필드의 값입니다. 파라미터가 두 개인 버전에서는 {{domxref("USVString")}}이고, 그렇지 않은 경우 문자열로 변환됩니다. 파라미터가 세 개인 버전에서는 {{domxref("Blob")}}, {{domxref("File")}}, {{domxref("USVString")}}이 될 수 있습니다. 이들 중 어느것도 지정되지 않으면 값은 문자열로 변환됩니다.</dd> + <dt><code>filename </code>{{optional_inline}}</dt> + <dd>{{domxref("Blob")}} 또는 {{domxref("File")}} 이 두 번째 매개 변수로 전달될 때, 서버에 리포트하는 파일 이름(a {{domxref("USVString")}})입니다. {{domxref("Blob")}} 객체의 기본 파일 이름은 "blob"입니다.</dd> +</dl> + +<div class="note"> +<p><strong>메모:</strong> {{domxref("Blob")}} 을 <code>FormData</code> 객체에 추가할 데이터로 지정하면, "Content-Disposition" 헤더에서 서버에 리포트하는 파일 이름이 브라우저마다 다를 수 있습니다.</p> +</div> + +<h2 id="Example">Example</h2> + +<p>다음 코드를 따라 빈 <code>FormData</code> 객체를 만듭니다:</p> + +<pre class="brush: js">var formData = new FormData(); // Currently empty</pre> + +<p>{{domxref("FormData.set")}}를 사용하여 key/value 쌍을 추가할 수 있습니다::</p> + +<pre class="brush: js">formData.set('username', 'Chris'); +formData.set('userpic', myFileInput.files[0], 'chris.jpg');</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata-set','set()')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.set")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> diff --git a/files/ko/web/api/formdata/values/index.html b/files/ko/web/api/formdata/values/index.html new file mode 100644 index 0000000000..9a28786ad6 --- /dev/null +++ b/files/ko/web/api/formdata/values/index.html @@ -0,0 +1,70 @@ +--- +title: FormData.values() +slug: Web/API/FormData/values +translation_of: Web/API/FormData/values +--- +<p>{{APIRef("XMLHttpRequest")}}</p> + +<p><code><strong>FormData.values()</strong></code> 메서드는 이 객체에 포함 된 모든 value를 통과하는 {{jsxref("Iteration_protocols",'iterator')}}를 반환합니다. value는 {{domxref("USVString")}} 또는 {{domxref("Blob")}} 객체입니다.</p> + +<div class="note"> +<p><strong>메모</strong>: 이 메서드는 웹워커<a href="/ko/docs/Web/API/Web_Workers_API">(Web Workers)</a>에서도 사용할 수 있습니다.</p> +</div> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox">formData.values();</pre> + +<h3 id="Return_value">Return value</h3> + +<p>{{jsxref("Iteration_protocols","iterator")}}를 반환합니다.</p> + +<h2 id="Example">Example</h2> + +<pre class="brush: js;highlight:[7]">// Create a test FormData object +var formData = new FormData(); +formData.append('key1', 'value1'); +formData.append('key2', 'value2'); + +// Display the values +for (var value of formData.values()) { + console.log(value); +} +</pre> + +<p>결과는 다음과 같습니다:</p> + +<pre>value1 +value2</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('XMLHttpRequest','#dom-formdata','values() (as iterator<>)')}}</td> + <td>{{Spec2('XMLHttpRequest')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.FormData.values")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("XMLHTTPRequest")}}</li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li> + <li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Using FormData objects</a></li> + <li>{{HTMLElement("Form")}}</li> +</ul> |