aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/htmltablerowelement
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
commit33058f2b292b3a581333bdfb21b8f671898c5060 (patch)
tree51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/api/htmltablerowelement
parent8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff)
downloadtranslated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip
initial commit
Diffstat (limited to 'files/ja/web/api/htmltablerowelement')
-rw-r--r--files/ja/web/api/htmltablerowelement/index.html169
-rw-r--r--files/ja/web/api/htmltablerowelement/insertcell/index.html61
-rw-r--r--files/ja/web/api/htmltablerowelement/rowindex/index.html57
3 files changed, 287 insertions, 0 deletions
diff --git a/files/ja/web/api/htmltablerowelement/index.html b/files/ja/web/api/htmltablerowelement/index.html
new file mode 100644
index 0000000000..9e5d3a8c9d
--- /dev/null
+++ b/files/ja/web/api/htmltablerowelement/index.html
@@ -0,0 +1,169 @@
+---
+title: HTMLTableRowElement
+slug: Web/API/HTMLTableRowElement
+tags:
+ - API
+translation_of: Web/API/HTMLTableRowElement
+---
+<div>{{ APIRef("HTML DOM") }}</div>
+
+<p>The <strong><code>HTMLTableRowElement</code></strong> interface provides special properties and methods (beyond the {{domxref("HTMLElement")}} interface it also has available to it by inheritance) for manipulating the layout and presentation of rows in an HTML table.</p>
+
+<h2 id="Properties" name="Properties">Properties</h2>
+
+<p><em>Inherits properties from its parent, {{domxref("HTMLElement")}}.</em></p>
+
+<dl>
+ <dt>{{domxref("HTMLTableRowElement.align")}} {{obsolete_inline}}</dt>
+ <dd>Is a {{domxref("DOMString")}} containing an enumerated value reflecting the {{htmlattrxref("align", "tr")}} attribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are <code>"left"</code>, <code>"right"</code>, and <code>"center"</code>.</dd>
+ <dt>{{domxref("HTMLTableRowElement.bgColor")}} {{obsolete_inline}}</dt>
+ <dd>Is a {{domxref("DOMString")}} containing the background color of the cells. It reflects the obsolete {{htmlattrxref("bgColor", "tr")}} attribute.</dd>
+ <dt>{{domxref("HTMLTableRowElement.cells")}} {{readonlyInline}}</dt>
+ <dd>Returns a live {{domxref("HTMLCollection")}} containing the cells in the row. The <code>HTMLCollection</code> is live and is automatically updated when cells are added or removed.</dd>
+ <dt>{{domxref("HTMLTableRowElement.ch")}} {{obsolete_inline}}</dt>
+ <dd>Is a {{domxref("DOMString")}} containing one single character. This character is the one to align all the cell of a column on. It reflects the {{htmlattrxref("char", "tr")}} and default to the decimal points associated with the language, e.g. <code>'.'</code> for English, or <code>','</code> for French. This property was optional and was not very well supported.</dd>
+ <dt>{{domxref("HTMLTableRowElement.chOff")}} {{obsolete_inline}}</dt>
+ <dd>Is a {{domxref("DOMString")}} containing a integer indicating how many characters must be left at the right (for left-to-right scripts; or at the left for right-to-left scripts) of the character defined by <code>HTMLTableRowElement.ch</code>. This property was optional and was not very well supported.</dd>
+ <dt>{{domxref("HTMLTableRowElement.rowIndex")}} {{readonlyInline}}</dt>
+ <dd>Returns a <code>long</code> value which gives the logical position of the row within the entire table. If the row is not part of a table, returns <code>-1</code>.</dd>
+ <dt>{{domxref("HTMLTableRowElement.sectionRowIndex")}} {{readonlyInline}}</dt>
+ <dd>Returns a <code>long</code> value which gives the logical position of the row within the table section it belongs to. If the row is not part of a section, returns <code>-1</code>.</dd>
+ <dt>{{domxref("HTMLTableRowElement.vAlign")}} {{obsolete_inline}}</dt>
+ <dd>Is a {{domxref("DOMString")}} representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the {{htmlattrxref("valign", "tr")}} attribute and can have one of the following values: <code>"top"</code>, <code>"middle"</code>, <code>"bottom"</code>, or <code>"baseline"</code>.</dd>
+</dl>
+
+<h2 id="Methods" name="Methods">Methods</h2>
+
+<p><em>Inherits methods from its parent, {{domxref("HTMLElement")}}</em>.</p>
+
+<dl>
+ <dt>{{domxref("HTMLTableRowElement.deleteCell()")}}</dt>
+ <dd>Removes the cell at the given position in the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than <code>0</code>, it raises a {{domxref("DOMException")}} with the <code>IndexSizeError</code> value.</dd>
+ <dt>{{domxref("HTMLTableRowElement.insertCell()")}}</dt>
+ <dd>Inserts a new cell just before the given position in the row. If the given position is not given or is <code>-1</code>, it appends the cell to the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than <code>-1</code>, it raises a {{domxref("DOMException")}} with the <code>IndexSizeError</code> value. Returns a reference to a <a href="/en-US/docs/Web/API/HTMLTableCellElement">HTMLTableCellElement [en-US]</a>.</dd>
+</dl>
+
+<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('HTML WHATWG', "tabular-data.html#the-tr-element", "HTMLTableRowElement")}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>No change from {{SpecName("HTML5 W3C")}}.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML5 W3C', "tabular-data.html#the-tr-element", "HTMLTableRowElement")}}</td>
+ <td>{{Spec2('HTML5 W3C')}}</td>
+ <td>The parameter of <code>insertCell</code> is now optional and default to <code>-1</code>.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('DOM2 HTML', 'html.html#ID-6986576', 'HTMLTableRowElement')}}</td>
+ <td>{{Spec2('DOM2 HTML')}}</td>
+ <td>The <code>cells</code>, <code>rowIndex</code>, and <code>selectionRowIndex</code> properties are now read-only.<br>
+ The methods <code>insertCell</code> and <code>deleteCell</code> can raise exceptions.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('DOM1', 'level-one-html.html#ID-6986576', 'HTMLTableRowElement')}}</td>
+ <td>{{Spec2('DOM1')}}</td>
+ <td>Initial definition.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility">Browser compatibility</h2>
+
+<div>{{CompatibilityTable}}</div>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari (WebKit)</th>
+ </tr>
+ <tr>
+ <td>Basic support</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatGeckoDesktop(1.0)}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>ch</code> and <code>chOff</code></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatNo}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ <tr>
+ <td>Optional parameter for <code>insertCell</code> and support for the <code>-1</code> value</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoDesktop(20.0)}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Android</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>IE Phone</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>Basic support</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatGeckoMobile(1.0)}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>ch</code> and <code>chOff</code></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatNo}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ <tr>
+ <td>Optional parameter for <code>insertCell</code> and support for the <code>-1</code> value</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoMobile(20.0)}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="See_also">See also</h2>
+
+<ul>
+ <li>The HTML element implementing this interface: {{HTMLElement("tr")}}.</li>
+</ul>
+
+<dl>
+ <dt> </dt>
+</dl>
diff --git a/files/ja/web/api/htmltablerowelement/insertcell/index.html b/files/ja/web/api/htmltablerowelement/insertcell/index.html
new file mode 100644
index 0000000000..ed195d4a80
--- /dev/null
+++ b/files/ja/web/api/htmltablerowelement/insertcell/index.html
@@ -0,0 +1,61 @@
+---
+title: HTMLTableRowElement.insertCell
+slug: Web/API/HTMLTableRowElement/insertCell
+tags:
+ - DOM
+ - Gecko
+ - Gecko DOM Reference
+ - tableRow
+translation_of: Web/API/HTMLTableRowElement/insertCell
+---
+<div>
+ {{ApiRef}}</div>
+<h2 id="Summary" name="Summary">概要</h2>
+<p>テーブル行に新規セルを挿入し、セルへの参照を返します。</p>
+<h2 id="Syntax" name="Syntax">構文</h2>
+<pre class="syntaxbox">var <var>cell</var> = <var>HTMLTableRowElement</var>.insertCell(<var>index</var>);
+</pre>
+<ul>
+ <li><code>HTMLTableRowElement</code> : HTML の tr 要素への参照</li>
+ <li><code>index</code> : 新しいセルのセルインデックス</li>
+ <li><code>cell</code> : 新しいセルへの参照が割り当てられる。<br>
+ <code>index</code> が -1 またはセル数と同じである場合は、セルは行内の最後のセルとして挿入される。 <code>index</code> が省略されているか行のセル数より大きい場合は IndexSizeError が発生する。</li>
+</ul>
+<h2 id="Example" name="Example">例</h2>
+<pre class="brush:html">&lt;table&gt;
+ &lt;tr id="row0"&gt;
+ &lt;td&gt;Original cell&lt;/td&gt;
+ &lt;/tr&gt;
+&lt;/table&gt;
+
+&lt;script type="text/javascript"&gt;
+
+function addCell(tableRowID) {
+ // 引数に指定された id によりテーブル行要素への参照を取得
+ var rowRef = document.getElementById(tableRowID);
+
+ // セルインデックス 0 の箇所にセルを挿入
+ var newCell = rowRef.insertCell(0);
+
+ // セルにテキストノードを追加
+ var newText = document.createTextNode('New cell')
+ newCell.appendChild(newText);
+}
+
+// 対象テーブル行の id をパラメータとし、関数 addCell を実行
+addCell('row0');
+
+&lt;/script&gt;
+</pre>
+<p>対象テーブルを valid な HTML とするには、tr 要素が最低でもひとつ td 要素を持っていなければなりません。</p>
+<p><code>insertCell</code> はテーブルにセルを直接的に挿入して新しい参照を返すものである事に注意して下さい。このメソッドを用いる場合、 予め {{domxref("document.createElement()")}} によって td 要素を生成する必要はありません。</p>
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ互換性</h2>
+<h3 id="Gecko-specific_notes" name="Gecko-specific_notes">Gecko 固有の注意事項</h3>
+<ul>
+ <li>Gecko 20.0 (Firefox 20.0 / Thunderbird 20.0 / SeaMonkey 2.17) 以降では、引数 <var>index</var> は HTML の仕様に則り省略可能となり、初期値は <code>-1</code> となりました。</li>
+</ul>
+<h2 id="Specification" name="Specification">仕様書</h2>
+<ul>
+ <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-68927016">DOM Level 2 HTML: insertCell</a></li>
+ <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/tabular-data.html#dom-tr-insertcell">HTML Living Standard HTMLTableRowElement.insertCell</a></li>
+</ul>
diff --git a/files/ja/web/api/htmltablerowelement/rowindex/index.html b/files/ja/web/api/htmltablerowelement/rowindex/index.html
new file mode 100644
index 0000000000..87d900ba04
--- /dev/null
+++ b/files/ja/web/api/htmltablerowelement/rowindex/index.html
@@ -0,0 +1,57 @@
+---
+title: HTMLTableRowElement.rowIndex
+slug: Web/API/HTMLTableRowElement/rowIndex
+tags:
+ - rowIndex
+ - table
+ - tr
+translation_of: Web/API/HTMLTableRowElement/rowIndex
+---
+<h2 id="Summary" name="Summary">概要</h2>
+
+<p>このプロパティは、テーブル全体に関連して <a href="/ja/docs/DOM/HTMLTableRowElement" title="DOM/HTMLTableRowElement">行 (row)</a> の 位置 (index) を {{htmlelement("thead")}} 、{{htmlelement("tbody")}} 、{{htmlelement("tfoot")}} の順序で取得します。</p>
+
+<p>※Opera は前述の順序ではなく、 HTML 中の記述順で rowIndex を取得します。</p>
+
+<h2 id="Example" name="Example">例</h2>
+
+<pre class="brush: html">&lt;table&gt;
+ &lt;thead&gt;
+ &lt;tr&gt;
+ &lt;th&gt;品目&lt;/th&gt;
+ &lt;th&gt;価格&lt;/th&gt;
+ &lt;/tr&gt;
+ &lt;/thead&gt;
+ &lt;tbody&gt;
+ &lt;tr&gt;
+ &lt;td&gt;抹茶プリン&lt;/td&gt;
+ &lt;td&gt;250 円&lt;/td&gt;
+ &lt;/tr&gt;
+ &lt;tr&gt;
+ &lt;td&gt;カスタードプリン&lt;/td&gt;
+ &lt;td&gt;200 円&lt;/td&gt;
+ &lt;/tr&gt;
+ &lt;tr&gt;
+ &lt;td&gt;牛乳プリン&lt;/td&gt;
+ &lt;td&gt;150 円&lt;/td&gt;
+ &lt;/tr&gt;
+ &lt;/tbody&gt;
+ &lt;tfoot&gt;
+ &lt;tr&gt;
+ &lt;td&gt;小計&lt;/td&gt;
+ &lt;td&gt;600 円&lt;/td&gt;
+ &lt;/tr&gt;
+ &lt;/tfoot&gt;
+&lt;/table&gt;</pre>
+
+<p>rowIndex の値を表示する例を以下に示します。</p>
+
+<pre class="brush: javascript">var rows = document.getElementsByTagName('tr');
+
+for(var x = 0, xLength = rows.length; x &lt; xLength; x++) {
+ alert('rowIndex=' + rows[x].rowIndex);
+}</pre>
+
+<h2 id="Compatibility" name="Compatibility">互換性</h2>
+
+<p>Quirksmode.org の <a href="http://www.quirksmode.org/dom/w3c_html.html#t317" title="http://www.quirksmode.org/dom/w3c_html.html#t317">rowIndex browser compatibility</a> を参照して下さい。</p>