Template:Notice: Difference between revisions

From The Reed and Rite
mNo edit summary
m Changed asterisk in "Prevent Dismissal" section to a superscript number.
 
(4 intermediate revisions by the same user not shown)
Line 22: Line 22:
! width=38%|You Type
! width=38%|You Type
!You Get
!You Get
|- style="text-align: center; background-color: white;"
|- style="text-align: center;"
| <pre>{{notice|text=This is a notice.}}</pre>
| <pre>{{notice|text=This is a notice.}}</pre>
| {{notice|text=This is a notice.}}
| {{notice|text=This is a notice.}}
Line 30: Line 30:
! width=30%|You Type
! width=30%|You Type
!You Get
!You Get
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{notice
| <pre>{{notice
|header=This is a header.
|header=This is a header.
Line 41: Line 41:
! width=30%|You Type
! width=30%|You Type
!You Get
!You Get
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{notice
| <pre>{{notice
|text=This notice's width is 100%.
|text=This notice's width is 100%.
Line 52: Line 52:
! width=30%|You Type
! width=30%|You Type
!You Get
!You Get
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{notice
| <pre>{{notice
|text=A left/right aligned notice.
|text=A left/right aligned notice.
Line 59: Line 59:
| {{notice|text=A left aligned notice.|align=left}}{{notice|text=A right aligned notice.|align=right}}
| {{notice|text=A left aligned notice.|align=left}}{{notice|text=A right aligned notice.|align=right}}
|-  
|-  
! colspan="2" style="text-align: center;" | <span style="font-size: 125%;">Adjust Color</span><br><div style="text-align: left;"><span style="font-weight: normal;">By default, the notice will have a light gray background with a gray border. You can adjust its background color by passing <code>color=</code> with a color value in one of three forms:<br>1. A [https://htmlcolorcodes.com/color-names/ Named HTML Color] (e.g., <code>red</code>)<br>2. A [https://www.color-hex.com hex color code] (e.g., <code>#ff0000</code>)<br>3. An [https://rgbcolorpicker.com RGB/RGBA value] (e.g., <code>rgb(255, 0, 0)</code>)<br><br>Please select a shade of color light enough that the black text remains legible.<span style="font-size: 90%;"><br><br>'''Note:''' By adding a color value, the border is removed.<span></span></div>
! colspan="2" style="text-align: center;" | <span style="font-size: 125%;">Adjust Color</span><br><div style="text-align: left;"><span style="font-weight: normal;">By default, the notice will have a light gray background with a gray border. You can adjust its background color by passing <code>color=</code> with a color value in one of three forms:<br>1. A [https://htmlcolorcodes.com/color-names/ Named HTML Color] (e.g., <code>red</code>)<br>2. A [https://www.color-hex.com hex color code] (e.g., <code>#ff0000</code>)<br>3. An [https://rgbcolorpicker.com RGB/RGBA value] (e.g., <code>rgb(255, 0, 0)</code>)<br><br>Adding a value not following one of the forms above will cause the background color to be transparent. Please select a shade of color light enough that the black text remains legible.<span style="font-size: 90%;"><br><br>'''Note:''' By adding a color value, the border is removed.<span></span></div>
|-
|-
! width=30%|You Type
! width=30%|You Type
!You Get
!You Get
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{notice
| <pre>{{notice
|text=A light green notice.
|text=A light green notice.
Line 74: Line 74:
! width=30%|You Type
! width=30%|You Type
!You Get
!You Get
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{notice
| <pre>{{notice
|text=A notice with a blue border.
|text=A notice with a blue border.
Line 81: Line 81:
| {{notice|text=A notice with a blue border.|border=1px solid blue}}
| {{notice|text=A notice with a blue border.|border=1px solid blue}}
|-  
|-  
! colspan="2" style="text-align: center;" | <span style="font-size: 125%;">Prevent Dismissal</span><br><div style="text-align: left;"><span style="font-weight: normal;">By default, notices have an "x" in the top right corner that, if clicked, will make the notice disappear.<span style="font-size: 125%;">'''*'''</span> You can pass <code>dismiss=no</code> to hide the "x", preventing the option to hide the notice. To unhide any notices you may have previously dismissed, select "Reset Notices" from the Tools menu.<br><br><span style="font-size: 125%;">'''*'''</span><span style="font-size: 90%;">Only users who are logged in have the ability to dismiss notices. Anonymous users (i.e., not logged in) cannot dismiss notices, regardless if <code>dismiss=no</code> is passed.</span></span></div>
! colspan="2" style="text-align: center;" | <span style="font-size: 125%;">Prevent Dismissal</span><br><div style="text-align: left;"><span style="font-weight: normal;">By default, notices have an "'''x'''" in the top right corner that, if clicked, will make the notice disappear.<sup>1</sup> You can pass <code>dismiss=no</code> to hide the "'''x'''", preventing the option to hide the notice. To unhide any notices you may have previously dismissed, select "Reset Notices" from the Tools menu in the upper, right hand corner of the page.<br><br>1. <span style="font-size: 90%;">Only users who are logged in have the ability to dismiss notices. Anonymous users (i.e., not logged in) cannot dismiss notices, regardless if <code>dismiss=no</code> is passed.</span></span></div>
|-
|-
! width=30%|You Type
! width=30%|You Type
!You Get
!You Get
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{notice
| <pre>{{notice
|text=This notice is not dismissible.
|text=This notice is not dismissible.
Line 98: Line 98:
|-  
|-  
| colspan="2" style="text-align: center;" | '''Without using <code>clear=yes</code>.'''
| colspan="2" style="text-align: center;" | '''Without using <code>clear=yes</code>.'''
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{quote}}{{notice
| <pre>{{quote}}{{notice
|text=This notice is not using "clear=yes".
|text=This notice is not using "clear=yes".
Line 112: Line 112:
|-  
|-  
| colspan="2" style="text-align: center;" | '''Using <code>clear=yes</code>.'''
| colspan="2" style="text-align: center;" | '''Using <code>clear=yes</code>.'''
|- style="text-align: left; background-color: white;"
|- style="text-align: left;"
| <pre>{{quote}}{{notice
| <pre>{{quote}}{{notice
|text=Using "clear=yes".
|text=Using "clear=yes".

Latest revision as of 19:26, 29 May 2025

Description

This template is a parent template that helps build Notice Templates. It is not intended to be used on its own, but rather to be used to help build other derivative templates.

Usage

Text Only
The only required parameter for this template is text=, which will populate the template with your input.
You Type You Get
{{notice|text=This is a notice.}}
×
This is a notice.
Add a Bold Header
You have the option to also add a bold header by passing header=.

Note: If you wish for the regular text to be bold, surround your text= input with triple apostrophes. ('''INPUT''')
You Type You Get
{{notice
|header=This is a header.
|text=This is the regular text.
}}
×
This is a header.
This is the regular text.
Adjust Width
By default, the width of the notice will be 65% the width of the page or container where it is used. You can adjust this value by passing width= and defining the width as either a percentage (preferred), e.g., 80%, or a pixel width, e.g., 300px.
You Type You Get
{{notice
|text=This notice's width is 100%.
|width=100%
}}
×
This notice's width is 100%.
×
This notice's width is 50%.
Adjust Alignment
By default, the notice will be centered on the page or within the container where it is used. You can adjust its alignment by passing align= with either the value LEFT or RIGHT.
You Type You Get
{{notice
|text=A left/right aligned notice.
|align=LEFT/RIGHT
}}
×
A left aligned notice.
×
A right aligned notice.
Adjust Color
By default, the notice will have a light gray background with a gray border. You can adjust its background color by passing color= with a color value in one of three forms:
1. A Named HTML Color (e.g., red)
2. A hex color code (e.g., #ff0000)
3. An RGB/RGBA value (e.g., rgb(255, 0, 0))

Adding a value not following one of the forms above will cause the background color to be transparent. Please select a shade of color light enough that the black text remains legible.

Note: By adding a color value, the border is removed.
You Type You Get
{{notice
|text=A light green notice.
|color=#bdcca1
}}
×
A light green notice.
Add a Border
It is preferred to have notices display without a border, however you can add a border by passing border=. Your input should follow the standard HTML border format of SIZE PATTERN COLOR, e.g., 1px solid blue.

Note: You can find further details on HTML borders here.
You Type You Get
{{notice
|text=A notice with a blue border.
|border=1px solid blue
}}
×
A notice with a blue border.
Prevent Dismissal
By default, notices have an "x" in the top right corner that, if clicked, will make the notice disappear.1 You can pass dismiss=no to hide the "x", preventing the option to hide the notice. To unhide any notices you may have previously dismissed, select "Reset Notices" from the Tools menu in the upper, right hand corner of the page.

1. Only users who are logged in have the ability to dismiss notices. Anonymous users (i.e., not logged in) cannot dismiss notices, regardless if dismiss=no is passed.
You Type You Get
{{notice
|text=This notice is not dismissible.
|dismiss=no
}}
This notice is not dismissible.
Clear Other Elements
On very rare occasions, a notice may overlap with other elements present on the page. You can prevent this by passing clear=yes. This parameter should only be used as a last resort as passing it may give unexpected or undesired results. Instead, try adjusting using the width or alignment parameters or adding a line break between the notice template and the other element(s).
You Type You Get
Without using clear=yes.
{{quote}}{{notice
|text=This notice is not using "clear=yes".
}}
“

A thing someone said. ”

—Who Said It
×
This notice is not using clear=yes.
Using clear=yes.
{{quote}}{{notice
|text=Using "clear=yes".
|clear=yes
}}
“

A thing someone said. ”

—Who Said It
×
Using clear=yes.

Derivative Templates