Changes between Version 23 and Version 24 of DeveloperGuidelines/Themes

Timestamp:

01/15/15 03:41:40 (10 years ago)

Author:

svineet

Comment:

add formstyle docs

DeveloperGuidelines/Themes

@@ -43 +43 @@
 Note that all CSS files should be able to find their images both in debug mode & when compressed into eden.min.css - this is normally done by having the files at the same depth in the tree.
 
+You can also customize the styling and classes used in forms using formstyle. Add this to config.py (in config() function if using the new template location):
+
+{{{
+settings.ui.formstyle = "your_formstyle"
+}}}
+
+Formstyles can be: table2cols, table3cols, divs, bootstrap, foundation and many more. You can find these functions in web2py/gluon/sqlhtml.py with the names "formstyle_<something here>". You can refer to these to implement custom functions. The settings.ui.formstyle can also take a function. And example function to use Semantic UI form styling:
+
+{{{
+def semantic_formstyle(id, label, controls, help):
+    """ divs only """
+    _help = DIV(help, _class='w2p_fc')
+    _controls = controls
+    _label = LABEL(label)
+    return DIV(
+        _label,
+        _controls,
+        _help,
+        _id=id,
+        _class="ui field"
+        )
+}}}
+
+
 NB Production sites who wish to compile their code either need to hardcode the theme name in their {{{views/layout.html}}} or upgrade to Web2Py version: 2.00.0 (2012-06-17 23:36:32), or newer.