files/de/web/api/htmltableelement/createcaption/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

---
title: HTMLTableElement.createCaption()
slug: Web/API/HTMLTableElement/createCaption
tags:
  - API
  - DOM
  - HTML DOM
  - HTMLTableElement
  - Method
  - Reference
translation_of: Web/API/HTMLTableElement/createCaption
---
<div>{{APIRef("HTML DOM")}}</div>

<p>Die <code><strong>HTMLTableElement.createCaption()</strong></code> Methode gibt das {{HtmlElement("caption")}} Element zurück, das einer {{HtmlElement("table")}} zugeordnet ist. Wenn in der Tabelle noch kein <code>&lt;caption&gt;</code> Element existiert, wird es durch diese Methode erzeugt und dann zurückgegeben..</p>

<div class="blockIndicator note">
<p><strong>Anmerkung:</strong> Wenn noch keine Überschrift vorhanden ist, fügt <code>createCaption()</code> sie direkt in die Tabelle ein. Die Überschrift muss nicht eigens hinzugefügt werden, wie man es tun müsste, wenn man das <code>&lt;caption&gt;</code> Element mittels {{domxref("Document.createElement()")}} erzeugt hätte.</p>
</div>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox notranslate"><em>HTMLTableCaptionElement</em> = <em>table</em>.createCaption();</pre>

<h3 id="Rückgabewert">Rückgabewert</h3>

<p>{{domxref("HTMLTableCaptionElement")}}</p>

<h2 id="Beispiel">Beispiel</h2>

<p>Dieses Beispiel verwendet JavaScript, um eine Tabelle um eine Überschrift zu erweitern.</p>

<h3 id="HTML">HTML</h3>

<pre class="brush: html notranslate">&lt;table&gt;
  &lt;tr&gt;&lt;td&gt;Cell 1.1&lt;/td&gt;&lt;td&gt;Cell 1.2&lt;/td&gt;&lt;td&gt;Cell 1.3&lt;/td&gt;&lt;/tr&gt;
  &lt;tr&gt;&lt;td&gt;Cell 2.1&lt;/td&gt;&lt;td&gt;Cell 2.2&lt;/td&gt;&lt;td&gt;Cell 2.3&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</pre>

<h3 id="JavaScript">JavaScript</h3>

<pre class="brush: js; highlight:[2] notranslate">let table = document.querySelector('table');
let caption = table.createCaption();
caption.textContent = 'Diese Überschrift wurde mit JavaScript erzeugt!';</pre>

<h3 id="Ergebnis">Ergebnis</h3>

<p>{{EmbedLiveSample("Beispiel")}}</p>

<h2 id="Specification" name="Specification">Spezifikationen</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', '#dom-table-createcaption', 'HTMLTableElement: createCaption')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Browserkompatibilität">Browserkompatibilität</h2>

<div>


<p>{{Compat("api.HTMLTableElement.createCaption")}}</p>
</div>