DocWiki: WikiFormsExampleText

This page uses the WikiForms plugins to provide parameters to the CurrentTimePlugin, and displays the result.

Giving Defaults

The FormSet plugin sets the default date format for a form field format in form testform. (It also sets a radio button default value - just for demonstration, no real functionality.)

Form Output and Error Messages

It specifies that the CurrentTimePlugin, which comes in the stock JSPWiki distribution, should be used to generate some output to display here. While the output is usually built in response to a POST from a form called testform, the populate attribute here hints the plugin that we want default information even if no post has been made. This is what the output looks like:

Opening the Form

Form Fields

We'll use a text field to provide the format of CurrentTimePlugin's output. Notice that the name of this field is format - the name of CurrentTimePlugin's relevant parameter. This value is passed straight to CurrentTimePlugin on submit:

Enter the time format string: [{FormInput type='text' name='format'}]

Enter the time format string:

The rest of the form merely demonstrates some other HTML form elements. The don't work with CurrentTimePlugin, but you'll probably want them in your special form handler plugins.

Select list:

[{FormSelect name='sel1' value='fee;*fie;foe;foo'}]\\

(Notice, here, the asterisk; this denotes the default value to select. The separator character and the default character can be overridden - check FormSelect for more information.)

Textarea:

[{FormTextarea name='area1' value='Write your own text here' rows=8 cols=40}]

Submitting

Before finishing up, we need to add a submit button:

[{FormInput type='submit' name='x' value='Update'}]

Closing the Form

And, finally, an invisible closing element to denote that this form has ended:

[{FormClose}]

Go ahead, click on Update, and notice how your format changes and selections are retained.

WikiFormsExampleText

WikiForms Form Plugin Example

Table of Contents