Readme.md 2.86 KB

项目整体说明

appweb及esp页面说明

  1. 后端使用appweb嵌入式web,使用c语言开发,由李云深负责。webapp服务器文档
  2. esp页面为 appweb支持的开发框架的一部分,文档请参考:esp框架文档,本项目中你可以简单的把esp作为 html页面来编辑。esp页面可以理解为 html页面中添加了部分C语言代码,类似于Php, jsp,asp.net等服务端动态页面技术。

页面实现细节

  1. 主体页面为 index.esp,主要职能是页面的布局(使用jquery easyui layout),消息OCX响应事件处理。
  2. 首页为 mainPage.html,主要功能是首页Ocx播放,处理消息控件发送的事件,显示图片,及表格数据等。处理数据及显示的逻辑,使用了knockoutjs框架,具体使用方法请参考: knockoutjs文档
  3. 所有的js文件放在scripts目录下。
  4. 国际化使用 jquery i18n properties来实现,请参数i18n目录下的说明及s2相机客户端交接项目中的国际化方案文档。
  5. 菜单数据在 i18n目录下,已经初步国际化,请参考: menu_en.jsonmenu_zh_CN.json文件,菜单展示相关逻辑在 mainPage.js文件中。
  6. 页面上大量使用了jquery easyui组件,具体使用方法自行查看网络上的相关文档。
  7. 页面参数验证使用的是jquery validate组件,具体方法自行查看文档,或参考之前的页面。

修改页面的步骤

  1. 确定要修改的页面,要修改或添加的参数。与李云深确定获取参数的类别的名称及成员参数是否改变(一般李云深会发一个xml文件,里面定义的是类别名称与成员参数的映射关系,具体格式请求李云深)。
  2. 根据该文档说明,结合scripts\utilities.js中获取参数的注释说明,参考之前的页面代码照着写就行。
  3. 页面大部分逻辑已经封装成函数,需要处理的一般是参数验证(使用 jquery validate组件),及UI展示的处理,获取,保存参数等方法直接调用现成的。

修改前注意事项

为了防止出现重复代码,各页面实现不一致等问题,修改前请检查以下各条规则是否成立

  1. utilities.js文件中封装了很多通用方法,首先看一下是否有需要的方法,尽量重用之前的。
  2. 一些功能的使用使用了对应的组件(参考页面实现细节),尽量使用原有方案,保证各个页面的统一。

可能出现的兼容性问题

该项目需要兼容IE8,使用console对象打印日志时要注意,IE8,IE9不打开开发者工具是没有console对象的,直接使用会报错。解决方法如下:

  1. 引入console-polyfill.js
  2. 使用前先判断console对象是否存在,参考 utilities.js中打印日志的方法。