User:Andreas Plank/Forms

Defintions

Details see Help:Semantic Forms.

{{#forminput: form= name-of-definied-form | … }}

                                                  │
┌─────────────────────────────────────────────────┘
├ default value= …
├ button text= …
├ autocompletion ─┬ autocomplete on category=
│                 ├ autocomplete on property=
│                 ├ autocomplete on namespace=
│                 └ remote autocompletion
├ query string=namespace=File (creates pages as “File:…”!)
├ popup
└ size= 50

{{{info | … }}} show infos, becomes for instance a <fieldset>

            │
┌───────────┘
├ partial form - Indicates that this form is a partial form; see "Partial forms", below.
├ create title=title - Sets the title for the 'FormEdit' page, if the form is being used to create a new page
├ edit title=title - Sets the title for the 'FormEdit' page, if the form is being used to edit an existing page
├ query title=title - Sets the title for the 'RunQuery' page
├ page name=Formula <template-name[field-name]> … <unique number> - Sets a formula for automatic setting of the name of the page being added; see "Linking to forms#The one-step process".
├ query form at top - Places the form at the top, instead of the bottom, for the 'RunQuery' page
└ onlyinclude free text - Indicates that the free text in the page generated by the form should be placed within an "<onlyinclude>" tag, so that pages created by the form can be transcluded in other pages without affecting those other pages' semantic properties

{{{for template | … }}} relate to template xy

                    │
┌───────────────────┘
├ template name → mandatory!!!
├ label= - Specifies a label to be placed in a square around the entire set of this template's fields in the form. This is especially useful if the template can have multiple instances.
├ add button text= - For multiple-instance templates, sets the text in the "Add another" button.
├ embed in field= template name[field name] - Specifies that the call(s) to this template within the generated pages will get embedded within a field of another template (i.e., "{{main template|some field={{embedded template|...its fields...}} ... }}"). It is used in conjunction with the "holds template" parameter for the 'field' tag (see below). Note that the template to be embedded must appear after the template in which it will be embedded.
├ multiple     → allows one template repeating multiple times on a page 
└ strict       → use strictly template parameters

{{{field|template parameter| … }}} field definitions

                              │
   ┌──────────────────────────┘
   ├ default= a default value (wiki variables don't work!)
   ├ mandatory (has to be filled by the user → CSS-class mandatoryField)
   ├ autocompletion ─┬ values from category=category
   │                 ├ values from concept=
   │                 ├ values from url=URL identifier - Used only for autocompletion. Specifies that autocompletion should be based on the values retrieved from an outside URL; see Autocompleting on outside values for how to do this.
   │                 ├ values from namespace=namespace name
   │                 ├ values from property=
   │                 └ remote autocompletion=
   ├ size= 50 (length of the box in #characters)
   ├ maxlength= 60 (maximal length of the box in #characters)
   ├ class= CSS-class
   ├ hidden
   ├ placeholder=placeholder text
   ├ input type=  ─┬ textarea [with autocomplete] (+ optional: | cols= … | rows= … | autogrow)
   │               ├ text [with autocomplete] (+ optional: | size= 50)
   │               ├─┬ category - used for single value
   │               │ └ categories - used for multiple values
   │               │     └ + optionally: | height = | widht = | delimiter = | hideroot = | depth = (10 default)
   │               │
   │               ├ combobox
   │               │
   │               ├ hidden
   │               │
   │               ├ date
   │               ├ datetime (+ optional: … | include timezone | …)
   │               ├ year
   │               │
   │               ├ dropdown + values= selct1, select2, select3, select4
   │               ├ listbox + values= selct1, select2, select3, select4 (is larger)
   │               ├ checkbox
   │               └ radiobutton
   ├ list + optional: | delimiter= ; (default is , comma)
   ├ specific values: | values = one; two; three;
   │ (e.g. one; two; three;)
   │
   ├ values dependent on=template name[field name] - Can be used for inputs of type 'combobox', 'text with autocomplete' and 'textarea with autocomplete'. Specifies that the current set of allowed values for this field depends on the values a user selected, or will select, for another field in the form.
   └ show on select=selection1=>HTML-ID1 of a <div>-container;selection2=>HTML-ID2 of a <div>-container;

-------8<-- text snippets -->8----------

{{{field|TemplateParameter|input type=textarea|cols=98|rows=3|autogrow}}}

<div class="floating-form-parts">Template-parameter <span class="comment-gray font-weight-normal"><!-- comments --></span><br/>
{{{field|template-parameter|mandatory}}}</div>

{{#info: text that has no = }}

show hints or small tooltip texts

{{#info: text that has no = | icontype }}

icontype can be info (=default) or warning

{{#info: message=text with equal character = | icon=icontype }}

You need to specify parameter
message=tooltip text
and optionally
icon=icontype

Form end

{{{free text| … }} free text below the templates

                │
   ┌────────────┘
  rows= 30
  cols= 50
  preload= a page name (only when new)
  hidden
  restricted
  editor - use the wiki editor
  autogrow
  default=

{{{standard input| … }} input buttons, like “save”, “preview” etc.

                     │
   ┌─────────────────┘
  summary     ┐
  minor edit  ┤
  watch       ┤
  save        ┤
  preview     ┤
  changes     ┤
  cancel      ┤
              + label= explicit description text
              + style= CSS style
              + style= CSS class

Setup

Place [[Has default form::form-name]] on a category page.