Changes between Version 4 and Version 5 of FormProcessing

Timestamp:

Jul 1, 2008, 9:24:32 PM (16 years ago)

Author:

cmlenz

Comment:

--

FormProcessing

@@ -11 +11 @@
 class LinkForm(Form):
     username = TextValidator(required=True)
-    url = TextValidator(required=True)
+    url = TextValidator(required=True, pattern=r'^https?://')
     title = TextValidator(required=True)
 
@@ -19 +19 @@
     if request.method == 'POST':
         if 'cancel' in request.POST:
-            redirect_to('index')
+            redirect_to('home')
         if form.validate(request.POST):
-            # Form is valid, store data int the database
+            # Form is valid, store data into the database
             link = Link(**form.data)
             link.store(app.db)
@@ -32 +32 @@
  * The form submission is protected against Cross-Site Request Forgery (CSRF) attacks, by adding a form token both as a cookie, and as a hidden form input field.
 
+== HTML Forms in Templates ==
+
+Diva does not generate HTML markup for your forms automatically. The `diva.forms` package is only concerned with the form data, not the rendering of individual form elements and how they assembled into the larger form.
+
+For the form defined above, a simple template might contain something like this:
+
+{{{
+#!genshi
+<form action="" method="post">
+  <p>
+    <label>Your name: <input type="text" name="username" /></label>
+    <span py:if="'username' in errors" class="error">${errors.username}</span>
+  </p><p>
+    <label>Link URL: <input type="text" name="url" /></label>
+    <span py:if="'url' in errors" class="error">${errors.url}</span>
+  </p><p>
+    <label>Title: <input type="text" name="title" /></label>
+    <span py:if="'title' in errors" class="error">${errors.title}</span>
+  </p>
+  <hr />
+  <p>
+    <input type="submit" />
+  </p>
+</form>
+}}}
+
+Note that while you don't need to manually take care of filling in the form values, you do have to explicitly add any error messages that need to be displayed after a failed validation.
+
 == API Documentation ==