Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@cocoon.apache.org
Content-Type: text/plain; charset="iso-8859-1"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
From: docs@cocoon.apache.org
To: docs@cocoon.apache.org
Subject: =?iso-8859-1?q?=5BCocoon_Wiki=5D_Updated=3A__WhiteBoardCocoonForms?=
Date: Tue, 08 Mar 2005 19:02:26 -0000
Message-ID: <20050308190226.83603.1956@minotaur.apache.org>

   Date: 2005-03-08T11:02:26
   Editor: ReinhardPoetz
   Wiki: Cocoon Wiki
   Page: WhiteBoardCocoonForms
   URL: http://wiki.apache.org/cocoon/WhiteBoardCocoonForms

   no comment

Change Log:

---------------------------------------------------------------------------=
---
@@ -22,10 +22,10 @@
 All aspects of these features (syntax, implementation, etc.)
 are subject to discussion and change.
 =

-=3D=3D Macro library support =3D=3D
+=3D=3D Macro library and field extensions support =3D=3D
  *Define - Creates a reusable macro definition.
  *Expand - Creates an instance of a macro definition.
- *Macros - Defines a reusable macro library.
+ *Library - Defines a reusable macro library.
  *Import - Brings a macro library into scope.
 =

 The syntax and examples below are written assuming use of
@@ -33,7 +33,7 @@
 also present for the form binding and the form template,
 using the respective name spaces.
 =

-=3D=3D=3D Define =3D=3D=3D
+=3D=3D=3D Define a macro =3D=3D=3D
 Creates a reusable macro definition.
 {{{
 Syntax:
@@ -80,22 +80,23 @@
 }}}
 =

 =3D=3D=3D Macros =3D=3D=3D
-Defines a reusable macro library.
+Defines a reusable library.
 =

 {{{
 Syntax:
 =

-  <fd:macros>
+  <fd:library>
     <!-- Macro definitions -->
-  </fd:macros>
+    <!-- Reusable field definitions -->
+  </fd:library>
 =

 Note:
 =

-  The "fd:macros" element must be the root of the document.
+  The "fd:library" element must be the root of the document and contains m=
acros and fields.
 =

 Example:
 =

-  <fd:macros>
+  <fd:library>
     <fd:macro define=3D"product">
       <fd:field id=3D"name">
         <fd:label>Name</fd:label>
@@ -106,11 +107,29 @@
         <fd:datatype base=3D"decimal"/>
       </fd:field>
     </fd:macro>
-  </fd:macros>
+
+    <fd:field id=3D"email">
+      <fd:label>email</fd:label>
+      <fd:datatype base=3D"string"/>
+      <fd:validation>
+         <fd:email/>
+      </fd:validation>
+    </fd:field>
+
+    <fd:field id=3D"customer-number">
+      <fd:label>customer number</fd:label>
+      <fd:datatype base=3D"string"/>
+      <fd:validation>
+        <fd:length exact=3D"16"/>
+      </fd:validation>
+    </fd:field>
+    =

+
+  </fd:library>
 }}}
 =

-=3D=3D=3D Import =3D=3D=3D
-Brings a macro library into scope.
+=3D=3D=3D Import (using the library's elements) =3D=3D=3D
+Bring library elements into scope.
 {{{
 Syntax:
 =

@@ -118,8 +137,15 @@
 =

 Example:
 =

-  <fd:import prefix=3D"my-macros" uri=3D"cocoon:/custom-fd-macros.xml"/>
-  <fd:macro expand=3D"my-macros:product"/>
+  <fd:import prefix=3D"my-library" uri=3D"cocoon:/custom-fd-library.xml"/>
+  <fd:macro expand=3D"my-library:product"/>
+  <fd:field id=3D"customer-email" extends=3D"my-library:email">
+    <fd:label>customer's email</fd:label>
+    <fd:validation>
+      <fd:length exact=3D"30"/>
+    </fd:validation>
+  </fd:field>
+  <fd:field id=3D"cust" extends=3D"my-library:customer-number"/>
 =

 Effective result:
 =

@@ -131,6 +157,23 @@
     <fd:label>Price</fd:label>
     <fd:datatype base=3D"decimal"/>
   </fd:field>
+
+  <fd:field id=3D"customer-email">
+    <fd:label>customer's email</fd:label>
+    <fd:validation>
+      <fd:length exact=3D"30"/>
+      <fd:email/>
+    </fd:validation>
+  </fd:field>
+
+  <fd:field id=3D"cust">
+    <fd:label>customer number</fd:label>
+    <fd:datatype base=3D"string"/>
+    <fd:validation>
+       <fd:length exact=3D"16"/>    =

+    </fd:validation>
+  </fd:field>
+
 }}}
 =

 The "prefix" is a user-defined string used when expanding
@@ -139,6 +182,8 @@
 =

 The "uri" identifies the source for the macro library.
 Any protocol understood by Cocoon may be used.
+
+Note that single fields don't need to be defined within an {{{fd:macro}}} =
element. This (global) definitions can be reused in the custom form definit=
ion using the {{{extends}}} attribut.
 =

 =3D=3D=3D Additional Notes =3D=3D=3D
=20