Html 类別

Html 类別是一个幾乎包含所有 HTML 标籤的 HTML 包裝器。

文件类型

我們引入一个擁有所有文件类型位於 fuel/core/config/doctypes.php 的配置档案。

anchor($href, $text, $attributes = array(), $secure = null)

anchor 方法回傳一个 HTML 錨點标籤。

靜態 是
參数
參数 預設 描述
$href 必要 目标 URL
$text 必要 錨點值
$attributes false 要被應用到錨點标籤的屬性陣列。
$secure null 在建立的URL中，設定为 false 強制 http，或設定为 true 強制 https。
回傳 包含正確格式的錨點标籤字串（及屬性，如果提供的話）。
範例 
// 回傳 <a href="http://www.domain.com/example">Example</a>
echo Html::anchor('example', 'Example');

// 回傳 <a href="http://www.otherdomain.com/example">Example</a>
echo Html::anchor('http://www.otherdomain.com/example', 'Example');

// 回傳 <a href="http://www.domain.com/example" id="a1" class="sample" style="color:red;">Example</a>
echo Html::anchor('example', 'Example', array('id' => 'a1', 'class' => 'sample', 'style' => 'color:red'));

// 回傳 <a href="https://www.domain.com/example" id="a1" class="sample" style="color:red;">Example</a>
echo Html::anchor('example', 'Example', array('id' => 'a1', 'class' => 'sample', 'style' => 'color:red'), true);

mail_to($email, $text, $subject = null, $attr = array())

mail_to 方法回傳一个帶有 mailto 做为目标的 HTML 錨點标籤。

靜態 是
參数
參数 預設 描述
$email 必要 Email 地址
$text 必要 錨點值
$subject null 主題
$attr empty 要被應用到錨點标籤的屬性陣列。
回傳 包含正確格式的錨點标籤字串（及屬性，如果提供的話）。
範例 
// 回傳 <a href="mailto:name@domain.com">Name</a>
echo Html::mail_to('name@domain.com', 'Name');

// 回傳 <a href="mailto:name@domain.com?subject=Something">Name</a>
echo Html::mail_to('name@domain.com', 'Name', 'Something');

// 回傳 <a href="mailto:name@domain.com" id="a2" class="sample" style="color:red;">Name</a>
echo Html:::mail_to('name@domain.com', 'Name', null, array('id' => 'a2', 'class' => 'sample', 'style' => 'color:red'));

mail_to_safe($email, $text, $subject = null, $attr = array())

mail_to_safe 方法回傳產生一个帶著 mailto 做为目标的 HTML 錨點标籤的 JavaScript 程式码。

靜態 是
參数
參数 預設 描述
$email 必要 Email 地址
$text 必要 錨點值
$subject null 主題
$attr empty 要被應用到錨點标籤的屬性陣列。
回傳 包含正確格式的錨點标籤字串（及屬性，如果提供的話）。
範例 
// 回傳
//<script type="text/javascript">
//	var user = "name";
//	var at = "@";
//	var server = "domain.com";
//	document.write('<a href="' + 'mail' + 'to:' + user + at + server + '">Name</a>');
//</script>
echo Html::mail_to_safe('name@domain.com', 'Name');

img($src, $attr = array())

img 方法回傳一个圖像标籤。

靜態 是
參数
參数 預設 描述
$src 必要 指向圖像的路徑。
$attr array() 屬性陣列，如果 alt 屬性沒有被提供，alt 屬性預設为档案名稱。
回傳 包含正確格式的圖像标籤字串。
範例 
// 回傳 <img src="http://example.com/path/to/image.png" alt="image.png" />
echo Html::img('path/to/image.png');

// 回傳 <img src="http://example.com/path/to/image.png" alt="Alt Message" class="myclass" />
echo Html::img('path/to/image.png', array("alt" => "Alt Message", 'class' => "myclass"));

meta($name, $content = '', $type = 'name')

meta 方法回傳 meta 标籤或一些标籤，如果提供多級陣列的話。

靜態 是
參数
參数 預設 描述
$name 必要 可以是包含单一或多个 meta 參数的陣列或是名稱／http-equiv 值。
$content 必要 如果在 $name 參数沒有提供陣列，$content 等於 meta 屬性內容的值。
$type 'name' 如果沒有提供值将預設为 name，可以是名稱或 http-equiv。
回傳 包含正確格式的 meta 标籤字串。
範例 
// 回傳 <meta name="description" content="Meta Example!" />
echo Html::meta('description', 'Meta Example!');

// 回傳 <meta name="robots" content="no-cache" />
echo Html::meta('robots', 'no-cache');

$meta = array(
	array('name' => 'robots', 'content' => 'no-cache'),
	array('name' => 'description', 'content' => 'Meta Example'),
	array('name' => 'keywords', 'content' => 'fuel, rocks'),
);

// 回傳 <meta name="robots" content="no-cache" />
// 回傳 <meta name="description" content="Meta Example!" />
// 回傳 <meta name="keywords" content="fuel, rocks" />
echo Html::meta($meta);

doctype($type = 'xhtml1-trans')

doctype 方法回傳正確格式的文件类型标籤。

靜態 是
參数
參数 預設 描述
$type 'xhtml1-trans' 要被輸出的 HTML 文件类型标籤的类型。
接受的值：xhtml11、xhtml1-strict、xhtml1-trans、xhtml1-frame、html5、html4-strict、html4-trans、html4-frame
回傳 包含正確格式的文件类型标籤字串。
範例 
// 回傳 XHTML1 Transitional 文件类型标籤。
echo Html::doctype();

// 回傳 <!DOCTYPE html>
echo Html::doctype('html5');

audio($src, $attr = false)

audio 方法为了被使用，需要你設定 html5 做为文件类型。

靜態 是
參数
參数 預設 描述
$src 必要 來源档案位置或包含多个位置的陣列。
$attr false 要被應用到音訊标籤的屬性陣列。
回傳 包含正確格式帶有來源的音訊标籤字串。
範例 
// 回傳 <audio><source src="../sounds/beep.mp3" /></audio>
echo Html::audio('../sounds/beep.mp3');

// 回傳 <audio><source src="../sounds/beep.mp3" /><source src="../sounds/frog.mp4" /></audio>
echo Html::audio(array('../sounds/beep.mp3','../sounds/frog.mp4'));

ul($list, $style = false)

ul 方法回傳一个正確格式的单一或多級的無序清单。

靜態 是
參数
參数 預設 描述
$list 必要 包含单一或多級項目要被輸出为清单項目的陣列。
$style false 要被應用到 ul 标籤的屬性陣列。
回傳 包含正確格式的列表字串。
範例 
/* 回傳
<ul id="todo" class="pending">
	<li>red</li>
	<li>blue</li>
	<li>green</li>
	<li>yellow</li>
</ul>
*/
$items = array('red', 'blue', 'green', 'yellow');
$attr = array('id' => 'todo','class' => 'pending');
echo Html::ul($items, $attr);

/* 回傳
<ul class="order">
	<li>colors
		<ul>
			<li>blue</li>
			<li>red</li>
			<li>green</li>
		</ul>
	</li>
	<li>sky</li>
	<li>tools
		<ul>
			<li>screwdriver</li>
			<li>hammer</li>
		</ul>
	</li>
</ul>
*/
$items = array(
	'colors' => array('blue', 'red', 'green'),
	'sky',
	'tools' => array('screwdriver','hammer')
);
$attr = array('class' => 'order');
echo Html::ul($items, $attr);

ol($list, $style = false)

ol 方法回傳一个正確格式的单一或多級的有序清单。

靜態 是
參数
參数 預設 描述
$list 必要 包含单一或多級項目要被輸出为清单項目的陣列。
$style false （選擇性）要被應用到 ol 标籤的屬性陣列。
回傳 包含正確格式的列表字串。
範例 
/* 回傳
<ol id="todo" class="pending">
	<li>red</li>
	<li>blue</li>
	<li>green</li>
	<li>yellow</li>
</ol>
*/
$items = array('red', 'blue', 'green', 'yellow');
$attr = array('id' => 'todo','class' => 'pending');
echo Html::ol($items, $attr);

/* 回傳
<ol class="order">
	<li>colors
		<ol>
			<li>blue</li>
			<li>red</li>
			<li>green</li>
		</ol>
	</li>
	<li>sky</li>
	<li>tools
		<ol>
			<li>screwdriver</li>
			<li>hammer</li>
		</ol>
	</li>
</ol>
*/
$items = array(
	'colors' => array('blue', 'red', 'green'),
	'sky',
	'tools' => array('screw driver','hammer'));
$attr = array('class' => 'order');
echo Html::ol($items, $attr);

程序助手

html_tag($tag, $attr = array(), $content = false)

html_tag 函式基於提供的屬性產生一个 HTML 标籤。

參数
參数 类型 預設 描述
$tag 字串 必要 标籤名稱
$attr 陣列 
array()
 屬性陣列
$content 字串 
false
 包覆在标籤中的內容
回傳 字串
範例 
echo html_tag('a', array(
	'href' => 'http://somedomain.com/',
	'class' => 'my_class'
), 'Link title');

// <a href="http://somedomain.com/" class="my_class">Link title</a>

array_to_attr($attr)

array_to_attr 函式產生一个屬性字串。

參数
參数 类型 預設 描述
$attr 陣列 必要 一个屬性的陣列
回傳 字串
範例 
echo array_to_attr(array(
	'href' => 'http://somedomain.com/',
	'class' => 'my_class'
));

// href="http://somedomain.com/" class="my_class"