微擎框架函数组件
官方文档里模板函数写的很少只有几个!但这些组件直接调用很方便开发者开发,因此将其整理,方便查找调用!
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名称 * 表单类型: ** 'avatar':上传头像 * 'gender':获取性别 * 'birth' :获取生日 * 'reside':获取地区 * 'education':获取学历 * 'constellation':获取星座 * 'zodiac':获取生肖 * 'bloodtype':获取血型 ** @param mixed $value 表单input值
* @return string
*/
function tpl_fans_form($field, $value = '')
还有些tpl开头的模板函数在web app下的common目录中的tpl.func.php文件内定义
web下:对应在web端的网页
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 图片上传配置信息 ** $options['width'] = ''; * $options['height'] = ''; * $options['global'] = '';// 是否显示 global 目录(公共目录) * $options['extras'] = array( * 'image'=> 缩略图img标签的自定义属性及属性值 , * 'text'=> input 标签的自定义属性及属性值 * ) ** @return string
*/
function tpl_form_field_image($name, $value = '', $default = '', $options = array()){php echo tpl_form_field_image('thumb',$activity['thumb'], '', array('global'=>false, 'dest_dir'=>'need_image/image'));}
'dest_dir'=>'need_image/image' 代表存储在微擎文件夹attachment/images/自定义文件夹/need_image/image目录下
注意:图片上传目录只能指定最多两级目录,如: "we7", "we7/d1"'
/**
* 批量上传图片
* @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 = '')
还有些函数没摘出来,因为我也不知道干啥用的。。。常用的函数,通过查询手册或者看我上面贴出来的基本就够用了。