<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
/**
* CodeIgniter
*
* An open source application development framework for PHP 5.1.6 or newer
*
* @package CodeIgniter
* @author ExpressionEngine Dev Team
* @copyright Copyright (c) 2008 - 2011, EllisLab, Inc.
* @license http://codeigniter.com/user_guide/license.html
* @link http://codeigniter.com
* @since Version 1.0
* @filesource
*/
// ------------------------------------------------------------------------
/**
* CodeIgniter HTML Helpers
* CI HTML助手
* @package CodeIgniter
* @subpackage Helpers
* @category Helpers
* @author ExpressionEngine Dev Team
* @link http://codeigniter.com/user_guide/helpers/html_helper.html
*/
// ------------------------------------------------------------------------
/**
* Heading
*
* Generates an HTML heading tag. First param is the data.
* Second param is the size of the heading tag.
* 生成HTML标题标签。第一个参数是数据。
* 的第二个参数是标题标签的大小。
* @access public
* @param string
* @param integer
* @return string
*/
if ( ! function_exists('heading'))
{
function heading($data = '', $h = '1', $attributes = '')
{
$attributes = ($attributes != '') ? ' '.$attributes : $attributes;
return "<h".$h.$attributes.">".$data."</h".$h.">";
}
}
// ------------------------------------------------------------------------
/**
* Unordered List
*
* Generates an HTML unordered list from an single or multi-dimensional array.
*
* @access public
* @param array
* @param mixed
* @return string
*/
if ( ! function_exists('ul'))
{
function ul($list, $attributes = '')
{
return _list('ul', $list, $attributes);
}
}
// ------------------------------------------------------------------------
/**
* Ordered List
*
* Generates an HTML ordered list from an single or multi-dimensional array.
*
* @access public
* @param array
* @param mixed
* @return string
*/
if ( ! function_exists('ol'))
{
function ol($list, $attributes = '')
{
return _list('ol', $list, $attributes);
}
}
// ------------------------------------------------------------------------
/**
* Generates the list
* 生成列表
* Generates an HTML ordered list from an single or multi-dimensional array.
* 生成论HTML有序列表从单维或多维数组。
* @access private
* @param string
* @param mixed
* @param mixed
* @param integer
* @return string
*/
if ( ! function_exists('_list'))
{
function _list($type = 'ul', $list, $attributes = '', $depth = 0)
{
// If an array wasn't submitted there's nothing to do...
// 如果在阵列没有提交有什么可以做...
if ( ! is_array($list))
{
return $list;
}
// Set the indentation based on the depth
// 设置基于深度的压痕
$out = str_repeat(" ", $depth); //将空格循环多出次，放到out字段中
// Were any attributes submitted? If so generate a string
// 被提交任何属性？如果是这样生成的字符串
if (is_array($attributes))
{
$atts = '';
foreach ($attributes as $key => $val)
{
$atts .= ' ' . $key . '="' . $val . '"';
}
$attributes = $atts;
}
elseif (is_string($attributes) AND strlen($attributes) > 0)
{
$attributes = ' '. $attributes;
}
// Write the opening list tag
// 写开幕列表标签
$out .= "<".$type.$attributes.">\n";
// Cycle through the list elements. If an array is
// encountered we will recursively call _list()
//循环通过列表中的元素。如果一个数组，是
//遇到我们将递归调用_list（）
static $_last_list_item = '';
foreach ($list as $key => $val)
{
$_last_list_item = $key;
$out .= str_repeat(" ", $depth + 2); //缩进两个空格
$out .= "<li>";
if ( ! is_array($val))
{
$out .= $val;
}
else
{
$out .= $_last_list_item."\n";
//如果为数组，然后进行递归
$out .= _list($type, $val, '', $depth + 4);
$out .= str_repeat(" ", $depth + 2);
}
$out .= "</li>\n";
}
// Set the indentation for the closing tag 设置收盘标签压痕
$out .= str_repeat(" ", $depth);
// Write the closing list tag
$out .= "</".$type.">\n";
return $out;
}
}
// ------------------------------------------------------------------------
/**
* Generates HTML BR tags based on number supplied
* 根据提供数生成HTML标签BR str_repeat()
* str_repeat() 把字符串重复指定的次数
* @access public
* @param integer
* @return string
*/
if ( ! function_exists('br'))
{
function br($num = 1)
{
return str_repeat("<br />", $num);
}
}
// ------------------------------------------------------------------------
/**
* Image
*
* Generates an <img /> element
* 生成img标答
* @access public
* @param mixed
* @return string
*/
if ( ! function_exists('img'))
{
function img($src = '', $index_page = FALSE)
{
//如果不为数组
if ( ! is_array($src) )
{
$src = array('src' => $src);
}
// If there is no alt attribute defined, set it to an empty string
// 如果没有定义的alt属性，将其设置为空字符串
if ( ! isset($src['alt']))
{
$src['alt'] = '';
}
$img = '<img';
foreach ($src as $k=>$v)
{
if ($k == 'src' AND strpos($v, '://') === FALSE)
{
$CI =& get_instance();
if ($index_page === TRUE)
{
$img .= ' src="'.$CI->config->site_url($v).'"';
}
else
{
$img .= ' src="'.$CI->config->slash_item('base_url').$v.'"';
}
}
else
{
$img .= " $k=\"$v\"";
}
}
$img .= '/>';
return $img;
}
}
// ------------------------------------------------------------------------
/**
* Doctype
*
* Generates a page document type declaration
* 生成页面文档类型声明
*
* Valid options are xhtml-11, xhtml-strict, xhtml-trans, xhtml-frame,
* html4-strict, html4-trans, and html4-frame. Values are saved in the
* doctypes config file.
* 有效的选项是，XHTML反11 XHTML，XHTML严格的XHTML帧，
* HTML4严格，HTML4反HTML4帧。值被保存在
* DOCTYPES配置文件。
*
* @access public
* @param string type The doctype to be generated 以生成的文档类型
* @return string
*/
if ( ! function_exists('doctype'))
{
function doctype($type = 'xhtml1-strict')
{
global $_doctypes;
if ( ! is_array($_doctypes))
{
if (defined('ENVIRONMENT') AND is_file(APPPATH.'config/'.ENVIRONMENT.'/doctypes.php'))
{
include(APPPATH.'config/'.ENVIRONMENT.'/doctypes.php');
}
elseif (is_file(APPPATH.'config/doctypes.php'))
{
include(APPPATH.'config/doctypes.php');
}
if ( ! is_array($_doctypes))
{
return FALSE;
}
}
if (isset($_doctypes[$type]))
{
return $_doctypes[$type];
}
else
{
return FALSE;
}
}
}
// ------------------------------------------------------------------------
/**
* Link
* 链接
*
* Generates link to a CSS file
* 生成链接到一个CSS文件
*
* @access public
* @param mixed stylesheet hrefs or an array
* @param string rel
* @param string type
* @param string title
* @param string media
* @param boolean should index_page be added to the css path
* @return string
*/
if ( ! function_exists('link_tag'))
{
//$href 需要链接到的地址
//$rel
//$type 类型
//$title
//$media
//$index_page
function link_tag($href = '', $rel = 'stylesheet', $type = 'text/css', $title = '', $media = '', $index_page = FALSE)
{
$CI =& get_instance();
$link = '<link ';
//如果为数组
if (is_array($href))
{
foreach ($href as $k=>$v)
{
//看href的值，如果href的值里面不包括"://"的值话
if ($k == 'href' AND strpos($v, '://') === FALSE)
{
//并且index_page为true 如果为分页信息
if ($index_page === TRUE)
{
$link .= 'href="'.$CI->config->site_url($v).'" ';
}
else
{
$link .= 'href="'.$CI->config->slash_item('base_url').$v.'" ';
}
}
else
{
$link .= "$k=\"$v\" ";
}
}
$link .= "/>";
}
else
{
if ( strpos($href, '://') !== FALSE)
{
$link .= 'href="'.$href.'" ';
}
elseif ($index_page === TRUE)
{
$link .= 'href="'.$CI->config->site_url($href).'" ';
}
else
{
$link .= 'href="'.$CI->config->slash_item('base_url').$href.'" ';
}
$link .= 'rel="'.$rel.'" type="'.$type.'" ';
if ($media != '')
{
$link .= 'media="'.$media.'" ';
}
if ($title != '')
{
$link .= 'title="'.$title.'" ';
}
$link .= '/>';
}
return $link;
}
}
// ------------------------------------------------------------------------
/**
* Generates meta tags from an array of key/values
* 从数组的键/值生成meta标签
* @access public
* @param array
* @return string
*/
if ( ! function_exists('meta'))
{
//$name meta的名称
//$content meta标答的内容
//$type meta标签类型
//$newline meta换行标
function meta($name = '', $content = '', $type = 'name', $newline = "\n")
{
// Since we allow the data to be passes as a string, a simple array
// or a multidimensional one, we need to do a little prepping.
// 由于我们允许数据作为一个字符串传递，一个简单的数组
// 或者一个多维的，我们需要做的有点跃跃欲试。
//如果$name不为一个数组的话，重新将$name包装成一个数组
if ( ! is_array($name))
{
$name = array(array('name' => $name, 'content' => $content, 'type' => $type, 'newline' => $newline));
}
else
{
// Turn single array into multidimensional
// 将单一到多维数组
if (isset($name['name']))
{
$name = array($name);
}
}
$str = '';
//开始循环
foreach ($name as $meta)
{
$type = ( ! isset($meta['type']) OR $meta['type'] == 'name') ? 'name' : 'http-equiv';
$name = ( ! isset($meta['name'])) ? '' : $meta['name'];
$content = ( ! isset($meta['content'])) ? '' : $meta['content'];
$newline = ( ! isset($meta['newline'])) ? "\n" : $meta['newline'];
$str .= '<meta '.$type.'="'.$name.'" content="'.$content.'" />'.$newline;
}
//返回字符串
return $str;
}
}
// ------------------------------------------------------------------------
/**
* Generates non-breaking space entities based on number supplied
* 生成非打破空间实体的基础上提供数
*
* @access public
* @param integer
* @return string
*/
if ( ! function_exists('nbs'))
{
function nbs($num = 1)
{
//nbs 将 换为指定的指
return str_repeat(" ", $num);
}
}
/* End of file html_helper.php */
/* Location: ./system/helpers/html_helper.php */
浙公网安备 33010602011771号