Tags:
create new tag
view all tags
ALERT! NOTE: This is a DistributionDocument.
  • Please help maintain high quality documentation: This is a wiki, please fix the documentation if you find errors or incomplete content.
  • Put questions and suggestions concerning the documentation of this topic in the comments section below.
  • Use the Support web for problems you are having using TWiki.
  • Use the Sandbox web to evaluate & test TWiki.

FORMFIELD{"fieldname"} -- render a field in the form attached to some topic

  • Syntax: %FORMFIELD{"fieldname"}%
  • Supported parameters:
    Parameter: Description: Default:
    "fieldname" The name of a TWiki form field required
    topic="..." Topic where form data is located. May be of the form Web.TopicName Current topic
    rev="..." Get the form field value from the specified topic revision, range "1" to top revision of topic. "0" is equivalent to the top revision The rev URL parameter value if present, otherwise the top revision
    format="..." Format string. Supported variables:
    $value - form field value
    $value(20, -<br />) - value hyphenated every 20 characters using separator -<br />
    $value(30, ...) - value shortened to 30 characters
    $length - length of value (can be used to test if value is set)
    $title - raw field name (includes space and other special characters)
    $name - field name (sanitized title)
    $attributes - form field attributes
    $formtopic - name of form definition topic
    "$value"
    default="..." Text shown when no value is defined for the field ""
    alttext="..." Text shown when field is not found in the form ""
    newline="$br" Convert newlines in textarea to other delimiters. Variable $br expands to <br /> tag, and $n to a newline. Other text is encoded based on encode parameter. no conversion
    encode="html" Encode special characters into HTML entities. If a FORMFIELD is passed into an HTML form field it should be encoded as "html". Additional encodings available: encode="quote", encode="moderate", encode="safe", encode="entity", encode="url" and encode="csv". See ENCODE for details. "" (no encoding)
  • Example: %FORMFIELD{"ProjectName" topic="Projects.SushiProject" default="(not set)" alttext="ProjectName field not found"}%
  • Example: %FORMFIELD{"Title" topic="%INCLUDINGTOPIC%" }%
    • Note: Specify topic="%INCLUDINGTOPIC%" if you have a base topic that includes a report topic, and in the report topic you want to reference a field of the base topic
  • Example: %FORMFIELD{"LastName" topic="%USERSWEB%.%WIKINAME%"}%
    • Note: Returns the "LastName" field from your profile page TWikiGuest
  • Example: <input type="text" name="Address" value="%FORMFIELD{ "Address" encode="html" }%" />
    • Note: It is easier to use EDITFORMFIELD for custom input fields
  • Category: DatabaseAndFormsVariables, DevelopmentVariables, FormattingAndRenderingVariables
  • Related: EDITFORM, EDITFORMFIELD, ENCODE, ENTITY, FORM, META, METASEARCH, SEARCH, TWikiForms, FormattedSearch, QuerySearch, SearchHelp



Comments & Questions about this Distribution Document Topic

Is there any way to pull in form fields from an older version of a topic?

-- NatalieBrown - 2011-12-15

If yo look at an older topic version that has a FORMFIELD it will pull the vale of that field as it was at that topic version.

Please ask support questions in the Support web, this section is about the documentation of this feature. You can submit feature proposals in the Codev web.

-- PeterThoeny - 2011-12-16

Can I suggest you add to the examples

Example: Last name: %FORMFIELD{"LastName" topic="%USERSWEB%.%WIKINAME%"}% Note allows you access and reuse the "Lastname" field from your one personal details page !%USERSWEB%.!%WIKINAME%

-- fergus mcmenemie - 2016-05-12

Thanks for the suggestion, Fergus. I added the example.

-- Peter Thoeny - 2016-05-13

Please use the Support forum if you have questions about TWiki features. This comment section is about the documentation of this topic.
Edit | Attach | Watch | Print version | History: r12 < r11 < r10 < r9 < r8 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r12 - 2016-05-13 - PeterThoeny
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.