增加注释

pages/classes/classes.js

@@ -12,13 +12,18 @@ const getDataForRender = class_ => ({
 Page({
 
   /**
-   * 页面的初始数据
+  页面的初始数据data，用于与.wxlm文件绑定
+  classes: 课程列表 type: Array
+    元素class: 课程信息 class.objectId 唯一
+      class.objectId  课程唯一主键
+      class.name  课程名称
    */
-  classes : [],
   data: {
     classes: [
       ]
   },
+
+  classes: [],
   enter_class: function(event){
     console.log(event);
     var class_id = event.currentTarget.dataset.class_id;

pages/classes/classes.wxml

@@ -1,3 +1,10 @@
+<!--
+所有的页面数据见同目录classes.js中Page.data定义部分
+classes: 课程列表 type: Array
+  元素class: 课程信息 class.objectId 唯一
+    class.objectId  唯一键
+    class.name  课程名称
+-->
 <view class="class-list">
 <block wx:for="{{classes}}" wx:for-item="class" wx:key="objectId">
   <view class="flex-wrap classroom" data-class_id="{{class.objectId}}" data-class_name="{{class.name}}" bindtap="enter_class">

pages/classroom/classroom.js

@@ -4,18 +4,24 @@ const { jsonify } = require('../../utils/leancloudutils');
 
 Page({
   /**
-   * 页面的初始数据
+   页面的初始数据
+   students: 该课程所有的学生
+    元素student
+      student.username 学生的用户名，是唯一，就像微信号一样
+      student.name  学生的姓名
+  
    */
   presence: null,
   students: [],
   present_students: [],
   class: null,
   data: {
-    present_students: [],
+    //以下数据的同步由该代码文件实现，数据的呈现由classroom.wxml实现
-    students: [],
+    present_students: [], // 出席的学生的用户名即上文提及的student.username
-    unpresent_students: [],
+    students: [],  // 该课程所有的学生
-    class_name: "",
+    unpresent_students: [], //没有出席的学生的用户名，不建议使用该数据，考虑弃用
-    class_id: "",
+    class_name: "",//课程名称
+    class_id: "",//该课程的主键（编号）
   },
   fetch_present: function(){
     var query = new AV.Query("Presence");

pages/classroom/classroom.wxss

@@ -7,6 +7,7 @@
   flex-wrap: wrap;
   width: 100%;
 }
+/* 下面这个实现表格式的布局，有多行多列，width=25% 表示将会显示4列 */
 .grid-cell{
  flex: 0 0 auto;
   width: 25%;

读我.txt

@@ -1,6 +1,6 @@
 # 后台数据交互部分日志
 
-## 登录微信公众平台，前往 设置 > 开发设置 > 服务器配置 > 「修改」 链接，增加下述域名为白名单中的域名
+## 已完成-登录微信公众平台，前往 设置 > 开发设置 > 服务器配置 > 「修改」 链接，增加下述域名为白名单中的域名
 request合法域名
 fqcxn98z.api.lncldglobal.com
 fqcxn98z.engine.lncldglobal.com