The HTMLTableElement.createCaption()
method returns the <caption>
element associated with a given <table>
. If no <caption>
element exists on the table, this method creates it, and then returns it.
Note: If no caption exists, createCaption()
inserts a new caption directly into the table. The caption does not need to be added separately as would be the case if Document.createElement()
had been used to create the new <caption>
element.
Syntax
HTMLTableElement = table.createCaption();
Return value
Example
This example uses JavaScript to add a caption to a table that initially lacks one.
HTML
<table>
<tr><td>Cell 1.1</td><td>Cell 1.2</td><td>Cell 1.3</td></tr>
<tr><td>Cell 2.1</td><td>Cell 2.2</td><td>Cell 2.3</td></tr>
</table>
JavaScript
let table = document.querySelector('table'); let caption = table.createCaption(); caption.textContent = 'This caption was created by JavaScript!';
Result
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living StandardThe definition of 'HTMLTableElement: createCaption' in that specification. | Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
createCaption
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
Full support Yes |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
? |
Firefox Android
Full support Yes |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
? |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
HTMLTableElement.createCaption() by Mozilla Contributors is licensed under CC-BY-SA 2.5.