Reba inkomoko ya Inyandikorugero:Pad/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE. -->

==Usage==
Use {{tl|pad}} to insert a horizontally padding HTML {{tag|span|open}} inline. The template takes one unnamed parameter; a width value specified in <code>[[Pixel|px]]</code>, <code>[[Em (typography)|em]]</code> or <code>[[x-height|ex]]</code> (other CSS units&nbsp;– in, cm, pc, pt&nbsp;– are supported as well, but not recommended, typically at 96dpi conversion ratio). The default is <code>1 em</code>.

'''The result is the specified padding followed by an &amp;nbsp;''' ([[non-breaking space]]&nbsp;– at 100% font size (8pt), typically 3px wide in narrow fonts like Arial and Tahoma, 4px in wider fonts like Arial Black and Verdana).

==Examples==
Indenting by 50 pixels plus an &amp;nbsp; (53px in Arial):
* <code>Indenting 50px causes<nowiki><br />{{pad|50px}}</nowiki>this amount of space.</code>
''Produces:''
* Indenting 50px causes<br />{{pad|50px}}this amount of space.

Width of a typical year-range in Arial font (4.8em plus an &amp;nbsp;):
* <code>1492–1540 Exploration by<nowiki><br />{{pad|4.8em}}</nowiki>Columbus & others.</code>
''Produces:''
* 1492–1540 Exploration by<br />{{pad|4.8em}}Columbus & others.

This is better produced by:
* <syntaxhighlight lang="text" inline>1492–1540 Exploration by<br/>{{hidden text|1492–1540}} Columbus & others.</syntaxhighlight>
''Which produces:''
* 1492–1540 Exploration by<br />{{hidden text|1492–1540}} Columbus & others


However, some digits supposedly require less space:
* <code>1111–1117 Exploration by<nowiki><br />{{pad|4.4em}}</nowiki>Explorer Bob.</code>
''Produces:''
* 1111–1117 Exploration by<br />{{pad|4.4em}}Explorer Bob.

But actually not:
* <syntaxhighlight lang="text" inline>1111–1117 Exploration by<br/>{{hidden text|9999–9999}} Explorer Bob.</syntaxhighlight>
''Produces:''
* 1111–1117 Exploration by<br/>{{hidden text|9999–9999}} Explorer Bob.


Spacing is, of course, different between fonts, too:
* {{Font|This is text 0123456789 in Arial<br />{{Pad|100px}}and this is indented by 100px + 1 &amp;nbsp;<br />{{Pad|9em}}and this is indented by 9em + 1 &amp;nbsp;|font=Arial}}
* {{Font|This is text 0123456789 in Times New Roman<br />{{Pad|100px}}and this is indented by 100px+ 1 &amp;nbsp;<br />{{Pad|9em}}and this is indented by 9em + 1 &amp;nbsp;|font=Times New Roman}}
* {{Font|This is text 0123456789 in Arial Black<br />{{Pad|100px}}and this is indented by 100px + 1 &amp;nbsp;<br />{{Pad|9em}}and this is indented by 9em + 1 &amp;nbsp;|font=Arial Black}}
* {{Font|This is text 0123456789 in Lucida Console<br />{{Pad|100px}}and this is indented by 100px+ 1 &amp;nbsp;<br />{{Pad|9em}}and this is indented by 9em + 1 &amp;nbsp;|font=Lucida Console}}

''Note: 1em is typically 11.2px at 100% font size (8 point), 21.3px at 200% font size (16 point), and 32px at 300% font size (24pt).''

== See also ==
{{Inline spacing templates}}

<includeonly>{{Sandbox other|
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Inline spacing templates]]
}}</includeonly>