Editing page: Outdated egg! - The CHICKEN Scheme wiki

You can edit this page using wiki syntax for markup.

Article contents:

== Outdated egg!

This is an egg for CHICKEN 4, the unsupported old release.  You're almost certainly looking for [[/eggref/5/html-form|the CHICKEN 5 version of this egg]], if it exists.

If it does not exist, there may be equivalent functionality provided by another egg; have a look at the [[https://wiki.call-cc.org/chicken-projects/egg-index-5.html|egg index]]. Otherwise, please consider porting this egg to the current version of CHICKEN.

[[tags: egg]]

== html-form

[[toc:]]

=== Introduction

The {{html-form}} library is intended to construct HTML form
descriptions in an s-expression syntax that are then passed to an HTML
generation routine.

=== Library procedures

This is the only exported routine in this egg. Given a form
specification, returns an SXML document containing an HTML
form. {{SPEC}} is an s-expression with the following grammar:

SPEC = (form-group NAME [(label LABEL)] (children ...) ) 
         | WIDGET

WIDGET =     (checkbox NAME DFLT [(label LABEL)] [(rel REL)] ) 
               (textarea NAME DFLT (rows N) (cols N) [(label LABEL)] [(rel REL)] ) 
               (select   NAME DFLT [(label LABEL)] [(rel REL)] ) 
               (button   NAME DFLT [(label LABEL)] [(rel REL)] [(onclick STRING)] )
               (radio    NAME DFLT [(label LABEL)] [(rel REL)] ( (RNAME ROPTS) ... ) )
               (text     NAME DFLT [(label LABEL)] [(rel REL)] )

{{NAME}}, {{LABEL}} and {{REL}} are symbols or strings. {{DFLT}} is
the default value of an input, or a list of values in the case of
{{textarea}} and {{select}}.

=== Example

(use html-form)

(define Country-List
  `("Afghanistan"
    "Albania"
    "Algeria"
    "American Samoa"
    "Andorra"
    ))

(define form-variables
  `(
    (form-group Personal-Data (label "Personal Data")
                (children 
                 (First-Name         ""  (label "First Name * "))
                 (Last-Name          ""  (label "Last Name * "))
                 (email              ""  (label "Email address * "))
                 (Nationality        ""  (label "Nationality *")
                                     (select ,Country-List))
                 (Birth-Year         ""
                                     (label "Year of birth *")
                                     (select ,(list-tabulate 50 (lambda (i) (number->string (+ 1940 i))))))
                 (Gender             "" 
                                     (label "Gender *")
                                     (select ("Female" "Male")))
                 ))

(form-group   Education (label "Education & professional background")
                  (children 
                   (Degree     "" (label "Last degree obtained ")
                                  (select 
                                     ("Bachelor of Science"
                                      "Master of Science"
                                      "Ph.D."
                                      "Current undergraduate student")))
                   (Major      "" (label "Academic major ")
                                  (select 
                                     ("Artificial Intelligence"
                                      "Biochemistry"
                                      "Biology"
                                      "Biomedicine"
                                      "Other")))
                   (Degree-Other ""   (label "Degree obtained if other "))
                   (Education-History ""  
                                      (label "Education history")
                                      (hint "Please list year, institution, and highest degree obtained. ")
                                      (textarea (rows 10) (cols 60)))
                   ))))

(pretty-print (map (lambda (x) (html-form x)) form-variables))

=== Author

[[/users/ivan-raikov|Ivan Raikov]]

=== Version

; 1.4 : checkbox fixes
; 1.3 : Added functionality for multiple selections
; 1.2.1 : Use of setup-api 'copy-file' [Kon Lovett]
; 1.1 : Ported to Chicken 4
; 1.0 : Initial version

=== License

Copyright 2008-2011 Ivan Raikov and the Okinawa Institute of Science
 and Technology.
 
 {{html-form}} is distributed along with the wFORMS 2.0 Stylesheet,
 copyright 2005-2006 Cedric Savarese (http://www.4213miles.com).
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or (at
 your option) any later version.
 
 This program is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 General Public License for more details.
 
 A full copy of the GPL license can be found at
 <http://www.gnu.org/licenses/>.

Description of your changes:

I would like to authenticate

Authentication

Username:Password:

Spam control

What do you get when you add 13 to 15?