HTML 要素を生成する軽量の PHP クラス。
このパッケージには php-5.4 以外の依存関係はありません。
Composer は、PHP パッケージの依存関係マネージャーとして広く使用されています。この Html-Form は、Packagist でuser-meta/htmlとして入手でき、 composer requireコマンドを実行することでインストールできます。プロジェクトで Composer を有効にするには、プロジェクトの「はじめに」ドキュメントを参照してください。
コマンドを使用してこの依存関係を追加するには、プロジェクト ディレクトリ内から次のコマンドを実行します。
composer require user-meta/html
Composer を使用して Html-Form でテキスト入力を生成する簡単な例:
<?php
require __DIR__ . ' /vendor/autoload.php ' ;
use UserMeta Html Html ;
echo Html:: text ( ' example ' );出力:
< input type =" text " value =" example " />ほぼすべての種類の html 要素を使用できます。 (例: ボタン、電子メール、div、p など)
echo Html:: button ( ' Submit Me ' );
echo Html:: email ( ' example email ' );
echo Html:: div ( ' example text ' );
echo Html:: p ( ' example text ' );出力:
< input type =" button " value =" Submit Me " />
< input type =" email " value =" example email " />
< div > example text </ div >
< p > example text </ p > ほとんどの要素は 2 つの引数を受け入れます。
$default : デフォルト値$attributes : 属性の配列echo Html::text($default, attributes); select、radio などのオプション要素の場合、3 番目の引数を$optionsとして受け入れます。
$options : オプションの配列。配列にはキーと値のペアまたは値のみを含めることができますecho Html::select($default, attributes, $options);名前、ID、クラス、またはその他の属性を割り当てるには、2 番目の引数 ( $attributes ) を使用します。
デフォルト値、名前、ID、およびクラス属性を含むテキスト フィールド:
echo Html:: text ( ' Example_Value ' , [ ' name ' => ' Example_Name ' , ' id ' => ' Example_ID ' , ' class ' => ' Example_Class ' ]);出力:
< input type =" text " name =" Example_Name " value =" Example_Value " id =" Example_ID " class =" Example_Class " /> 任意の属性を任意の要素に追加することもできます。
echo Html:: text ( ' Example_Value ' , [ ' name ' => ' Example_Name ' , ' data-example ' => ' Example_Data ' ]);出力:
< input type =" text " name =" Example_Name " value =" Example_Value " data-example =" Example_Data " /> echo Html:: email ( null , [ ' name ' => ' Email ' , ' required ' ]);
echo Html:: email ( null , [ ' name ' => ' Email ' , ' readonly ' ]);
echo Html:: email ( null , [ ' name ' => ' Email ' , ' disabled ' ]);出力:
< input type =" email " name =" Email " required =" required " />
< input type =" email " name =" Email " readonly =" readonly " />
< input type =" email " name =" Email " disabled =" disabled " /> echo Html:: email ( null , [
' name ' => ' Example_Name ' ,
' label ' => ' Email '
]); echo Html:: email ( null , [
' name ' => ' Example_Name ' ,
' label ' => [
' Example ' ,
' class ' => ' Class '
]
]);出力:
< label > Email </ label >
< input type =" email " name =" Example_Name " /> < label class =" Class " > Example </ label >
< input type =" email " name =" Example_Name " /> echo Html:: div ( ' example text ' , [ ' id ' => ' Example_ID ' , ' class ' => ' Example_Class ' ]);出力:
< div id =" Example_ID " class =" Example_Class " > example text </ div > echo Html:: label ( ' Some text ' , [ ' id ' => ' ID ' , ' class ' => ' Class ' , ' for ' => ' For ' ]);出力:
< label id =" ID " class =" Class " for =" For " > Some text </ label > echo Html:: checkbox ( true , [ ' name ' => ' Name ' ]);
echo Html:: checkbox ( true , [ ' name ' => ' Name ' , ' value ' => ' Value ' ]);出力:
< input type =" checkbox " name =" Name " value =" 1 " checked =" checked " />
< input type =" checkbox " name =" Name " value =" Value " checked =" checked " />デフォルトでチェックされていない場合は、最初の引数を false として渡します。 echo Html::checkbox(false)
デフォルト値を使用してチェックボックスのリストを作成する
echo Html:: checkbox ( ' cat ' , [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);
echo Html:: checkbox ([ ' cat ' ], [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);出力
< label > < input type =" checkbox " value =" dog " name =" Name " id =" ID_1 " /> Dog </ label >
< label > < input type =" checkbox " value =" cat " name =" Name " id =" ID_2 " checked =" checked " /> Cat </ label >POSTまたはGETメソッドで値の配列を取得するには
echo Html:: checkbox ([ ' cat ' ], [ ' name ' => ' Name[] ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);出力
< label > < input type =" checkbox " value =" dog " name =" Name[] " id =" ID_1 " /> Dog </ label >
< label > < input type =" checkbox " value =" cat " name =" Name[] " id =" ID_2 " checked =" checked " /> Cat </ label > echo Html:: select ([ ' cat ' ], [ ' name ' => ' Name ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);
echo Html:: select ([ ' cat ' ], [ ' name ' => ' Name ' ], [ ' dog ' , ' cat ' ]);出力
< select name =" Name " >
< option value =" dog " > Dog </ option >
< option value =" cat " selected =" selected " > Cat </ option >
</ select >
< select name =" Name " >
< option value =" dog " > dog </ option >
< option value =" cat " selected =" selected " > cat </ option >
</ select > echo Html:: radio ([ ' cat ' ], [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' , ' cat ' ]);出力
< label > < input type =" radio " value =" dog " name =" Name " id =" ID_1 " /> dog </ label >
< label > < input type =" radio " value =" cat " name =" Name " id =" ID_2 " checked =" checked " /> cat </ label >複数の要素をコレクションとしてグループ化できます
$ div = new Html ( ' div ' );
$ div -> p ( ' Hello World ' );
$ div -> text ( ' example ' );
$ div -> add ( ' Some plain text ' );
echo $ div -> render ();出力:
< div >
< p > Hello World </ p >
< input type =" text " value =" example " />
Some plain text
</ div >コレクションはHtmlコンストラクターを使用し、2 つのパラメーターを受け取ります。
$type (オプション): タグの名前。 (例: フォーム、div)$attributes (オプション): 属性の配列コレクションを使用したフォームの生成:
$ form = new Html ( ' form ' , [ ' method ' => ' POST ' ]);
$ form -> div ( ' Enter your email and password for login ' );
$ form -> email ( '' , [ ' name ' => ' email ' , ' label ' => ' Email ' ]);
$ form -> password ( '' , [ ' name ' => ' password ' , ' label ' => ' Password ' ]);
$ form -> submit ( ' login ' );
echo $ form -> render ();出力:
< form method =" POST " >
< div > Enter your email and password for login </ div >
< label > Email </ label >
< input type =" email " name =" email " />
< label > Password </ label >
< input type =" password " name =" password " />
< input type =" submit " value =" login " />
</ form > ネストされたコレクションを使用した HTML テンプレートの生成:
$ html = new Html ( ' html ' );
$ head = $ html -> import ( ' head ' );
$ head -> title ( ' Example Title ' );
$ body = $ html -> import ( ' body ' );
$ body -> p ( ' Hello World ' );
echo $ html -> render (); < html >
< head >
< title > Example Title </ title >
</ head >
< body >
< p > Hello World </ p >
</ body >
</ html > $ book = new Html ( ' book ' );
$ book -> title ( ' The Da Vinci Code ' );
$ author = $ book -> import ( ' author ' );
$ author -> name ( ' Dan Brown ' );
$ author -> nationality ( ' American ' );
echo $ book -> render ();出力
< book >
< title >The Da Vinci Code</ title >
< author >
< name >Dan Brown</ name >
< nationality >American</ nationality >
</ author >
</ book >名前を呼び出すことで、任意の HTML 要素を作成できます。
echo Html:: email ( ' [email protected] ' );
echo Html:: h1 ( ' Example Heading ' );内部では、入力要素にはHtml::input()を使用し、HTML タグにはHtml::tag()を使用します。
inputメソッドを使用して電子メール入力を作成します。
echo Html:: input ( ' email ' , ' [email protected] ' ); tagメソッドを使用して h1 を作成します。
echo Html:: tag ( ' h1 ' , ' Example Heading ' ); echo Html:: email ( '' , [ ' _before ' => ' Before ' , ' _after ' => ' After ' ]);出力
Before < input type =" email " /> After echo Html:: email ( '' , [ ' _enclose ' => ' div ' ]);
echo Html:: email ( '' , [ ' _enclose ' => [ ' div ' , ' class ' => ' Class ' ]]);出力
< div >
< input type =" email " />
</ div >
< div class =" Class " >
< input type =" email " />
</ div > // Same value and label
echo Html:: select ( null , [], [ ' audi ' , ' bmw ' ]);
// Different value and label
echo Html:: select ( null , [], [ ' audi ' => ' Audi ' , ' bmw ' => ' BMW ' ]);
// Option with extra attributes
echo Html:: select ( null , [], [ ' ferrari ' => [ ' Ferrari ' , ' data-origin ' => ' Italy ' ]]);
echo Html:: select ( null , [], [[ ' value ' => ' ferrari ' , ' label ' => ' Ferrari ' , ' data-origin ' => ' Italy ' ]]);出力
< select > < option value =" audi " > audi </ option > < option value =" bmw " > bmw </ option > </ select >
< select > < option value =" audi " > Audi </ option > < option value =" bmw " > BMW </ option > </ select >
< select > < option value =" ferrari " data-origin =" Italy " > Ferrari </ option > </ select >
< select > < option value =" ferrari " data-origin =" Italy " > Ferrari </ option > </ select >1 つのオプション配列で複数の方法を混合する
echo Html:: select ( null , [], [
' audi ' ,
' bmw ' => ' BMW ' ,
' honda ' => [
' Honda ' ,
' data-origin ' => ' Japan '
],
[
' value ' => ' ferrari ' ,
' label ' => ' Ferrari ' ,
' data-origin ' => ' Italy '
]
]);出力
< select >
< option value =" audi " > audi </ option >
< option value =" bmw " > BMW </ option >
< option value =" honda " data-origin =" Japan " > Honda </ option >
< option value =" ferrari " data-origin =" Italy " > Ferrari </ option >
</ select >数値の使用
echo Html:: select ( null , [], [ 2 => ' Two ' , 4 => ' Four ' ]);出力
< select >
< option value =" 2 " > Two </ option >
< option value =" 4 " > Four </ option >
</ select > エスケープとは、不正な HTML タグやスクリプト タグなどの不要なデータを削除することを意味します。
ライブラリはesc_attr value 属性に適用します。 esc_url hrefとsrc属性に設定します。