Шаблон:Cmbox: различия между версиями

Материал из Тептар — свободной энциклопедии
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
 
Строка 1: Строка 1:
<table class="plainlinks cmbox
{{#invoke:Message box|cmbox}}<noinclude>
{{#switch:{{{type|}}}
| speedy    = cmbox-speedy
| delete    = cmbox-delete
| content    = cmbox-content
| style      = cmbox-style
| move      = cmbox-move
| protection = cmbox-protection
| notice          <!-- notice = default -->
| #default  = cmbox-notice
}} {{{class|}}}" style="{{{style|}}}">
<tr>
{{#ifeq:{{{image|}}}|none
| <!-- No image. Cell with some width or padding necessary for text cell to have 100% width. --><td class="mbox-empty-cell"></td>
| <td class="mbox-image">
  {{#if:{{{image|}}}
  | {{{image}}}
  | [[File:{{#switch:{{{type|}}}
    | speedy    = Cmbox deletion.png
    | delete    = Cmbox deletion.png
    | content    = Cmbox content.png
    | style      = Edit-clear.svg
    | move      = Cmbox move.png
    | protection = Cmbox protection.png
    | notice          <!-- notice = default -->
    | #default  = Cmbox notice.png
    }}|40x40px|link=|alt=]]
  }}</td>
}}
<td class="mbox-text" style="{{{textstyle|}}}"> {{{text}}} </td>
{{#if:{{{imageright|}}}
| <td class="mbox-imageright"> {{{imageright}}} </td>
}}
</tr>
</table><!--
  Detect and report usage with faulty "type" parameter:
-->{{#switch:{{{type|}}}
|  <!-- No type fed, is also valid input -->
| speedy
| delete
| content
| style
| move
| protection
| notice    =    <!-- Do nothing, valid "type" -->
| #default  = <div style="text-align: center;">Этот шаблон использует неверный параметр "type={{{type|}}}", который необходимо исправить.</div>[[Категория:Шаблоны сообщений требующие исправления|{{main other|Main:}}{{FULLPAGENAME}}]]<!-- Sort on namespace -->
}}<noinclude>
{{documentation}}
{{documentation}}
<!-- Добавляйте категории и интервики на подстранице /doc, а не здесь! -->
<!-- Добавляйте категории и интервики на подстранице /doc, а не здесь! -->
</noinclude>
</noinclude>

Текущая версия от 14:34, 31 января 2022

Документация
Мета-шаблоны
блоков сообщений

Этот мета-шаблон используется для формирования информационных сообщений на страницах пространства категорий. Шаблон позволяет задать различные цвета окна сообщения, вид значка и прочее.

Использование[править код]

Простое использование:

{{cmbox | text = Обычный текст. }}


Сложное использование:

{{cmbox
| type      = style
| image     = [[Файл:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = The message body text.
}}

Типы информационных сообщений в категориях[править код]

Следующие примеры используют различные значения параметра type, но не меняют параметры отображения значка (иконки), поэтому везде отображается картинка по умолчанию.

Другие значки[править код]

Значок по умолчанию добавлен для удобства. В большинстве случаев целесообразнее более конкретно указывать вид значка. Ниже показаны несколько примеров, поясняющих как использовать параметр image для отображения других значков.

Дополнительно[править код]

Примеры использования других параметров и их комбинаций.

Параметры[править код]

Список всех параметров:

{{cmbox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[Файл:Some image.svg|40px]]
| imageright = [[Файл:Some image.svg|40px]]
| class = A custom CSS class to apply to the box
| style = CSS values
| textstyle = CSS values
| text  = The message body text. 
}}

type

нет параметра = если параметр type не задан, то используется значение по умолчанию notice (голубой фон).

image

нет параметра = если параметр image не задан, то используется значок по умолчанию в зависимости от того что задано в параметре type.
файл изображения = ссылка на файл использующая вики разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
image = [[Файл:Sub-arrows.svg|40px]]
none = обозначает, что не нужно отображать значок.

imageright

нет параметра = если параметр imageright не задан, то значок справа не показывается.
файл изображения = ссылка на файл использующая вики разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
imageright = [[Файл:Nuvola apps bookcase.png|40px]]
одругое = все что вы хотите отобразить справа.

style

Дополнительный параметр стиля CSS для всей таблицы. Например:
style = margin-bottom: 0.5em;

textstyle

Дополнительный параметр стиля CSS для текстовой ячейки. Например:
textstyle = text-align: center;

text

Текст сообщения.

Технические детали[править код]

Если вам необходимо использовать специальные символы внутри параметра text, то вам необходимо заменять их ESC-последовательностями :

{{cmbox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.  
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. 
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}

Этот шаблон использует cmbox CSS-классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.

Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.