模板:Tree list/doc

此页面是Template:Tree list的模板文档。
此页面可能包含了模板的使用说明、分类和其他内容。

本模板使用以下模板样式：

Template:Tree list/styles.css

此模板适用于呈现树状资料，且允许在资讯中引用条目连结。可用于显示家谱、王位继承、演化树等资讯。其组成模板包含：

{{Tree list}}
- {{Tree list/end}}
- {{Tree list/branching}}

语法

宣告模板的开始与结束

{{Tree list}} 与 {{Tree list/end}} 分别宣告树状图绘制的起点与结束，生成树状图的内容资料必须位于这两个标签之间。内容的资料格式是一组由星号 * 组成的槽状清单。

{{Tree list}}
* 前綴一個或多個星號的樹狀圖內容。
{{Tree list/end}}

建立分支

使用巢状列表建立每个树状图的分支：

{{Tree list}}
* 第一層級分支
** 第二層級分支
*** 第三層級分支
{{Tree list/end}}

结果：

第一层级分支
- 第二层级分支
  - 第三层级分支

跨阶层分支 Unlabelled branches

某些树状图资料有跨阶层的需求，可将 {{Tree list/branching}} 标签置于不需显示阶层资料（unlabelled）的结点，达成排版目的。例如第一阶层旗下有部分资料直属于第三阶层，此时可将 {{Tree list/branching}} 至于第二阶层，在排版上形成跨阶层分支。

{{Tree list}}
* 第一層級分支
** {{Tree list/branching}}
*** 第三層級分支
*** 另一個第三層級分支
*** 最後一個第三層級分支
** 第二層級分支
** {{Tree list/branching}} <!--- 此分支將終結上行的第二層級，並指引下一行的第三層級直接從第一層級分支至此 --->
*** 第三層級分支
*** 最後一個第三層級分支
{{Tree list/end}}

结果：

第一层级分支
- - 第三层级分支
  - 另一个第三层级分支
  - 最后一个第三层级分支
- 第二层级分支
- - 第三层级分支
  - 最后一个第三层级分支

折叠模式

折叠模式可协助版面过长的树状图折叠收起，使画面简洁。使用方式为：在{{Tree list}}之前新增模组 {{Hidden begin}}，在 {{Tree list/end}} 之后新增 {{Hidden end}}。预设状态的折叠模式只有一个“展开”按钮在右边，但在下方诸多范例中，引用了多个参数完善使用者体验，参数们详列如下：

 |border=1px  #aaa solid — a solid border around the tree
 |title=Demonstration tree — a suitable name for the tree
 |ta1=center – center the title= name

{{hidden begin|border=1px  #aaa solid|title=Demonstration tree|ta1=center}}
{{Tree list}}
* 第一層級分支
** {{Tree list/branching}}
*** 第三層級分支
*** 另一個第三層級分支
*** 最後一個第三層級分支
** 第二層級分支
** {{Tree list/branching}} <!--- 此分支將終結上行的第二層級，並指引下一行的第三層級直接從第一層級分支至此 --->
*** 第三層級分支
*** 最後一個第三層級分支
{{Tree list/end}}
{{hidden end}}

Demonstration tree

第一层级分支
- - 第三层级分支
  - 另一个第三层级分支
  - 最后一个第三层级分支
- 第二层级分支
- - 第三层级分支
  - 最后一个第三层级分支

树状图预设为折叠收起的状态。若将参数 |expanded=on 加入 {{hidden begin}} 则可将树状图预设为展开状态。

范例

家族树

源代码：

{{hidden begin|border=1px  #aaa solid|title=A family tree (descendants of Henry VII of England)|ta1=center|expanded=on}}
{{Tree list}}
*[[Image:Simple gold crown.svg|15px]] '''(1)''' [[Henry VII of England|Henry VII]] (1457–1509)
**[[Arthur, Prince of Wales]] (1486–1502)
**[[Margaret Tudor|Margaret, Queen of Scots]] (1489–1541)
***[[James, Duke of Rothesay]] (1507–1508)
***[[Arthur, Duke of Rothesay]] (1509–1510)
***[[Image:Simple silver crown.svg|15px]] [[James V of Scotland]] (1512–1542)
****[[Image:Simple silver crown.svg|15px]] [[Mary, Queen of Scots]] (1542–1587)
*****[[Image:Simple silver crown.svg|15px]] [[Image:Simple gold crown.svg|15px]] '''(7)''' [[James VI and I|James VI of Scotland and I of England]] (1566–1625)
******''From whom succeeding English, Scottish and British monarchs are descended.''
***[[Alexander Stewart, Duke of Ross]] (1514–1515)
***[[Margaret Douglas|Margaret Douglas, Countess of Lennox]] (1515–1578)
**[[Image:Simple gold crown.svg|15px]] '''(2)''' [[Henry VIII of England]] (1491–1547)
***[[Henry, Duke of Cornwall]] (1511–1511)
***[[Image:Simple gold crown.svg|15px]] '''(5)''' [[Mary I of England]] (1516–1558)
***[[Image:Simple gold crown.svg|15px]] '''(6)''' [[Elizabeth I of England]] (1533–1603)
***[[Image:Simple gold crown.svg|15px]] '''(3)''' [[Edward VI of England]]
**[[Elizabeth Tudor (daughter of Henry VII)|Elizabeth Tudor]] (1492–1495)
**[[Mary Tudor (queen consort of France)|Mary, Queen of France]] (1496–1533)
***Henry Brandon (1516–1522)
***[[Frances Grey, Duchess of Suffolk]] (1517–1547)
****[[Image:Simple gold crown.svg|15px]] '''(4)''' [[Lady Jane Grey]] (1536–1553)
****[[Lady Catherine Grey|Catherine Seymour, Countess of Hertford]] (1540–1568)
****[[Lady Mary Grey|Lady Mary Keyes]] (1545–1578)
****Elizabeth Stokes (1555–1556)
***[[Eleanor Clifford, Countess of Cumberland]] (1519–1547)
****''From whom are descended the [[Earl of Derby|Earls of Derby]]''
***[[Henry Brandon, 1st Earl of Lincoln]] (1523–1534)
**[[Edmund Tudor, Duke of Somerset]] (1499–1500) 
**[[Katherine Tudor (1503)|Katherine Tudor]] (1503–1503)
{{Tree list/end}}
{{hidden end}}

结果：

A family tree (descendants of Henry VII of England)

(1) Henry VII (1457–1509)
- Arthur, Prince of Wales (1486–1502)
- Margaret, Queen of Scots (1489–1541)
  - James, Duke of Rothesay (1507–1508)
  - Arthur, Duke of Rothesay (1509–1510)
  - James V of Scotland (1512–1542)
    - Mary, Queen of Scots (1542–1587)
      - (7) James VI of Scotland and I of England (1566–1625)
        From whom succeeding English, Scottish and British monarchs are descended.
  - Alexander Stewart, Duke of Ross (1514–1515)
  - Margaret Douglas, Countess of Lennox (1515–1578)
- (2) Henry VIII of England (1491–1547)
  - Henry, Duke of Cornwall (1511–1511)
  - (5) Mary I of England (1516–1558)
  - (6) Elizabeth I of England (1533–1603)
  - (3) Edward VI of England
- Elizabeth Tudor (1492–1495)
- Mary, Queen of France (1496–1533)
  - Henry Brandon (1516–1522)
  - Frances Grey, Duchess of Suffolk (1517–1547)
    - (4) Lady Jane Grey (1536–1553)
    - Catherine Seymour, Countess of Hertford (1540–1568)
    - Lady Mary Keyes (1545–1578)
    - Elizabeth Stokes (1555–1556)
  - Eleanor Clifford, Countess of Cumberland (1519–1547)
    - From whom are descended the Earls of Derby
  - Henry Brandon, 1st Earl of Lincoln (1523–1534)
- Edmund Tudor, Duke of Somerset (1499–1500)
- Katherine Tudor (1503–1503)

血统表 ancestry tree

树状图模板亦可用于显示血统表，但小于六代以下的血统表，通常推荐使用专为此类用途客制的模板 {{Ahnentafel}} （详见 Template:Ahnentafel/doc ），资讯表达将更加清晰。另一种模板 {{Ahnentafel-tree}} 便是以此为基础，但更方便组织绘制树状图。

{{hidden begin|border=1px  #aaa solid|title=Ancestry tree of Prince William, Duke of Cambridge|ta1=center|expanded=on}}
{{Tree list}}
*1. '''[[William, Prince of Wales]]''' (born 21 June 1982)
**2. [[Charles III|Charles III of the United Kingdom]] (born 14 November 1948)
***4. [[Prince Philip, Duke of Edinburgh|Prince Philip of Greece and Denmark]] (10 June 1921 – 9 April 2021)
****8. [[Prince Andrew of Greece and Denmark]] (20 January 1882 – 3 December 1944)
****9. [[Princess Alice of Battenberg]] (25 February 1885 – 5 December 1969)
***5. [[Elizabeth II|Elizabeth II of the United Kingdom]] (21 April 1926 – 8 September 2022)
****10. [[George VI|George VI of the United Kingdom]] (14 December 1895 – 6 February 1952)
****11. [[Queen Elizabeth The Queen Mother|Lady Elizabeth Bowes-Lyon]] (4 August 1900 – 30 March 2002)
**3. [[Diana, Princess of Wales|Lady Diana Spencer]]  (1 July 1961 – 31 August 1997)
***6. [[John Spencer, 8th Earl Spencer]] (21 April 1926 – 29 March 1992)
****12. [[Albert Spencer, 7th Earl Spencer]] (23 May 1892 – 9 June 1975)
****13. [[Cynthia Spencer, Countess Spencer|Lady Cynthia Hamilton]]  (16 August 1897 – 4 December 1972)
***7. [[Frances Shand Kydd|The Honourable Frances Roche]] (20 January 1936 – 3 June 2004)
****14. [[Maurice Roche, 4th Baron Fermoy]] (15 May 1885 – 8 July 1955)
****15. [[Ruth Roche, Baroness Fermoy|Ruth Gill]] (2 October 1908 – 6 July 1993)
{{Tree list/end}}
{{hidden end}}

演化树

{{hidden begin|border=1px  #aaa solid|title=A cladogram|ta1=center|expanded=on}}
{{Tree list}}
*[[四足類|Tetrapoda]]
** {{Tree list/branching}}
*** Many extinct groups such as the ''[[Eucritta]]''
*** '''[[Lissamphibia]]''' Whose ancestors of the current amphibians
** {{Tree list/branching}}
*** Many extinct groups reminiscent of amphibians with more or less pronounced reptilian characteristics such as [[始爬螈屬|Eoherpetontidae]], the [[Embolomeri]], the [[Tokosauridae]], [[Chroniosuchidae]], [[Gephyrostegidae]], [[Solenodonsauridae]], [[Seymouriamorpha]], [[Westlothiana]], [[殼椎亞綱|Lepospondyli]]
*** [[大鼻龍目|Cotylosauria]]
**** [[羊膜動物|Amniota]], Originally all "Reptilian"
**** Other extinct sibling taxa like [[Diadectomorpha]] or [[Tseajaiidae]] are close enough to reptiles
{{Tree list/end}}
{{hidden end}}

结果：

A cladogram

Tetrapoda
- - Many extinct groups such as the Eucritta
  - Lissamphibia Whose ancestors of the current amphibians
- - Many extinct groups reminiscent of amphibians with more or less pronounced reptilian characteristics such as Eoherpetontidae, the Embolomeri, the Tokosauridae, Chroniosuchidae, Gephyrostegidae, Solenodonsauridae, Seymouriamorpha, Westlothiana, Lepospondyli
  - Cotylosauria
    - Amniota, Originally all "Reptilian"
    - Other extinct sibling taxa like Diadectomorpha or Tseajaiidae are close enough to reptiles

另见

Wikipedia:Family trees
{{Tree chart}} — 可绘制以横排为同阶层的树状图，以资料方框加上线段表示树状资料。
{{Ahnentafel}} — 此模组将家谱资料以Ahnentafel数据的形式，转换为血统树结构图
{{ahnentafel-tree}} — 采用 {{Tree list}} 显示方式，但资料输入型态雷同 {{Ahnentafel}} ，可帮助撰写者处理最多九代分支（即511个地点）。此树状图最少必须显示第一阶层。