@tabler/core 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/emails/index.mdx +14 -0
- package/docs/emails/introduction/compiled-html.mdx +29 -0
- package/docs/emails/introduction/contents.mdx +63 -0
- package/docs/emails/introduction/index.mdx +9 -0
- package/docs/emails/introduction/source-html.mdx +26 -0
- package/docs/icons/index.mdx +13 -0
- package/docs/icons/libraries/index.mdx +5 -0
- package/docs/icons/libraries/preact.mdx +42 -0
- package/docs/icons/libraries/react.mdx +42 -0
- package/docs/icons/libraries/solidjs.mdx +42 -0
- package/docs/icons/libraries/svelte.mdx +43 -0
- package/docs/icons/libraries/vue.mdx +50 -0
- package/docs/icons/libraries/webfont.mdx +60 -0
- package/docs/icons/plugins/figma.mdx +15 -0
- package/docs/icons/plugins/index.mdx +4 -0
- package/docs/icons/static-files/eps.mdx +15 -0
- package/docs/icons/static-files/index.mdx +5 -0
- package/docs/icons/static-files/pdf.mdx +15 -0
- package/docs/icons/static-files/png.mdx +31 -0
- package/docs/icons/static-files/svg.mdx +85 -0
- package/docs/illustrations/index.mdx +8 -0
- package/docs/illustrations/introduction/contents.mdx +77 -0
- package/docs/illustrations/introduction/customization.mdx +1198 -0
- package/docs/illustrations/introduction/index.mdx +5 -0
- package/docs/illustrations/introduction/license.mdx +90 -0
- package/docs/img/browsers/brave.svg +1 -0
- package/docs/img/browsers/chrome.svg +1 -0
- package/docs/img/browsers/edge.svg +1 -0
- package/docs/img/browsers/electron.svg +1 -0
- package/docs/img/browsers/firefox.svg +1 -0
- package/docs/img/browsers/internet-explorer.svg +1 -0
- package/docs/img/browsers/opera.svg +1 -0
- package/docs/img/browsers/safari.svg +1 -0
- package/docs/img/browsers/vivaldi.svg +1 -0
- package/docs/img/cover-illustrations-dark.png +0 -0
- package/docs/img/cover-illustrations.png +0 -0
- package/docs/img/cover-tabler-dark.png +0 -0
- package/docs/img/cover-tabler.png +0 -0
- package/docs/img/icons/figma-plugin.png +0 -0
- package/docs/img/icons/package-angular-dark.png +0 -0
- package/docs/img/icons/package-angular.png +0 -0
- package/docs/img/icons/package-eps-dark.png +0 -0
- package/docs/img/icons/package-eps.png +0 -0
- package/docs/img/icons/package-js-dark.png +0 -0
- package/docs/img/icons/package-js.png +0 -0
- package/docs/img/icons/package-pdf-dark.png +0 -0
- package/docs/img/icons/package-pdf.png +0 -0
- package/docs/img/icons/package-png-dark.png +0 -0
- package/docs/img/icons/package-png.png +0 -0
- package/docs/img/icons/package-preact-dark.png +0 -0
- package/docs/img/icons/package-preact.png +0 -0
- package/docs/img/icons/package-react-dark.png +0 -0
- package/docs/img/icons/package-react-native-dark.png +0 -0
- package/docs/img/icons/package-react-native.png +0 -0
- package/docs/img/icons/package-react.png +0 -0
- package/docs/img/icons/package-solidjs-dark.png +0 -0
- package/docs/img/icons/package-solidjs.png +0 -0
- package/docs/img/icons/package-sprite-dark.png +0 -0
- package/docs/img/icons/package-sprite.png +0 -0
- package/docs/img/icons/package-svelte-dark.png +0 -0
- package/docs/img/icons/package-svelte.png +0 -0
- package/docs/img/icons/package-svg-dark.png +0 -0
- package/docs/img/icons/package-svg.png +0 -0
- package/docs/img/icons/package-vue-dark.png +0 -0
- package/docs/img/icons/package-vue.png +0 -0
- package/docs/img/icons/package-webfont-dark.png +0 -0
- package/docs/img/icons/package-webfont.png +0 -0
- package/docs/index.mdx +16 -0
- package/docs/ui/base/colors.mdx +83 -0
- package/docs/ui/base/index.mdx +6 -0
- package/docs/ui/base/typography.mdx +311 -0
- package/docs/ui/components/alerts.mdx +406 -0
- package/docs/ui/components/autosize.mdx +25 -0
- package/docs/ui/components/avatars.mdx +227 -0
- package/docs/ui/components/badges.mdx +112 -0
- package/docs/ui/components/breadcrumb.mdx +199 -0
- package/docs/ui/components/buttons.mdx +1213 -0
- package/docs/ui/components/cards.mdx +417 -0
- package/docs/ui/components/carousel.mdx +459 -0
- package/docs/ui/components/charts.mdx +697 -0
- package/docs/ui/components/countup.mdx +165 -0
- package/docs/ui/components/datagrid.mdx +120 -0
- package/docs/ui/components/divider.mdx +68 -0
- package/docs/ui/components/dropdowns.mdx +302 -0
- package/docs/ui/components/dropzone.mdx +88 -0
- package/docs/ui/components/empty.mdx +149 -0
- package/docs/ui/components/icons.mdx +392 -0
- package/docs/ui/components/index.mdx +6 -0
- package/docs/ui/components/inline-player.mdx +58 -0
- package/docs/ui/components/modals.mdx +297 -0
- package/docs/ui/components/offcanvas.mdx +70 -0
- package/docs/ui/components/placeholder.mdx +273 -0
- package/docs/ui/components/popover.mdx +142 -0
- package/docs/ui/components/progress.mdx +241 -0
- package/docs/ui/components/range-slider.mdx +32 -0
- package/docs/ui/components/ribbons.mdx +207 -0
- package/docs/ui/components/segmented-control.mdx +401 -0
- package/docs/ui/components/spinners.mdx +135 -0
- package/docs/ui/components/statuses.mdx +322 -0
- package/docs/ui/components/steps.mdx +174 -0
- package/docs/ui/components/switch-icon.mdx +386 -0
- package/docs/ui/components/tables.mdx +397 -0
- package/docs/ui/components/tabs.mdx +396 -0
- package/docs/ui/components/timelines.mdx +697 -0
- package/docs/ui/components/tinymce.mdx +46 -0
- package/docs/ui/components/toasts.mdx +126 -0
- package/docs/ui/components/tooltips.mdx +65 -0
- package/docs/ui/components/tracking.mdx +548 -0
- package/docs/ui/components/vector-maps.mdx +166 -0
- package/docs/ui/forms/form-color-check.mdx +220 -0
- package/docs/ui/forms/form-elements.mdx +632 -0
- package/docs/ui/forms/form-fieldset.mdx +45 -0
- package/docs/ui/forms/form-helpers.mdx +91 -0
- package/docs/ui/forms/form-image-check.mdx +213 -0
- package/docs/ui/forms/form-input-mask.mdx +61 -0
- package/docs/ui/forms/form-selectboxes.mdx +398 -0
- package/docs/ui/forms/form-validation.mdx +62 -0
- package/docs/ui/forms/index.mdx +6 -0
- package/docs/ui/getting-started/browser-support.mdx +28 -0
- package/docs/ui/getting-started/customize.mdx +28 -0
- package/docs/ui/getting-started/download.mdx +44 -0
- package/docs/ui/getting-started/faq.mdx +30 -0
- package/docs/ui/getting-started/how-to-contribute.mdx +84 -0
- package/docs/ui/getting-started/index.mdx +16 -0
- package/docs/ui/getting-started/installation.mdx +67 -0
- package/docs/ui/getting-started/license.mdx +30 -0
- package/docs/ui/index.mdx +8 -0
- package/docs/ui/layout/index.mdx +6 -0
- package/docs/ui/layout/navbars.mdx +164 -0
- package/docs/ui/layout/navs-tabls.mdx +201 -0
- package/docs/ui/layout/page-headers.mdx +365 -0
- package/docs/ui/layout/page-layouts.mdx +213 -0
- package/docs/ui/plugins/flags.mdx +316 -0
- package/docs/ui/plugins/index.mdx +6 -0
- package/docs/ui/plugins/payments.mdx +152 -0
- package/docs/ui/plugins/social-icons.mdx +135 -0
- package/docs/ui/utilities/borders.mdx +260 -0
- package/docs/ui/utilities/cursors.mdx +63 -0
- package/docs/ui/utilities/index.mdx +5 -0
- package/docs/ui/utilities/interactions.mdx +26 -0
- package/docs/ui/utilities/margins.mdx +234 -0
- package/docs/ui/utilities/vertical-align.mdx +66 -0
- package/docs/ui/utilities/visually-hidden.mdx +12 -0
- package/package.json +6 -6
- package/LICENSE +0 -21
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: How to Contribute
|
|
3
|
+
summary: This guide explains how to contribute to Tabler, from setting up a development environment to making and testing changes. It covers essential steps like forking the repository, installing dependencies, and submitting a pull request to help improve Tabler's features and functionality.
|
|
4
|
+
description: Guide to contributing to Tabler and setting up for development.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Contributions are always welcome and highly encouraged! Whether you're new to open source or a seasoned contributor, your input helps make Tabler better for everyone. If you're new to open source, [start here](https://opensource.guide/how-to-contribute/) to learn more about contributing.
|
|
8
|
+
|
|
9
|
+
## Contribution Requirements
|
|
10
|
+
|
|
11
|
+
When contributing to Tabler, please adhere to the following guidelines:
|
|
12
|
+
|
|
13
|
+
1. By submitting a contribution, you grant a non-exclusive license to the Tabler project to use your contribution in any context deemed appropriate.
|
|
14
|
+
2. If your contribution includes content from other sources, it must be appropriately licensed under an open source license.
|
|
15
|
+
3. Contributions must be submitted via GitHub pull requests.
|
|
16
|
+
4. Ensure your code works in all supported browsers (refer to our [browser support documentation](/docs/ui/getting-started/browser-support)).
|
|
17
|
+
|
|
18
|
+
## Installation
|
|
19
|
+
|
|
20
|
+
Follow these steps to set up Tabler for development:
|
|
21
|
+
|
|
22
|
+
1. Fork the repository: [Guide to forking](https://docs.github.com/en/get-started/quickstart/fork-a-repo).
|
|
23
|
+
|
|
24
|
+
2. Clone the repository to your local machine:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
git clone https://github.com/YOUR_USERNAME/tabler.git
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
3. Create a new branch for your changes:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
git checkout -b your-branch-name
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Development
|
|
37
|
+
|
|
38
|
+
To set up Tabler for development, follow these steps:
|
|
39
|
+
|
|
40
|
+
<div className="steps">
|
|
41
|
+
|
|
42
|
+
### Ensure Node.js and npm are installed
|
|
43
|
+
|
|
44
|
+
You’ll need Node.js (v20 or higher) and pnpm to compile Tabler’s files. If you don’t have them installed, download and install them from the official websites:
|
|
45
|
+
|
|
46
|
+
- [Node.js](https://nodejs.org/)
|
|
47
|
+
- [pnpm](https://pnpm.io/)
|
|
48
|
+
|
|
49
|
+
### Install dependencies
|
|
50
|
+
|
|
51
|
+
Run the following command to install all required npm packages. We recommend using pnpm for faster installation:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
pnpm install
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Start developer mode
|
|
58
|
+
|
|
59
|
+
Use the following command to enable autocompilation with live reload. This will start a local server at `http://localhost:3000/`:
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
pnpm run dev
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Make changes
|
|
66
|
+
|
|
67
|
+
Make your changes in the appropriate folders, such as `./src/` or `./docs/`. Avoid modifying files in `./dist/`, as they are auto-generated during the build process and will be overwritten.
|
|
68
|
+
</div>
|
|
69
|
+
|
|
70
|
+
## Compiling for Production
|
|
71
|
+
|
|
72
|
+
Before submitting a pull request, ensure your changes are properly compiled and tested:
|
|
73
|
+
|
|
74
|
+
1. Compile the production files
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
pnpm run build
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
2. Test all pages to confirm everything works as expected.
|
|
81
|
+
|
|
82
|
+
## Submitting Your Contribution
|
|
83
|
+
|
|
84
|
+
Once your changes are ready, create a pull request (PR) on GitHub. Make sure to include a clear and concise description of the changes and their purpose. Thank you for contributing to Tabler!
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Introduction
|
|
3
|
+
summary: Free and open-source HTML Dashboard UI Kit built on Bootstrap
|
|
4
|
+
order: 1
|
|
5
|
+
description: Overview of Tabler UI Kit.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## What is Tabler?
|
|
9
|
+
|
|
10
|
+
Tabler is fully responsive and compatible with all modern browsers. Thanks to its modern and user-friendly design you can create a fully functional interface that users will love! Choose the layouts and components you need and customize them to make your design consistent and eye-catching. Every component has been created with attention to detail to make your interface beautiful!
|
|
11
|
+
|
|
12
|
+
## What are the benefits?
|
|
13
|
+
|
|
14
|
+
Tabler is a perfect solution if you want to create an interface which is not only user-friendly but also fully responsive. Thanks to the big choice of ready-made components, you can customize your design and adapt it to the needs of even the most demanding users. On top of that, Tabler is an open source solution, continuously developed and improved by the open source community.
|
|
15
|
+
|
|
16
|
+
<img src="https://raw.githubusercontent.com/tabler/tabler/dev/preview/static/tabler-preview.png?2" src-dark="https://raw.githubusercontent.com/tabler/tabler/dev/preview/static/tabler-preview-dark.png?2" alt="Screencap of tabler site showing global traffic and statistics" />
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Installation
|
|
3
|
+
order: 1
|
|
4
|
+
summary: Learn how to set up Tabler in your project by creating a basic HTML file, adding Tabler’s CSS and JavaScript, and exploring its powerful components to build responsive and visually stunning web applications.
|
|
5
|
+
description: "Set up Tabler: HTML, CSS, JS, and build stunning UIs."
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
This guide will take you through the essential steps to set up Tabler in your project, from creating a basic HTML file to incorporating Tabler’s styles and scripts. Let’s dive in!
|
|
9
|
+
|
|
10
|
+
<div className="steps">
|
|
11
|
+
|
|
12
|
+
### Step 1: Create a Basic HTML File
|
|
13
|
+
|
|
14
|
+
Begin by creating a new `index.html` file in the root of your project. This file will serve as the foundation for your Tabler-based interface. Include the basic HTML structure and a `<meta name="viewport">` tag for proper responsiveness:
|
|
15
|
+
|
|
16
|
+
```html
|
|
17
|
+
<!doctype html>
|
|
18
|
+
<html lang="en">
|
|
19
|
+
<head>
|
|
20
|
+
<meta charset="utf-8" />
|
|
21
|
+
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
22
|
+
<title>Tabler demo</title>
|
|
23
|
+
</head>
|
|
24
|
+
<body>
|
|
25
|
+
<h1>Hello, world!</h1>
|
|
26
|
+
</body>
|
|
27
|
+
</html>
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Step 2: Add Tabler CSS and JavaScript
|
|
31
|
+
|
|
32
|
+
Enhance your page by including Tabler's CSS and JavaScript files. Use the following links to load the core Tabler styles and scripts from the CDN:
|
|
33
|
+
|
|
34
|
+
```html
|
|
35
|
+
<link rel="stylesheet" href="$TABLER_CDN/dist/css/tabler.min.css" />
|
|
36
|
+
<script src="$TABLER_CDN/dist/js/tabler.min.js"></script>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Update your HTML file to include these resources:
|
|
40
|
+
|
|
41
|
+
```html
|
|
42
|
+
<!doctype html>
|
|
43
|
+
<html lang="en">
|
|
44
|
+
<head>
|
|
45
|
+
<meta charset="utf-8" />
|
|
46
|
+
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
47
|
+
<title>Tabler Demo</title>
|
|
48
|
+
<link rel="stylesheet" href="$TABLER_CDN/dist/css/tabler.min.css" />
|
|
49
|
+
</head>
|
|
50
|
+
<body>
|
|
51
|
+
<h1>Hello, Tabler!</h1>
|
|
52
|
+
<script src="$TABLER_CDN/dist/js/tabler.min.js"></script>
|
|
53
|
+
</body>
|
|
54
|
+
</html>
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
This setup includes the Tabler CSS and JavaScript via a CDN, providing a responsive and functional base for your project.
|
|
58
|
+
|
|
59
|
+
You can also download the files and include them locally in your project. For more information, see the [Download](/docs/ui/getting-started/download) page.
|
|
60
|
+
|
|
61
|
+
### 3. Open in Your Browser
|
|
62
|
+
|
|
63
|
+
Save the file and open it in your browser. You should see your first Tabler-powered page! From here, you can start adding layouts and components to create a fully functional and visually appealing web application.
|
|
64
|
+
|
|
65
|
+
</div>
|
|
66
|
+
|
|
67
|
+
With these simple steps, you're ready to explore Tabler's features and build stunning web interfaces. For inspiration and guidance, you can view live demos at [preview.tabler.io](https://preview.tabler.io) and consult our [official documentation](https://tabler.io/docs) for detailed instructions and examples.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Tabler License
|
|
3
|
+
summary: The MIT license grants you the flexibility to use Tabler in commercial or personal projects, modify its code, and distribute it freely. Ensure you include the required license and copyright notices to stay compliant with the terms.
|
|
4
|
+
description: "Tabler's MIT license: freedom to use, modify, and share."
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Tabler is an open-source project licensed under the **MIT license**, giving you extensive freedom to use, modify, and distribute the software. This license ensures that you can adapt Tabler to your needs while maintaining the required attributions. While attribution is not required, it is greatly appreciated to acknowledge the hard work of the developers.
|
|
8
|
+
|
|
9
|
+
## What You Can Do with Tabler
|
|
10
|
+
|
|
11
|
+
The MIT license allows you to:
|
|
12
|
+
- Use Tabler in **commercial projects**.
|
|
13
|
+
- Use Tabler in **personal or private projects**.
|
|
14
|
+
- **Modify and customize** the source code to fit your requirements.
|
|
15
|
+
- **Distribute** the original or modified code.
|
|
16
|
+
- **Sublicense**: Integrate Tabler into projects with a more restrictive license.
|
|
17
|
+
|
|
18
|
+
## What You Cannot Do with Tabler
|
|
19
|
+
|
|
20
|
+
- The software is provided **“as is”**, meaning you cannot hold the authors or contributors liable for any issues, bugs, or damages that may arise from its use.
|
|
21
|
+
|
|
22
|
+
## What You Must Do When Using Tabler
|
|
23
|
+
|
|
24
|
+
When using Tabler, you must:
|
|
25
|
+
1. Include the **license notice** in all copies of the work.
|
|
26
|
+
2. Include the **copyright notice** in all copies of the work, except for the footer of the example HTML pages provided in the repository.
|
|
27
|
+
|
|
28
|
+
For more details, please refer to the full [Tabler License](https://github.com/tabler/tabler/blob/main/LICENSE).
|
|
29
|
+
|
|
30
|
+
By adhering to these requirements, you help ensure the continued openness and usability of Tabler for everyone. Thank you for supporting open-source software!
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Tabler UI
|
|
3
|
+
order: 1
|
|
4
|
+
description: Free and open source web application UI kit based on Bootstrap
|
|
5
|
+
summary: Tabler UI is a carefully crafted collection of modern and responsive user interface components. Built on top of Bootstrap, it helps developers create stunning and functional web applications quickly and efficiently.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+

|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Navbars
|
|
3
|
+
summary: A navbar serves as a central navigation tool, offering users quick and easy access to key sections of a website or application, improving usability and enhancing the overall user experience.
|
|
4
|
+
description: Create and customize responsive navigation bars with ease.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
The navbar is a core component of any website or application, serving as the primary navigation tool. It provides users with quick access to key sections, enhancing usability and improving the overall user experience. Positioned typically at the top of the page, the navbar can contain links, buttons, branding elements, and even interactive components like dropdown menus or search bars.
|
|
8
|
+
|
|
9
|
+
With Tabler's utility classes, creating and customizing a responsive navbar is straightforward. Whether you’re building a simple site or a complex dashboard, Tabler’s navbar utilities offer the flexibility to design navigation that aligns perfectly with your project’s requirements.
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
## Sample navbar
|
|
14
|
+
|
|
15
|
+
To create a navbar, use the `.navbar` class. The navbar is a horizontal bar that contains links to different sections of a website. It is typically placed at the top of the page and is used to provide navigation to the rest of the site.
|
|
16
|
+
|
|
17
|
+
```html
|
|
18
|
+
<header class="navbar navbar-expand-md d-print-none">...</header>
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
The navbar can contain links, buttons, and other elements. You can customize the appearance of the navbar by adding classes to the elements inside it.
|
|
22
|
+
|
|
23
|
+
```html example fullpage vcentered padding={0} height="20rem"
|
|
24
|
+
<header class="navbar navbar-expand-md d-print-none">
|
|
25
|
+
<div class="container-xl">
|
|
26
|
+
<button
|
|
27
|
+
class="navbar-toggler"
|
|
28
|
+
type="button"
|
|
29
|
+
data-bs-toggle="collapse"
|
|
30
|
+
data-bs-target="#navbar-menu"
|
|
31
|
+
aria-controls="navbar-menu"
|
|
32
|
+
aria-expanded="false"
|
|
33
|
+
aria-label="Toggle navigation"
|
|
34
|
+
>
|
|
35
|
+
<span class="navbar-toggler-icon"></span>
|
|
36
|
+
</button>
|
|
37
|
+
<div class="navbar-brand navbar-brand-autodark d-none-navbar-horizontal pe-0 pe-md-3">
|
|
38
|
+
<a href="javascript:void(0)">
|
|
39
|
+
<svg
|
|
40
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
41
|
+
width="110"
|
|
42
|
+
height="32"
|
|
43
|
+
viewBox="0 0 232 68"
|
|
44
|
+
class="navbar-brand-image"
|
|
45
|
+
>
|
|
46
|
+
<path
|
|
47
|
+
d="M64.6 16.2C63 9.9 58.1 5 51.8 3.4 40 1.5 28 1.5 16.2 3.4 9.9 5 5 9.9 3.4 16.2 1.5 28 1.5 40 3.4 51.8 5 58.1 9.9 63 16.2 64.6c11.8 1.9 23.8 1.9 35.6 0C58.1 63 63 58.1 64.6 51.8c1.9-11.8 1.9-23.8 0-35.6zM33.3 36.3c-2.8 4.4-6.6 8.2-11.1 11-1.5.9-3.3.9-4.8.1s-2.4-2.3-2.5-4c0-1.7.9-3.3 2.4-4.1 2.3-1.4 4.4-3.2 6.1-5.3-1.8-2.1-3.8-3.8-6.1-5.3-2.3-1.3-3-4.2-1.7-6.4s4.3-2.9 6.5-1.6c4.5 2.8 8.2 6.5 11.1 10.9 1 1.4 1 3.3.1 4.7zM49.2 46H37.8c-2.1 0-3.8-1-3.8-3s1.7-3 3.8-3h11.4c2.1 0 3.8 1 3.8 3s-1.7 3-3.8 3z"
|
|
48
|
+
fill="#066fd1"
|
|
49
|
+
style="fill: var(--tblr-primary, #066fd1)"
|
|
50
|
+
></path>
|
|
51
|
+
<path
|
|
52
|
+
d="M105.8 46.1c.4 0 .9.2 1.2.6s.6 1 .6 1.7c0 .9-.5 1.6-1.4 2.2s-2 .9-3.2.9c-2 0-3.7-.4-5-1.3s-2-2.6-2-5.4V31.6h-2.2c-.8 0-1.4-.3-1.9-.8s-.9-1.1-.9-1.9c0-.7.3-1.4.8-1.8s1.2-.7 1.9-.7h2.2v-3.1c0-.8.3-1.5.8-2.1s1.3-.8 2.1-.8 1.5.3 2 .8.8 1.3.8 2.1v3.1h3.4c.8 0 1.4.3 1.9.8s.8 1.2.8 1.9-.3 1.4-.8 1.8-1.2.7-1.9.7h-3.4v13c0 .7.2 1.2.5 1.5s.8.5 1.4.5c.3 0 .6-.1 1.1-.2.5-.2.8-.3 1.2-.3zm28-20.7c.8 0 1.5.3 2.1.8.5.5.8 1.2.8 2.1v20.3c0 .8-.3 1.5-.8 2.1-.5.6-1.2.8-2.1.8s-1.5-.3-2-.8-.8-1.2-.8-2.1c-.8.9-1.9 1.7-3.2 2.4-1.3.7-2.8 1-4.3 1-2.2 0-4.2-.6-6-1.7-1.8-1.1-3.2-2.7-4.2-4.7s-1.6-4.3-1.6-6.9c0-2.6.5-4.9 1.5-6.9s2.4-3.6 4.2-4.8c1.8-1.1 3.7-1.7 5.9-1.7 1.5 0 3 .3 4.3.8 1.3.6 2.5 1.3 3.4 2.1 0-.8.3-1.5.8-2.1.5-.5 1.2-.7 2-.7zm-9.7 21.3c2.1 0 3.8-.8 5.1-2.3s2-3.4 2-5.7-.7-4.2-2-5.8c-1.3-1.5-3-2.3-5.1-2.3-2 0-3.7.8-5 2.3-1.3 1.5-2 3.5-2 5.8s.6 4.2 1.9 5.7 3 2.3 5.1 2.3zm32.1-21.3c2.2 0 4.2.6 6 1.7 1.8 1.1 3.2 2.7 4.2 4.7s1.6 4.3 1.6 6.9-.5 4.9-1.5 6.9-2.4 3.6-4.2 4.8c-1.8 1.1-3.7 1.7-5.9 1.7-1.5 0-3-.3-4.3-.9s-2.5-1.4-3.4-2.3v.3c0 .8-.3 1.5-.8 2.1-.5.6-1.2.8-2.1.8s-1.5-.3-2.1-.8c-.5-.5-.8-1.2-.8-2.1V18.9c0-.8.3-1.5.8-2.1.5-.6 1.2-.8 2.1-.8s1.5.3 2.1.8c.5.6.8 1.3.8 2.1v10c.8-1 1.8-1.8 3.2-2.5 1.3-.7 2.8-1 4.3-1zm-.7 21.3c2 0 3.7-.8 5-2.3s2-3.5 2-5.8-.6-4.2-1.9-5.7-3-2.3-5.1-2.3-3.8.8-5.1 2.3-2 3.4-2 5.7.7 4.2 2 5.8c1.3 1.6 3 2.3 5.1 2.3zm23.6 1.9c0 .8-.3 1.5-.8 2.1s-1.3.8-2.1.8-1.5-.3-2-.8-.8-1.3-.8-2.1V18.9c0-.8.3-1.5.8-2.1s1.3-.8 2.1-.8 1.5.3 2 .8.8 1.3.8 2.1v29.7zm29.3-10.5c0 .8-.3 1.4-.9 1.9-.6.5-1.2.7-2 .7h-15.8c.4 1.9 1.3 3.4 2.6 4.4 1.4 1.1 2.9 1.6 4.7 1.6 1.3 0 2.3-.1 3.1-.4.7-.2 1.3-.5 1.8-.8.4-.3.7-.5.9-.6.6-.3 1.1-.4 1.6-.4.7 0 1.2.2 1.7.7s.7 1 .7 1.7c0 .9-.4 1.6-1.3 2.4-.9.7-2.1 1.4-3.6 1.9s-3 .8-4.6.8c-2.7 0-5-.6-7-1.7s-3.5-2.7-4.6-4.6-1.6-4.2-1.6-6.6c0-2.8.6-5.2 1.7-7.2s2.7-3.7 4.6-4.8 3.9-1.7 6-1.7 4.1.6 6 1.7 3.4 2.7 4.5 4.7c.9 1.9 1.5 4.1 1.5 6.3zm-12.2-7.5c-3.7 0-5.9 1.7-6.6 5.2h12.6v-.3c-.1-1.3-.8-2.5-2-3.5s-2.5-1.4-4-1.4zm30.3-5.2c1 0 1.8.3 2.4.8.7.5 1 1.2 1 1.9 0 1-.3 1.7-.8 2.2-.5.5-1.1.8-1.8.7-.5 0-1-.1-1.6-.3-.2-.1-.4-.1-.6-.2-.4-.1-.7-.1-1.1-.1-.8 0-1.6.3-2.4.8s-1.4 1.3-1.9 2.3-.7 2.3-.7 3.7v11.4c0 .8-.3 1.5-.8 2.1-.5.6-1.2.8-2.1.8s-1.5-.3-2.1-.8c-.5-.6-.8-1.3-.8-2.1V28.8c0-.8.3-1.5.8-2.1.5-.6 1.2-.8 2.1-.8s1.5.3 2.1.8c.5.6.8 1.3.8 2.1v.6c.7-1.3 1.8-2.3 3.2-3 1.3-.7 2.8-1 4.3-1z"
|
|
53
|
+
fill-rule="evenodd"
|
|
54
|
+
clip-rule="evenodd"
|
|
55
|
+
fill="#4a4a4a"
|
|
56
|
+
></path>
|
|
57
|
+
</svg>
|
|
58
|
+
</a>
|
|
59
|
+
</div>
|
|
60
|
+
<ul class="navbar-nav">
|
|
61
|
+
<li class="nav-item active">
|
|
62
|
+
<a class="nav-link" href="javascript:void(0)">
|
|
63
|
+
<span class="nav-link-icon">
|
|
64
|
+
<!-- Download SVG icon from http://tabler.io/icons/icon/home -->
|
|
65
|
+
<svg
|
|
66
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
67
|
+
width="24"
|
|
68
|
+
height="24"
|
|
69
|
+
viewBox="0 0 24 24"
|
|
70
|
+
fill="none"
|
|
71
|
+
stroke="currentColor"
|
|
72
|
+
stroke-width="2"
|
|
73
|
+
stroke-linecap="round"
|
|
74
|
+
stroke-linejoin="round"
|
|
75
|
+
class="icon icon-tabler icons-tabler-outline icon-tabler-home"
|
|
76
|
+
>
|
|
77
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
78
|
+
<path d="M5 12l-2 0l9 -9l9 9l-2 0" />
|
|
79
|
+
<path d="M5 12v7a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-7" />
|
|
80
|
+
<path d="M9 21v-6a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v6" />
|
|
81
|
+
</svg>
|
|
82
|
+
</span>
|
|
83
|
+
<span class="nav-link-title"> Home </span>
|
|
84
|
+
</a>
|
|
85
|
+
</li>
|
|
86
|
+
<li class="nav-item">
|
|
87
|
+
<a class="nav-link" href="javascript:void(0)">
|
|
88
|
+
<span class="nav-link-icon"
|
|
89
|
+
><!-- Download SVG icon from http://tabler.io/icons/icon/checkbox -->
|
|
90
|
+
<svg
|
|
91
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
92
|
+
width="24"
|
|
93
|
+
height="24"
|
|
94
|
+
viewBox="0 0 24 24"
|
|
95
|
+
fill="none"
|
|
96
|
+
stroke="currentColor"
|
|
97
|
+
stroke-width="2"
|
|
98
|
+
stroke-linecap="round"
|
|
99
|
+
stroke-linejoin="round"
|
|
100
|
+
class="icon icon-tabler icons-tabler-outline icon-tabler-user"
|
|
101
|
+
>
|
|
102
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
103
|
+
<path d="M8 7a4 4 0 1 0 8 0a4 4 0 0 0 -8 0" />
|
|
104
|
+
<path d="M6 21v-2a4 4 0 0 1 4 -4h4a4 4 0 0 1 4 4v2" />
|
|
105
|
+
</svg>
|
|
106
|
+
</span>
|
|
107
|
+
<span class="nav-link-title"> Profile </span>
|
|
108
|
+
</a>
|
|
109
|
+
</li>
|
|
110
|
+
<li class="nav-item">
|
|
111
|
+
<a class="nav-link" href="javascript:void(0)">
|
|
112
|
+
<span class="nav-link-icon"
|
|
113
|
+
><!-- Download SVG icon from http://tabler.io/icons/icon/checkbox -->
|
|
114
|
+
<svg
|
|
115
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
116
|
+
width="24"
|
|
117
|
+
height="24"
|
|
118
|
+
viewBox="0 0 24 24"
|
|
119
|
+
fill="none"
|
|
120
|
+
stroke="currentColor"
|
|
121
|
+
stroke-width="2"
|
|
122
|
+
stroke-linecap="round"
|
|
123
|
+
stroke-linejoin="round"
|
|
124
|
+
class="icon"
|
|
125
|
+
>
|
|
126
|
+
<path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
|
|
127
|
+
<path d="M9 11l3 3l8 -8"></path>
|
|
128
|
+
<path d="M20 12v6a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2v-12a2 2 0 0 1 2 -2h9"></path>
|
|
129
|
+
</svg>
|
|
130
|
+
</span>
|
|
131
|
+
<span class="nav-link-title"> Settings </span>
|
|
132
|
+
</a>
|
|
133
|
+
</li>
|
|
134
|
+
</ul>
|
|
135
|
+
<div class="navbar-nav flex-row order-md-last ms-auto">
|
|
136
|
+
<div class="nav-item dropdown">
|
|
137
|
+
<a
|
|
138
|
+
href="#"
|
|
139
|
+
class="nav-link d-flex lh-1 text-reset p-0"
|
|
140
|
+
data-bs-toggle="dropdown"
|
|
141
|
+
aria-label="Open user menu"
|
|
142
|
+
>
|
|
143
|
+
<span
|
|
144
|
+
class="avatar avatar-sm"
|
|
145
|
+
style="background-image: url(/static/samples/avatars/044m.jpg)"
|
|
146
|
+
></span>
|
|
147
|
+
<div class="d-none d-xl-block ps-2">
|
|
148
|
+
<div>Paweł Kuna</div>
|
|
149
|
+
<div class="mt-1 small text-secondary">UI Designer</div>
|
|
150
|
+
</div>
|
|
151
|
+
</a>
|
|
152
|
+
<div class="dropdown-menu dropdown-menu-end dropdown-menu-arrow">
|
|
153
|
+
<a href="#" class="dropdown-item">Status</a>
|
|
154
|
+
<a href="./profile.html" class="dropdown-item">Profile</a>
|
|
155
|
+
<a href="#" class="dropdown-item">Feedback</a>
|
|
156
|
+
<div class="dropdown-divider"></div>
|
|
157
|
+
<a href="./settings.html" class="dropdown-item">Settings</a>
|
|
158
|
+
<a href="./sign-in.html" class="dropdown-item">Logout</a>
|
|
159
|
+
</div>
|
|
160
|
+
</div>
|
|
161
|
+
</div>
|
|
162
|
+
</div>
|
|
163
|
+
</header>
|
|
164
|
+
```
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Navs and tabs
|
|
3
|
+
summary: This guide covers the basics of creating different types of navigation bars and tabs, including horizontal, vertical, pill-shaped, and underline-styled navs.
|
|
4
|
+
description: "Essential guide to nav styles: tabs, pills, dropdowns, and more."
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Navigation bars are essential components of modern web applications, providing users with intuitive ways to navigate between different sections and content. This guide explores various types of navigation bars and tabs that can be easily implemented using predefined classes in HTML and CSS. Each type serves specific use cases, from horizontal and vertical layouts to tabbed interfaces and dropdown menus. By utilizing these examples, developers can enhance the usability and aesthetics of their web projects.
|
|
8
|
+
|
|
9
|
+
## Horizontal nav
|
|
10
|
+
|
|
11
|
+
If you want to create a horizontal navigation bar, you can use the `.nav` class. The `.nav-item` class is used to style each item within the navigation bar, and `.nav-link` is applied to the links. The `.active` class highlights the current active link, while the `.disabled` class styles non-clickable links.
|
|
12
|
+
|
|
13
|
+
```html
|
|
14
|
+
<ul class="nav">
|
|
15
|
+
<li class="nav-item">
|
|
16
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
17
|
+
</li>
|
|
18
|
+
<li class="nav-item">
|
|
19
|
+
<a class="nav-link" href="#">Link</a>
|
|
20
|
+
</li>
|
|
21
|
+
<li class="nav-item">
|
|
22
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
23
|
+
</li>
|
|
24
|
+
</ul>
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Look at the example below to see how the horizontal navigation bar is displayed.
|
|
28
|
+
|
|
29
|
+
```html example centered
|
|
30
|
+
<ul class="nav">
|
|
31
|
+
<li class="nav-item">
|
|
32
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
33
|
+
</li>
|
|
34
|
+
<li class="nav-item">
|
|
35
|
+
<a class="nav-link" href="#">Link</a>
|
|
36
|
+
</li>
|
|
37
|
+
<li class="nav-item">
|
|
38
|
+
<a class="nav-link" href="#">Link</a>
|
|
39
|
+
</li>
|
|
40
|
+
<li class="nav-item">
|
|
41
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
42
|
+
</li>
|
|
43
|
+
</ul>
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Vertical nav
|
|
47
|
+
|
|
48
|
+
To create a vertical navigation bar, add the `.flex-column` class to the `.nav` element. This arranges the navigation items in a column instead of a row, making it suitable for sidebars or vertical menus.
|
|
49
|
+
|
|
50
|
+
```html
|
|
51
|
+
<ul class="nav flex-column">
|
|
52
|
+
...
|
|
53
|
+
</ul>
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
There is an example below to see how the vertical navigation bar is displayed.
|
|
57
|
+
|
|
58
|
+
```html example centered
|
|
59
|
+
<ul class="nav flex-column">
|
|
60
|
+
<li class="nav-item">
|
|
61
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
62
|
+
</li>
|
|
63
|
+
<li class="nav-item">
|
|
64
|
+
<a class="nav-link" href="#">Link</a>
|
|
65
|
+
</li>
|
|
66
|
+
<li class="nav-item">
|
|
67
|
+
<a class="nav-link" href="#">Link</a>
|
|
68
|
+
</li>
|
|
69
|
+
<li class="nav-item">
|
|
70
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
71
|
+
</li>
|
|
72
|
+
</ul>
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Tabs
|
|
76
|
+
|
|
77
|
+
To create a tabbed navigation interface, use the `.nav-tabs` class. This is ideal for displaying different content sections within a single interface, where each tab represents a section.
|
|
78
|
+
|
|
79
|
+
```html
|
|
80
|
+
<ul class="nav nav-tabs">
|
|
81
|
+
...
|
|
82
|
+
</ul>
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Example below shows how the tabbed navigation interface is displayed.
|
|
86
|
+
|
|
87
|
+
```html example centered
|
|
88
|
+
<ul class="nav nav-tabs">
|
|
89
|
+
<li class="nav-item">
|
|
90
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
91
|
+
</li>
|
|
92
|
+
<li class="nav-item">
|
|
93
|
+
<a class="nav-link" href="#">Link</a>
|
|
94
|
+
</li>
|
|
95
|
+
<li class="nav-item">
|
|
96
|
+
<a class="nav-link" href="#">Link</a>
|
|
97
|
+
</li>
|
|
98
|
+
<li class="nav-item">
|
|
99
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
100
|
+
</li>
|
|
101
|
+
</ul>
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Pills
|
|
105
|
+
|
|
106
|
+
For a pill-shaped navigation style, use the `.nav-pills` class. This is a great choice for a sleek, modern look, especially in interactive UI components.
|
|
107
|
+
|
|
108
|
+
```html example centered
|
|
109
|
+
<ul class="nav nav-pills">
|
|
110
|
+
<li class="nav-item">
|
|
111
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
112
|
+
</li>
|
|
113
|
+
<li class="nav-item">
|
|
114
|
+
<a class="nav-link" href="#">Link</a>
|
|
115
|
+
</li>
|
|
116
|
+
<li class="nav-item">
|
|
117
|
+
<a class="nav-link" href="#">Link</a>
|
|
118
|
+
</li>
|
|
119
|
+
<li class="nav-item">
|
|
120
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
121
|
+
</li>
|
|
122
|
+
</ul>
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Underline
|
|
126
|
+
|
|
127
|
+
To create a navigation bar with an underline effect for active links, use the `.nav-underline` class. This provides a clean and minimalistic style.
|
|
128
|
+
|
|
129
|
+
```html example centered
|
|
130
|
+
<ul class="nav nav-underline">
|
|
131
|
+
<li class="nav-item">
|
|
132
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
133
|
+
</li>
|
|
134
|
+
<li class="nav-item">
|
|
135
|
+
<a class="nav-link" href="#">Link</a>
|
|
136
|
+
</li>
|
|
137
|
+
<li class="nav-item">
|
|
138
|
+
<a class="nav-link" href="#">Link</a>
|
|
139
|
+
</li>
|
|
140
|
+
<li class="nav-item">
|
|
141
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
142
|
+
</li>
|
|
143
|
+
</ul>
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
## Tabs with Dropdown
|
|
147
|
+
|
|
148
|
+
You can enhance tabs by adding dropdown menus using the `.dropdown` class inside a `.nav-tabs` structure. This allows for additional options under a single tab, improving the navigation experience.
|
|
149
|
+
|
|
150
|
+
```html
|
|
151
|
+
<ul class="nav nav-tabs">
|
|
152
|
+
...
|
|
153
|
+
<li class="nav-item dropdown">
|
|
154
|
+
<a
|
|
155
|
+
class="nav-link dropdown-toggle"
|
|
156
|
+
data-bs-toggle="dropdown"
|
|
157
|
+
href="#"
|
|
158
|
+
role="button"
|
|
159
|
+
aria-expanded="false"
|
|
160
|
+
>Dropdown</a
|
|
161
|
+
>
|
|
162
|
+
<ul class="dropdown-menu">
|
|
163
|
+
...
|
|
164
|
+
</ul>
|
|
165
|
+
</li>
|
|
166
|
+
...
|
|
167
|
+
</ul>
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
Example below shows how tabs with dropdown menus are displayed.
|
|
171
|
+
|
|
172
|
+
```html example centered height="15rem"
|
|
173
|
+
<ul class="nav nav-tabs">
|
|
174
|
+
<li class="nav-item">
|
|
175
|
+
<a class="nav-link active" aria-current="page" href="#">Active</a>
|
|
176
|
+
</li>
|
|
177
|
+
<li class="nav-item dropdown">
|
|
178
|
+
<a
|
|
179
|
+
class="nav-link dropdown-toggle"
|
|
180
|
+
data-bs-toggle="dropdown"
|
|
181
|
+
href="#"
|
|
182
|
+
role="button"
|
|
183
|
+
aria-expanded="false"
|
|
184
|
+
>Dropdown</a
|
|
185
|
+
>
|
|
186
|
+
<ul class="dropdown-menu">
|
|
187
|
+
<li><a class="dropdown-item" href="#">Action</a></li>
|
|
188
|
+
<li><a class="dropdown-item" href="#">Another action</a></li>
|
|
189
|
+
<li><a class="dropdown-item" href="#">Something else here</a></li>
|
|
190
|
+
<li><hr class="dropdown-divider" /></li>
|
|
191
|
+
<li><a class="dropdown-item" href="#">Separated link</a></li>
|
|
192
|
+
</ul>
|
|
193
|
+
</li>
|
|
194
|
+
<li class="nav-item">
|
|
195
|
+
<a class="nav-link" href="#">Link</a>
|
|
196
|
+
</li>
|
|
197
|
+
<li class="nav-item">
|
|
198
|
+
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
|
|
199
|
+
</li>
|
|
200
|
+
</ul>
|
|
201
|
+
```
|