©
本文档使用
php.cn手册 发布
HTMLHelper文件包含有助于使用HTML的功能。
加载此助手
可用职能
使用以下代码加载此助手:
$this->load->helper('html');
现有下列职能:
heading([$data = ''[, $h = '1'[, $attributes = '']]])
参数: | $ data(string) - Content $ h(string) - 标题级别$ attributes(混合) - HTML属性 |
---|---|
返回: | HTML标题标签 |
返回类型: | 串 |
$ data(string) - 内容
$ h(字符串) - 标题级别
$ attributes(mixed) - HTML属性
Returns: HTML heading tag
Return type: string
让您创建HTML标题标签。第一个参数将包含数据,第二个参数将包含标题的大小。例:
echo heading('Welcome!', 3);
以上将产生:<h3>欢迎%21</h3>
此外,为了向标题标记添加属性,如HTML类、ID或内联样式,第三个参数接受字符串或数组:
回声标题('Welcome!',3,'class =“pink”'); echo'heading('你好吗?',4,array('id'=>'question','class'=>'green'));
上述代码产生:
<h3 class="pink">Welcome!<h3> <h4 id="question" class="green">How are you?</h4>
img([$src = ''[, $index_page = FALSE[, $attributes = '']]])
参数: | $ src(string) - 图片源数据$ index_page(bool) - 是否将$ src视为路由URI字符串$ attributes(array) - HTML属性 |
---|---|
返回: | HTML图片标签 |
返回类型: | 串 |
$ src(字符串) - 图像源数据
$ index_page(bool) - 是否将$ src视为路由URI字符串
$ attributes(array) - HTML属性
Returns: HTML image tag
Return type: string
让您创建HTML <img />标签。第一个参数包含图像源。例:
echo img('images / picture.jpg'); //给出<img src =“http://site.com/images/picture.jpg”/>
有一个可选的第二个参数,它是一个true/false值,它指定SRC应该有指定的页面。$config['index_page']
添加到它创建的地址中。如果您使用的是媒体控制器,那么大概是这样的:
echo img('images / picture.jpg',TRUE); //给出<img src =“http://site.com/index.php/images/picture.jpg”alt =“”/>
此外,可以将关联数组传递给img()
函数,以完全控制所有属性和值。如果未提供alt属性,则CodeIgniter将生成一个空字符串。
例子:
$image_properties = array( 'src' => 'images/picture.jpg', 'alt' => 'Me, demonstrating how to eat 4 slices of pizza at one time', 'class' => 'post_images', 'width' => '200', 'height'=> '200', 'title' => 'That was quite a night', 'rel' => 'lightbox' ); img($image_properties); // <img src="http://site.com/index.php/images/picture.jpg" alt="Me, demonstrating how to eat 4 slices of pizza at one time" class="post\_images" width="200" height="200" title="That was quite a night" rel="lightbox" />
link_tag([$href = ''[, $rel = 'stylesheet'[, $type = 'text/css'[, $title = ''[, $media = ''[, $index_page = FALSE]]]]]])
参数: | $ href(string) - 我们链接到$ rel(string)的什么 - 关系类型$ type(string) - 相关文档的类型$ title(string) - 链接标题$ media(string) - 介质类型$ index_page(bool ) - 是否将$ src视为路由URI字符串 |
---|---|
返回: | HTML链接标记 |
返回类型: | 串 |
$ href(string) - 我们链接到的是什么
$ rel(字符串) - 关系类型
$ type(string) - 相关文档的类型
$ title(string) - 链接标题
$ media(字符串) - 媒体类型
$ index_page(bool) - 是否将$ src视为路由URI字符串
Returns: HTML link tag
Return type: string
Lets you create HTML <link /> tags. This is useful for stylesheet links, as well as other links. The parameters are _href_, with optional _rel_, _type_, _title_, _media_ and _index\_page_.
index_page是一个布尔值,用于指定href是否应该将通过$config['index_page']
添加指定的页面添加到它创建的地址。
例子:
echo link_tag('css / mystyles.css'); //给出<link href =“http://site.com/css/mystyles.css”rel =“stylesheet”type =“text / css”/>
其他例子:
echo link_tag('favicon.ico','快捷图标','image / ico'); // <link href =“http://site.com/favicon.ico”rel =“shortcut icon”type =“image / ico”/> echo link_tag('feed','alternate','application / rss + xml','我的RSS Feed'); // <link href =“http://site.com/feed”rel =“alternate”type =“application / rss + xml”title =“My RSS Feed”/>
此外,可以将关联数组传递给link()
函数,用于对所有属性和值进行完全控制:
$link=Array%28%27 href%27=>%27 css/printer.css%27,%27 rel%27=>%27样式表%27,%27 type%27=>%27 text/css%27,%27media%27=%27打印%27%29;echo链接[医]标签%28$link%29;//<link href="http://site.com/css/printer.css" rel="stylesheet" type="text/css" media="print" />
ul($list[, $attributes = ''])
参数: | $ list(array) - 列出条目$ attributes(array) - HTML属性 |
---|---|
返回: | HTML格式的无序列表 |
返回类型: | 串 |
$ list(array) - 列出条目
$ attributes(array) - HTML属性
Returns: HTML-formatted unordered list
Return type: string
Permits you to generate unordered HTML lists from simple or multi-dimensional arrays. Example:
$ list = array('red','blue','green','yellow'); $ attributes = array('class'=>'boldlist','id'=>'mylist'); echo ul($ list,$ attributes);
上述代码将产生以下结果:
<ul class="boldlist" id="mylist"> <li>red</li> <li>blue</li> <li>green</li> <li>yellow</li> </ul>
下面是一个更复杂的示例,使用多维数组:
$ attributes = array('class'=>'boldlist','id'=>'mylist'); $ list = array('colors'=> array('red','blue','green'),'shapes'=> array('round','square','circles'=> array('ellipse' ''''),'心情'=>数组('happy','upset'=> array('defeated'=> array('dejected',' 'disheartened', 'depressed' ), 'annoyed', ))); echo ul($ list,$ attributes);
上述代码将产生以下结果:
<ul class="boldlist" id="mylist"> <li>colors <ul> <li>red</li> <li>blue</li> <li>green</li> </ul> </li> <li>shapes <ul> <li>round</li> <li>suare</li> <li>circles <ul> <li>elipse</li> <li>oval</li> <li>sphere</li> </ul> </li> </ul> </li> <li>moods <ul> <li>happy</li> <li>upset <ul> <li>defeated <ul> <li>dejected</li> <li>disheartened</li> <li>depressed</li> </ul> </li> <li>annoyed</li> <li>cross</li> <li>angry</li> </ul> </li> </ul> </li> </ul>
ol($list, $attributes = '')
参数: | $ list(array) - 列出条目$ attributes(array) - HTML属性 |
---|---|
返回: | HTML格式的有序列表 |
返回类型: | 串 |
$ list(array) - 列出条目
$ attributes(array) - HTML属性
Returns: HTML-formatted ordered list
Return type: string
Identical to [`ul()`](about:blank#ul), only it produces the <ol> tag for ordered lists instead of <ul>.
meta([$name = ''[, $content = ''[, $type = 'name'[, $newline = "n"]]]])
参数: | $ name(字符串) - 元名称$ content(字符串) - 元内容$ type(字符串) - 元类型$ newline(字符串) - 换行符 |
---|---|
返回: | HTML元标记 |
返回类型: | 串 |
$ name(字符串) - 元名称
$ content(字符串) - 元内容
$ type(string) - 元类型
$ newline(string) - 换行符
Returns: HTML meta tag
Return type: string
帮助您生成元标记。您可以将字符串传递给该函数,或简单数组或多维数组。
例子:
echo meta('description', 'My Great site'); // Generates: <meta name="description" content="My Great Site" /> echo meta('Content-type', 'text/html; charset=utf-8', 'equiv'); // Note the third parameter. Can be "equiv" or "name" // Generates: <meta http-equiv="Content-type" content="text/html; charset=utf-8" /> echo meta(array('name' => 'robots', 'content' => 'no-cache')); // Generates: <meta name="robots" content="no-cache" /> $meta = array( array( 'name' => 'robots', 'content' => 'no-cache' ), array( 'name' => 'description', 'content' => 'My Great Site' ), array( 'name' => 'keywords', 'content' => 'love, passion, intrigue, deception' ), array( 'name' => 'robots', 'content' => 'no-cache' ), array( 'name' => 'Content-type', 'content' => 'text/html; charset=utf-8', 'type' => 'equiv' ) ); echo meta($meta); // Generates: // <meta name="robots" content="no-cache" /> // <meta name="description" content="My Great Site" /> // <meta name="keywords" content="love, passion, intrigue, deception" /> // <meta name="robots" content="no-cache" /> // <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
doctype([$type = 'xhtml1-strict'])
参数: | $ type(字符串) - Doctype名称 |
---|---|
返回: | HTML DocType标签 |
返回类型: | 串 |
$ type(字符串) – Doctype name Returns: HTML DocType tag Return type: string Helps you generate document type declarations, or DTD’s. XHTML 1.0 Strict is used by default, but many doctypes are available. Example: echo doctype(); // <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> echo doctype('html4-trans'); // <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> The following is a list of doctype choices. These are configurable, and pulled from application/config/doctypes.php Document type Option Result XHTML 1.1 xhtml11 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1//EN” “[http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd](https://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd)“> XHTML 1.0 Strict xhtml1-strict <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Strict//EN” “[http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd](https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd)“> XHTML 1.0 Transitional xhtml1-trans <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “[http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd](https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd)“> XHTML 1.0 Frameset xhtml1-frame <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Frameset//EN” “[http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd](https://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd)“> XHTML Basic 1.1 xhtml-basic11 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML Basic 1.1//EN” “[http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd](https://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd)“> HTML 5 html5 <!DOCTYPE html> HTML 4 Strict html4-strict <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01//EN” “[http://www.w3.org/TR/html4/strict.dtd](https://www.w3.org/TR/html4/strict.dtd)“> HTML 4 Transitional html4-trans <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN” “[http://www.w3.org/TR/html4/loose.dtd](https://www.w3.org/TR/html4/loose.dtd)“> HTML 4 Frameset html4-frame <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Frameset//EN” “[http://www.w3.org/TR/html4/frameset.dtd](https://www.w3.org/TR/html4/frameset.dtd)“> MathML 1.01 mathml1 <!DOCTYPE math SYSTEM “[http://www.w3.org/Math/DTD/mathml1/mathml.dtd](https://www.w3.org/Math/DTD/mathml1/mathml.dtd)“> MathML 2.0 mathml2 <!DOCTYPE math PUBLIC “-//W3C//DTD MathML 2.0//EN” “[http://www.w3.org/Math/DTD/mathml2/mathml2.dtd](https://www.w3.org/Math/DTD/mathml2/mathml2.dtd)“> SVG 1.0 svg10 <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.0//EN” “[http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd](https://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd)“> SVG 1.1 Full svg11 <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1//EN” “[http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd](https://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd)“> SVG 1.1 Basic svg11-basic <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1 Basic//EN” “[http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd](https://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd)“> SVG 1.1 Tiny svg11-tiny <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1 Tiny//EN” “[http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd](https://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd)“> XHTML+MathML+SVG (XHTML host) xhtml-math-svg-xh <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN” “[http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd](https://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd)“> XHTML+MathML+SVG (SVG host) xhtml-math-svg-sh <!DOCTYPE svg:svg PUBLIC “-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN” “http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd”> XHTML+RDFa 1.0 xhtml-rdfa-1 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML+RDFa 1.0//EN” “[http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd](https://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd)“> XHTML+RDFa 1.1 xhtml-rdfa-2 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML+RDFa 1.1//EN” “[http://www.w3.org/MarkUp/DTD/xhtml-rdfa-2.dtd](https://www.w3.org/MarkUp/DTD/xhtml-rdfa-2.dtd)“> br([$count = 1])
参数:$ count(int) - 重复tagReturns的次数:HTML换行符tagReturn类型:string
$ count(int) - 重复标签的次数
Returns: HTML line break tag
Return type: string
Generates line break tags (<br />) based on the number you submit. Example:
回声br(3);
以上将产生:
<br /><br /><br />
注
这一功能已被废弃。使用本机str_repeat()
结合在一起<br />
相反。
nbs([$num = 1])
参数: | $ num(int) - 要生成的空间实体的数量 |
---|---|
返回: | 一系列不间断的空间HTML实体 |
返回类型: | 串 |
$ num(int) - 要生成的空间实体的数量
Returns: A sequence of non-breaking space HTML entities
Return type: string
Generates non-breaking spaces ( ) based on the number you submit. Example:
echonbs(3);
以上将产生:
注
这个功能是DEPRECATED。str_repeat()
结合使用本地和
替代。