Шаблон:Предмет

Матеріал з Terraria Wiki
Перейти до навігації Перейти до пошуку
У цьому шаблоні використовується Lua.
Цей шаблон використовує Модуль:Item — скрипт, написаний на мові програмування Lua. Щоб дізнатися більше про Lua, див. en:Terraria Wiki:Lua.
Цей шаблон i18n-ready, що означає, що його легко локалізувати для різних мов. Будь ласка, ознайомтеся з i18n та l10n для шаблонів, щоб дізнатися більше.
Цей шаблон використовує розширення Cargo.
Цей шаблон використовує Розширення:Cargo, невід'ємну частину серверної частини вікі.
Template-info.svg Документація Наведена нижче документація запозичена з «Шаблон:Предмет/док». (редагувати | історія)
Для більш повної чи актуальної інформації ви можете переглянути документацію англійською.

An all-in-one template for display item name/icon/link.

By default, displays a link to the item and adds an item icon in front of it.

Usage

All parameters are optional. Despite this, some combinations are invalid and may cause errors, e.g. {{item|icons=no|mode=image}}

See examples below for more details.

unnamed parameter 1

Default item display name, link target, and image file name. If unspecified, will try to retrieve it from {{{id}}}.

unnamed Parameter 2

Custom link text, which can include line breaks (<br />) and other wikitext. If an 's', 'es', 'ies' or 'ves' is passed as the custom text, it will be appended to the end of the item name. Pluralism is partially intuitive - adding 's' to Butterfly will return Butterflies. For non-english language, auto translation will be applied.

t

Custom link text, it will override unnamed Parameter 2, and it will be displayed as-is, without plural processing and auto translation.

mode

Display mode. It can be:

  • image(Preferred) or imageonly or onlyimage means only image will be displayed;
  • text(Preferred) or noimage means no image will be displayed;
  • table(Preferred) or 2-cell will output 2 cells code for table. This is roughly a shortcut for {{item|mode=image|itemname}} || {{item|mode=text|itemname}}

Use preferred values as much as possible to get the best performance.

image

image filename, no brackets nor "File:"(must include file extension, eg. Parrot.png).

You can specify multiple images, just separate filenames with slashes(eg. Parrot.png/Parrot (placed).png).

size

Custom graphic size (Read Extended image syntax for details).

You can specify multiple sizes, just separated with slashes(eg. 32px/24x24px).

When multiple images specified:

    • If only one size specified, it will apply to all images
    • if size is less then image, extra images will be displayed as if they don't have size argument
    • if size is more then image, extra sizes will simply be ignored.

And you can append it with *[factor] to scale image, e.g. 24x24px*0.5, 24px*0.5/24px*2 ...

scale

Image(s) will be scaled based on size and scale. e.g. |size=32x32px|scale=0.5 is equal to |size=16x16px. This will multiply with scale factor in size parameter, |size=32x32px*0.5|scale=0.5 is equal to |size=8x8px. scale can be set by options.

maxsize

Image size limit. Using standard image size syntax, eg. 32px/24x24px. will be applied after scale.

ext

image file extension, default is png. Only valid when there is no image input.

link

Custom link target. If blank given(i.e. |link=|), it will be no link(See example below). Note: eicons also will base on link first.

nolink = y/yes

Same as |link=|, only valid when there is no link input. If you use |link=somelink|nolink=y, it will be ignored.

anchor = y/yes

If set, will create an anchor for {{{1}}}.

note

Extra note text. By default, it will displayed as smaller and gray text between item name and platform icons , and without link on it.

note2

Another note text. By default, it will displayed as gray txt in normal size, without link, and always take a single line.

wrap = y/yes

Only valid when there is no id= or note2= input. If set, platform icons and/or note will be displayed in new line.

icons = n/no/y/yes

n/no=suppresses the platform icons; default is yes.

id

Number, will display items(or other type) ID information.

type

the type of ID, case-insensitive, default is item, only valid when id is specified. can be tile, wall, npc, mount, buff, debuff, projectile, or armor. All other values are treated as item.

showid = y/yes/n/no

Explicitly turn on/off id display. Default is on when id is set, off when id is not set. If showid is turned on and id is not set, will auto retrieve id from database (using data templates such as {{itemIdFromName}}, according to value of type).

small = y/yes

Reduces the size of the platform icons (useful when space is an issue).

class

Custom Css class(es). There're some predefined classes for certain formatting purpose(see examples below). You can add yours if needed.

css or style

Custom css style rules.

Examples

Basic

Result Code Note
ЛіжкоЛіжко {{item|Bed}} Basic usage.
Формат:CФормат:C(Видання для ПК, консолей та мобільних пристроїв) {{item|Format:C}} ":" in item name.
Змазана Зброя: Кислотна ОтрутаЗмазана Зброя: Кислотна Отрута {{item|Weapon Imbue: Venom}} ": " in item name.
ЛіжкоAny Bed {{item|Bed|Any Bed}} Custom text.
Ніж ПсихоНіж Психо(Видання для ПК, консолей та мобільних пристроїв) МетеликМетелик {{item|Psycho Knife|case=нв_м}} {{item|Butterfly|case=нв_м}} plural.
Дерев'яний МечДерев'яний МечВнутрішній ID предмета: 24 {{item|id=24}} auto retrieve name from id.
Дерев'яний МечДерев'яний Меч {{item|id=24|showid=no}} auto retrieve name from id but don't display id.
Дерев'яний МечMy Best WeaponВнутрішній ID предмета: 24 {{item|id=24|t=My Best Weapon}} auto retrieve name from id.
[[File:Помилка Lua Module GameText|link=Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.|Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.]][[File:loaddata-en returned boolean, table expected.<|link=Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.|Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.]][[File:span><|link=Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.|Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.]][[File:strong>.png|link=Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.|Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.]][[Помилка Lua: Module:GameText/loaddata-en returned boolean, table expected.]]Внутрішній ID бафа: 31 {{item|id=31|type=buff}} auto retrieve buff name from id.
Стіна ПлотіСтіна Плоті {{item|Wall of Flesh|size=32px}} custom image size. (Read Extended image syntax for details).
Стіна ПлотіWall of
Flesh		 {{item|Wall of Flesh|size=32px|Wall of<br/>Flesh}} Custom text in multiple lines.
Стіна ПлотіWall of
Flesh		 {{item|Wall of Flesh|size=32px|Wall of<br/>Flesh|class=multi-line}} Multiple lines need "multi-line" class for middle vertical align.
Treasure BagTreasure Bag(Видання для ПК, консолей та мобільних пристроїв) {{item|Treasure Bag|case=нв_м|ext=gif}} Custom image file extension.
Treasure BagTreasure Bag(Expert Mode)(Видання для ПК, консолей та мобільних пристроїв) {{item|Treasure Bag|case=нв_м|note={{small|(Expert Mode)}}|ext=gif}} Note text.
Ручний ПапугаParrot Pet {{item|Pet Parrot|image=Parrot.png|Parrot Pet}} Custom image file name.
Ручний ПапугаParrot Pet {{item|Pet Parrot|image=Parrot.png|Parrot Pet|ext=jpg}} Will display Parrot.png, ext is ignored when image specified.
Guide.png×Nurse.png
Бджолиний Віск(Видання для консолей старого покоління та 3DS)		 {{item|Beeswax|image=<div style="background:yellow">[[File:Guide.png]]×[[File:Nurse.png]]</div>}} Custom image code. The code must include at least one [[File: (case insenstive).
ПапугаParrot Pet {{item|Parrot|link=Pet Parrot|Parrot Pet}} Custom link target.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|link=}} Unlinked.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|nolink=y}} Unlinked.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|nolink=y|link=Bee}} if link is specified, it will override unlink=y.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|small=y}} Small platform icons.
Бджолиний ВіскБджолиний Віск {{item|Beeswax|icons=no}} Don't display platform icons.(Will be faster)
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 5019 {{item|Beeswax|id=5019}} With Item ID infomation
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: {{item|Beeswax|showid=y}} Auto Item ID.
Pet TiphiaPet Tiphia(Видання для консолей старого покоління та 3DS)Внутрішній ID бафа: 204 {{item|Pet Tiphia|id=204|type=buff}} Other type of ID, in this case, Buff ID.
ГідГідВнутрішній ID істоти: 22 {{item|Guide|id=22|type=npc}} NPC ID.
ЗамішанняЗамішанняВнутрішній ID бафа: 31 {{item|Confused|showid=y|type=buff}} Auto Buff ID
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 5019 {{item|Beeswax|id=5019|anchor=y}} Create an anchor. Now {{PAGENAME}}#Beeswax will link to here.

Size and scale

Result Code Note
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax}} Default size, this image is 32px in height.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|size=16px}} Custom absolute size.(x16px)
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|size=*0.5}} Custom scaled size.(x16px)
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|size=x40px*0.5}} Scaled absolute size.(x20px)
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|scale=0.5}} Scale. (x16px)
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|size=40px*0.5|scale=2}} combine scaled size and scale. (40px)
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|maxsize=12px}} maxsize
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|maxsize=40px}} maxsize, no effect
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|maxsize=12x16px}} maxsize
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{options/set|item|scale=0.5}}{{item|Beeswax}}{{options/reset|item}} change scale via option.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{options/set|item|scale=0.55}}{{item|Beeswax|size=*0.5}}{{options/reset|item}} double scale.

Note: Due to the way of [[File:]]'s size option works, if you want to set a size(after scale) larger then origin image size, you need to set it in DDpx or DDxDDpx, and xDDpx will be no effect. e.g. for Beeswax, {{item|Beeswax|size=x40px}} will be no effect.

Multiple images

Result Code Note
ПічПічПіч {{item|Furnace|image=Furnace.png/Furnace_(placed).gif}} Multiple images with auto size.
ПічПічПіч {{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=20px}} Only one size specified, all images will use this size.
ПічПічПіч {{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=30px/20px}} Multiple images with multiple sizes.
ПічПічПіч {{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=30px/20px/300px}} Size is more them images, extra size is ignored.
ПічПічПічПіч {{item|Furnace|image=Furnace.png/Furnace_(placed).gif/Hellforge.png|size=16px/50px}} Size is less then image, extra image will use auto size.

Wrap, id and note2

wrap is valid only when id and note2 are not specified.

Result Code Note
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS) {{item|Beeswax|wrap=y}} If there are platform icons and no note, platform icons will wrap to next line. note that platform icons are displayed in reduced size.
bedbed(some note) {{item|bed|wrap=y|note=(some note)}} If there are some note, note will wrap next line.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)(some note) {{item|Beeswax|wrap=y|note=(some note)}} If there are some note, note will display in next line, and platform icons will display in same line.
Бджолиний ВіскБджолиний Віск(some note)(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 234 {{item|Beeswax|wrap=y|note=(some note)|id=234}} If id is specified, note and eicons will displayed in same line, even if wrap=y.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)some other notes. {{item|Beeswax|wrap=y|note2=some other notes.}} note2 is similar.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)some other notes.Внутрішній ID предмета: 2384 {{item|Beeswax|id=2384|note2=some other notes.}} id and note2 will always take a single line.

Display mode

Result Code Note
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 2384 {{item|Beeswax|id=2384}} By default, it will display image and text info.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 2384 {{options/set|item|mode=table}}{{item|Beeswax|mode=|id=2384}}{{options/set|item|mode=}} Force to use default mode .
Бджолиний Віск {{item|Beeswax|mode=image|id=2384}} mode=image: Only image will be displayed, no text, no note, no id, and no platform icons.
Бджолиний Віск(Видання для консолей старого покоління та 3DS)(some note) {{item|Beeswax|mode=text|wrap=y|note=(some note)}} mode=text: image won't be displayed.
Бджолиний Віск Бджолиний Віск(Видання для консолей старого покоління та 3DS)
Метелик Метелик(some note) 
{| class="terraria lined"
|{{item|Beeswax|mode=table}}
|-
|{{item|Butterfly|ies|note=(some note)|mode=table}}
|}
mode=table: output as two adjacent cells for table.
Бджолиний Віск Бджолиний Віск(Видання для консолей старого покоління та 3DS) text
Метелик Метелик(some note) row 1
row 2 
{| class="terraria lined"
|{{item|Beeswax|mode=table}} || text
|-
|{{item|Butterfly|ies|note=(some note)|mode=table|rowspan=2}} || row 1
|-
| row 2
|}
mode=table: rowspan
Бджолиний Віск Бджолиний Віск(Видання для консолей старого покоління та 3DS)
Метелик Метелик(some note) 
{| class="terraria lined item-noborder"
|{{item|Beeswax|mode=table}}
|-
|{{item|Butterfly|ies|note=(some note)|mode=table}}
|}
table with "item-noborder" class: hide border between 2 cells.

Css and predefined classes

Result Code Note
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 2384 {{item|Beeswax|link=|id=2384|css=color:red;border: 2px solid blue;padding: 3px; background:#ccc}} Custom css rules.
Бджолиний ВіскБджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 2384 {{item|Beeswax|id=2384|class=boldname}} Predefined class: boldname, item name will displayed in bold.
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384		 {{item|Beeswax|id=2384|note=note|note2=note2|class=notecolor}}
{{item|Beeswax|id=2384|note=note|note2=note2|class=note2color}}
{{item|Beeswax|id=2384|note=note|note2=note2|css=color:red|class=note2color}}		 Predefined class: notecolor and note2color, note or note2 will display in normal(inherited) text color， respectively .
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384		 {{item|Beeswax|id=2384|note=note|note2=note2|class=notecolor}}
{{item|Beeswax|id=2384|note=note|note2=note2|class=note2color}}		 Predefined class: notesize and note2size, note will display in normal size, or note2 will display in reduced size, respectively.
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384		 {{item|Beeswax|id=2384|note=note|note2=note2|class=textleft}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=textcenter}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=textright}} Predefined class: textleft, textcenter， and textright, Similar to alignleft/aligncenter/alignright, but only applied to text part.alignleft/center/right can use with text/align/center/right at same time.
Бджолиний Віск(Видання для консолей старого покоління та 3DS)Внутрішній ID предмета: 2384 {{item|Beeswax|id=2384|class=block|mode=text}} Predefined class: block, main item element and text element will display as block element(default is inline-block). It is usually only practical when mode=text.
Бджолиний ВіскБджолиний Віскnote(Видання для консолей старого покоління та 3DS)note2Внутрішній ID предмета: 2384 {{item|Beeswax|id=2384|note=note|note2=note2|class=notesize notecolor boldname|css=color:red}} You can specify multiple classes, seperate with space, and can specify custom css rules at the same time.
Стіна ПлотіСтіна Плоті
 <div style="width: 5em">{{item|Wall of Flesh|size=32px|class=break}}</div> Wrap item name for long text when there is no enough space.

Transform

You can transform item image via these CSS classes.

The transformation happens at the center of the image and its effective dimensions will retain the original values of the object as if untransformed. So be careful with rotate90 and rotate270.

Result Code
guideguide {{item|guide}}
guideguide {{item|guide|class=mirror}}
guideguide {{item|guide|class=flip}}
guideguide {{item|guide|class=rotate90}}
guideguide {{item|guide|class=rotate180}}
guideguide {{item|guide|class=rotate270}}

Change default options

Цей шаблон підтримує параметри через шаблон {{options}}. Нижче наведено всі дійсні параметри. Щодо використання та іншої інформації перегляньте {{options}}.

Дивіться Template:предмет/initOptions, щодо налаштування параметрів цього шаблону.

НазваІнша назваЗначення за замовчуваннямЗаміна значень[1]Примітка
  1. ↑ Значення із заміною будуть збережені та завантажені як замінені значення. Інші значення без замін будуть збережені та завантажені як є.
NOTE: In order to avoid unwanted influences, it is very important to restore options state as soon as possible, especially in the template. Use {{options/snap}} and {{options/restore}}

See examples below for more details.

Example

Code output 
By default: 

{{item|Beeswax|note=(note)}}

turn off platform icons: 
{{options/set|item|icons=no}}
{{item|Beeswax|note=(note)}}

turn on platform icons, and turn on small icons:
{{options/set|item|icons=y|smallicons=y}}
{{item|Beeswax|note=(note)}}

turn on line wrap, and set to text mode: 
{{options/set|item|wrap=y|mode=text}}
{{item|Beeswax|note=(note)}}

turn on no link mode: 
{{options/set|item|nolink=y}}
{{item|Beeswax|note=(note)}}

This will be overridden by '''<code>link=</code>'''

{{item|Beeswax|note=(note)|link=Bee}}

get current setting:

nolink = {{options|item|nolink}} ; 
wrap = {{options|item|wrap}} ;
mode = {{options|item|mode}} ;

reset all options: 
{{options/reset|item}}
{{item|Beeswax|note=(note)}}

custom css and class:
{{options/set|item|css=border:1px solid red;padding:3px}}
{{item|Beeswax|note=(note)}}
{{options/set|item|class=boldname}}
{{item|Beeswax|note=(note)}}

reset all:
{{options/reset|item}}
{{item|Beeswax|note=(note)}}

By default:

Бджолиний ВіскБджолиний Віск(note)(Видання для консолей старого покоління та 3DS)

turn off platform icons:

Бджолиний ВіскБджолиний Віск(note)

turn on platform icons, and turn on small icons:

Бджолиний ВіскБджолиний Віск(note)(Видання для консолей старого покоління та 3DS)

turn on line wrap, and set to text mode:

Бджолиний Віск(Видання для консолей старого покоління та 3DS)(note)

turn on no link mode:

Бджолиний Віск(Видання для консолей старого покоління та 3DS)(note)

This will be overridden by link=

Бджолиний Віск(Видання для консолей старого покоління та 3DS)(note)

get current setting:

nolink = y ; wrap = y ; mode = text ;

reset all options:

Бджолиний ВіскБджолиний Віск(note)(Видання для консолей старого покоління та 3DS)

custom css and class:

Бджолиний ВіскБджолиний Віск(note)(Видання для консолей старого покоління та 3DS)

Бджолиний ВіскБджолиний Віск(note)(Видання для консолей старого покоління та 3DS)

reset all:

Бджолиний ВіскБджолиний Віск(note)(Видання для консолей старого покоління та 3DS)

About Translation

{{item}} is i18n-ready and integrated automatic translation. When translate to other language, It may not require any edit, auto translation will get things done, for example:

Code On English Page On Italian Page
{{item|Golden Chest}} Розкішна CкриняРозкішна Cкриня(Видання для ПК, консолей та мобільних пристроїв) Помилка Lua у package.lua у рядку 80: module 'Module:Tr/loaddata-it' not found.

if there is still English text, or you want to modify display text, please keep unnamed parameter 1 untouched({{item}} will handle the image and link target), and change unnamed parameter 2, for example:

On English Page On Italian Page Wrong usage
{{item|Copper Ore|Ore}}: Мідна РудаРуда
(links to Copper Ore)		 {{item|Copper Ore|Minerale}}: Помилка Lua у package.lua у рядку 80: module 'Module:Tr/loaddata-it' not found.
(links to Copper Ore/it)		 {{item|Minerale di rame}}: Помилка Lua у package.lua у рядку 80: module 'Module:Tr/loaddata-it' not found.
{{item|Minerale di rame|Minerale}}: Помилка Lua у package.lua у рядку 80: module 'Module:Tr/loaddata-it' not found.
(image and link are broken.)
Отримано з https://terraria.wiki.gg/uk/index.php?title=Шаблон:Предмет&oldid=6539