Xeverything11 (talk | contribs)
m 132 revisions imported from mhdev:Template:Fraction/doc
 
(84 intermediate revisions by 40 users not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{Uses TemplateStyles|Template:Fraction/styles.css}}
This template builds an alternative form of [[common fraction]]s. It takes one, two or three parameters: the optional integer (may be signed), the optional numerator and the required denominator; in this order. Please '''do not''' <code>subst:</code>itute it. This template should '''not''' be used in mathematical articles, per [[MOS:MATH#Fractions]].
This template builds an alternative form of common fractions. The template takes one, two, or three parameters: the optional integer (may be signed), the optional numerator and the required denominator; in this order.  
; <code><nowiki>{{frac|A|B|C}}</nowiki></code>: {{frac|A|B|C}} (integer, numerator and denominator)
 
: <source lang=html4strict><span class="frac">A<sup>&nbsp;B</sup>⁄<sub>C</sub></span></source>
Please '''do not''' <code>subst:</code>itute it.
; <code><nowiki>{{frac|A|B}}</nowiki></code>: {{frac|A|B}} (numerator and denominator)
 
: <source lang=html4strict><span class="frac"><sup>A</sup>⁄<sub>B</sub></span></source>
; <code><nowiki>{{fraction|A|B|C}}</nowiki></code> : {{fraction|A|B|C}} (integer, numerator and denominator)
; <code><nowiki>{{frac|A}}</nowiki></code>: {{frac|A}} (denominator only)
; <code><nowiki>{{fraction|B|C}}</nowiki></code> : {{fraction|B|C}} (numerator and denominator)
: <source lang=html4strict><span class="frac"><sup>1</sup>⁄<sub>A</sub></span></source>
; <code><nowiki>{{fraction|C}}</nowiki></code> : {{fraction|C}} (denominator only)
; <code><nowiki>{{fraction}}</nowiki></code> : {{fraction}} (fraction slash only)


== Examples ==
== Examples ==
;Numbers: {{frac|2}} {{frac|3}} {{frac|2|3}} {{frac|4}} {{frac|3|4}} {{frac|5}} {{frac|2|5}} {{frac|3|5}} {{frac|4|5}} {{frac|6}} {{frac|5|6}} {{frac|7}} {{frac|2|7}} {{frac|3|7}} {{frac|4|7}} {{frac|5|7}} {{frac|6|7}} {{frac|8}} {{frac|3|8}} {{frac|5|8}} {{frac|7|8}} {{frac|16}} {{frac|3|16}} {{frac|5|16}} {{frac|7|16}} {{frac|9|16}} {{frac|11|16}} {{frac|13|16}} {{frac|15|16}}
<!--the fractions are separated by commas that are only visible to screen readers because they do not read out the space separators here-->
;Units: {{frac|m|s}} {{frac|km|h}} {{frac|kg·m|}} {{frac|s}} {{frac|Mbit|s}}
; Numbers : {{fraction|2}} {{fraction|3}} {{fraction|2|3}} {{fraction|4}} {{fraction|3|4}} {{fraction|5}} {{fraction|2|5}} {{fraction|3|5}} {{fraction|4|5}} {{fraction|6}} {{fraction|5|6}} {{fraction|7}} {{fraction|2|7}} {{fraction|3|7}} {{fraction|4|7}} {{fraction|5|7}} {{fraction|6|7}} {{fraction|8}} {{fraction|3|8}} {{fraction|5|8}} {{fraction|7|8}} {{fraction|16}} {{fraction|3|16}} {{fraction|5|16}} {{fraction|7|16}} {{fraction|9|16}} {{fraction|11|16}} {{fraction|13|16}} {{fraction|15|16}}
; Units : {{fraction|m|s}} {{fraction|km|h}} {{fraction|kg·m|s<sup>2</sup>}} {{fraction|s}} {{fraction|Mbit|s}}
 
== Notes ==
* <code><nowiki>{{fraction}}</nowiki></code> or <code>&amp;frasl;</code> may be used to print out the fraction slash glyph " &frasl; ".
* For mixed fractions, in some contexts (like link targets) a "+" is generated between the whole number part and fraction part. If this is not desirable, put the whole number part outside the template, and put a [[w:non-breaking space|non-breaking space]] between when the spacing is desirable. For example: "<nowiki>33&amp;nbsp;{{frac|1|3}}</nowiki>".


== Deactivation and customization ==
== Parameters ==
Users who prefer to see fractions inline, e.g. „1&nbsp;2⁄3“ instead of „{{frac|1|2|3}}, can turn off the effects of this template by adding the following code to [[Help:User style|their user stylesheet]]:
<templatedata>{
<source lang="css">.frac>sup /* numerator */,
"description": "A template for displaying common fractions of the form int+num/den nicely. It supports 0–3 anonymous parameters with positional meaning.",
.frac>sub /* denominator */
"params": {
{
"1": {
   vertical-align: inherit/* or baseline*/;
   "label": "leftmost part",
   font-size: inherit/* or 1em*/;
   "description": "Denominator if only parameter supplied. Numerator if 2 parameters supplied. Integer if 3 parameters supplied. If no parameter is specified the template will render a fraction slash only.",
   line-height: inherit/* or 1*/;
   "type": "string/line",
   position: inherit/* or static*/;
   "required": false
}</source><!--untested-->
},
These selectors and properties can also be used as a base for custom rendering of vulgar fractions:
"2": {
<source lang="css">/* Stacked Fractions (does not work with three parameters currently) */
   "label": "middle-right part",
.frac
   "description": "Denominator if 2 parameters supplied. Numerator if 3 parameters supplied.",
{
   "inherits": "1"
   display: inline-block;
},
   margin-bottom: -0.3em;
"3": {
  vertical-align: 0.8em;
   "label": "rightmost part",
   line-height: 1.2em;
   "description": "Denominator, always.",
  text-align: center;
   "inherits": "1"
  visibility: hidden;/*hide fraction slash*/
}
.frac>sup /* numerator */,
.frac>sub /* denominator */
{
   vertical-align: inherit;
   font-size: 85%;
   line-height: inherit;
  position: static;
  visibility: show;
}
}
.frac>sup::after
}}</templatedata>
{
  content: "\A" /* a line break */
}
.frac>sub
{
  text-decoration: overline;
}</source><!--untested-->


== See also ==
== See also ==
To allow numerical sorting of a column containing fractions, use {{tl|sortfrac}} instead. It is a combination of this template and {{tl|sort}}.
* {{tl|sfrac}} ({{sfrac|2}}) – displays common fractions using a [[w:vinculum (symbol)|vinculum]] (horizontal line), for scientific and mathematical text


*{{tl|1/2}}, {{tl|1/3}}, {{tl|2/3}}, {{tl|1/4}}, {{tl|3/4}}
*{{tl|fraction}}, only uses precomposed glyphs
*{{tl|fracText}}, use inline fractions, for use in mathematics articles
<includeonly>
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Formatting templates]]
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
[[Category:Mathematical formatting templates|{{PAGENAME}}]]
 
[[ca:Plantilla:Frac]]
[[cs:Šablona:Zlomek]]
[[de:Vorlage:Bruch]]
[[et:Mall:Murd]]
[[es:Plantilla:Fracción]]
[[fa:الگو:تقسیم]]
[[id:Templat:Frac]]
[[ko:틀:분수]]
[[hi:साँचा:Frac]]
[[is:Snið:Brot]]
[[lv:Veidne:Frac]]
[[mk:Шаблон:Дроп]]
[[nl:Sjabloon:Breuk]]
[[no:Mal:Brøk]]
[[ja:Template:分数]]
[[pl:Szablon:U]]
[[pt:Predefinição:Frac]]
[[ru:Шаблон:Дробь]]
[[simple:Template:Frac]]
[[sl:Predloga:Ulomek]]
[[zh:Template:Fraction]]
</includeonly>
</includeonly>

Latest revision as of 08:13, 8 April 2025

Template:Documentation subpage Template:Uses TemplateStyles This template builds an alternative form of common fractions. The template takes one, two, or three parameters: the optional integer (may be signed), the optional numerator and the required denominator; in this order.

Please do not subst:itute it.

{{fraction|A|B|C}}
A+BC (integer, numerator and denominator)
{{fraction|B|C}}
BC (numerator and denominator)
{{fraction|C}}
1C (denominator only)
{{fraction}}
(fraction slash only)

Examples

Numbers
12 13 23 14 34 15 25 35 45 16 56 17 27 37 47 57 67 18 38 58 78 116 316 516 716 916 1116 1316 1516
Units
ms kmh kg·ms2 1s Mbits

Notes

  • {{fraction}} or &frasl; may be used to print out the fraction slash glyph " ⁄ ".
  • For mixed fractions, in some contexts (like link targets) a "+" is generated between the whole number part and fraction part. If this is not desirable, put the whole number part outside the template, and put a non-breaking space between when the spacing is desirable. For example: "33&nbsp;{{frac|1|3}}".

Parameters

A template for displaying common fractions of the form int+num/den nicely. It supports 0–3 anonymous parameters with positional meaning.

Template parameters

ParameterDescriptionTypeStatus
leftmost part1

Denominator if only parameter supplied. Numerator if 2 parameters supplied. Integer if 3 parameters supplied. If no parameter is specified the template will render a fraction slash only.

Lineoptional
middle-right part2

Denominator if 2 parameters supplied. Numerator if 3 parameters supplied.

Lineoptional
rightmost part3

Denominator, always.

Lineoptional

See also