模板:Static row numbers/doc

此作品正在从非中文的原文进行翻译。欢迎您积极翻译与修订。
原文在en:template:Static row numbers。

Template to automatically add row numbers to sortable tables. The row numbers will not be sorted when columns of data are sorted. A possible note to add above a table: {{noprint|'''''Row numbers''' are static. Other columns are sortable. This allows ranking of any column.''}}

These templates work together and make table formatting fast:

• {{Static row numbers table}}
• {{Static row numbers header}}
• {{Static row numbers arrows}}
• {{Static row numbers total}}

Some are used together here: List of U.S. states and territories by incarceration and correctional supervision rate

Usage with wikitable and sortable

Place template before table where the automatic row numbers are required. Add class static-row-numbers to the table wikitext, as in the following example. It adds an unsorted column of row numbers.

Name	Number	Another Number
A	10	1000
B	50	800
C	100	150
D	20	700
E	70	350

{{Static row numbers}}
{| class="wikitable sortable static-row-numbers"
! Name !! Number !! Another Number
|-
| A || 10 || 1000
|-
| B || 50 || 800
|-
| C || 100 || 150
|-
| D || 20 || 700
|-
| E || 70 || 350
|}

Usage with sortable

Name	Number	Another Number
A	10	1000
B	50	800
C	100	150
D	20	700
E	70	350

{{Static row numbers}}
{| class="sortable static-row-numbers"
! Name !! Number !! Another Number
|-
| A || 10 || 1000
|-
| B || 50 || 800
|-
| C || 100 || 150
|-
| D || 20 || 700
|-
| E || 70 || 350
|}

Usage with no other classes

While designed to provide a static row number for sortable tables, it can be used just to add an automatic row number to plain tables.

Name	Number	Another Number
A	10	1000
B	50	800
C	100	150
D	20	700
E	70	350

{{Static row numbers}}
{| class="static-row-numbers"
! Name !! Number !! Another Number
|-
| A || 10 || 1000
|-
| B || 50 || 800
|-
| C || 100 || 150
|-
| D || 20 || 700
|-
| E || 70 || 350
|}

Using static-row-header-hash to add a hash # column header

This adds a hash # as the row number column header.

Name	Number	Another Number
A	10	1000
B	50	800
C	100	150
D	20	700
E	70	350

{{Static row numbers}}
{| class="wikitable sortable static-row-numbers static-row-header-hash"
! Name !! Number !! Another Number
|-
| A || 10 || 1000
|-
| B || 50 || 800
|-
| C || 100 || 150
|-
| D || 20 || 700
|-
| E || 70 || 350
|}

Marking additional header and footer rows with static-row-header

The class static-row-header is added to additional header rows (other than the first one). It prevents those header rows from having row numbers. It also prevents them from being sorted. It is important to add this class for consistent appearance in different Wikipedia skins and views. It is necessary for correct numbering in the minerva skin on mobile view which renders HTML tables differently.

Name	Number	Another Number
	(unit)	(per capita)
A	10	1000
B	50	800
C	100	150
D	20	700
E	70	350
Totals	250	3000

{{Static row numbers}}
{| class="wikitable sortable static-row-numbers"
! Name !! Number !! Another Number
|- class="static-row-header"
!  !! (unit) !! (per capita)
|-
| A || 10 || 1000
|-
| B || 50 || 800
|-
| C || 100 || 150
|-
| D || 20 || 700
|-
| E || 70 || 350
|- class="static-row-header"
! Totals !! 250 !! 3000
|}

Marking footer or header rows that also contain data cells (non-header cells)

To prevent them from sorting class=sorttop or class=sortbottom must also be added. For an example of header rows like this see this version of the 2021 table in this list article.

Name	Number	Another Number
	(unit)	(per capita)
A	10	1000
B	50	800
C	100	150
D	20	700
E	70	350
Totals	250	3000

{{Static row numbers}}
{| class="wikitable sortable static-row-numbers"
! Name !! Number !! Another Number
|- class="static-row-header"
!  !! (unit) !! (per capita)
|-
| A || 10 || 1000
|-
| B || 50 || 800
|-
| C || 100 || 150
|-
| D || 20 || 700
|-
| E || 70 || 350
|- class="sortbottom static-row-header"
! Totals 
|| 250 || 3000
|}

White background for data cells

Add class=srn-white-background to the top line of the table wikitext. It can be used on tables with inline cell or row background colors. Neither are affected by this class.

This class is unnecessary if you are using this:

• {{Static row numbers table}}

The class is incorporated into that template.

1	2	3
1-1	2-1	3-1
1-2	2-2	3-2

{{Static row numbers}}
{| class="wikitable sortable static-row-numbers srn-white-background"
|-
! 1 !! 2 !! 3
|-
| 1-1 || 2-1 || 3-1
|-
| 1-2 || 2-2 || 3-2
|}