form_tag

Starts a form tag that points the action to an url.

The url options should be given either as a string, or as a url() function. The method for the form defaults to POST.

Options:

multipart

If set to True, the enctype is set to "multipart/form-data".

method

The method to use when submitting the form, usually either "GET" or "POST". If "PUT", "DELETE", or another verb is used, a hidden input with name _method is added to simulate the verb over POST.

Starts a form tag that points the action to an url.

The url options should be given either as a string, or as a url() function. The method for the form defaults to POST.

Options:

multipart

If set to True, the enctype is set to "multipart/form-data".

method

The method to use when submitting the form, usually either "GET" or "POST". If "PUT", "DELETE", or another verb is used, a hidden input with name _method is added to simulate the verb over POST.

Outputs "</form>"

Example:

>>> end_form()
'</form>'

Creates a dropdown selection box

option_tags is a string containing the option tags for the select box:

>>> select("people", "<option>George</option>")
'<select id="people" name="people"><option>George</option></select>'

Options:

• multiple - If set to true the selection will allow multiple choices.

Creates a standard text field.

value is a string, the content of the text field

Options:

• disabled - If set to True, the user will not be able to use this input.
• size - The number of visible characters that will fit in the input.
• maxlength - The maximum number of characters that the browser will allow the user to enter.

Remaining keyword options will be standard HTML options for the tag.

Creates a hidden field.

Takes the same options as text_field

Creates a file upload field.

If you are using file uploads then you will also need to set the multipart option for the form.

Example:

>>> file_field('myfile')
'<input id="myfile" name="myfile" type="file" />'

Creates a password field

Takes the same options as text_field

Creates a text input area.

Options:

• size - A string specifying the dimensions of the textarea.

Example:

>>> text_area("body", '', size="25x10")
'<textarea cols="25" id="body" name="body" rows="10"></textarea>'

Creates a check box.

Creates a radio button.

The id of the radio button will be set to the name + value with a _ in between to ensure its uniqueness.

Creates a submit button with the text value as the caption.

Options:

• confirm - A confirm message displayed when the button is clicked.
• disable_with - The value to be used to rename a disabled version of the submit button.