Calculators/Form calculators


 * For example usage of this script, see /Examples. For tests, see /Tests.

Form calculators use a script that enables dynamic loading of templates into parts of a page. A configurable form is used to input parameters into the template.

Configuration
The JS calculator's configuration section uses  pairs, each separated by a newline. The possible names are:
 * - The name of the template to use on form submittal. If no namespace is provided, then the template namespace will be searched by default. If the template is in the main namespace, you must prepend a colon to the article name. This follows the same convention that's used when transcluding templates into a page.
 * - The unique HTML ID of the element that will contain the form. Each configuration block should specify a different form ID.
 * - The unique HTML ID of the element that will contain the parsed template.
 * - A comma-separated list of namespace IDs to use for autocomplete. This field applies for all article parameter types used in the form. By default, namespace 0 (main) is searched. See the table to the bottom for the valid namespace IDs.
 * - Defines a parameter to be sent to the template, in the format shown in the next section.

Parameter format
A  line should be in the following format:




 * - The name of the parameter as used by the template. Parameter names are case sensitive, and there can be no spaces.
 * - The label used for the parameter in the form. If blank,  is used.   supports using HTML to format the labels - including simple formats like ,   and even.
 * However, normal wikiscript can only be used if the config is contained within a div tag instead of a pre tag
 * - The default value used to prefill the form initially.
 * - The type of the parameter, used for form validation and to control the appearance of the form field. Valid values for  are:
 * (default) - The input box can contain any value.
 * - The input box should contain an article name. Currently, this means that autocomplete will be enabled for the text box. To set the namespaces searched by autocomplete, use the  field (see above).
 * - The input box must contain a number. A valid range can be specified in  in the format min-max. If either min or max is omitted or a range is not given, then infinity is assumed.
 * - The input box must contain an integer. A valid range can be specified (see above).
 * - The input is selected from a comma-separated list of values given in.
 * - A checkbox, with values sent to the template defined by the.
 * The  has format , which defines what the form will pass to the template when ticked or not ticked. The default for this is.
 * The checkbox will be checked by default if the  is set to   or the same as the   given in the.
 * - A special field which attempts to lookup a player's hiscores for values to be passed into other parameters.
 * Currently,  is ignored. The form will automatically try to prefill the form with the last name entered in a   type box.
 * has a format of  where   is the   of any other parameter in the form,   is the integer of the skill to lookup (as defined by the table to the bottom), and   is 0 for rank, 1 for level and 2 for experience (0 for rank and 1 for score in minigames). Multiple parameters can be changed by using   - i.e..
 * - The value specified by  will be shown but cannot be changed in the form.
 * - The value specified by  will be hidden in the form and cannot be changed. No row is generated for the form at all.
 * - A combination of fixed and hidden: The value specified by  will be hidden in the form and cannot be changed, but unlike , a row is added to the form, which is hidden with CSS. This is primarily for inter-script usage (i.e. some other script sets the semihidden value to something so that it is passed to the template when submitted).
 * - The allowed range of the parameter. The format of this field depends on the  chosen.

The configuration section should be contained within a &lt;div&gt; or &lt;pre&gt; tag with the class, e.g.: &lt;pre class="jcConfig"&gt; ... configuration ... &lt;/pre&gt;

For example configurations, see /Examples.

License
This script is released under the GNU General Public License. The source code is available at MediaWiki:Common.js/calc.js.