of the HTML form\n - Opening <form> tag and internal fields\n - The submit button(s)\n - The reset button\n - Just the closing </form> tag\n\nLet's look at an example \"form.html\" template we could use:\n\n<html>\n<head>\n<title>User Information

{ "content": [ { "type": "text", "text": "# CGI::FormBuilder::Template::CGI_SSI (perldoc)\n\n## NAME\n\nCGI::FormBuilder::Template::CGISSI - FormBuilder interface to CGI::SSI\n\n## SYNOPSIS\n\nmy $form = CGI::FormBuilder->new(\nfields => \\@fields,\ntemplate => {\ntype => 'CGISSI',\nfile => \"template.html\",\n},\n);\n\n## DESCRIPTION\n\nThis engine adapts FormBuilder to use \"CGI::SSI\".\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **TEMPLATES**\n- **SEE ALSO**\n- **REVISION**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "CGI::FormBuilder::Template::CGI_SSI", "section": "", "mode": "perldoc", "summary": "CGI::FormBuilder::Template::CGISSI - FormBuilder interface to CGI::SSI", "synopsis": "my $form = CGI::FormBuilder->new(\nfields => \\@fields,\ntemplate => {\ntype => 'CGISSI',\nfile => \"template.html\",\n},\n);", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 8, "subsections": [] }, { "name": "DESCRIPTION", "lines": 27, "subsections": [] }, { "name": "TEMPLATES", "lines": 65, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "REVISION", "lines": 2, "subsections": [] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "CGI::FormBuilder::Template::CGISSI - FormBuilder interface to CGI::SSI\n", "subsections": [] }, "SYNOPSIS": { "content": "my $form = CGI::FormBuilder->new(\nfields => \\@fields,\ntemplate => {\ntype => 'CGISSI',\nfile => \"template.html\",\n},\n);\n", "subsections": [] }, "DESCRIPTION": { "content": "This engine adapts FormBuilder to use \"CGI::SSI\".\n\nYou can specify any options which \"CGI::SSI->new\" accepts by using a hashref:\n\nmy $form = CGI::FormBuilder->new(\nfields => \\@fields,\ntemplate => {\ntype => 'CGI::SSI',\nfile => 'form.shtml',\nsizefmt => 'abbrev'\n}\n);\n\nIn addition to CGI::SSI new arguments, you can also specify \"file\", \"virtual\", or \"string\"\nargument.\n\nThe following methods are provided (usually only used internally):\n\nengine\nReturns a reference to the \"CGI::SSI\" object\n\nprepare\nReturns a hash of all the fields ready to be rendered.\n\nrender\nUses the prepared hash and expands the template, returning a string of HTML.\n", "subsections": [] }, "TEMPLATES": { "content": "In your template, each of the form fields will correspond directly to a \"\" of the\nsame name prefixed with \"field-\" in the template. So, if you defined a field called \"email\",\nthen you would setup a variable called \"\" in your template.\n\nIn addition, there are a couple special fields:\n\n - JavaScript to stick in \n - The of the HTML form\n - Opening <form> tag and internal fields\n - The submit button(s)\n - The reset button\n - Just the closing </form> tag\n\nLet's look at an example \"form.html\" template we could use:\n\n<html>\n<head>\n<title>User Information\n\n\n\n

User Information

\nPlease fill out the following information:\n's corresponds to a field -->\n

Your full name: \n

Your email address: \n

Choose a password: \n

Please confirm it: \n

Your home zipcode: \n

\n\n\n\nAs you see, you get a \"\" for each for field you define.\n\nHowever, you may want even more control. That is, maybe you want to specify every nitty-gritty\ndetail of your input fields, and just want this module to take care of the statefulness of the\nvalues. This is no problem, since this module also provides several other \"\" tags as\nwell:\n\n - The value of a given field\n - The human-readable label\n - Any optional comment\n - Error text if validation fails\n - See if the field is required\n\nThis means you could say something like this in your template:\n\n:\n\">\n\n\nAnd FormBuilder would take care of the value stickiness for you, while you have control over the\nspecifics of the \"\" tag. A sample expansion may create HTML like the following:\n\nEmail:\n\nYou must enter a valid value\n\nNote, though, that this will only get the *first* value in the case of a multi-value parameter\n(for example, a multi-select list). Multiple values (loops) in \"CGISSI\" are not yet\nimplemented.\n\nFor more information on templates, see HTML::Template.\n", "subsections": [] }, "SEE ALSO": { "content": "CGI::FormBuilder, CGI::FormBuilder::Template, HTML::Template\n", "subsections": [] }, "REVISION": { "content": "$Id: HTML.pm 97 2007-02-06 17:10:39Z nwiger $\n", "subsections": [] }, "AUTHOR": { "content": "Copyright (c) Nate Wiger . All Rights Reserved.\n\nThis module is free software; you may copy this under the terms of the GNU General Public\nLicense, or the Artistic License, copies of which should have accompanied your Perl kit.\n", "subsections": [] } } } }