Wii AdminUI 3(WAU3)

概述

页面渲染流程

WAU3采用单点入口模式进行页面渲染,流程如下:

  1. 同步加载基础页面,拉取前端资源。
  2. 异步拉取页面模板(Layout)数据。
  3. 异步拉取页面内容(Content)数据。
  4. 异步拉取页面业务数据。
  5. 渲染页面。

关键概念

  • 默认入口页面(推荐)

    https://[DOMAIN]/[APP]/[MODULE]/v3#[CONTROLLER]/[ACTION]`
    

    每个模块(Module)需定义入口页面:[APP]/[MODULE]/V3Controller,可直接继承 \wii\wau\controllers\V3Controller,例如:

    namespace wii\api\modules\useridentity\controllers;
    
    /**
    * WAU
    * Class V3Controller
    * @package wii\api\modules\useridentity\controllers
    */
    class V3Controller extends \wii\wau\controllers\V3Controller
    {
    }
    

    此时“默认入口”使用 [MODULE]/views/layouts/default.yml 数据进行渲染页面。

  • 自定义入口页面

    在任意Action中都可以使用 renderWau3($view)的方式实现入口文件:

    /**
     * 我的入口
     */
    public function actionMy()
    {
       return $this->renderWau3('layout');
    }
    

    此时“自定义入口”使用 [MODULE]/views/layouts/layout.yml 数据进行渲染页面。

  • 页面模板/内容数据拉取接口

    https://[DOMAIN]/[APP]/[MODULE]/v3/content?path=[CONTROLLER]/[ACTION]
    

    注意: 此接口地址不允许自定义

  • 页面数据路径

    页面数据路径:[CONTROLLER]/[ACTION],文件路径:

    [MODULE]/views/[CONTROLLER]/[ACTION].yml
    

常量说明

DOMAIN : 访问域名 APP : 应用名 MODULE : 模块名 VIEW_PATH : 页面访问路径,通常格式为:CONTROLLER/ACTION

基本页面/接口

访问入口页面

/**
 * WAU - 默认页面入口
 * @return mixed
 * @throws Exception
 */
public function actionIndex()
{
    return $this->renderWau3('default');
}

default为页面layout名,存储在 [APP]/[MODULE]/views/layout/default.yml中。

页面内容接口

https://[DOMAIN]/[MODULE]/v3/content?path=[VIEW_PATH]

results matching ""

    No results matching ""