微擎框架函数组件

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

使用前请务必加载模板组件函数

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 = '')

还有些函数没摘出来,因为我也不知道干啥用的。。。常用的函数,通过查询手册或者看我上面贴出来的基本就够用了。