微擎自带组件 tpl函数

共计 4249 个字符，预计需要花费 11 分钟才能阅读完成。

官方文档里模板函数写的很少只有几个！但这些组件直接调用很方便开发者开发，因此将其整理，方便查找调用！

使用前请务必 load()->func('tpl'); 加载模板组件函数

• 在 /framework/function/ 目录下的 tpl.func.php 文件中定义。

/**
 *【表单控件】: 范围日期选择器
 * @param string $name 表单 input 名称
 * @param array $value 表单 input 值
 *      array('start' => 开始日期,'end' => 结束日期)
 * @param boolean $time 是否显示时间
 **/
function tpl_form_field_daterange($name, $value = array(), $time = false)

/**
 *【表单控件】: 出生日期控件
 * @param array $name 表单 input 名称
 * @param array $values 表单 input 值
 * @return string
 */
function tpl_form_field_calendar($name, $values = array())

/**
 *【表单控件】: 省市县 (区) 地区选择器
 * @param array $name 表单 input 名称
 *        默认为 $names['province'] = 'province',
 *        $names['city'] = 'city, $names['district'] ='district'
 * @param array $values 表单 input 值
 * @return string
 */
function tpl_form_field_district($name, $values = array()) 

/**
 * 二级分类选择器
 * @param string $name 表单名称
 * @param array $parents 父分类,
 * @param array $children 子分类,
 * @param int $parentid 选择的父 id
 * @param int $childid 选择的子 id
 * @return string Html 代码
 */
function tpl_form_field_category_2level($name, $parents, $children, $parentid, $childid)

/**
 *【表单控件】: 行业分类选择器
 * @param string $name  表单名称
 * @param string $pvalue 父类选中元素
 * @param string $cvalue 子类选中元素
 * @param string $parentid select 父类 id
 * @param string $childid  select 子类 id
 * @return string
 */
function tpl_form_field_industry($name, $pvalue = '', $cvalue ='', $parentid = 'industry_1', $childid = 'industry_2')

/**
 *【表单控件】: 地理位置选择器
 * @param string $field 表单中 input 名称
 * @param array $value 表单中 input 值
 *      $value['lat']，$value['lng']
 * @return string
 */
function tpl_form_field_coordinate($field, $value = array())

/**
 *【表单控件】: 系统预设表单
 * @param string $field 表单 input 名称
 *  表单类型:
 * <pre>
 *  'avatar': 上传头像
 *  'gender': 获取性别
 *  'birth' : 获取生日
 *  'reside': 获取地区
 *  'education': 获取学历
 *  'constellation': 获取星座
 *  'zodiac': 获取生肖
 *  'bloodtype': 获取血型
 * </pre>
 * @param mixed $value 表单 input 值
 * @return string
 */
function tpl_fans_form($field, $value = '')

还有些 tpl 开头的模板函数在 web app 下的 common 目录中的 tpl.func.php 文件内定义

1. web 下：对应在 web 端的网页
2. app 下：对应在手机端的网页

   web：

/**
 *【表单控件】: 日期控件
 *
 * @param string $name
 *      表单名称
 * @param string $value
 *      默认为当前日期时间
 * @param boolean $withtime
 *      是否显示时间(时分), 默认为不显示
 * @return form input string
 */
function _tpl_form_field_date($name, $value = '', $withtime = false)

/**
 *【表单控件】: 系统链接选择器
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @param array $options 选择器样式配置信息
 * @return string
 */
function tpl_form_field_link($name, $value = '', $options = array())

/**
 *【表单控件】:
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @return string
 */
function tpl_form_module_link($name)

/**
 *【表单控件】: Emoji 表情选择器
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @return string
 */
function tpl_form_field_emoji($name, $value = '')

/**
 *【表单控件】: 拾色器 (获取 HTML 色彩代码)
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @return string
 */
function tpl_form_field_color($name, $value = '')

/**
 *【表单控件】: 系统图标选择器
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @return string
 */
function tpl_form_field_icon($name, $value='')

/**
 *【表单控件】: 图片上传与选择控件
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @param string $default 默认显示的缩略图
 * @param array $options 图片上传配置信息
 * <pre>
 *      $options['width'] = '';
 *      $options['height'] = '';
 *      $options['global'] = '';// 是否显示 global 目录（公共目录）*      $options['extras'] = array(
 *          &nbsp;'image'=> 缩略图 img 标签的自定义属性及属性值 ,
 *          &nbsp;'text'=> input 标签的自定义属性及属性值
 *      )
 * </pre>
 * @return string
 */
function tpl_form_field_image($name, $value = '', $default ='', $options = array()) 

/**
 * 批量上传图片
 * @param string $name 表单 input 名称
 * @param array $value 附件路径信息
 * @param array $options  自定义图片上传路径
 * @return string
 */
function tpl_form_field_multi_image($name, $value = array(), $options = array())

/**
 *【表单控件】: 音乐选择与上传
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @param array $options 表单中 input 附加信息
 * @return string
 */
function tpl_form_field_audio($name, $value = '', $options = array()) 

/**
 * 批量上传音频
 * @param string $name 表单 input 名称
 * @param array $value 表单 input 值
 * @param array $options 自定义上传路径
 * @return string
 */
function tpl_form_field_multi_audio($name, $value = array(), $options = array())

/**
 *【表单控件】: 视频选择与上传
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @param array $options 表单中 input 附加信息
 * @return string
 */
function tpl_form_field_video($name, $value = '', $options = array())

/*
 * 门店类目选择三级联动
 * */
function tpl_form_field_location_category($name, $values = array(), $del = false)

/*
 * 百度富文本编辑器
 * @param $id 表单 input 名称
 * @param $value 表单 textarea 值
 * @return string
*/
 
function tpl_ueditor($id, $value = '', $options = array())

/*
 * 短信条数编辑器
 * @param $name 表单 input 名称
*/
function tpl_edit_sms($name, $value, $uniacid, $url, $num)

app 端：有个规律，就是在 web 端函数中加入_app_ 例如 tpl_app_fans_form

/**
 *【表单控件】: 图片上传
 * @param string $name 表单 input 名称
 * @param string $value 表单 input 值
 * @return string
 */
function tpl_app_form_field_image($name, $value = '')