Predloga:Calculator button
Creates a button for use with {{Calculator}} widgets. Requires the calculator gadget to be enabled.
Usage
[uredi kodo]Upon clicking a button, the button evaluates its formula parameter and inserts the results into the field identified by the for parameter. You can separate multiple for/formula with a semicolon.
For example:
{{calculator button|contents=Add 1|for=x|formula=x+1|type=plain}}. X = {{calculator|type=plain|id=x|default=0}}
Creates
. X = 0
The contents of a button should only contain non-interactive phrasing content (No links, no <div>. Images are ok)
Repeating buttons
[uredi kodo]If the delay parameter is set, then the button will repeat every that many seconds. It will repeat until the max iterations parameter is reached or otherwise forever. There is only one button allowed to repeat at a time, so starting one repeating button cancels all other repeating buttons within a calculator container. If the toggle parameter is set then clicking the button a second time stops the iteration. The until parameter can be used to stop the iterations once some formula is true.
You can also use the functions timertime(), timer() timeriterations() in formulas to get information about the current repeating button.
{{calculator button
|id=buttoncount
|type=progressive
|contents=
{{calculator
|type=plain
|formula=timer()
|mapping={"Start counting":0,"Stop counting": 1}
|default=Start counting
}}
|for=y
|formula=y+1
|delay=0.5 <!-- Update every half a second -->
|toggle=1 <!-- Stop counting if we click again -->
|max iterations=40 <!-- Stop if we reach 40. If this is unspecified we'd go forever. -->
}}. I counted up to {{calculator|type=plain|id=y|default=0}} in total. I have been counting for {{calculator|type=plain|formula=timertime(buttoncount)|default=?}} seconds since my last break.
Makes:
. I counted up to 0 in total. I have been counting for ? seconds since my last break.
Types of buttons
[uredi kodo]There are many different types of buttons you can make. For codex style buttons, see for best practice on how to use them. Note, the value default refers to the codex "default" styles, it is not the default option. The style of plain buttons may vary between different skins and operating systems.
| type | normal | primary | quiet | disabled |
| plain (non-codex) | ||||
| default | ||||
| progressive | ||||
| destructive | ||||
There is also support for size parameter that takes "medium" or "large". Medium is recommended unless the button is only a small icon. There is an alt parameter to provide alt text for screen readers. However you should only use it if the text contents of the button don't explain its purpose. Most of the time it is better to just make the button contents descriptive.
Template data
[uredi kodo]Create a button element that can affect a widget from Template:Calculator
| Parameter | Opis | Vrsta | Stanje | |
|---|---|---|---|---|
| for | for | id of Calculator field that is the target of this button | Niz | zahtevano |
| formula | formula | Formula to set the field from the for parameter to
| Niz | zahtevano |
| contents | contents 1 | Contents of the button
| Vsebina | zahtevano |
| type | type | Style of button. Default is "plain". The value of "default" means a codex default button, which is not the default of this template
| Niz | predlagano |
| alt | alt | Alt text of button for screen readers. Only use if the text content of the button would not be clear to a screen reader | Niz | neobvezno |
| class | class | Extra CSS classes to add to the button. If you want this styled like a button even when the gadget is disabled add "cdx-button cdx-button--fake-button cdx-button--fake-button--enabled" | Niz | neobvezno |
| class-live | class-live | Extra CSS classes that are only added if the calculator gadget is enabled | Niz | neobvezno |
| disabled | disabled | Formula to determine if the button should be disabled. Button becomes disabled when formula is true | Niz | neobvezno |
| id | id | id of button element | Niz | neobvezno |
| size | size | Size of button. medium is default
| Niz | neobvezno |
| style | style | Extra CSS for button | Niz | neobvezno |
| title | title | Tooltip for button | Niz | neobvezno |
| weight | weight | Weight of button (Ignored for plain buttons)
| Niz | neobvezno |
| role | role | Aria role for button. Typically you wouldn't need to set this. | Neznano | neobvezno |
| aria-live | aria-live | Value for aria-live attribute. Controls if screen readers announce changes. | Neznano | neobvezno |
| delay | delay | Make this be a repeating button. How many seconds between each repeat. Must be at least 0.5 seconds. | Številka | neobvezno |
| max iterations | max iterations | How many times to repeat a button. Set to 0 to cancel any ongoing repeating button. If not set, then it is considered infinity if delay is set, otherwise 1. | Številka | neobvezno |
| toggle | toggle | If this is a repeating button, if set then when the user clicks the button a second time, it will stop the repeat. Otherwise a second click just restarts the repetition. | Bool | neobvezno |
| until | until | Repeat this button until this formula is true. delay parameter must also be set. | Neznano | neobvezno |