mirror of
https://github.com/tabler/tabler.git
synced 2025-12-21 17:34:25 +04:00
Add button to docs, font awesome icons, new & updated variables
This commit is contained in:
42
_config.yml
42
_config.yml
@@ -108,7 +108,47 @@ variants:
|
|||||||
- name: danger
|
- name: danger
|
||||||
icon: x-octagon
|
icon: x-octagon
|
||||||
|
|
||||||
socials: [facebook, twitter, google, youtube, vimeo, dribbble, github, instagram, pinterest, vk, rss, flickr, bitbucket]
|
button_variants:
|
||||||
|
- name: primary
|
||||||
|
title: Primary
|
||||||
|
- name: secondary
|
||||||
|
title: Secondary
|
||||||
|
- name: success
|
||||||
|
title: Success
|
||||||
|
- name: info
|
||||||
|
title: Info
|
||||||
|
- name: warning
|
||||||
|
title: Warning
|
||||||
|
- name: danger
|
||||||
|
title: Danger
|
||||||
|
|
||||||
|
socials:
|
||||||
|
- name: facebook
|
||||||
|
title: Facebook
|
||||||
|
- name: twitter
|
||||||
|
title: Twitter
|
||||||
|
- name: google
|
||||||
|
title: Google
|
||||||
|
- name: youtube
|
||||||
|
title: Youtube
|
||||||
|
- name: vimeo
|
||||||
|
title: Vimeo
|
||||||
|
- name: dribbble
|
||||||
|
title: Dribbble
|
||||||
|
- name: github
|
||||||
|
title: Github
|
||||||
|
- name: instagram
|
||||||
|
title: Instagram
|
||||||
|
- name: pinterest
|
||||||
|
title: Pinterest
|
||||||
|
- name: vk
|
||||||
|
title: Vk
|
||||||
|
- name: rss
|
||||||
|
title: Rss
|
||||||
|
- name: flickr
|
||||||
|
title: Flickr
|
||||||
|
- name: bitbucket
|
||||||
|
title: Bitbucker
|
||||||
|
|
||||||
months_short: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
|
months_short: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
|
||||||
months_long: ['January', 'Febuary', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
|
months_long: ['January', 'Febuary', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
|
||||||
|
|||||||
@@ -1,14 +1,248 @@
|
|||||||
---
|
---
|
||||||
title: Buttons
|
title: Buttons
|
||||||
menu: docs.buttons
|
icon: fe fe-plus-square
|
||||||
|
description: Use Bootstrap’s custom button styles for actions in forms, dialogs, and more. Includes support for a handful of contextual variations, sizes, states, and more.
|
||||||
---
|
---
|
||||||
|
|
||||||
## Default markup
|
|
||||||
|
### Button tag
|
||||||
|
|
||||||
|
The `.btn` classes are designed to be used with the `<button>` element. However, you can also use these classes on `<a>` or `<input>` elements (though some browsers may apply a slightly different rendering).
|
||||||
|
|
||||||
{% example html wrapper=btn-list %}
|
{% example html wrapper=btn-list %}
|
||||||
{% include ui/button.html color="primary" text="Button" %}
|
<a href="#" class="btn btn-primary" role="button">Link</a>
|
||||||
{% include ui/button.html color="secondary" text="Button" %}
|
<button class="btn btn-primary">Button</button>
|
||||||
{% include ui/button.html color="danger" text="Button" %}
|
<input type="button" class="btn btn-primary" value="Input" />
|
||||||
{% include ui/button.html color="warning" text="Button" %}
|
<input type="submit" class="btn btn-primary" value="Submit" />
|
||||||
{% include ui/button.html color="success" text="Button" %}
|
<input type="reset" class="btn btn-primary" value="Reset" />
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Button variations
|
||||||
|
|
||||||
|
Use any of the available button classes to quickly create a styled button . We provide a variety of colors for you to express different emotions.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.button_variants %}
|
||||||
|
<a href="#" class="btn btn-{{ button.name }}">{{ button.title }}</a>
|
||||||
|
{% endfor %}
|
||||||
|
<a href="#" class="btn btn-link">Link</a>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Disabled buttons
|
||||||
|
|
||||||
|
Make buttons look inactive by adding the disabled boolean attribute to any `.btn` element. `<a>`s don’t support the disabled attribute, so you must add the `.disabled` class to make it visually appear disabled.
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.button_variants %}
|
||||||
|
{% include ui/button.html color=button.name text=button.title disabled="true" %}
|
||||||
|
{% endfor %}
|
||||||
|
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
|
||||||
|
### Color variations
|
||||||
|
|
||||||
|
The classic button, in different colors.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.colors %}
|
||||||
|
<a href="#" class="btn btn-{{ button[0] }}">{{ button[1].name }}</a>
|
||||||
|
{% endfor %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Square buttons
|
||||||
|
|
||||||
|
Add `.btn-square` to button to remove border-radius.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.button_variants %}
|
||||||
|
{% include ui/button.html text=button.title color=button.name square=true %}
|
||||||
|
{% endfor %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Pill buttons
|
||||||
|
|
||||||
|
Add `.btn-pill` class to any button to make them more rounded.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.button_variants %}
|
||||||
|
{% include ui/button.html text=button.title color=button.name pill=true %}
|
||||||
|
{% endfor %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Outline buttons
|
||||||
|
|
||||||
|
In need of a button, but not the hefty background colors they bring? Replace the default modifier classes with the `.btn-outline-*` ones to remove all background images and colors on any button.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.button_variants %}
|
||||||
|
{% include ui/button.html text=button.title color=button.name outline=true %}
|
||||||
|
{% endfor %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Button size
|
||||||
|
|
||||||
|
Add `.btn-lg` or `.btn-sm` for additional sizes.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
<button type="button" class="btn btn-primary btn-lg">Large button</button>
|
||||||
|
<button type="button" class="btn btn-secondary btn-lg">Large button</button>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
<button type="button" class="btn btn-primary btn-sm">Small button</button>
|
||||||
|
<button type="button" class="btn btn-secondary btn-sm">Small button</button>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
Create block level buttons—those that span the full width of a parent—by adding `.btn-block`.
|
||||||
|
|
||||||
|
{% example html %}
|
||||||
|
<button type="button" class="btn btn-primary btn-block">Block level button</button>
|
||||||
|
<button type="button" class="btn btn-secondary btn-block">Block level button</button>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Button with icon
|
||||||
|
|
||||||
|
Basic buttons are traditional buttons with borders and background with an extra commponent like an icon. You can place it either on the left or the right which ever you want with different color opitons.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
<button type="button" class="btn btn-dark"><i class="fe fe-upload mr-2"></i>Upload</button>
|
||||||
|
<button type="button" class="btn btn-warning"><i class="fe fe-heart mr-2"></i>I like</button>
|
||||||
|
<button type="button" class="btn btn-success"><i class="fe fe-check mr-2"></i>I agree</button>
|
||||||
|
<button type="button" class="btn btn-outline-primary"><i class="fe fe-plus mr-2"></i>More</button>
|
||||||
|
<button type="button" class="btn btn-danger"><i class="fe fe-link mr-2"></i>Link</button>
|
||||||
|
<button type="button" class="btn btn-info"><i class="fe fe-message-circle mr-2"></i>Comment</button>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Social buttons
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.socials %}
|
||||||
|
{% include ui/button.html color=button.name icon=button.name text=button.title provider="fas" %}
|
||||||
|
{% endfor %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
You can use only icons.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% for button in site.socials %}
|
||||||
|
{% include ui/button.html color=button.name icon=button.name provider="fas" %}
|
||||||
|
{% endfor %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Icon buttons
|
||||||
|
|
||||||
|
Icon only button. Add `.btn-icon` class to remove unnecessary padding from button.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
<button type="button" class="btn btn-icon btn-primary"><i class="fe fe-activity"></i></button>
|
||||||
|
<button type="button" class="btn btn-icon btn-primary btn-github"><i class="fe fe-github"></i></button>
|
||||||
|
<button type="button" class="btn btn-icon btn-primary btn-success"><i class="fe fe-bell"></i></button>
|
||||||
|
<button type="button" class="btn btn-icon btn-primary btn-warning"><i class="fe fe-star"></i></button>
|
||||||
|
<button type="button" class="btn btn-icon btn-primary btn-danger"><i class="fe fe-trash"></i></button>
|
||||||
|
<button type="button" class="btn btn-icon btn-primary btn-purple"><i class="fe fe-bar-chart"></i></button>
|
||||||
|
<button type="button" class="btn btn-icon btn-primary btn-secondary"><i class="fe fe-git-merge"></i></button>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Button dropdown
|
||||||
|
|
||||||
|
Wrap the dropdown’s toggle (your button or link) and the dropdown menu within `.dropdown`, or another element that declares `position: relative;`. Dropdowns can be triggered from `<a>` or `<button>` elements to better fit your potential needs.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
<div class="dropdown">
|
||||||
|
<button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown">
|
||||||
|
<i class="fe fe-calendar"></i>
|
||||||
|
</button>
|
||||||
|
<div class="dropdown-menu">
|
||||||
|
<a class="dropdown-item" href="javascript:void(0)">Dropdown link</a>
|
||||||
|
<a class="dropdown-item" href="javascript:void(0)">Dropdown link</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="dropdown">
|
||||||
|
<button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown">
|
||||||
|
<i class="fe fe-calendar mr-2"></i>Show calendar
|
||||||
|
</button>
|
||||||
|
<div class="dropdown-menu">
|
||||||
|
<a class="dropdown-item" href="javascript:void(0)">Dropdown link</a>
|
||||||
|
<a class="dropdown-item" href="javascript:void(0)">Dropdown link</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="dropdown">
|
||||||
|
<button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown">
|
||||||
|
Show calendar
|
||||||
|
</button>
|
||||||
|
<div class="dropdown-menu">
|
||||||
|
<a class="dropdown-item" href="javascript:void(0)">Dropdown link</a>
|
||||||
|
<a class="dropdown-item" href="javascript:void(0)">Dropdown link</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### Loading button
|
||||||
|
|
||||||
|
Add `.btn-loading` to use a loading state on a button. The width of the button depends on the length of the text inside.
|
||||||
|
|
||||||
|
Since the loading spinner is implemented using the `:after` pseudo-element, it is not supported by the `<input type="submit">` element.
|
||||||
|
|
||||||
|
{% example html wrapper=btn-list %}
|
||||||
|
{% include ui/button.html spinner=true text="Button" color="primary" %}
|
||||||
|
{% include ui/button.html spinner=true text="Button" color="danger" %}
|
||||||
|
{% include ui/button.html spinner=true text="Button" color="warning" %}
|
||||||
|
{% include ui/button.html spinner=true color="success" %}
|
||||||
|
{% include ui/button.html spinner=true color="secondary" %}
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
### List of buttons
|
||||||
|
|
||||||
|
You can now create a list of buttons with the `.btn-list` container.
|
||||||
|
|
||||||
|
{% example html %}
|
||||||
|
<div class="btn-list">
|
||||||
|
<a href="#" class="btn btn-success">Save changes</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Save and continue</a>
|
||||||
|
<a href="#" class="btn btn-danger">Cancel</a>
|
||||||
|
</div>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
If the list is very long, it will automatically wrap on multiple lines, while keeping all buttons evenly spaced.
|
||||||
|
|
||||||
|
{% example html %}
|
||||||
|
<div class="btn-list">
|
||||||
|
<a href="#" class="btn btn-secondary">One</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Two</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Three</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Four</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Five</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Six</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Seven</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Eight</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Nine</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Ten</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Eleven</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Twelve</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Thirteen</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Fourteen</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Fifteen</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Sixteen</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Seventeen</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Eighteen</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Nineteen</a>
|
||||||
|
</div>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
Use the `.text-center` or the `.text-right` modifiers to alter the alignment.
|
||||||
|
|
||||||
|
{% example html %}
|
||||||
|
<div class="btn-list text-center">
|
||||||
|
<a href="#" class="btn btn-primary">Save changes</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Save and continue</a>
|
||||||
|
</div>
|
||||||
|
{% endexample %}
|
||||||
|
|
||||||
|
{% example html %}
|
||||||
|
<div class="btn-list text-right">
|
||||||
|
<a href="#" class="btn btn-primary">Save changes</a>
|
||||||
|
<a href="#" class="btn btn-secondary">Save and continue</a>
|
||||||
|
</div>
|
||||||
{% endexample %}
|
{% endexample %}
|
||||||
|
|||||||
@@ -1,4 +1,5 @@
|
|||||||
{% assign spinner-class = false %}
|
{% assign spinner-class = false %}
|
||||||
|
{% assign provider = include.provider | default: 'fe' %}
|
||||||
{% if include.text %}{% assign spinner-class="mr-2" %}{% endif %}
|
{% if include.text %}{% assign spinner-class="mr-2" %}{% endif %}
|
||||||
{% assign element = include.element | default: 'button' %}<{{ element }}{% if element == 'a' %} href="{{ include.href | default: '#' }}"{% endif %} class="btn{% if include.height %} btn-{{ include.height }}{% endif %}{% if include.color %} btn-{% if include.outline %}outline-{% endif %}{{ include.color }}{% endif %}{% if include.disabled %} disabled{% endif %}{% if include.square %} btn-square{% endif %}{% if include.pill %} btn-pill{% endif %}{% if include.class %} {{ include.class }}{% endif %}{% if include.block %} btn-block{% endif %}{% if include.link %} btn-link{% endif %}{% if include.label %} btn-label{% endif %}">{% if include.spinner %}
|
{% assign element = include.element | default: 'button' %}<{{ element }}{% if element == 'a' %} href="{{ include.href | default: '#' }}"{% endif %} class="btn{% if include.height %} btn-{{ include.height }}{% endif %}{% if include.color %} btn-{% if include.outline %}outline-{% endif %}{{ include.color }}{% endif %}{% if include.disabled %} disabled{% endif %}{% if include.square %} btn-square{% endif %}{% if include.pill %} btn-pill{% endif %}{% if include.class %} {{ include.class }}{% endif %}{% if include.block %} btn-block{% endif %}{% if include.link %} btn-link{% endif %}{% if include.label %} btn-label{% endif %}">{% if include.spinner %}
|
||||||
{% include ui/spinner.html color=false size="sm" class=spinner-class element="span" %}{% endif %}{% if include.icon %}{% include ui/icon.html icon=include.icon %}{% endif %}{% if include.label %}<span class="btn-label-icon">{% include ui/icon.html icon=include.label %}</span>{% endif %}{{ include.text }}</{{ element }}>
|
{% include ui/spinner.html color=false size="sm" class=spinner-class element="span" %}{% endif %}{% if include.icon %}{% include ui/icon.html icon=include.icon provider=provider %}{% endif %}{% if include.label %}<span class="btn-label-icon">{% include ui/icon.html icon=include.label %}</span>{% endif %}{{ include.text }}</{{ element }}>
|
||||||
|
|||||||
@@ -1 +1,2 @@
|
|||||||
<i class="icon fe fe-{{ include.icon }}{% if include.class %} {{ include.class }}{% endif %}{% if include.color %} text-{{ include.color }}{% endif %}"></i>
|
{% assign provider = include.provider | default: "fe" %}
|
||||||
|
<i class="icon {{ provider }} {{ provider }}-{{ include.icon }}{% if include.class %} {{ include.class }}{% endif %}{% if include.color %} text-{{ include.color }}{% endif %}"></i>
|
||||||
|
|||||||
@@ -5,9 +5,7 @@ $font-icons: "Feather" !default;
|
|||||||
|
|
||||||
// EXTERNAL FONTS
|
// EXTERNAL FONTS
|
||||||
$google-font-url: "https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,500,600,700&display=swap" !default;
|
$google-font-url: "https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,500,600,700&display=swap" !default;
|
||||||
$icon-fonts: (
|
$icon-fonts: () !default;
|
||||||
"https://use.fontawesome.com/releases/v5.3.1/css/brands.css"
|
|
||||||
) !default;
|
|
||||||
|
|
||||||
// COLORS
|
// COLORS
|
||||||
$full-black: rgba(0, 0, 0, 1) !default;
|
$full-black: rgba(0, 0, 0, 1) !default;
|
||||||
|
|||||||
2148
scss/fonts/font_awesome_brands.scss
Normal file
2148
scss/fonts/font_awesome_brands.scss
Normal file
File diff suppressed because it is too large
Load Diff
@@ -6,6 +6,7 @@
|
|||||||
@import "../node_modules/bootstrap/scss/bootstrap";
|
@import "../node_modules/bootstrap/scss/bootstrap";
|
||||||
|
|
||||||
@import "fonts/feather";
|
@import "fonts/feather";
|
||||||
|
@import "fonts/font_awesome_brands";
|
||||||
|
|
||||||
@import "layout/webfonts";
|
@import "layout/webfonts";
|
||||||
|
|
||||||
|
|||||||
@@ -49,6 +49,7 @@
|
|||||||
> .btn,
|
> .btn,
|
||||||
> .dropdown {
|
> .dropdown {
|
||||||
margin-bottom: .5rem;
|
margin-bottom: .5rem;
|
||||||
|
display: inline-block;
|
||||||
|
|
||||||
&:not(:last-child) {
|
&:not(:last-child) {
|
||||||
margin-right: .5rem;
|
margin-right: .5rem;
|
||||||
|
|||||||
Reference in New Issue
Block a user