HTMLTableColElement: span property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{ APIRef("HTML DOM") }}
The **span** property of the {{domxref("HTMLTableColElement")}} interface represents the number of columns this {{htmlelement("col")}} or {{htmlelement("colgroup")}} must span; this lets the column occupy space across multiple columns of the table. It reflects the [span](/en-US/docs/Web/HTML/Reference/Elements/col#span) attribute.
Value
A positive number representing the number of columns.
توجه: When setting a new value, the value is _clamped_ to the nearest strictly positive number (up to 1000).
Examples
This example provides two buttons to modify the column span of the first cell of the body.
HTML
<table>
<colgroup>
<col />
<col span="2" class="multiColumn" />
</colgroup>
<thead>
<tr>
<th></th>
<th scope="col">C1</th>
<th scope="col">C2</th>
<th scope="col">C3</th>
<th scope="col">C4</th>
</tr>
</thead>
<tbody>
<tr>
<th scope="row">Row 1</th>
<td>cell</td>
<td>cell</td>
<td>cell</td>
<td>cell</td>
</tr>
</tbody>
</table>
<button id="increase">Increase column span</button>
<button id="decrease">Decrease column span</button>
<div>The first <col> spans <output>2</output> actual column(s).</div>CSS
.multiColumn {
background-color: #d7d9f2;
}JavaScript
// Obtain relevant interface elements
const col = document.querySelectorAll("col")[1];
const output = document.querySelectorAll("output")[0];
const increaseButton = document.getElementById("increase");
const decreaseButton = document.getElementById("decrease");
increaseButton.addEventListener("click", () => {
col.span += 1;
// Update the display
output.textContent = col.span;
});
decreaseButton.addEventListener("click", () => {
col.span -= 1;
// Update the display
output.textContent = col.span;
});Result
{{EmbedLiveSample("Examples", "100%", 175)}}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("HTMLTableCellElement.colSpan")}}