Some documentation and better defaults for formlayout

svn changeset:5849/svn branch:trunk

1 files changed, 21 insertions, 0 deletions

diff --git a/src/com/itmill/toolkit/ui/FormLayout.java b/src/com/itmill/toolkit/ui/FormLayout.java
index fe972db98b..d822887fa9 100644
--- a/src/com/itmill/toolkit/ui/FormLayout.java
+++ b/src/com/itmill/toolkit/ui/FormLayout.java
@@ -4,8 +4,29 @@
 
 package com.itmill.toolkit.ui;
 
+/**
+ * FormLayout is used by {@link Form} to layout fields. It may also be used
+ * separately without {@link Form}.
+ * 
+ * FormLayout is a close relative to vertical {@link OrderedLayout}, but in
+ * FormLayout caption is rendered on left side of component. Required and
+ * validation indicators are between captions and fields.
+ * 
+ * FormLayout does not currently support some advanced methods from
+ * OrderedLayout like setExpandRatio and setComponentAlignment.
+ * 
+ * FormLayout by default has component spacing on. Also margin top and margin
+ * bottom are by default on.
+ * 
+ */
 public class FormLayout extends OrderedLayout {
 
+    public FormLayout() {
+        super();
+        setSpacing(true);
+        setMargin(true, false, true, false);
+    }
+
     public String getTag() {
         return "formlayout";
     }