boa框架开发手册v5.2

view类
版本 1.0+
命名空间 boa
文件 boa/view.php
说明 视图类,配置:'VIEW_XML_ROOT' => ''
配置
配置项 默认值 类型 说明
VIEW_XML_ROOT boa string 可选;默认的XML文档根元素
目录
方法 说明
assign() 为可视化输出中的变量赋值
cli() 命令行下内容输出
str() 输出一段字符串,支持HTML
json() 输出或返回json格式内容
page() 渲染分页页码
html() 输出或返回编译后的HTML模板内容
xml() 输出或返回xml格式内容
jsonp() 输出或返回jsonp格式内容
jump() 页面跳转
msg() 系统消息输出
lost() 显示404页面
error() 显示500页面
file() 直接输出文件到浏览器供下载
方法

assign()

说明
为可视化输出中的变量赋值
参数 必须 默认值 类型 说明
$k Y string
$v Y string
示例
$this->view->assign('title', 'Boa welcome you');

cli()

说明
命令行下内容输出
参数 必须 默认值 类型 说明
$str Y string 要输出的内容
$clean true bool 输出前是否清除缓冲区内容
$exit true bool 输出后是否退出程序
示例
$this->view->cli('Hello world');

str()

说明
输出一段字符串,支持HTML
参数 必须 默认值 类型 说明
$str Y string 要输出的内容
$exit true bool 输出后是否退出程序
示例
$this->view->str('Hello world');

json()

说明
输出或返回json格式内容
参数 必须 默认值 类型 说明
$data [] array 要输出的数据
$code 0 int 状态码,0=无错
$msg OK string 提示信息
$return false bool 是否返回内容
返回值
如果return=true时,返回内容,否则直接输出
示例
$this->view->json(['row1','row2','...']);

page()

说明
渲染分页页码
参数 必须 默认值 类型 说明
$page Y array 分页数据,由database类提供
$number 10 int 显示多少页码
$first true bool 是否显示首页
$last true bool 是否显示尾页
$prev false bool 是否显示上页
$next false bool 是否显示下页
返回值
返回分页页码内容(string)
示例
$page = $this->view->page([total:500, pagesize:10, pages: 50, current: 1]);

$page = $this->view->page($db->page());

html()

说明
输出或返回编译后的HTML模板内容
参数 必须 默认值 类型 说明
$tpl string 模板相对路径,省略则等于当前“控制器/动作”;在实例和模块中,程序优先查找实例中的模板
$return false bool 是否返回内容,命令行下默认关闭缓冲(直接输出),如需要返回内容请在适当的地方使用ob_start()开启缓冲
返回值
如果return=true时,返回内容,否则直接输出
示例
$this->view->html('index/custom');

xml()

说明
输出或返回xml格式内容
参数 必须 默认值 类型 说明
$data [] array 要输出的数据
$code 0 int 状态码,0=无错
$msg OK string 提示信息
$return false bool 是否返回内容
返回值
如果return=true时,返回内容,否则直接输出
示例
$this->view->xml(['row1','row2','...']);

jsonp()

说明
输出或返回jsonp格式内容
参数 必须 默认值 类型 说明
$callback Y string 前端回调函数名称
$data [] array 要输出的数据
$code 0 int 状态码,0=无错
$msg OK string 提示信息
$return false bool 是否返回内容
返回值
如果return=true时,返回内容,否则直接输出
示例
$this->view->jsonp('js_callback', ['row1','row2','...']);

jump()

说明
页面跳转
参数 必须 默认值 类型 说明
$url Y string 要跳转到的链接
$sec 0 int 跳转前等待时长,单位:秒
$tip null string 跳转提示
示例
$this->view->jump('/user/login.php', 10, '请登录');

msg()

说明
系统消息输出
参数 必须 默认值 类型 说明
$msg Y array 要输出的消息数据
$type error string 消息模板类型,可选值:info、error或其他自定义类型
$clean true bool 输出前是否清除缓冲区内容
$exit true bool 输出后是否退出程序
示例
$this->view->msg(['key' => 0, 'msg' => 'done'], 'info');

lost()

说明
显示404页面
参数 必须 默认值 类型 说明
$url string 丢失页面的路径,默认为当前页面
示例
$this->view->lost();

error()

说明
显示500页面
示例
$this->view->error();

file()

说明
直接输出文件到浏览器供下载
参数 必须 默认值 类型 说明
$file Y string 服务器端文件路径
$name string 浏览器端下载时保存的名称,默认为文件原始名称
示例
$this->view->file(BS_WWW .'file/document.pdf', 'readme.pdf');