軽量シンプルPHPフレームワーク

core

db

html

utility

HtmlTableRow

クラス概要

HtmlTableの各行を表現するクラスで、TRタグのエレメントインスタンスです。
ArrayAccessインターフェイスを実装しているため、行に含まれるセルのエレメントに対してオブジェクト的にアクセスすることが可能です。
またIteratorAggregateを実装しているため、foreachなどでこの行オブジェクトを指定することで行に含まれる全てのセルに順次処理を行うことができます。

Curry対応バージョン

バージョン 1.4.0 以降

クラスファイル位置

curry/html/html_table_row.php

フィールド

公開されるフィールドはありません。

メソッド

メソッド名	アクセス	概要
__construct	public	コンストラクタ。引数として親テーブルのHtmlTableインスタンスが指定可能です。
__set	public	setCellValueのエイリアスとして機能します。
__get	public	getCellValueのエイリアスとして機能します。
setCellTagName	public	セルオブジェクトのタグ名を設定します。これはTDまたはTHのどちらかの指定になりますが、通常はヘッダ行かボディ行かによって自動的に設定されるため、実装者が意識して設定する必要はありません。
setCellValue	public	セルの値を設定します。指定の列キーのセルが存在しない場合はセルを作成し、値を設定します。存在する場合はそのセルの値を更新します。
addCell	public	指定の列キーセルを生成し追加します。既に指定のキーのセルが存在する場合は例外を発生します。
getCell	public	指定の列キーのセルオブジェクトを取得します。
getCellValue	public	指定の列キーのセルオブジェクトの子ノードをHTMLとして取得します。子ノードがHtmlElementであってもHTMLとして取得します。
existsCell	public	指定の列キーのセルが存在するか否かを確認します。
removeCell	public	指定の列キーのセルを削除します。
setCellAttributes	public	指定の列キーのセルのエレメントの属性を設定します。
setCellsAttributes	public	復数のセルのエレメントの属性を一度に設定します。

継承メソッド（）

メソッド名	アクセス	概要
__call	public	HtmlElementにおける__callは、エレメント属性の設定または取得の役割を果たします。実際にクラスメソッドとして定義されているメソッド以外で"set"や"get"で始まるメソッドを呼び出すと、"set"や"get"に続く部分を属性名として扱い、その属性に値をセット、または値の取得を行います。例えばsetIdメソッドを実行すると、id属性に対して引数で指定した値を設定します。つまり、setId('example_id')と、setAttribute('id', 'example_id')は全く同じ動作となります。
create	public	HtmlElementのインスタンスを生成して返します。このメソッドはPHP5.3で追加されている関数を使用しているため、PHP5.2以下では使用出来ません。
setIndentChar	public	HTML生成の際の自動インデントに使用する文字種を指定します。初期値は半角スペース2個です。
getClone	public	自信のインスタンスのコピーを生成し、新規インスタンスとして取得します。
setTagName	public	エレメントのタグ名を指定します。
getTagName	public	エレメントのタグ名として設定されている値を取得します。
addClass	public	エレメントのclass属性として設定したい値を追加します。
getClass	public	現在設定されている、エレメントのclass属性値を取得します。復数設定されている場合は全ての値が居半角スペースで区切られた文字列となります。
hasClass	public	指定された値がclass属性値に含まれているかを確認します。
removeClass	public	指定された値を、現在設定されているclass属性値から削除します。
clearClass	public	クラス属性値の設定をクリアします。
addStyle	public	エレメントのstyle属性値を追加します。
addStyles	public	エレメントのstyle属性値を復数一度に追加します。
getStyle	public	現在設定されているstyle属性値を取得します。
addNode	public	エレメントの子ノードを追加します。追加できるのはHtmlElementのインスタンスまたはテキストです。
addNodes	public	エレメントの子ノードを配列で指定し、復数一度に追加します。追加できるのはHtmlElementのインスタンスまたはテキストです。これはaddNodeメソッドを複数回実行するの同じ意味になります。
insertNode	public	既に存在する子ノード群の任意の位置に新たなノードを挿しこむ用に追加します。指定方法は数値インデックスまたは既に存在する子ノードに含まれるHtmlElementのインスタンスを指定します。前者の場合は指定したインデックス位置に既に存在する子ノードの手前に追加します。後者の場合は指定したインスタンスと同一のインスタンスが存在する場合に、そのインスタンスの手前に追加します。指定したインデックスが存在しない、または指定したHtmElementのインスタンスが存在しない場合は末尾に追加します。
getNode	public	指定したインデックス位置に存在する子ノードを取得します。
getNodes	public	全ての子ノードを配列として取得します。
addElement	public	子ノードとしてエレメントを追加します。
addElements	public	子ノードとしてエレメントを配列で指定し、復数一度に追加します。
insertElement	public	既に存在する子ノード群の任意の位置に新たなエレメントを挿しこむように追加します。指定方法は数値インデックスまたは既に存在する子ノードに含まれるHtmlElementのインスタンスを指定します。前者の場合は指定したインデックス位置に既に存在する子ノードの手前に追加します。後者の場合は指定したインスタンスと同一のインスタンスが存在する場合に、そのインスタンスの手前に追加します。指定したインデックスが存在しない、または指定したHtmElementのインスタンスが存在しない場合は末尾に追加します。
getElement	public	インデックスを指定し、子ノードからエレメントを取得します。指定したインデックスが存在しない、または指定したインデックスのノードがHtmlElementのインスタンスではない場合はfalseが返ります。
getElementById	public	子ノードの中からid属性指定で単一のエレメントを取得します。指定したid属性のエレメントが存在しない、またはエレメントではない場合はnullを返します。
getElementsByTagName	public	子ノードの中からタグ名指定でエレメントを取得します。タグ名が合致するエレメント全てを配列で返します。
getElementsByClass	public	子ノードの中からクラス属性指定でエレメントを取得します。エレメントの持つクラス属性値のうち一つでも合致するエレメント全てを配列で返します。
getElements	public	すべての子ノードのうち、HtmlElementのインスタンスである物のみを全て配列として取得します。
removeElement	public	子ノードから特定のエレメントを削除します。削除対象は子ノードに含まれるHtmlElementのインスタンスを引数として指定します。同一インスタンスが存在すれば削除します。
addText	public	子ノードとしてテキストノードを追加します。
setText	public	子ノードとしてテキストノードを設定します。 addTextとの違いは一旦全ての子ノードをクリアするということです。setTextは子ノードの追加という概念ではなく、エレメントのコンテンツとしてテキストを設定するという考え方です。
clearNodes	public	設定されている全ての子ノードをクリアし、何もない状態にします。
setAttribute	public	エレメントの属性値を設定します。
setAttributes	public	エレメエントの属性値を復数一度に設定します。パラメーターには属性名と属性値の組み合わせの配列を指定します。これは個々の属性の設定をsetAttributeメソッドにより複数回実行するの同じいみになります。
getAttribute	public	設定されている属性の属性値を取得します。
getAttributes	public	設定されている全ての属性値を取得します。得られるのは属性名をキー、属性値が値として定義された配列です。
setIsEmptyTag	public	空要素タグであるか否かを設定します。空要素タグとは要素を持たないタグで、通常のタグが開始タグと終了タグで構成されるのに対し、空要素タグでは閉じタグが必要ありません。空要素タグはHTMLの仕様として規定されたものであり、また主要な空要素はインスタンス生成時（タグ名指定時）に自動的に空要素として設定されるため、通常は実装者が意識する必要はありません。
isEmptyTag	public	空要素タグであるか否かを取得します。
addEmptyTags	public	HtmlElementが内部的に持っている空要素タグのリストにタグ名を追加します。静的メソッドであるため、設定を行う場合は初期化処理としてあらかじめ行います。指定はタグ名を文字列で、または復数のタグ名を配列で指定します。
setIsReturnInner	public	出力するHTMLで、開始タグの直後と終了タグの直前、子ノード間に改行を挿入するか否かを指定します。これは人間の目に視覚的な見やすさのための設定であるため、処理内容やブラウザの表示に影響をあたえるものではありません。
isReturnInner	public	開始タグの直後と終了タグの直前、子ノード間に改行を挿入するか否かの設定を取得します。
addReturnInnerNgTags	public	デフォルトでタグの内部に改行の挿入を禁止するタグ名を設定します。これは、対象のタグ名の個々のHtmlElementに都度、setIsReturnInnerを実行するのと同じ意味になり、あらかじめ内部に改行を挿入したくないタグが決まっている場合はこのメソッドによりデフォルト設定として設定しておきます。静的メソッドであるため、初期設定としてあらかじめ実行しておきます。以下のタグはデフォルトで改行禁止に設定されています。・a ・textarea ・label ・strong ・em ・object
getInnerHtml	public	子ノード全てのHTMLを生成し、取得します。得られるHTMLに自身のエレメントは含まれず、子ノード以下の最下層までHTMLとして取得することができます。
getHtml	public	エレメント以下、エレメント自身を含む全ての子ノードを最下層までを含めてHTMLを生成し、取得します。
render	public	エレメント以下、エレメント自身を含む全ての子ノードを最下層までを含めてHTMLを生成し、出力します。これはgetHtmlで取得したHTMLをそのままechoするのと同じ意味になります。
addFromArray	public	子ノード情報を定義した配列を元に子ノードを追加します。このメソッドの詳細はマニュアルを参照してください。
fromArray	public	子ノード情報を含むエレメント情報を定義した配列を元にHtmlElementのインスタンスを生成し、返します。静的メソッドであるため、既に存在するインスタンスに子ノードを設定するaddFromArrayメソッドとは違い、親となるエレメント自身を新規インスタンスとして生成します。このメソッドの詳細はマニュアルを参照してください。

CurryPHP Framework