diff options
Diffstat (limited to 'files/ko/archive/mozilla/firefox/using_microformats/index.html')
| -rw-r--r-- | files/ko/archive/mozilla/firefox/using_microformats/index.html | 144 |
1 files changed, 144 insertions, 0 deletions
diff --git a/files/ko/archive/mozilla/firefox/using_microformats/index.html b/files/ko/archive/mozilla/firefox/using_microformats/index.html new file mode 100644 index 0000000000..b7fcdf224f --- /dev/null +++ b/files/ko/archive/mozilla/firefox/using_microformats/index.html @@ -0,0 +1,144 @@ +--- +title: Using microformats +slug: Archive/Mozilla/Firefox/Using_microformats +tags: + - Firefox 3 + - Microformats +translation_of: Archive/Mozilla/Firefox/Using_microformats +--- +<p>{{ Fx_minversion_header(3) }} +</p><p>마이크로포맷(Microformats)을 이용하면 문서 자체를 분석하는 방법을 알아야 할 필요없이 페이지의 정보에 대한 요약을 표시할 수 있도록 웹 사이트가 의미 데이터(semantic data)를 브라우저에 제공할 수 있습니다. Firefox 3는 마이크로포맷에 대한 접근을 제공하는 전역 <code>Microformats</code> 개체를 구현합니다. 이 개체와 API를 이용하면 마이크로포맷을 쉽게 찾고 읽을 수 있습니다. +</p> +<h2 id=".EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7_API_.EB.A1.9C.EB.93.9C.ED.95.98.EA.B8.B0" name=".EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7_API_.EB.A1.9C.EB.93.9C.ED.95.98.EA.B8.B0">마이크로포맷 API 로드하기</h2> +<p><code>Microformats</code> 개체는 Firefox 3에 추가된 새로운 자바스크립트 로더를 이용하여 생성합니다. API를 사용하려면 먼저 개체를 로드해야 합니다: +</p> +<pre class="eval"><span class="nowiki">Components.utils.import("resource://gre/modules/Microformats.js");</span> +</pre> +<p>마이크로포맷 API를 로드하고 나면 아래에 나열한 메소드를 이용하여 마이크로포맷을 다룰 수 있습니다. 마이크로포맷을 파싱하는 방법에 대한 정보는 <a href="ko/Parsing_microformats_in_JavaScript">Parsing microformats in JavaScript</a>를 참고하십시오. +</p> +<h2 id=".EB.AF.B8.EB.A6.AC_.EC.A0.95.EC.9D.98.EB.90.9C_.EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7" name=".EB.AF.B8.EB.A6.AC_.EC.A0.95.EC.9D.98.EB.90.9C_.EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7">미리 정의된 마이크로포맷</h2> +<p>Firefox 3는 몇 가지 일반적인 마이크로포맷을 구현한 정의를 제공합니다. +</p> +<dl><dt><code><a href="ko/The_adr_microformat">adr</a></code> +</dt><dd>주소를 표시합니다. +</dd><dt><code><a href="ko/The_geo_microformat">geo</a></code> +</dt><dd>위도와 경도를 이용한 지리적 위치를 표시합니다. +</dd><dt><code><a href="ko/The_hCard_microformat">hCard</a></code> +</dt><dd>사람에 대한 연락 정보를 표시합니다. +</dd><dt><code><a href="ko/The_hCalendar_microformat">hCalendar</a></code> +</dt><dd>달력의 일정 항목을 표시합니다. +</dd><dt><code><a href="ko/The_tag_microformat">tag</a></code> +</dt><dd>다른 마이크로포맷에 태그를 추가하는데 사용합니다. +</dd></dl> +<h2 id=".EB.A9.94.EC.86.8C.EB.93.9C" name=".EB.A9.94.EC.86.8C.EB.93.9C">메소드</h2> +<h3 id="add.28.29" name="add.28.29">add()</h3> +<p>마이크로포맷 모듈에 새로운 마이크로포맷을 추가합니다. +</p><p>{{ Note("지정한 이름을 가진 마이크로포맷이 이미 존재하면 새로운 것으로 바뀝니다.") }} +</p> +<pre class="eval">add(name, definition); +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98">매개변수</h6> +<dl><dt><tt>name</tt> +</dt><dd>마이크로포맷 모듈에 추가하려는 마이크로포맷의 이름. +</dd><dt><tt>definition</tt> +</dt><dd>마이크로포맷을 기술하는 자바스크립트 구조. 자세한 사항은 <a href="ko/Describing_microformats_in_JavaScript">Describing microformats in JavaScript</a>를 참고. +</dd></dl> +<h3 id="count.28.29" name="count.28.29">count()</h3> +<p>지정한 조건을 만족하는 문서에 있는 마이크로포맷의 개수를 구합니다. +</p> +<pre class="eval">numMicroformats = Microformats.count(name, rootElement, recurseFrames); +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_2" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_2">매개변수</h6> +<dl><dt><tt>name</tt> +</dt><dd>검색하려는 마이크로포맷의 이름 +</dd><dt><tt>rootElement</tt> +</dt><dd>검색을 시작할 DOM 요소. 전체 문서에서 검색하려면 <code>content.document</code>를 명시해야 합니다. +</dd><dt><tt>options</tt> +</dt><dd>선택사항. 아래 플래그를 포함하는 자바스크립트 개체: +</dd></dl> +<blockquote> +<dl><dt><tt>recurseExternalFrames</tt> +</dt><dd><code>true</code>이면 자식 프레임을 검색에 포함. 기본 값은 <code>true</code>. +</dd><dt><tt>showHidden</tt> +</dt><dd><code>true</code>이면 숨겨진 마이크로포맷을 추가하고 그렇지 않으면 생략. 기본 값은 <code>false</code>. +</dd><dt><tt>debug</tt> +</dt><dd>디버그 모드를 사용하려면 <code>true</code>로 지정하고 그렇지 않으면 <code>false</code>로 지정. 기본 값은 <code>false</code>.</dd></dl></blockquote> <h6 id=".EB.B0.98.ED.99.98_.EA.B0.92" name=".EB.B0.98.ED.99.98_.EA.B0.92">반환 값</h6> +<p>지정한 조건을 만족하는 마이크로포맷 개수를 가리키는 정수 값. +</p> +<h3 id="debug.28.29" name="debug.28.29">debug()</h3> +<p>마이크로포맷 개체를 설명하는 문자열을 반환합니다. +</p><p>{{ Note("마이크로포맷 개체에 대해 <code>debug()</code>를 호출할 수 있습니다: 이 메소드 대신 <code>microformatObject.debug()</code>를 이용할 수도 있습니다.") }} +</p> +<pre class="eval">dumpString = debug(microformatObject) +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_3" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_3">매개변수</h6> +<dl><dt><tt>microformatObject</tt> +</dt><dd>정보를 표시할 마이크로포맷 개체. +</dd></dl> +<h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_2" name=".EB.B0.98.ED.99.98_.EA.B0.92_2">반환 값</h6> +<p>지정한 마이크로포맷 개체의 내용을 설명하는 문자열. +</p> +<h3 id="get.28.29" name="get.28.29">get()</h3> +<p>지정한 조건에 따라 검색한 마이크로포맷에 해당하는 마이크로포맷 개체의 배열을 반환합니다. +</p> +<pre class="eval">microformatsArray = Microformats.get(name, rootElement, options, targetArray); +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_4" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_4">매개변수</h6> +<dl><dt><tt>name</tt> +</dt><dd>검색하려는 마이크로포맷의 이름 +</dd><dt><tt>rootElement</tt> +</dt><dd>검색을 시작할 DOM 요소. 전체 문서에서 검색하려면 <code>content.document</code>를 명시해야 합니다. +</dd><dt><tt>options</tt> +</dt><dd>선택사항. 아래 플래그를 포함하는 자바스크립트 개체: +</dd></dl> +<blockquote> +<dl><dt><tt>recurseExternalFrames</tt> +</dt><dd><code>true</code>이면 자식 프레임을 검색에 포함. 기본 값은 <code>true</code>. +</dd><dt><tt>showHidden</tt> +</dt><dd><code>true</code>이면 숨겨진 마이크로포맷을 추가하고 그렇지 않으면 생략. 기본 값은 <code>false</code>. +</dd><dt><tt>debug</tt> +</dt><dd>디버그 모드를 사용하려면 <code>true</code>로 지정하고 그렇지 않으면 <code>false</code>로 지정. 기본 값은 <code>false</code>.</dd></dl></blockquote> <dl><dt><tt>targetArray</tt> +</dt><dd>선택사항. 검색 결과를 추가할 마이크로포맷 개체의 배열. +</dd></dl> <h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_3" name=".EB.B0.98.ED.99.98_.EA.B0.92_3">반환 값</h6> +<p>검색 조건을 만족하는 마이크로포맷 개체의 새로운 배열, 혹은 발견한 마이크로포맷 개체를 추가한 <tt>microformats</tt>에서 지정한 배열. +</p> +<h3 id="getNamesFromNode.28.29" name="getNamesFromNode.28.29">getNamesFromNode()</h3> +<p>지정한 마이크로포맷 노드에 해당하는 공백으로 구별되는 마이크로포맷 이름의 목록을 반환합니다. +</p> +<pre class="eval">nameList = Microformats.getNamesFromNode(node); +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_5" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_5">매개변수</h6> +<dl><dt><tt>node</tt> +</dt><dd>마이크로포맷 이름 목록을 구할 노드 +</dd></dl> +<h6 id="Return_value" name="Return_value">Return value</h6> +<p>지정한 노드가 마이크로포맷인 경우 노드에 해당하는 모든 마이크로포맷의 이름을 공백으로 구별하여 나열하는 문자열. 해당 노드가 마이크로포맷이 아닌 경우에는 아무것도 반환하지 않음. +</p> +<h3 id="getParent.28.29" name="getParent.28.29">getParent()</h3> +<p>지정한 마이크로포맷이나 마이크로포맷 자식의 부모 노드를 반환합니다. +</p> +<pre class="eval">parentNode = Microformats.getParent(node); +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_6" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_6">매개변수</h6> +<dl><dt><tt>node</tt> +</dt><dd>부모 노드를 구할 노드 +</dd></dl> +<h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_4" name=".EB.B0.98.ED.99.98_.EA.B0.92_4">반환 값</h6> +<p>지정한 노드의 부모. 지정한 노드가 마이크로포맷이 아니거나 마이크로포맷의 자식이 아닌 경우에는 아무것도 반환하지 않음. +</p> +<h3 id="isMicroformat.28.29" name="isMicroformat.28.29">isMicroformat()</h3> +<p>지정한 DOM 노드가 마이크로포맷인지 구별합니다. +</p> +<pre class="eval">flag = Microformats.isMicroformat(node); +</pre> +<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_7" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_7">매개변수</h6> +<dl><dt><tt>node</tt> +</dt><dd>마이크로포맷 여부를 확인할 DOM 노드. +</dd></dl> +<h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_5" name=".EB.B0.98.ED.99.98_.EA.B0.92_5">반환 값</h6> +<p>노드가 마이크로포맷이면 <code>true</code>, 그렇지 않으면 <code>false</code>. +</p><p>{{ Note("만약 노드가 마이크로포맷의 자식이면 이 메소드는 <code>true</code>를 반환하지 <i>않습니다</i>.") }} +</p> +<div class="noinclude"> +</div> +{{ languages( { "en": "en/Using_microformats", "fr": "fr/Utilisation_de_microformats", "ja": "ja/Using_microformats", "pl": "pl/Zastosowanie_mikroformat\u00f3w" } ) }} |