Changes between Version 2 and Version 3 of TracFormsPlugin/Starter


Ignore:
Timestamp:
Apr 30, 2011 3:46:47 PM (3 years ago)
Author:
hasienda
Comment:

add more content

Legend:

Unmodified
Added
Removed
Modified
  • TracFormsPlugin/Starter

    v2 v3  
    1111Hereby you define a form with 
    1212 * default settings, i.e. no field change tracking, standard submit button label 
    13  * one field of default field type ''checkbox'' with the label 'checked' 
     13 * one field 
     14  * of default field type ''checkbox'' 
     15  * with a label 'checked' 
    1416  
    15 result: 
     17rendered result: 
     18[[Image(forms_example_basic-form.png)]] 
    1619 
    17 == More/other form fields == 
    18 == Form customization == 
     20== Diversify == 
     21When you go on designing your forms, you may wish to arrange and more-or-less beautify them. 
     22 
     23This is fairly easy using !TracWiki markup. The following examples show only a small subset of the possibilities, but simple and advanced tables are certainly among the dominating design elements. Use common sense when deciding on parameters like table border width or background color. 
     24 
     25=== More form fields === 
     26Most probably you'll want to have multiple form fields. 
     27 
     28The single most important rule is: Make sure, that you have '''unique field names''' within a form. 
     29{{{ 
     30{{{ 
     31#!TracForm 
     32choose combinations 
     33|| ||a||b||c|| 
     34||1||[tf:check1a]||[tf:check1b]||[tf:check1c]|| 
     35||2||[tf:check2a]||[tf:check2b]||[tf:check2c]|| 
     36||3||[tf:check3a]||[tf:check3b]||[tf:check3c]|| 
     37}}} 
     38}}} 
     39  
     40rendered result: 
     41[[Image(forms_example_more-fields.png)]] 
     42 
     43How well does it scale? It has been proven to work for fairly large quantities of form fields. 
     44 I do use tickets with more than 120 checkboxes in one !TracForm. --hasienda 
     45 
     46=== Other field types === 
     47{{{ 
     48{{{ 
     49#!TracForm 
     50[tf:mycheck] checked 
     51 
     52[tf.input:myinput] 
     53 
     54Like it? [tf.radio:mychoice true] Yes [tf.radio:mychoice false] No 
     55 
     56[tf.select:myselect val0//(default) val1//label1 val2//label2] 
     57 
     58Tell me more:[[BR]] 
     59[tf.textarea:comment '(default comment)' 20 5] 
     60}}} 
     61}}} 
     62  
     63rendered result: 
     64[[Image(forms_example_field-types.png)]] 
     65 
     66== Manage == 
    1967=== Track changes === 
     68 
    2069=== Submit button label === 
     70 
    2171=== Form-related operations === 
     72{{{ 
     73{{{ 
     74#!TracForm 
     75form ID: [tf.form_id:] 
     76 
     77ToDo:[[BR]] 
     78[tf.textarea:comment '(default comment)' 20 5][[BR]] 
     79last comment: 
     80by [tf.form_updater:] 
     81on [tf.form_updated_on:] 
     82}}} 
     83}}} 
     84  
     85rendered result: 
     86[[Image(forms_example_form-operations.png)]]