- Prepares text for use in input forms such as <textarea> tags.
To prepare text fields that may contain carriage returns for use in <textarea> portions of a form, place them inside an [Input] context. Certain characters, such as carriage returns, are converted to "soft-returns" when they are saved in a database file. The [Input] context converts them back to "hard-returns" so they look right when displayed inside <textarea> tags. Other characters, such as "<" and ">" cause the <textarea> tag to get confused, so they are converted to "<" and ">" in order to display properly.
Example (normally you would put the following text into a .tpl file on your server and use a web browser to link to it):
This context is most often used when you create a form allowing visitors to edit (replace a record) with large portions of text in a database field that has carriage returns in it. If you do not use this context, then the lines of text inside the <textarea> multiline input field will appear to have "lost" all the carriage returns that were originally there. This is because web browsers do not understand how to display a "soft-return" character, so it appears as a simple space instead.
- Note: there is probably no reason to ever use this context unless it is inside <textarea>, because no other input field allows carriage returns to be typed into it.
Here is a list of exactly what happens to text when it is put inside an [Input] context:
If the character is...
then it is translated to...
|Any other character