Шаблон:Userbox/Документация
Этот шаблон упрощает создание юзербоксов, которые обычно размещаются на личной странице участника.
Использование[править]
{{userbox | bodyclass = <!--добавляет атрибут класса для всей таблицы.--> | border-c = <!--цвет бордюра (по умолчанию=id-c)--> | border-s = <!--ширина бордюра в пикселях (по умолчанию=1)--> | float = <!--left|right|none // слева, справа или как есть (по умолчанию=left)--> | id = <!--иконка с изображением и/или текст--> | id-a = <!--горизонтальное выравнивание иконки left/center/right/justify (по умолчанию=center)--> | id-c = <!--цвет фона окна с иконкой (по умолчанию=#d0d0d0)--> | id-fc = <!--цвет надписи на иконке (по умолчанию=black)--> | id-h = <!--высота окна с иконкой в пикселях (по умолчанию=45)--> | id-lh = <!--высота строки в окне с иконкой (по умолчанию=1.25em)--> | id-op = <!--другие CSS параметры окна с иконкой--> | id-p = <!--отступ в ячейке с иконкой (по умолчанию=0 1px 0 0)--> | id-s = <!--размер текста в точках в окне с иконкой (по умолчанию=14)--> | id-w = <!--ширина окна с иконкой в пикселях (по умолчанию=45)--> | info-class = <!--добавляет атрибут класса для информационной строки таблицы--> | info = <!--информационный текст и/или изображение--> | info-a = <!--горизонтальное выравнивание в окне с информацией left/center/right/justify (default=left)--> | info-c = <!--цвет фона окна с информацией (по умолчанию=#e0e0e0)--> | info-fc = <!--цвет надписи в окне с информацией (по умолчанию=black)--> | info-lh = <!--высота строки в окне с информацией (по умолчанию=1.25em)--> | info-op = <!--другие CSS параметры окна с информацией--> | info-p = <!--отступ в ячейке информацией (по умолчанию=0 4px 0 4px)--> | info-s = <!--размер текста в точках в окне с информацией (по умолчанию=8)--> | nocat = <!--блокировка включения в категорию (по умолчанию=false)--> | usercategory = <!--категория (необязательно)--> | usercategory2 = <!--категория (необязательно)--> | usercategory3 = <!--категория (необязательно)--> }}
- Все параметры необязательные
- Изображение должно быть соразмерно с x45px или меньше.
Список наиболее значимых параметров:
{{userbox | border-c = | id = | id-c = | id-fc = | id-s = | info = | info-c = | info-fc = | info-lh = | info-s = | nocat = {{{nocat|}}} | usercategory = }}
Примеры[править]
Code | Result | |||||
---|---|---|---|---|---|---|
{{userbox}} |
| |||||
{{userbox | border-c = #aaffaa | border-s = 2 | id = foo | id-c = #ffffee | id-s = 20 | info = ''foo bar'' | info-c = #ffeeff | info-s = 12 }} |
| |||||
Следующий пример показывает, как выглядит юзербокс, высота которого выше чем 45 пикселей. Сравните с примерами выше и ниже. | ||||||
{{userbox | border-c = #aaffaa | border-s = 2 | id = foo logo | id-c = #ffffee | info = ''We are trying to see default distance in between text lines, see the distance in between cell content and its border, and also see total height.'' | info-c = #ffeeff }} |
| |||||
Следующий пример показывает, как мы можно изменить параметры юзербокса, чтобы уменьшить его высоту до рекомендуемой в 45 пикселей, даже если в нём четыре строки текста. Параметр отступа в ячейке "info-p" можно установить в "1pt 1pt 1pt 2pt" или "1pt 2pt" для улучшения внешнего вида, если нужно показать 4 строки текста. | ||||||
{{userbox | border-c = #aaffaa | border-s = 1 | id = foo logo | id-c = #ffffee | id-lh = 1.1em | id-s = 14 | info = ''We have specified values to lessen the distance in between text lines & padding space in between cell content and its border.'' | info-c = #ffeeff | info-lh = 1.05em | info-p = 1pt | info-s = 8 }} |
| |||||
Следующий пример для продвинутых пользователей, показывает как можно указать другие свойства CSS, например, "font-family", чтобы изменить шрифт или "text-align", чтобы изменить выравнивание. Ниже справа два юзербокса: верхний без параметров "font-family" и "text-align", а в нижнем они изменены с помощью параметра "info-op". | ||||||
{{userbox | border-c = #afa | border-s = 2 | id = foo logo | id-c = #ffe | id-lh = 1.1em | id-s = 14 | info = foo bar | info-c = #fef | info-op = font-family:'Courier New'; text-align:center; | info-s = 14 }} |
|
Микроформаты[править]
- bodyclass
- Этот параметр задаёт атрибут "class" для всего юзербокса.
- info-class
- Этот параметр задаёт атрибут "class" только для части информационного сообщения.
Этот шаблон позволяет дополнять информацию с помощью микроформатов. Это делается путём добавления атрибута "class" в различные ячейки с данными, в котором указывается какого типа информация в них содержится. Например, чтобы пометить юзербокс, содержащий контактную информацию в микроформате w:hCard, добавьте следующий параметры:
| bodyclass = vcard
или
| info-class = vcard
далее (например):
| title = …the books of <span class="fn">[[Iain Banks]]</span>
...и так далее.