3.0 KiB
title, menu, description, bootstrap-link
| title | menu | description | bootstrap-link |
|---|---|---|---|
| Badges | docs.badges | Badges are small count and labeling components, which are used to add extra information to an interface element. You can use them to draw users' attention to a new element, notify about unread messages or provide any kind of additional info. | components/badge/ |
Default markup
The default badges are square and come in the basic set of colours.
{% capture code %} {% for color in site.colors %} {{ color[0] }} {% endfor %} {% endcapture %} {% include example.html code=code centered=true %}
Pill badges
Use the .bagde-pill class if you want to create a badge with rounded corners. Its width will adjust to the label text.
{% capture code %} {% for color in site.colors %} {{ forloop.index }} {% endfor %} {% endcapture %} {% include example.html code=code centered=true %}
Soft colour badges
You can create a soft colour variant of a corresponding contextual badge variation, to make it look more subtle. Click [here]({% docs_url colors %}) to see the list of available colours and choose ones that best suit your design.
{% capture code %} {% for color in site.colors %} {{ color[0] }} {% endfor %} {% endcapture %} {% include example.html code=code centered=true %}
Links
Place the badge within an <a> element if you want it to perform the function of a link and make it clickable.
{% capture code %} {% for color in site.colors %} {{ color[0] }} {% endfor %} {% endcapture %} {% include example.html code=code centered=true %}
Empty badges
Leave the HTML element empty if you want to create badges without any text. Empty badges are particularly useful if you want to make an interface element more noticeable regardless of limited space.
{% capture code %} {% for color in site.colors %} {% endfor %} {% endcapture %} {% include example.html code=code centered=true %}
Badge add-ons
Add the .badge-addon class to create an add-on that will customise your badge and make it more noticeable. You can use any colour variants and combine them as you see fit.
{% capture code %} {% include ui/badge.html text="task" color="green" addon="finished" %} {% include ui/badge.html text="bundle" color="purple" addon="passing" %} {% include ui/badge.html text="CSS gzip size" color="red-lt" addon="20.9kB" addon-color="red" %} {% endcapture %} {% include example.html code=code %}
Badge avatars
Create the .badge-avatar class to add an avatar that will make a badge more personalised.
{% capture code %} {% include ui/badge.html person-id=1 color="blue" %} {% include ui/badge.html person-id=2 color="blue" %} {% include ui/badge.html person-id=3 color="blue" %} {% include ui/badge.html person-id=4 color="blue" %} {% include ui/badge.html person-id=5 color="blue" %} {% endcapture %} {% include example.html code=code %}