Changes between Version 5 and Version 6 of DeveloperGuidelines/DataTables

Timestamp:

06/10/11 06:51:40 (15 years ago)

Author:

graeme

Comment:

--

DeveloperGuidelines/DataTables

@@ -58 +58 @@
 
     response.s3.postp = postp
-    return s3_rest_controller(module, resourcename)  }}}
+    return s3_rest_controller(module, resourcename)
+   }}}
 }}}
 This is sufficient to generate a vanilla dataTable as follows:
@@ -89 +90 @@
                               ]
         return output
+   }}}
 }}}
 Notice that before the Open and Delete buttons were provided, now they need to be explicitly added.
@@ -126 +128 @@
                               ]
         return output
+   }}}
 }}}
 The key is the restrict argument that is passed to the Import button. This is set up as a list of record ids that will display the button.
@@ -133 +136 @@
 
 === Changing the displayed text ===
+Sometimes it can be convenient to change the displayed text of a status field in the dataTable. This can be done by using the response.s3.dataTableDisplay attribute. First I'll change the model to include a status field:
+{{{
+#!div style="font-size: 80%"
+change to teh data model:
+  {{{#!python
+    table = db.define_table(tablename,
+                            Field("name", required=True, notnull=True),
+                            Field("path", type="upload", uploadfield=True, required=True, notnull=True, readable=False),
+                            comments(),
+                            Field("status", type="integer"),
+                            migrate=migrate,
+                            *(s3_timestamp() + s3_uid()))
+  }}}
+}}}
+[[BR]]
+[[Image(DataTable_with_Status.png)]]
+[[BR]]
+Now add the code to display a text field depending upon the status:
+{{{
+#!div style="font-size: 80%"
+Add this to the postp() function of the controller:
+  {{{#!python
+        values = [dict(col=3, key="1", display=str(T("Uploaded"))),
+                  dict(col=3, key="2", display=str(T("Imported")))
+                 ]
+        response.s3.dataTableDisplay = values
+  }}}
+}}}
+[[BR]]
+[[Image(DataTable_with_Status_Labels.png)]]
+[[BR]]
 === Sorting by a selected column ===
+
 === Filter Rows ===
 === Selecting Rows ===