Difference between revisions of "Buttons"

From Tweeki
Jump to: navigation, search
 
(38 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[Category:Components]] __FORCETOC__
 
[[Category:Components]] __FORCETOC__
With tweeki it is very easy to create any button you would like to have. By using smart defaults the markup can be very reduced.
+
With Tweeki it is very easy to create any button you would like to have. By using smart defaults the markup can be very reduced.
  
<div class="alert alert-info" role="alert">This feature bypasses MediaWiki's default link handling. This might have security implications. You should only allow editing to people you trust! Also features like 'Links to this site' will not work for button links.</div>
+
<div class="alert alert-info" role="alert"><strong>Caveat:</strong> This feature bypasses MediaWiki's default link handling. This might have security implications. You should only allow editing to people you trust! Also features like 'Links to this site' will not work for button links.</div>
  
 
== Standard Buttons ==
 
== Standard Buttons ==
{| class=wikitable
+
{| class="table table-bordered"
 
! Markup !! Result
 
! Markup !! Result
 
|-
 
|-
Line 17: Line 17:
 
|
 
|
 
<pre>
 
<pre>
<btn size="large">Large Button</btn>
+
<btn size="lg">Large Button</btn>
<btn size="small">Small Button</btn>
+
<btn size="sm">Small Button</btn>
<btn size="mini">Mini Button</btn>
 
 
</pre>
 
</pre>
 
|
 
|
<div class="btn-toolbar"><btn size="large">Large Button</btn>
+
<btn size="lg">Large Button</btn>
<btn size="small">Small Button</btn>
+
<btn size="sm">Small Button</btn>
<btn size="mini">Mini Button</btn></div>
 
 
|-
 
|-
 
|
 
|
Line 67: Line 65:
 
Classy
 
Classy
 
Buttons
 
Buttons
 +
</btn>
 +
|-
 +
|
 +
<pre>
 +
<btn class="">
 +
Button without any class
 +
</btn>
 +
</pre>
 +
|
 +
<btn class="">
 +
Button without any class
 
</btn>
 
</btn>
 
|-
 
|-
Line 102: Line 111:
 
== Dropdown Buttons ==
 
== Dropdown Buttons ==
  
{| class=wikitable
+
{| class="table table-bordered"
 
! Markup !! Result
 
! Markup !! Result
 
|-
 
|-
Line 110: Line 119:
 
Dropdown-Menu
 
Dropdown-Menu
 
* Some Menu Item
 
* Some Menu Item
** Submenu
 
 
*
 
*
 +
*: Some Heading
 
* Some Other Menu Item
 
* Some Other Menu Item
 
</btn>
 
</btn>
Line 119: Line 128:
 
Dropdown-Menu
 
Dropdown-Menu
 
* Some Menu Item
 
* Some Menu Item
** Submenu
 
 
*
 
*
 +
*: Some Heading
 
* Some Other Menu Item
 
* Some Other Menu Item
 
</btn>
 
</btn>
Line 157: Line 166:
 
</btn>
 
</btn>
 
</pre>
 
</pre>
 +
<small>'''Note:''' this only works with the [https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Semantic MediaWiki] extension installed.
 
|
 
|
 
<btn>
 
<btn>
Line 166: Line 176:
 
== Wrappers ==
 
== Wrappers ==
  
{| class=wikitable
+
{| class="table table-bordered"
 
! Markup !! Result
 
! Markup !! Result
 
|-
 
|-
Line 184: Line 194:
 
|
 
|
 
<pre>
 
<pre>
<btn wrapperclass="btn-group btn-group-vertical">
+
<btn wrapperclass="btn-group-vertical">
 
Explicit
 
Explicit
 
Wrapper
 
Wrapper
Line 191: Line 201:
 
</pre>
 
</pre>
 
|
 
|
<btn wrapperclass="btn-group btn-group-vertical">
+
<btn wrapperclass="btn-group-vertical">
 
Explicit
 
Explicit
 
Wrapper
 
Wrapper
Line 210: Line 220:
 
Wrapper
 
Wrapper
 
Unsetting
 
Unsetting
 +
</btn>
 +
|}
 +
 +
== Styling ==
 +
 +
{| class="table table-bordered"
 +
! Markup !! Result
 +
|-
 +
|
 +
<pre>
 +
<btn>
 +
Target|<i>Italic Tag</i>
 +
</btn>
 +
</pre>
 +
|
 +
<btn>
 +
Target|<i>Italic Tag</i>
 +
</btn>
 +
|-
 +
|
 +
<pre>
 +
<btn>
 +
Target|''Italic Wiki Markup''
 +
</btn>
 +
</pre>
 +
|
 +
<btn>
 +
Target|''Italic Wiki Markup''
 +
</btn>
 +
|-
 +
|
 +
<pre>
 +
''<btn>
 +
Surrounding Italic Wiki Markup
 +
</btn>''
 +
</pre>
 +
|
 +
''<btn>
 +
Surrounding Italic Wiki Markup
 +
</btn>''
 +
|}
 +
 +
== Icons ==
 +
 +
{| class="table table-bordered"
 +
! Markup !! Result
 +
|-
 +
|
 +
<pre>
 +
<btn>
 +
Target|<span class="fa fa-cog"></span> icon with span
 +
</btn>
 +
</pre>
 +
|
 +
<btn>
 +
Target|<span class="fa fa-cog"></span> icon with span
 +
</btn>
 +
|-
 +
|
 +
<pre>
 +
<btn icon="cog">
 +
icon attribute
 +
</btn>
 +
</pre>
 +
|
 +
<btn icon="cog">
 +
icon attribute
 +
</btn>
 +
|}
 +
 +
== Parsing ==
 +
{| class="table table-bordered"
 +
! Markup !! Result
 +
|-
 +
|
 +
<pre>
 +
<btn>
 +
{{fullurl:{{PAGENAME}}}}|{{ucfirst:magic words}}
 +
</btn>
 +
</pre>
 +
|
 +
<btn>
 +
{{fullurl:{{PAGENAME}}}}|{{ucfirst:magic words}}
 +
</btn>
 +
|-
 +
|
 +
<pre>
 +
<btn>
 +
mainpage
 +
</btn>
 +
</pre>
 +
<small><b>Info</b>: if a system message by that name exists, the text will be replaced by it's content</small>
 +
|
 +
<btn>
 +
mainpage
 +
</btn>
 +
|-
 +
|
 +
<pre>
 +
<btn>
 +
&&shy;shy;mainpage
 +
</btn>
 +
</pre>
 +
<small><b>Info</b>: you can avoid this behaviour by adding an HTML entity that doesn't consume screen space like <code>&amp;shy;</code>. It will be invisible in the title and filtered out for the URL.<br>Alternatively, create a new message and use that.</small>
 +
|
 +
<btn>
 +
&shy;mainpage
 
</btn>
 
</btn>
 
|}
 
|}

Latest revision as of 12:04, 30 December 2021

With Tweeki it is very easy to create any button you would like to have. By using smart defaults the markup can be very reduced.

Standard Buttons

Markup Result
<btn>Simple Button</btn>
<btn size="lg">Large Button</btn>
<btn size="sm">Small Button</btn>
<btn>
Grouped
Buttons
</btn>
<btn>
Button

Tool
Bar
</btn>
<btn class="btn-primary">
Classy
Buttons
</btn>
<btn class="">
Button without any class
</btn>
<btn>
Classy||btn-primary
Non-classy
Very Classy||btn-success
</btn>
<btn>
Standard Button
Some Page Title|Internal Target
http://some.where|External Target
</btn>

Dropdown Buttons

Markup Result
<btn>
Dropdown-Menu
* Some Menu Item
*
*: Some Heading
* Some Other Menu Item
</btn>
<btn>
Target|Split Dropdown
* Some Menu Item
</btn>
<btn class="">
Non-Button Dropdown
* Some Menu Item
</btn>
<btn>
Semantic Dropdown
* {{#ask:[[Category:Components]]}}
</btn>

Note: this only works with the Semantic MediaWiki extension installed.

Wrappers

Markup Result
<btn wrapperclass="btn-group dropup">
Dropup
* Some Menu Item
</btn>
<btn wrapperclass="btn-group-vertical">
Explicit
Wrapper
Setting
</btn>
<btn wrapper="">
Explicit
Wrapper
Unsetting
</btn>

ExplicitWrapperUnsetting

Styling

Markup Result
<btn>
Target|<i>Italic Tag</i>
</btn>
<btn>
Target|''Italic Wiki Markup''
</btn>
''<btn>
Surrounding Italic Wiki Markup
</btn>''

Icons

Markup Result
<btn>
Target|<span class="fa fa-cog"></span> icon with span
</btn>
<btn icon="cog">
icon attribute
</btn>

Parsing

Markup Result
<btn>
{{fullurl:{{PAGENAME}}}}|{{ucfirst:magic words}}
</btn>
<btn>
mainpage
</btn>

Info: if a system message by that name exists, the text will be replaced by it's content

<btn>
&­shy;mainpage
</btn>

Info: you can avoid this behaviour by adding an HTML entity that doesn't consume screen space like &shy;. It will be invisible in the title and filtered out for the URL.
Alternatively, create a new message and use that.

Specifications

The general structure for the code of a single button is target|text|class, where text and class are optional. If text is omitted it is assumed to be the same as target. target and text are parsed after the following algorithm.

  1. Check for semantic queries.
  2. If there is an existing or default interface message with that name, use the content of that message instead.
  3. Parse it.
  4. If it is a valid URL (beginning with http:// or other URL protocol), the link will point to that URL.
  5. Else, it will be treated as a wikilink.