Html - 类別

优质

小牛编辑

122浏览

2023-12-01

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" class="sample">Example</a>
echo Html::anchor('example', 'Example', array('id' => 'a1', 'class' => 'sample', 'style' => 'color:red'));

// 回传 <a href="https://www.domain.com/example" class="sample">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" class="sample">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 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 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"