Template:United States topic

Template documentation[view] [edit] [history] [purge]

This template employs complicated features of template syntax.

You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages.
Remember that you can conduct experiments, and should test all improvements, in either the general Template sandbox or your user space before changing anything here.

This template allows quick creation of navigational template for groups of articles containing names of U.S. states. It uses Template:Navbox to create the navigation box.

Blank syntax change

{{United States topic
<!--passed through to Template:Navbox-->
| name       =
| state      =
| title      =
| titlestyle =
| bodystyle  =
| groupstyle =
<!--specific to Template:United States topic-->
| prefix =
| suffix =
| exclude-wdc =
| exclude-ter =
| exclude-isl =
}}

Parameters change

Mandatory change

name: Mandatory when creating a new template (i.e. Template:Hospitals in the United States), otherwise the "view · talk · edit" links will connect to Template:United States topic. You can enter {{subst:PAGENAME}} for this value as a shortcut.

One of the following combinations is needed to create the links:

prefix: Places text before the U.S. state name. For example: |prefix = List of airports in would create a title List of airports in the United States and a body containing state names linked to List of airports in Alabama, List of airports in Alaska, etc.; Note: in instances when only prefix is specified, the template inserts "the" between the prefix text and "United States", creating the title List of airports in the United States instead of List of airports in United States. In the body it does the same for the District of Columbia, the Northern Mariana Islands, and the United States Virgin Islands.

suffix: Places text after the U.S. state name. For example: |suffix = National Guard would create a title United States National Guard and a body containing state names linked to Alabama National Guard, Alaska National Guard, etc.

prefix and suffix: Places text before and after the U.S. state name. For example: |prefix = List of and |suffix = rivers would create a title List of United States rivers and a body containing state names linked to List of Alabama rivers, List of Alaska rivers, etc.; Note: The title in this example should be replaced by using the title parameter described below.

Optional change

state: A navbox with autocollapse will start out collapsed if there are two or more tables on the same page that use collapsible. If set to collapsed, the navbox will always start out in a collapsed state. If set to blank or anything other than autocollapse or collapsed, the navbox will always start out in an expanded state.; Default is: autocollapse.

title: Text that appears centered in the titlebar (the top bar). This is optional because the use of either prefix, suffix or both will automatically generate a title if the title parameter is not supplied. This parameter is not automatically wiki-linked. For example: title = [[List of rivers in the United States|Rivers in the United States]] generates the title Rivers in the United States.

Excluding groups change

In some instances the District of Columbia, large islands (U.S. Territories / Insular Areas) or small islands (U.S. Minor Outlying Islands) may not have their own articles on particular topics. To disable their inclusion in the template and avoid unnecessary red links, add any or all of the following parameters:

exclude-wdc: Set to any value this excludes display of the group named National capital which links to District of Columbia.

exclude-ter: Set to any value this excludes display of the group named Large islands which links to American Samoa, Guam, etc.

exclude-isl: Set to any value this excludes display of the group named Small islands which links to Baker Island, Howland Island, etc.

Adding groups and lists change

Some templates may require a list of links not already included in the template. These can be specified as follows:

list5: Text or a list of links that is displayed below the state and territory links.

group5: Header text displayed in cell to left of text specified in list5.

above: A full-width cell (no group header) displayed above the template's body (between the title and U.S. state links).

below: A full-width cell (no group header) displayed below the template's body.

Change state name used in link change

The link for the District of Columbia uses "District of Columbia" and for the state of Georgia it is "Georgia (U.S. state)". The following parameters allow for substitution where the article name does not use the default

DC

Replace "(the) District of Columbia" in links with specified text, i.e. "Washington, D.C.".

| DC = Washington, D.C.

GA

Replace "Georgia (U.S. state)" in links with specified text, i.e. "Georgia".

| GA = Georgia

Styles change

titlestyle

Specifies CSS values to apply to the title. One use of this is to set the background color of the title:

titlestyle = background: #0000FF;

titlestyle = background: blue;

Default is: background: #ccccff;

bodystyle

Specifies CSS values to apply to the entire template. This will not override the following {{Navbox}} default styles:

abovestyle = background:#ddddff;

belowstyle = background:#ddddff;

groupstyle = background:#ddddff; text-align:right; white-space:nowrap;

liststyle = width:100%; font-size:95%;

abovestyle

belowstyle

Specifies CSS values to apply to the cell specified via the above and below parameters. For instance:

belowstyle = border-top: #ccccff 1px solid;

Default is: background: #ddddff;

groupstyle

Specifies CSS values to apply to the cells specified via the group_n cells. This option overrides any styles that are applied to the entire table. Example:

groupstyle = background:#6AFB92; vertical-align:top;

Default is: background: #ddddff; text-align:right; white-space:nowrap;

liststyle

Specifies CSS values to apply to the cells specified via the list_n cells. This option overrides any styles that are applied to the entire table. Examples:

liststyle = padding: 5px 10px 5px 10px;

Default is: width:100%; font-size:95%;

Examples change

Changing the navigation box title change

{{United States topic
| title  = [[History of the United States]] by political division
| prefix = History of
}}

Excluding display of federal district and minor outlying islands change

This example also shows the use of the titlestyle to change the background color and the groupstyle parameters to change the background color and vertical alignment of text.

{{United States topic
| title  = [[Airports in the United States]]
| titlestyle = background: #64E986;
| groupstyle = background: #6AFB92; vertical-align: top;
| prefix = List of airports in
| exclude-wdc = y
| exclude-isl = y
}}

Adding suffix without leading space change

This example also shows the use of the liststyle parameter to add some extra padding around the list, the group1 parameter to remove the "States" heading, and the GA parameter to change link from "Georgia (U.S. state)" to "Georgia".

{{United States topic
| liststyle = padding: 5px 10px 5px 10px;
| group1 =
| prefix = List of
| suffix = -related topics
| GA = Georgia
| exclude-wdc = y
| exclude-ter = y
| exclude-isl = y
}}

Adding suffix with leading space change

Note the use of an underscore in place of the leading space in the suffix. This is done to accommodate the use of suffixes without a leading space, as in the previous example. A title should be specified to avoid the underscore appearing in the title. This example also uses the DC parameter to change link from "District of Columbia" to "Washington, D.C.".

{{United States topic
| title  = [[Rivers in the United States]]
| prefix = List of
| suffix = _rivers
| DC = Washington, D.C.
| exclude-isl = y
}}

Using a suffix without a prefix change

This example also shows use of the group5 and list5 parameters to add a group and list.

{{United States topic
<!--passed through to Template: Navbox -->
| title   = [[United States National Guard|National Guard]] in the [[United States]]
| group5  = {{nowrap|National capital<br/>and large islands}}
| list5   = [[District of Columbia National Guard|District of Columbia]]{{·}} [[Puerto Rico National Guard|Puerto Rico]]{{·}} [[Virgin Islands National Guard|U.S. Virgin Islands]]
<!-- specific to Template: United States topic -->
| suffix  = _National Guard
| GA = Georgia
| exclude-wdc = y
| exclude-ter = y
| exclude-isl = y

Creating a new template change

Code used to create Template:Hospitals in the United States:

{{United States topic
<!--passed through to Template:Navbox-->
| name  = {{subst:PAGENAME}}
| title = [[List of hospitals in the United States|Hospitals in the United States]]
<!--specific to Template:United States topic-->
| prefix = List of hospitals in
| exclude-ter = y
| exclude-isl = y
}}<noinclude>
[[Category:United States topic navigational boxes|{{PAGENAME}}]]
</noinclude>

Note: {{subst:PAGENAME}} in the above example would be replaced by Hospitals in the United States when this code is saved in Template:Hospitals in the United States.

Result:

Templates implemented with United States topic change

The documentation on top is transcluded from Template:United States topic/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.

v t e United States
States	Alabama Alaska Arizona Arkansas California Colorado Connecticut Delaware Florida Georgia Hawaii Idaho Illinois Indiana Iowa Kansas Kentucky Louisiana Maine Maryland Massachusetts Michigan Minnesota Mississippi Missouri Montana Nebraska Nevada New Hampshire New Jersey New Mexico New York North Carolina North Dakota Ohio Oklahoma Oregon Pennsylvania Rhode Island South Carolina South Dakota Tennessee Texas Utah Vermont Virginia Washington West Virginia Wisconsin Wyoming
Federal district	Washington, D.C.
Insular areas	American Samoa Guam Northern Mariana Islands Puerto Rico U.S. Virgin Islands
Outlying islands	Baker Island Howland Island Jarvis Island Johnston Atoll Kingman Reef Midway Atoll Navassa Island Palmyra Atoll Wake Island

v t e History of the United States by political division
States	Alabama Alaska Arizona Arkansas California Colorado Connecticut Delaware Florida Georgia Hawaii Idaho Illinois Indiana Iowa Kansas Kentucky Louisiana Maine Maryland Massachusetts Michigan Minnesota Mississippi Missouri Montana Nebraska Nevada New Hampshire New Jersey New Mexico New York North Carolina North Dakota Ohio Oklahoma Oregon Pennsylvania Rhode Island South Carolina South Dakota Tennessee Texas Utah Vermont Virginia Washington West Virginia Wisconsin Wyoming
Federal district	Washington, D.C.
Insular areas	American Samoa Guam Northern Mariana Islands Puerto Rico U.S. Virgin Islands

v t e Rivers in the United States
States	Alabama Alaska Arizona Arkansas California Colorado Connecticut Delaware Florida Georgia Hawaii Idaho Illinois Indiana Iowa Kansas Kentucky Louisiana Maine Maryland Massachusetts Michigan Minnesota Mississippi Missouri Montana Nebraska Nevada New Hampshire New Jersey New Mexico New York North Carolina North Dakota Ohio Oklahoma Oregon Pennsylvania Rhode Island South Carolina South Dakota Tennessee Texas Utah Vermont Virginia Washington West Virginia Wisconsin Wyoming
Federal district	Washington, D.C.
Insular areas	American Samoa Guam Northern Mariana Islands Puerto Rico U.S. Virgin Islands