render 渲染方法族 - KuoqiPHP v1.05 开发文档

首页›MVC 核心›render 渲染方法族

render 渲染方法族

render / renderPartial / renderText 三种渲染方式与返回值约定

本页内容

方法对比
$errReturn 语义
渲染选型经验

方法对比

方法	layout 标志	模板文件	说明
`render($tpl="",$params=[],$errReturn=false)`	true	必须存在	标准渲染，内容交由 returnLayout 包裹
`renderPartial($tpl="",$params=[],$errReturn=false)`	false	必须存在	渲染片段，不包裹 layout（AJAX/片段）
`renderText($stream)`	false	不需要	直接返回字符串（trim），不做模板解析
`display($tpl="",$params=[])`	true	必须存在	有 Bug，等价 render("",[])，勿用

$errReturn 语义

值	模板不存在时
`false`（默认）	抛 Exception 终止
`true`	返回 false，可降级处理

直接传参（无需 assign）

// 推荐写法：$params 直接传给模板
return $this->render("", array(
    "model" => $model,
    "list"  => $list,
    "title" => "页面标题",
));

// 等价于（冗余写法）
$this->assign("model", $model);
$this->assign("list", $list);
$this->assign("title", "页面标题");
return $this->render();

渲染选型经验

普通页面 → render()（自动套用已设置的 layout）
iframe 弹窗页面 → render()（需要完整 HTML + $__ui_layout CSS）
AJAX 返回片段 → renderPartial()
纯字符串输出 → renderText()
自带完整 HTML 的独立页面 → renderPartial()（避免 layout 嵌套两套 html）

KuoqiPHP v1.05 · 离线静态文档 · 界面基于 KuoqiUI · 返回首页