模板:Xiangqi diagram/doc
 | 此模板使用Lua语言： |
 | 本模板使用以下模板样式： |
概要
用于展示象棋棋谱，具有标框、标点、标叉、箭头等功能，可以更快读懂棋谱想表达的意思。
使用方法
| 基本参数 | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 第一个参数 | 对其方式，有center、tleft、tright，预设为tleft。 | |||||||||||||||||||||||||
| 第二个参数 | 标题 | |||||||||||||||||||||||||
| 第三个 至 第九十二个参数 |
棋子种类和颜色，以下表为示： 没有棋子可以填入“_”或者空白键。
| |||||||||||||||||||||||||
| 第九十三个参数 | 说明 | |||||||||||||||||||||||||
| size | 棋子大小 | 这三个参数三选一，也可以都不写会自动用预设大小，预设是棋子大小25px。 | ||||||||||||||||||||||||
| width | 宽度 | |||||||||||||||||||||||||
| height | 高度 | |||||||||||||||||||||||||
| startrow | 开始显示行 | 显示范围 | ||||||||||||||||||||||||
| rows | 要显示行数 | |||||||||||||||||||||||||
| startcol | 开始显示列 | |||||||||||||||||||||||||
| cols | 要显示列数 | |||||||||||||||||||||||||
| arrow arrow2 arrow3...... |
显示箭头 | |||||||||||||||||||||||||
使用范例
基本功能
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例（空棋盘）
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
|展示一个空棋盘
|size=25
}}
|
示例（空棋盘） 展示一个空棋盘 |
{{Xiangqi diagram
|tleft
|示例（英文代码）
|rd|hd|ed|ad|gd|ad|ed|hd|rd
| | | | | | | | |
| |cd| | | | | |cd|
|sd| |sd| |sd| |sd| |sd
| | | | | | | | |
| | | | | | | | |
|sl| |sl| |sl| |sl| |sl
| |cl| | | | | |cl|
| | | | | | | | |
|rl|hl|el|al|gl|al|el|hl|rl
|左浮动
|size=25
}}
|
示例（英文代码） 左浮动 |
{{Xiangqi diagram
|tright
|示例（简体版）
|车|马|象|士|将|士|象|马|车
| | | | | | | | |
| |砲| | | | | |砲|
|卒| |卒| |卒| |卒| |卒
| | | | | | | | |
| | | | | | | | |
|兵| |兵| |兵| |兵| |兵
| |炮| | | | | |炮|
| | | | | | | | |
|伡|㐷|相|仕|帅|仕|相|㐷|伡
|右浮动
|size=25
}}
|
示例（简体版） 右浮动 |
{{Xiangqi diagram
|center
|示例（繁體版）
|車|馬|象|士|將|士|象|馬|車
| | | | | | | | |
| |砲| | | | | |砲|
|卒| |卒| |卒| |卒| |卒
| | | | | | | | |
| | | | | | | | |
|兵| |兵| |兵| |兵| |兵
| |炮| | | | | |炮|
| | | | | | | | |
|俥|傌|相|仕|帥|仕|相|傌|俥
|居中
|size=25
}}
|
示例（繁体版） 居中 |
显示特殊标记
在从第3到第92个参数中，除了填入棋子的中文名或英文代码外，还可以填入某些特定代码，在棋盘上显示相对应的标记。
- 输入“[]”，可在相应位置显示一个方框。可用于突出强调某块区域、某个棋子，或表示当前正在移动的棋子。
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例2
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | |砲|
| | | | | | | | |
| | | | | | |[㐷]| |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |帅| | |
|“㐷”
|size=25
}}
|
示例2 “㐷” |
- 输入“..”，可在相应位置显示一个圆点，可用于表示某个棋子的起落点、允许着法等。
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例3
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |..| |.砲.|
| | | | |..| | | |..
| | | | | | |[㐷]| |
| | | | |..| | | |..
| | | | | |..| |..|
| | | | | | | | |
| | | | | |帅| | |
|马踏八方
|size=25
}}
|
示例3 马踏八方 |
- 输入“xx”，可在相应位置显示一个叉号，可用于表示某个棋子的禁止着法等。
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例4
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |.砲.| |..|
| | | | |..| | | |xx
| | | | | | |[㐷]|卒|
| | | | |..| | | |xx
| | | | | |xx| |..|
| | | | | | | | |
| | | | | |帅| | |
|“蹩马腿”/禁止“送将”
|size=25
}}
|
示例4 “蹩马腿”/禁止“送将” |
指定范围
可使用rows、startrow、cols、startcol等参数让棋图的一部分可见，其余部分则隐藏：
- rows参数用以控制需要显示的行数，startrow参数指定起始行数。
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例5
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |..| |.砲.|
| | | | |..| | | |..
| | | | | | |[㐷]| |
| | | | |..| | | |..
| | | | | |..| |..|
| | | | | | | | |
| | | | | |帅| | |
|从第三行开始显示，共显示6行
|size=40
|rows=6
|startrow=3
}}
|
示例5 从第三行开始显示，共显示6行 |
- cols参数用以控制需要显示的列数，startcol参数指定起始列数。
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例6
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |..| |.砲.|
| | | | |..| | | |..
| | | | | | |[㐷]| |
| | | | |..| | | |..
| | | | | |..| |..|
| | | | | | | | |
| | | | | |帅| | |
|从第三行开始显示，共显示6行<br/>从第四列开始显示，共显示6列
|size=50
|rows=6
|startrow=3
|cols=6
|startcol=4
}}
|
示例6 从第三行开始显示，共显示6行 从第四列开始显示，共显示6列 |
箭头指示
此功能需要CSS3（层叠样式表第三份标准）的支持，不支持CSS3的浏览器（如Internet Explorer 8等）可能无法正确显示
- arrow参数用于显示箭头，可更直观的展示某个棋子的行棋路线。
- 格式：
arrow = a, b, c, d
- arrow由四个数字组成，用英文逗号分隔。第一个数（a）为箭头的起始横坐标，第二个数（b）为箭头的起始纵坐标，第三个数（c）为箭头长度，第四个数（d）为箭头的旋转角度。坐标以最左上角的交叉点位作为原点（1, 1）。角度以右箭头（→）作为0°，按顺时针旋转。
- 若要使用多个箭头可以用arrow2或者是更大的数字和arrow组合，但需要从2开始且必须是连续数字，例如需要五个箭头则必须设定arrow、arrow2、arrow3、arrow4、arrow5。
| 源代码 | 页面显示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例7
| | | |士|将|士| | |
| | | | | | | | |
| | | | |傌| | | |
| | | | | | | | |
| | | | | | | | |
| | |炮| | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=3, 6, 2, 0
}}
|
示例7 |
{{Xiangqi diagram
|tleft
|示例8
|车| | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=1, 1, 9, 90
}}
|
示例8 |
{{Xiangqi diagram
|tleft
|示例9
|车| | | |将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |伡
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=9, 8, 4, 180
}}
|
示例9 |
{{Xiangqi diagram
|tleft
|示例10
|车| | | |将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |炮
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=9, 8, 7, 270
}}
|
示例10 |
{{Xiangqi diagram
|tleft
|示例11
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | |炮| | | |
| | |相| | |帅| | |
|
|size=25
|arrow=3, 10, 2.8, 315
}}
|
示例11 |
{{Xiangqi diagram
|tleft
|示例12
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | |傌| | | | |
| | | | | | | | |
| | | | | | | | |
| | | | |炮| | | |
| | | | | |帅| | |
|
|size=25
|arrow=4, 6, 2.2, 63.4
}}
|
示例12 |
{{Xiangqi diagram
|tleft
|示例13
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | |傌| | | | | |
| | | | | | | | |
| | | | |炮| | | |
| | | | | |帅| | |
|
|size=25
|arrow=3, 7, 2.2, 26.6
}}
|
示例13 |
{{Xiangqi diagram
|tleft
|示例14
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | |仕| | | | |
| | | | | | | | |
| | | | |炮|帅| | |
|
|size=25
|arrow=4, 8, 1.4, 45
}}
|
示例14 |