查看“︁模板:Map/doc”︁的源代码

{{documentation header}}
<!-- 文档页面 -->
== 描述 ==
当前模板用于展示一张游戏地图，并在地图上插入一个或多个玩家的位置的图标。此模板通过动态生成标记，直观地展示游戏内的具体位置。

== 用法 ==
该模板接受多个参数，可以控制地图的类型、尺寸和标记的位置。坐标参数用于设定玩家头像图标在地图上的位置。

第一个位置的 x 和 y 坐标是匿名参数（也就是参数一和参数二），必须按顺序作为第 1 和第 2 个参数传入。如果需要指定宽度，必须将其作为第 3 个参数。

=== 基本结构 ===

<pre>
{{Map
|x 坐标 (左侧偏移)
|y 坐标 (顶部偏移)
|宽度 (可选, 默认为 400)
|loc2x = 第二个位置的 x 坐标（可选）
|loc2y = 第二个位置的 y 坐标（可选）
|loc3x = 第三个位置的 x 坐标（可选）
|loc3y = 第三个位置的 y 坐标（可选）
|loc4x = 第四个位置的 x 坐标（可选）
|loc4y = 第四个位置的 y 坐标（可选）
|island = （可选，可填写 true 或 small，显示姜岛相关的地图）
|main = （可选，设置为 false 时隐藏主地图）
……其他用于姜岛地图的特定坐标参数……
}}
</pre>

== 参数详解 ==
=== 通用参数 ===
; <code>{{{1}}}</code> (匿名参数)
: 第一个标记的 '''x 坐标'''（从左侧的偏移量，单位 px）。仅对主地图和附带姜岛的主地图有效。
; <code>{{{2}}}</code> (匿名参数)
: 第一个标记的 '''y 坐标'''（从顶部的偏移量，单位 px）。仅对主地图和附带姜岛的主地图有效。
; <code>{{{3}}}</code> (匿名参数)
: 地图的 '''宽度'''，单位 px。高度会根据宽度自动缩放。如果省略，默认为 400。

=== 地图类型控制 ===
; <code>island</code>
: 控制显示的地图类型。
:* 如果设为 true，则仅显示'''姜岛的地图'''。
:* 如果设为 small，则显示'''包含姜岛区域的完整主地图'''。
:* 如果省略或为其他值，则显示默认的'''星露谷主地图'''。
; <code>main</code>
: 如果设为 false，则在不使用 island 参数的情况下，主地图不会显示。可用于仅显示姜岛地图的场景。

=== 额外位置参数 ===
==== 用于主地图和带岛屿的主地图 ====

<code>loc2x</code> / <code>loc2y</code>：第二个标记的 x / y 坐标。

<code>loc3x</code> / <code>loc3y</code>：第三个标记的 x / y 坐标。

<code>loc4x</code> / <code>loc4y</code>：第四个标记的 x / y 坐标。

==== 仅用于姜岛地图 (island=true) ====

<code>islandloc1x</code> / <code>islandloc1y</code>：第一个标记的 x / y 坐标。

<code>islandloc2x</code> / <code>islandloc2y</code>：第二个标记的 x / y 坐标。

<code>islandloc3x</code> / <code>islandloc3y</code>：第三个标记的 x / y 坐标。

<code>islandloc4x</code> / <code>islandloc4y</code>：第四个标记的 x / y 坐标。

== 示例 ==
=== 基础示例 ===
在 (100, 100) 坐标处显示一个标记。

<pre>{{Map|100|100}}</pre>

显示效果:
{{Map|100|100}}

=== 自定义尺寸 ===
将地图宽度设为 200px。

<pre>{{Map|100|10|200}}</pre>

显示效果:
{{Map|100|10|200}}

=== 带有 3 个位置标记的地图 ===

<pre>{{Map|200|150|loc2x=276|loc2y=54|loc3x=96|loc3y=130}}</pre>

显示效果:
{{Map|200|150|loc2x=276|loc2y=54|loc3x=96|loc3y=130}}

=== 仅显示姜岛地图 ===

<pre>{{Map|island=true|islandloc1x=180|islandloc1y=107}}</pre>

显示效果:
{{Map|island=true|islandloc1x=180|islandloc1y=107}}

=== 显示包含姜岛的完整地图 ===

<pre>{{Map|360|214|island=small}}</pre>

显示效果:
{{Map|360|214|island=small}}

<includeonly>
<!-- 页面分类 -->
[[分类:文档页面]]
<!--[[分类:手动填写]]-->
</includeonly>
<noinclude>
<!-- 文档分类 -->
</noinclude>