• Welcome to the Kancolle Wiki!
  • If you have any questions regarding site content, account registration, etc., please visit the KanColle Wiki Discord

Difference between revisions of "Template:Timer"

From Kancolle Wiki
Jump to navigation Jump to search
m
(enabling use of hidden "short-format" via "short=")
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
<includeonly><div style="{{{style|text-align:center;font-size:18px;font-weight:bold;color:red;margin:0px 0px 10px 0px}}};{{{extra_style|}}}">
 
<includeonly><div style="{{{style|text-align:center;font-size:18px;font-weight:bold;color:red;margin:0px 0px 10px 0px}}};{{{extra_style|}}}">
<span class="countdown" data-options="no-leading-zeros" data-end="toggle" data-toggle=".{{{class|{{{endClass|countdownComplete{{{2|1}}}}}}}}}" style="display:none">
+
<span class="countdown" data-options="no-leading-zeros;{{#if:{{{short|}}}|short-format}}" {{#if:{{{countup|}}}||data-end="toggle" data-toggle=".{{{class|{{{endClass|countdownComplete{{{2|1}}}}}}}}}"}} style="display:none">
<span class="countdowndate">{{{1|{{{time|}}}}}}</span>
+
<span class="countdowndate">{{{1|{{{time|}}}}}}</span> {{#if:{{{countup|}}}|{{{text|{{{endText|}}}}}}}}
</span>
+
</span>{{#if:{{{countup|}}}||
<span class="{{{class|{{{endClass|countdownComplete{{{2|1}}}}}}}}}" style="display:none">{{{text|{{{endText|Countdown complete!}}}}}}</span>
+
<span class="{{{class|{{{endClass|countdownComplete{{{2|1}}}}}}}}}" style="display:none">{{{text|{{{endText|Countdown complete!}}}}}}</span>}}
 
</div></includeonly><noinclude>
 
</div></includeonly><noinclude>
 
Displays a countdown timer.
 
Displays a countdown timer.
 
==Parameters==
 
==Parameters==
 
* <code>time</code> or <code>[1]</code> : [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse time] to countdown to, required.
 
* <code>time</code> or <code>[1]</code> : [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse time] to countdown to, required.
 +
* <code>countup</code> : boolean. Timer counts upwards if chosen date has passed. Will override/disregard <code>class</code> & <code>[2]</code>.
 +
* <code>short</code> : boolean. Timer text is changed to single letters, e.g. "Days" becomes "d".
 
* <code>class</code> : specify when multiple timers are used on the page, <code>countdownComplete1</code> by default, e.g., <code>countdownComplete2</code> for a second timer, etc.
 
* <code>class</code> : specify when multiple timers are used on the page, <code>countdownComplete1</code> by default, e.g., <code>countdownComplete2</code> for a second timer, etc.
 
** <code>[2]</code> : alternatively, to only specify a number, e.g. <code>2</code> for a second timer.
 
** <code>[2]</code> : alternatively, to only specify a number, e.g. <code>2</code> for a second timer.
* <code>text</code> : optional completion text, <code>Countdown complete!</code> by default.
+
* <code>text</code> : optional completion text, <code>Countdown complete!</code> by default. Used at end of timer text for <code>countup</code>.
 
* <code>style</code> : custom style, optional.
 
* <code>style</code> : custom style, optional.
 
* <code>extra_style</code> : extra style to add to the default style, optional.
 
* <code>extra_style</code> : extra style to add to the default style, optional.
Line 27: Line 29:
 
</pre>
 
</pre>
 
{{Timer|January 19 2038 12:14:07 +0900|3|style = font-weight:bold|text = The time is now!}}
 
{{Timer|January 19 2038 12:14:07 +0900|3|style = font-weight:bold|text = The time is now!}}
 +
<pre>
 +
{{Timer|January 29 2042 12:17:04 +0900|3|style = font-weight:bold|short=true|text = The time is now short!}}
 +
</pre>
 +
{{Timer|January 29 2042 12:17:04 +0900|3|style = font-weight:bold|short=true|text = The time is now short!}}
 +
==countup Examples==
 +
<pre>
 +
{{Timer|January 1 2020 00:00:00 +0900|countup=true|extra_style = text-align:left}}
 +
</pre>
 +
{{Timer|January 1 2020 00:00:00 +0900|countup=true|extra_style = text-align:left}}
 +
<pre>
 +
{{Timer|January 1 1980 00:00:00 +0900|countup=true|style = font-style:italic|text = ago}}
 +
</pre>
 +
{{Timer|January 1 1980 00:00:00 +0900|countup=true|style = font-style:italic|text = ago}}
 +
<pre>
 +
{{Timer|January 1 1970 00:00:00 +0900|countup=true|style = font-weight:bold|short=true|text = in the past}}
 +
</pre>
 +
{{Timer|January 1 1970 00:00:00 +0900|countup=true|style = font-weight:bold|short=true|text = in the past}}
 +
<pre>
 +
{{Timer|January 19 2038 12:14:07 +0900|countup=true|style = font-weight:bold|text =. Still counts down normally for future dates.}}
 +
</pre>
 +
{{Timer|January 19 2038 12:14:07 +0900|countup=true|style = font-weight:bold|text =. Still counts down normally for future dates.}}
 
</noinclude>
 
</noinclude>

Latest revision as of 14:46, 8 August 2023

Displays a countdown timer.

Parameters

  • time or [1] : time to countdown to, required.
  • countup : boolean. Timer counts upwards if chosen date has passed. Will override/disregard class & [2].
  • short : boolean. Timer text is changed to single letters, e.g. "Days" becomes "d".
  • class : specify when multiple timers are used on the page, countdownComplete1 by default, e.g., countdownComplete2 for a second timer, etc.
    • [2] : alternatively, to only specify a number, e.g. 2 for a second timer.
  • text : optional completion text, Countdown complete! by default. Used at end of timer text for countup.
  • style : custom style, optional.
  • extra_style : extra style to add to the default style, optional.

See MediaWiki:Gadget-Countdown.js for JS implementation details.

Examples

{{Timer|January 1 2023 00:00:00 +0900|extra_style = text-align:left}}

{{Timer|January 1 2030 00:00:00 +0900|2|style = font-style:italic|text = Not yet.}}

{{Timer|January 19 2038 12:14:07 +0900|3|style = font-weight:bold|text = The time is now!}}

{{Timer|January 29 2042 12:17:04 +0900|3|style = font-weight:bold|short=true|text = The time is now short!}}

countup Examples

{{Timer|January 1 2020 00:00:00 +0900|countup=true|extra_style = text-align:left}}

{{Timer|January 1 1980 00:00:00 +0900|countup=true|style = font-style:italic|text = ago}}

{{Timer|January 1 1970 00:00:00 +0900|countup=true|style = font-weight:bold|short=true|text = in the past}}

{{Timer|January 19 2038 12:14:07 +0900|countup=true|style = font-weight:bold|text =. Still counts down normally for future dates.}}