门户站群【数据集成】开发文档（V1.5）

开发流程：【制作静态网站】=>【创建子网站栏目】=>【网站数据集成】=>【发布网站】

一、准备工作

制作网站静态页面（包含html文件、css文件、js文件和图片文件）,网站至少应包括以下几个页面：

二、每个页面头部（head标签内）或尾部（body标签内）引入如下JS（其中域名xxx.xxx.xxx更改为当前接口文档的域名）

    <script src="https://xxx.xxx.xxx/wwwservice/commonJs/jquery1.min.js" type="text/javascript"></script>
    <script src="https://xxx.xxx.xxx/wwwservice/commonJs/moment.min.js" type="text/javascript"></script>
    <!--当前jquery1.min.js的版本为1.12.4，请避免在网页中重复引入-->
    <!--根据需要，也可以使用其他版本的引用（3.7.1）：https://xxx.xxx.xxx/wwwservice/commonJs/jquery3.min.js-->
    <script src="https://xxx.xxx.xxx/wwwservice/commonJs/ZywCommonApi.js?v=1" type="text/javascript"></script>
    <script src="https://xxx.xxx.xxx/wwwservice/commonJs/loadingData.js?v=1" type="text/javascript"></script>

三、每个页面头部head标签内或尾部（body标签内）添加入口函数加载数据。（可放在单独的JS文件中再引入）

    <script>
        $(function () {
            //参数1：必填，顶级栏目ID（由超级管理员分配）
            //参数2：必填，固定值（门户站群系统数据接口地址）
            //参数3：选填，回调函数，可利用回调函数来进行装载数据后的一些处理，比如页面的轮播图片.（注意不同的loadType,其参数值表示不同的内容）
            loadingData("www", "https://xxx.xxx.xxx/wwwservice", function (loadType,param1,param2) {
            switch (loadType) {
                case "loadingType0":
                    //TODO 完成加载一级栏目后执行......;
                    break;
                case "loadingType":
                    //TODO 完成加载二级栏目（单项）后执行......;
                    break;
                case "loadingInfoType0ListAll":
                    //TODO 完成加载一级栏目全部列表后执行......;
                    //参数param1：自定义参数，对应data-infoListBy-search-typeListAll的参数值
                    break;
                case "loadingInfoTypeListAll":
                    //TODO 完成加载二级栏目全部列表后执行......;
                    //参数param1：自定义参数，对应data-infoListBy-search-typeListAll的参数值
                    break;
                case "loadingInfoTypeListBy":
                    //TODO 完成加载二级栏目（列表）后执行......;
                    //参数param1：对应data-typeListBy="type0id"中的值type0id（一级栏目ID）
                    break;
                case "loadingInfomationList":
                    //TODO 完成加载信息列表后执行......;
                    //参数param1：对应data-infoListBy="typeid,recordNum,currentPage,customParam"中的第1个参数typeid（二级栏目ID）
                    //参数param2：对应data-infoListBy="typeid,recordNum,currentPage,customParam"中的第四个参数customParam（自定义参数）

                    //  if(param1==="www0004") {
                    // 在这里可以加载依赖动态数据的JS，比如动态新闻的轮播图片
                    // }

                    break;
                case "loadingInfomationListForSearch":
                    //TODO 完成加载信息列表后执行......;
                    //参数param1：对应data-infoListBy-forSearch="typeid,recordNum,currentPage,customParam"中的第1个参数typeid（二级栏目ID）
                    //参数param2：对应data-infoListBy-forSearch="typeid,recordNum,currentPage,customParam"中的第四个参数customParam（自定义参数）
                    break;

                case "loadingInfomationById":
                   //TODO 完成加载信息内容后执行......;
                   //参数param1：对应当前页面的请求参数informationid（信息ID）
                    break;
                case "loadingInformationAccessory"://加载附件（列表）
                  //TODO 完成加载附件（列表）后执行......;
                  //参数param1：对应当前页面的请求参数informationid（信息ID）
                    break;
            }
        });
    })
    </script>

    推荐方法：将以上加载数据脚本放在单独的JS文件中再引入
    JS文件：commonMy.js
    HTML文件： <head><script src="js/commonMy.js"></script></head>

    如果页面的头部或尾部是分离出来后动态加载的（head.html），并且这些页面有动态加载的数据，需注意加载顺序
    HTML文件：<body><div id="headerPlaceholder" ></div></body>
    JS脚本：
    $(function () {
        $("#headerPlaceholder").load("head.html",function (){
                loadingData("www", "https://xxx.xxx.xxx/wwwservice", function (loadType,param1,param2) {
                    ......
                ｝
        });
    })

四、为每个页面的html标签添加data属性（未特别说明，data属性将作用于标签内容或指定的属性值，部分标注可使用的URL请求参数：$typeid0，$typeid，$page）

属性
说明
属性值

五、其他说明

  1. 1、如果页面中存在加载数据之后才能运行的其他JS插件，请迁移至入口函数中加载数据的回调函数中处理