Add-ons / <<numberpool>> Macro Set

Syntax: <<numberinput receiverName defaultValue minValue maxValue [poolCost] [autofocus]>>

Creates a whole number input box, used to modify the value of the $variable with the given name.

Arguments:

• receiverName: The name of the $variable to modify, which must be quoted (e.g. "$foo"). Object and array property references are also supported (e.g., "$foo.bar", "$foo['bar']", & "$foo[0]").
• defaultValue: The default value.
• minValue: The minimum allowed value.
• maxValue: The maximum allowed value.
• poolCost: (optional) If part of a number pool, the amount by which the pool is changed for each level of the numberinput value. If omitted, will default to 1. Only useful when part of a pool.
• autofocus: (optional) Keyword, used to signify that the number box should automatically receive focus. Only use the keyword once per page; attempting to focus more than one element is undefined behavior.

Usage:

→ Creates a number box which modifies $Strength
<<numberinput "$Strength" $Strength 1 20>>
→ Creates an automatically focused number box which modifies $Strength
<<numberinput "$Strength" $Strength 1 20 autofocus>>

Syntax: <<numberpool receiverName>><</numberpool>>

Creates a number pool for use with the other macros from this set. Only useful when paired with them.

Arguments:

• receiverName: The name of the $variable to modify, which must be quoted (e.g. "$foo"). Object and array property references are also supported (e.g., "$foo.bar", "$foo['bar']", & "$foo[0]").

Usage:

<<numberpool "$StatPool">>
|''ST:''|<<numberinput "$ST" $ST 1 20>>|
|''DX:''|<<numberinput "$DX" $DX 1 20>>|
|''IQ:''|<<numberinput "$IQ" $IQ 1 20>>|
|''HT:''|<<numberinput "$HT" $HT 1 20>>|
<</numberpool>>

Syntax: <<onchange>>

Silently executes its contents when the pool is changed via one of the other macros from this set.

Arguments: none

Usage:

You have <span id="stat-pool">$StatPool</span> points remaining to allocate.
<<numberpool "$StatPool">>
|''ST:''|<<numberinput "$ST" $ST 1 20>>|
|''DX:''|<<numberinput "$DX" $DX 1 20>>|
|''IQ:''|<<numberinput "$IQ" $IQ 1 20>>|
|''HT:''|<<numberinput "$HT" $HT 1 20>>|
<<onchange>>
    <<replace "#stat-pool">>$StatPool<</replace>>
<</numberpool>>

Syntax: <<numberslider receiverName defaultValue minValue maxValue stepValue [autofocus]>>

Creates a number range slider, used to modify the value of the $variable with the given name.

Arguments:

• receiverName: The name of the $variable to modify, which must be quoted (e.g. "$foo"). Object and array property references are also supported (e.g., "$foo.bar", "$foo['bar']", & "$foo[0]").
• defaultValue: The default value. It should be a multiple of the step value plus the minimum value.
• minValue: The minimum allowed value.
• maxValue: The maximum allowed value. It must be a multiple of the step value plus the minimum value.
• stepValue: The allowed increments to which a value may be set.
• autofocus: (optional) Keyword, used to signify that the number slider should automatically receive focus. Only use the keyword once per page; attempting to focus more than one element is undefined behavior.

Usage:

→ Creates a number slider which modifies $opacity
<<numberslider "$opacity" $opacity 0 1 0.5>>
→ Creates an automatically focused number slider which modifies $opacity
<<numberslider "$opacity" $opacity 0 1 0.5 autofocus>>