View source for Template:Nocaps/doc

{{Documentation subpage}}
{{Update|warnings about cross-browser errors}}
__NOTOC__
'''<code><nowiki>{{Nocaps|yOuR tExT}}</nowiki></code>''' will (in most browsers) display upper- or mixed-case text in, and (in many browsers) permanently convert it to, full [[lowercase]].

==Usage==
{{Warning|This template is not cross-browser compatible, and will corrupt upper- or mixed-case data by permanently converting it to uppercase for users of many browsers, including Chrome, Chromium, Opera, and any text-only browser (Lynx, Lynx, W3M, etc), from which copy-pasted output will be all-uppercase.|image=Stop hand nuvola.svg|left=y}}
{{COinS safe|n}}

Your source text {{em|will be}} altered in many browsers (a copy-paste will not give it in its original form):
: '''In:''' <code><nowiki>{{Nocaps|The ''Name'' of the Game}}</nowiki></code>
: '''Out:''' {{Nocaps|The ''Name'' of the Game}}
: '''Pasted:''' Incorrectly as "the ''name'' of the game" or correctly as "The ''Name'' of the Game", depending on browser.

You can use this template to control the display of the variable output of magic words and of other templates.{{dubious}}

== Technical notes ==
{{anchor|Note}}
* This template is a wrapper for <code><nowiki><span class="nocaps" style="text-transform: lowercase;">...</span></nowiki></code> – This method is implemented inconsistently in browsers, such that it copy-pastes as the original text in Firefox, but as the altered text in Chrome, Safari, Opera, and text-only browsers.
* '''Preferably do not subst: it''' because the result will {{em|not}} be an lowercase source text but the original text wrapped in HTML code making it appear lowercase, so it is more efficient for this purpose to simply rewrite the text in uppercase, or use <nowiki>"{{subst:lc:&nbsp;...text...}}"</nowiki> to store lowercase text into the page.  You can also use the template in edit mode, then copy-paste the result from preview mode into the editing field, replacing the original material and the template.
* [[Diacritic]]s (å, ç, é, ğ, ı, ñ, ø, ş, ü, etc.) are handled. However, because the job is performed by the browser, inconsistencies in [[CSS]] implementations can lead to some browsers not converting certain rare diacritics.
* As with most templates, if the argument contains an equals sign (<code>=</code>), the sign should be replaced with {{[[Template:=|=]]}}, or the whole argument be prefixed with <code>1=</code>. And for wikilinks, you need to use piping. There is a parsing problem with MediaWiki which causes unexpected behavior when a template with one style is used within a template with another style.
* Do not use this inside {{cs1}} or {{cs2}} templates (most citation templates), or other templates that emit [[COinS]] metadata, or the markup will be included in the metadata.
* This template will not affect the use of HTML character entities like <code>&amp;nbsp;</code>.

==Comparison of the case transformation templates==
{{Case templates table}}

==TemplateData==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Input text",
			"required": true
		}
	},
	"format": "block"
}
</templatedata>

==See also==
{{Case templates see also}}

<includeonly>{{Sandbox other||
[[Category:Text-specific formatting and function templates|Nocaps]]

}}</includeonly>