HTML::Tableモジュール（日本語ちょー訳）

by oota( oota@itp.nec.co.jp )(2000/10/11)

HTML::Tableモジュールの翻訳です。

なおこのドキュメントはCPAN上で検索できる HTML::Tableモジュールの説明を日本語に訳そうとしたものです。わかりにくい部分は本物を見てください。

原本の著作権はAnthony Peacock氏がお持ちです。
Anthony Peacockさんにはメールで了解をいただきました。

なお内容等が間違っていたら修正します。ご連絡ください。

(2001/12/1) 連絡先を変更させていただきました。

名前

HTML::Table - HTML table を作成する

概要

  use HTML::Table;

  $table1 = new HTML::Table($rows, $cols);
  $table1->setCell($cellrow, $cellcol, "This is Cell 1");
  $table1->setCellBGColor("blue");
  $table1->setCellColSpan(1,1, 2);
  $table1->print;

  $table2 = new HTML::Table;
  $table2->addRow(@cell_values);
  $table2->addCol(@cell_values2);

  $table1->setCell(1,1, "$table2->getTable");
  $table1->print;

動作条件

Perl5.002

エクスポート

なし

説明

HTML::Table は、ＣＧＩスクリプトのために、HTMLテーブルを生成するために使われます。このメソッドを使うことによって提供されるかなり複雑な表を作成し、操作でき、それらはPerl スクリプトから印刷することができます。このモジュールはまた Perlから、テーブルの中にテーブルを作ることを大いに単純化します。提供されるメソッドを使ってすべてのテーブルを作成し、HTMLタグを使わないということは可能です。

HTML::Table は、 addRow とaddCol メソッド経由でサイズを動的に変更できるテーブルを作成することもできます。それらメソッドは、現在のテーブル格子に適合するより多くのセル値を渡されるならば、自動的にテーブルの大きさを変更します。.

メソッドは、HTML 3.0 で定義されているほとんどすべての有効なテーブル、行、列とセルタグを提供しています。

メソッド

  [] はオプションのパラメータを意味します。既定値はなんの値も指定されなかったときに使われます。

作成

new HTML::Table([num_rows, num_cols])

新しい HTML table オブジェクトを作成します。もしも、行と列が指定されたならば、そのサイズにテーブルは初期化されます。行数と列の数は 1,1から始まります。 0,0 は空のテーブルを意味します。

テーブルレベルのメソッド

setBorder([pixels])

テーブルの境界幅 -- <BORDER> タグを設定します。
setWidth([pixels|percentofscreen]); テーブルの幅-- <WIDTH> タグを設定します。パーセントシンボルを使う時にはエスケープすることを忘れないでください。
setCellSpacing([pixels])
setCellPadding([pixels])
setCaption("CaptionText" [, TOP|BOTTOM])
setBGColor([colorname|colortriplet])

行/列レベルのメソッド

addRow("cell 1 content" [, "cell 2 conent", ...])

テーブルの最下部に行を追加します。もしも、希望する列数よりも多くの値を渡すと、列数を増やすと仮定します。.
addCol("cell 1 content" [, "cell 2 conent", ...]); テーブルの右端に列を追加します。もしも、希望する行数より多くの値を渡すと、行数を増やすと仮定します。
setColAlign(col_num, [CENTER|RIGHT|LEFT])
setColVAlign(col_num, [CENTER|TOP|BOTTOM])
setRowAlign(row_num, [CENTER|RIGHT|LEFT])
setRowVAlign(row_num, [CENTER|TOP|BOTTOM])
setColNoWrap(col_num, [0|1])
setRowBGColor(row_num, [colorname|colortriplet])

セルレベルのメソッド

setCell(row_num, col_num, "content")

テーブルのセルの内容を設定します。この値には、getTableメソッド経由での他のテーブルオブジェクトのようなものも含め、任意の文字列が使用できます。
setCellAlign(row_num, col_num, [CENTER|RIGHT|LEFT])
setCellVAlign(row_num, col_num, [CENTER|TOP|BOTTOM])
setCellWidth(row_num, col_num, [pixels])
setCellHeight(row_num, col_num, [pixels])
setCellNoWrap(row_num, col_num, [0|1])
setCellBGColor(row_num, col_num, [colorname|colortriplet])
setCellRowSpan(row_num, col_num, num_cells): セルの右にたくさんのセルを重ねるようにします。もしも、右端のセルよりも大きな数のセルを重ねようとすると、戻り値が偽になります。
setCellColSpan(row_num, col_num, num_cells); セルの下方にたくさんのセルを重ねるようにします。もしも、下方のセルよりも大きな数のセルを重ねようとすると、戻り値が偽になります。
setCellSpan(upleft_row_num, up_left_col_num, lowright_row_num, lowrigt_col_num); 指定されたコーナーに、ブロックになっているセルを結合します。もしも、列数や行数よりも大きな数のセルを指定すると、戻り値が偽になります。
getCell(row_num, col_num); 指定されたセルの内容を文字列で返します。

Output Methods

getTable

テーブルのHTML表現を含んでいる文字列を返します。

文字列スカラーコンテキストにおいて、オブジェクト参照を使うことによって、同じ効果を得ることができます。.

例...

        以下のコードの切れっぱしは:

		$table = new HTML::Table(2, 2);
		print "<P>Start</P>";
		print $table->getTable;
		print "<P>End</P>";

        下記のコードと同じ結果を生成します:

		$table = new HTML::Table(2, 2);
		print "<P>Start</P>$table<P>End</P>";

print

テーブルのHTML表現を STDOUTにプリントします。

クラスの変数

履歴

このモジュールはステーシー・レイシーによって1997年に元々作成されました、そして、最後のバージョンは1998年にCPANにアップロードされました。このモジュールは修正されたバージョンを配布するためにAnthony Peacockによって2000年7月に採用されました。その時に彼と連絡をとることは不可能でしたので、採用はStacy Lacyの明確な同意なしで起こりました。明確な同意はその時に得られなかったけれども、Stacy Lacyが1998年にモジュールを採用する誰かを捜していたという若干の証拠がありました。

著者

Anthony Peacock, a.peacock@chime.ucl.ac.uk Stacy Lacy (Original author)

著作権

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

参照

perl(1), CGI(3)

ホーム　Perlの小技

ご意見、ご質問はこちらの掲示板で受け付けています。
またメールは河馬屋(Nifty)にお願いします。