Template:Background/doc: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
 
(33 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{documentation subpage}}
{{Doc/subpage}}__NOTOC__
 
This template allows you to add a background for an article.
This template allows you to add a background for an article.


== Usage ==
== Usage ==
Just insert {{MdCode|outline-oneclick|<nowiki>{{background|}}</nowiki>}} into the page and insert your image after {{MdCode|outline-oneclick|<nowiki>{{background|</nowiki>}}.
{{Template usage example|column}}


<br>'''Using Modifiers:'''<br>
== Parameters and Examples ==
Insert {{MdCode|outline-oneclick|<nowiki>modifier=|</nowiki>}} after {{MdCode|outline-oneclick|<nowiki>{{background|</nowiki>}} and replace '''"modifier"''' with the name of an existing modifier. After the equal sign, you need to write the properties corresponding to the modifier.
{| class="standard-table" width="100%"
 
! style="width:12%" | Name
== Mofifiers ==
! style="width:48%" | Description
{| class="standard-table"
! Example
! Name !! Description
! style="width:8%" | Preview
|-
| style="text-align:center" | <code>{{param|file}}</code>
| The path to the image.
| style="background-color:#1f1f1f" | <pre style="margin:0">| file = Hlalyx1.jpg</pre>
| rowspan="6" style="background-color:#262626; text-align:center; vertical-align:top" | See [[Template:Background/sandbox|Sandbox]].
|-
| style="text-align:center" | <code>{{param|opacity}}</code>
| Allows you to change the opacity of the entire block.
(<code>0.05</code> by default)
| style="background-color:#1f1f1f" | <pre style="margin:0">| opacity = 0.5</pre>
|-
|-
| <code style="padding: 1px 3px; user-select: all;">opacity</code> || allows you to change the opacity of the entire block (default {{MdCode|outline|0.5}})
| style="text-align:center" | <code>{{param|bgcolor}}</code>
| Controls the background color of the block.
(<code>transparent</code> by default)
| style="background-color:#1f1f1f" | <pre style="margin:0">| bgcolor = rgb(255,255,255)</pre>
|-
|-
| <code style="padding: 1px 3px; user-select: all;">background-color</code> || controls the background color of the block
| style="text-align:center" | <code>{{param|gradient-color}}</code>
| Controls the color of the bottom gradient.
(<code>38,38,38</code> by default)
| style="background-color:#1f1f1f" | <pre style="margin:0">| gradient-color = 50,50,50</pre>
|-
|-
| <code style="padding: 1px 3px; user-select: all;">gradient-color</code> || controls the color of the bottom gradient
| style="text-align:center" | <code>{{param|gradient-height}}</code>
| Controls the height of the gradient.
(<code>150px</code> by default)
| style="background-color:#1f1f1f" | <pre style="margin:0">| gradient-height = 600px</pre>
|-
|-
| style="text-align:center" | <code>{{Param|mode}}</code>
| Controls the position of the background image on the page.
* <code>0</code> &ndash; Absolute ''(default)'': Always at the top of the page.
* <code>1</code> &ndash; Static: The regular position where the template occurs in the wikitext
* <code>2</code> &ndash; Sticky: Like static, but the image follows the user when scrolling about, until the containing block (such as a simple <code>&lt;div&gt;</code>) ends.
| style="background-color:#1f1f1f" | <pre style="margin:0">| mode = 1</pre>
|}
|}


== Example ==
<includeonly>{{sandbox other||
* [[Half-Life: Alyx Workshop Tools:ru|Инструменты Мастерской Half-Life: Alyx]]
[[Category:Templates]]
}}</includeonly>

Latest revision as of 22:56, 26 September 2025

Edit-copy.png
This is a documentation subpage for Template:Background.
Don't forget to purge the contents of the base page upon creating or editing this subpage.

This template allows you to add a background for an article.

Usage

This template is usually written in a column. To use it, insert {{Background}} on the desired page and specify the parameters under the template name in the following format:

{{Background | parameter 1 = value | parameter 2 = value }}

Parameters and Examples

Name Description Example Preview
{{{file}}} The path to the image.
| file = Hlalyx1.jpg
See Sandbox.
{{{opacity}}} Allows you to change the opacity of the entire block.

(0.05 by default)

| opacity = 0.5
{{{bgcolor}}} Controls the background color of the block.

(transparent by default)

| bgcolor = rgb(255,255,255)
{{{gradient-color}}} Controls the color of the bottom gradient.

(38,38,38 by default)

| gradient-color = 50,50,50
{{{gradient-height}}} Controls the height of the gradient.

(150px by default)

| gradient-height = 600px
{{{mode}}} Controls the position of the background image on the page.
  • 0 – Absolute (default): Always at the top of the page.
  • 1 – Static: The regular position where the template occurs in the wikitext
  • 2 – Sticky: Like static, but the image follows the user when scrolling about, until the containing block (such as a simple <div>) ends.
| mode = 1