HTML 辅助函数

HTML 辅助函数包含的函数辅助 HTML 运行。

加载 HTML 辅助函数

HTML 辅助函数使用下面的代码加载:

helper('html');

通用函数

下面的函数是通用的:

img([$src = ''[, $indexPage = false[, $attributes = '']]])

param mixed $src:  Image 原始码数据 param bool $indexPage:  是否像路由的 URI 字符串处理 $src param mixed $attributes:  HTML 属性 returns:HTML image tag rtype:string

让你创建 HTML tags. 第一个参数包含 image 原始码。事例:

echo img('images/picture.jpg');
// 

有一个可选择的第二参数是特定的 true/false 值并规定如果 src 将经由 $config['indexPage'] 被添加到地址并创建有明确说明的页面。推测起来，假如你正在使用一个 media 控制器那将是自以为是的:

echo img('images/picture.jpg', true);
// 

此外，组合数组能被作为第一参数传达，为了完成控制额外的所有属性和值。 如果不提供 alt 属性，CodeIgniter 将产生空字符串。

例如:

$imageProperties = [
    '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($imageProperties);
// 

link_tag([$href = ''[, $rel = 'stylesheet'[, $type = 'text/css'[, $title = ''[, $media = ''[, $indexPage = false]]]]]])

参数:

• $href (string) – 链接文件的原始码
• $rel (string) – 关系类型
• $type (string) – 关系文件夹的类型
• $title (string) – 链接主题
• $media (string) – 媒体类型
• $indexPage (bool) – 是否像路由的 URI 字符串处理 $src

返回:

HTML link tag

返回类型:

string

让你创建 HTML tags. 这对样式表链接是有用的,和其他链接一样。参数是 href ，带着可选择的 rel, type, title, media 和 indexPage.

indexPage 是 boolean 值并规定如果 href 将经由 $config['indexPage'] 被添加到地址并创建有明确说明的页面。

例如:

echo link_tag('css/mystyles.css');
// 

更多示例:

echo link_tag('favicon.ico', 'shortcut icon', 'image/ico');
// 

echo link_tag('feed', 'alternate', 'application/rss+xml', 'My RSS Feed');
// 

间隔地，为了完全控制额外的所有属性和值组合数组能被传达到 link_tag() 函数:

$link = [
    'href'  => 'css/printer.css',
    'rel'   => 'stylesheet',
    'type'  => 'text/css',
    'media' => 'print'
];

echo link_tag($link);
// 

script_tag([$src = ''[, $indexPage = false]])

参数:

• $src (mixed) – JavaScript 文件的原始码名称
• $indexPage (bool) – 是否像路由的 URI 字符串处理 $src

返回:

HTML script tag

返回类型:

string

让你创建 HTML tags. 参数是 src, 与可选的 indexPage 一起.

indexPage 是 boolean 值并规定如果 src 将经由 $config['indexPage'] 被添加到地址并创建有明确说明的页面。

例如:

echo script_tag('js/mystyles.js');
// 

间隔地，为了完全控制额外的所有属性和值组合数组能被通过 script_tag() 函数:

$script = ['src'  => 'js/printer.js'];

echo script_tag($script);
// 

ul($list[, $attributes = ''])

param array $list:  目录登录 param array $attributes:  HTML 属性 returns:HTML-formatted 无序目录 rtype:string

容许你从简单或者多倍空间的数组产生无序 HTML 目录。事例::

    $list = [
        'red',
        'blue',
        'green',
        'yellow'
    ];

    $attributes = [
        'class' => 'boldlist',
        'id'    => 'mylist'
    ];

    echo ul($list, $attributes);

上文的代码将产生下文这样地 HTML 代码:

.. code-block:: html

    <ul class="boldlist" id="mylist">
        <li>redli>
        <li>blueli>
        <li>greenli>
        <li>yellowli>
    ul>

下面是更复杂的事例，使用多维空间的数组::

    $attributes = [
        'class' => 'boldlist',
        'id'    => 'mylist'
    ];

    $list = [
        'colors' => [
            'red',
            'blue',
            'green'
        ],
        'shapes' => [
            'round',
            'square',
            'circles' => [
                'ellipse',
                'oval',
                'sphere'
            ]
        ],
        'moods'  => [
            'happy',
            'upset'   => [
                'defeated' => [
                    'dejected',
                    'disheartened',
                    'depressed'
                ],
                'annoyed',
                'cross',
                'angry'
            ]
        ]
    ];

    echo ul($list, $attributes);

上文的代码将产生这样的 HTML 前端代码:

.. code-block:: html

    <ul class="boldlist" id="mylist">
        <li>colors
            <ul>
                <li>redli>
                <li>blueli>
                <li>greenli>
            ul>
        li>
        <li>shapes
            <ul>
                <li>roundli>
                <li>suareli>
                <li>circles
                    <ul>
                        <li>elipseli>
                        <li>ovalli>
                        <li>sphereli>
                    ul>
                li>
            ul>
        li>
        <li>moods
            <ul>
                <li>happyli>
                <li>upset
                    <ul>
                        <li>defeated
                            <ul>
                                <li>dejectedli>
                                <li>disheartenedli>
                                <li>depressedli>
                            ul>
                        li>
                        <li>annoyedli>
                        <li>crossli>
                        <li>angryli>
                    ul>
                li>
            ul>
        li>
    ul>

ol($list, $attributes = '')

参数:

• $list (array) – 目录登录
• $attributes (array) – HTML 属性

返回:

HTML-formatted 有序目录

返回类型:

string

完全相似于 ul() ,为了代替有序目录

它仅产生
tag.

video($src[, $unsupportedMessage = ''[, $attributes = ''[, $tracks = [][, $indexPage = false]]]])

参数:

• $src (mixed) – 任一原始码字符串或者原始码的数组. 参看 source() 函数
• $unsupportedMessage (string) – 如果 media tag 不支持由浏览器提供的消息会显示
• $attributes (string) – HTML 属性
• $tracks (array) – 在数组里使用追踪函数。参看 track() 函数
• $indexPage (bool) –

返回:

HTML-formatted 影像元素

返回类型:

string

容许你从简单的或者原始码数组产生 HTML 影像元素。事例:

$tracks =
[
    track('subtitles_no.vtt', 'subtitles', 'no', 'Norwegian No'),
    track('subtitles_yes.vtt', 'subtitles', 'yes', 'Norwegian Yes')
];

echo video('test.mp4', 'Your browser does not support the video tag.', 'controls');

echo video
(
    'http://www.codeigniter.com/test.mp4',
    'Your browser does not support the video tag.',
    'controls',
    $tracks
);

echo video
(
    [
      source('movie.mp4', 'video/mp4', 'class="test"'),
      source('movie.ogg', 'video/ogg'),
      source('movie.mov', 'video/quicktime'),
      source('movie.ogv', 'video/ogv; codecs=dirac, speex')
    ],
    'Your browser does not support the video tag.',
    'class="test" controls',
    $tracks
 );

上文的编码将产生这样地 HTML 前端代码:

<video src="test.mp4" controls>
  Your browser does not support the video tag.
video>

<video src="http://www.codeigniter.com/test.mp4" controls>
  <track src="subtitles_no.vtt" kind="subtitles" srclang="no" label="Norwegian No" />
  <track src="subtitles_yes.vtt" kind="subtitles" srclang="yes" label="Norwegian Yes" />
  Your browser does not support the video tag.
video>

<video class="test" controls>
  <source src="movie.mp4" type="video/mp4" class="test" />
  <source src="movie.ogg" type="video/ogg" />
  <source src="movie.mov" type="video/quicktime" />
  <source src="movie.ogv" type="video/ogv; codecs=dirac, speex" />
  <track src="subtitles_no.vtt" kind="subtitles" srclang="no" label="Norwegian No" />
  <track src="subtitles_yes.vtt" kind="subtitles" srclang="yes" label="Norwegian Yes" />
  Your browser does not support the video tag.
video>

audio($src[, $unsupportedMessage = ''[, $attributes = ''[, $tracks = [][, $indexPage = false]]]])

参数:

• $src (mixed) – 任一原始码字符串或者原始码数组。参看 source() 函数
• $unsupportedMessage (string) – 如果 media tag 不支持由浏览器提供的消息会显示
• $attributes (string) –
• $tracks (array) – 在数组里用追踪函数. 参看 track() 函数
• $indexPage (bool) –

返回:

HTML-formatted 音频元素

返回类型:

string

完全相似于 video(), 它仅仅产生

source($src = ''[, $type = false[, $attributes = '']])

param string $src:  media source的路径 param bool $type:  以可选择的编码参数的资源 MIME（多用途的网络邮件扩充协议）类型 param array $attributes:  HTML 属性 returns:HTML source tag rtype:string

让你创建 HTML tags. 第一个参数包含起源 source. 例如:

echo source('movie.mp4', 'video/mp4', 'class="test"');
// 

embed($src = ''[, $type = false[, $attributes = ''[, $indexPage = false]]])

param string $src:  资源的路径 embed param bool $type:  MIME（多用途的网络邮件扩充协议）类型 param array $attributes:  HTML 属性 param bool $indexPage:   returns:HTML embed tag rtype:string

让你创建 HTML tags.第一参数包含 embed source. 例如:

echo embed('movie.mov', 'video/quicktime', 'class="test"');
// 

object($data = ''[, $type = false[, $attributes = '']])

参数:

• $data (string) – 资源 URL
• $type (bool) – 资源的内容类型
• $attributes (array) – HTML 属性
• $params (array) – 在数组里使用 param 函数。参看 param() 函数

返回:

HTML object tag

返回类型:

string

让你创建 HTML