You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by bu...@apache.org on 2013/11/22 16:45:19 UTC

svn commit: r887702 - in /websites/staging/isis/trunk: cgi-bin/ content/ content/core/dynamic-layouts.html

Author: buildbot
Date: Fri Nov 22 15:45:19 2013
New Revision: 887702

Log:
Staging update by buildbot for isis

Modified:
    websites/staging/isis/trunk/cgi-bin/   (props changed)
    websites/staging/isis/trunk/content/   (props changed)
    websites/staging/isis/trunk/content/core/dynamic-layouts.html

Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Nov 22 15:45:19 2013
@@ -1 +1 @@
-1544529
+1544581

Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Nov 22 15:45:19 2013
@@ -1 +1 @@
-1544529
+1544581

Modified: websites/staging/isis/trunk/content/core/dynamic-layouts.html
==============================================================================
--- websites/staging/isis/trunk/content/core/dynamic-layouts.html (original)
+++ websites/staging/isis/trunk/content/core/dynamic-layouts.html Fri Nov 22 15:45:19 2013
@@ -400,6 +400,10 @@ public class ToDoItem {
 </ul></li>
 </ul>
 
+<h3>Other Annotations</h3>
+
+<p>The <code>@Named</code>, <code>@DescribedAs</code>, <code>@MultiLine</code>, <code>@TypicalLength</code>, <code>@Render</code> and <code>@CssClass</code> annotations are also all hints that can affect the UI.  See the <a href="../applib-guide/reference/recognized-annotations/about.html">reference guide</a> for further details.</p>
+
 <h2>Dynamic Layouts</h2>
 
 <p>While the use of annotations to specify layout metadata is typesafe, it does have the disadvantage that changing the layout means recompiling the code and redeploying.</p>
@@ -411,63 +415,79 @@ public class ToDoItem {
 <p>The format of the <code>.layout.json</code> file is:</p>
 
 <pre><code>{
-    columns: [                                      // list of columns
+    columns: [                                                   // list of columns
         {
-            span: 6,                                // span of the left-hand property column
-            memberGroups: {                         // ordered map of member (property) groups
-                General: {                          // member group name
+            span: 6,                                             // span of the left-hand property column
+            memberGroups: {                                      // ordered map of member (property) groups
+                General: {                                       // member group name
                     members: {           
-                        description: {},            // property, no associated actions
+                        description: {                           // property, no associated actions, but with UI hint
+                            typicalLength: {                     // UI hint for size of field [new in 1.4.0-SNAPSHOT]
+                                value: 50
+                            }
+                        },            
                         category: {},               
-                        complete: {                 // property, with associated actions
+                        complete: {                              // property, with associated actions
                             actions: {              
                                 completed: {
-                                    named: {        // naming UI hint [new in 1.4.0-SNAPSHOT]
+                                    named: {                     // naming UI hint [new in 1.4.0-SNAPSHOT]
                                         value: "Done"
                                     }
+                                    cssClass: {                  // CSS UI hint [new in 1.4.0-SNAPSHOT] 
+                                        value: "x-highlight"
+                                    },
                                 },       
-                                notYetCompleted: {}
+                            notYetCompleted: {
+                                named: { value: "Not done" }
+                            },
+                            describedAs: {
+                                value: "Whether this todo item has been completed"
                             }
                         }
                     }
                 },
                 Misc: {
                     members: {
+                        notes: {
+                            multiLine: {                         // UI hint for text area
+                                numberOfLines: 5
+                            }
+                        },
                         versionSequence: {}
                     }
                 }
             }
         },
         {
-            span: 6,                                // span of the middle property column
+            span: 6,                                             // span of the middle property column
             memberGroups: { ... }
         },
         {
-            span: 0                                 // span of the right property column (if any)
+            span: 0                                              // span of the right property column (if any)
         },
         {
             span: 6,
-            collections: {                          // ordered map of collections
-                dependencies: {                     // collection, with associated actions
+            collections: {                                       // ordered map of collections
+                dependencies: {                                  // collection, with associated actions
                     actions: {                      
                         add:{},
                         delete: {}
                     },
-                    paged: {                        // pagination hint [new in 1.4.0-SNAPSHOT]
-                        value: 10                   // 10 items to a page 
+                    paged: {                                     // pagination UI hint [new in 1.4.0-SNAPSHOT]
+                        value: 10                                // 10 items to a page 
                     },
-                    render: {                       // rendering hint [new in 1.4.0-SNAPSHOT]
+                    render: {                                    // lazy-loading UI hint [new in 1.4.0-SNAPSHOT]
                         value: EAGERLY
                     }
                 },
-                similarItems: {}                    // collection, no associated actions
+                similarItems: {}                                 // collection, no associated actions
             }
         }
     ],
-    actions: {                                      // actions not associated with any member
+    actions: {                                                   // actions not associated with any member
         delete: {},
         duplicate: {
-            named: {                                // naming UI hint [new in 1.4.0-SNAPSHOT]
+            named: {                                             
                 value: "Clone"
             }
         }