@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.
Files changed (145) hide show
  1. package/docs/emails/index.mdx +14 -0
  2. package/docs/emails/introduction/compiled-html.mdx +29 -0
  3. package/docs/emails/introduction/contents.mdx +63 -0
  4. package/docs/emails/introduction/index.mdx +9 -0
  5. package/docs/emails/introduction/source-html.mdx +26 -0
  6. package/docs/icons/index.mdx +13 -0
  7. package/docs/icons/libraries/index.mdx +5 -0
  8. package/docs/icons/libraries/preact.mdx +42 -0
  9. package/docs/icons/libraries/react.mdx +42 -0
  10. package/docs/icons/libraries/solidjs.mdx +42 -0
  11. package/docs/icons/libraries/svelte.mdx +43 -0
  12. package/docs/icons/libraries/vue.mdx +50 -0
  13. package/docs/icons/libraries/webfont.mdx +60 -0
  14. package/docs/icons/plugins/figma.mdx +15 -0
  15. package/docs/icons/plugins/index.mdx +4 -0
  16. package/docs/icons/static-files/eps.mdx +15 -0
  17. package/docs/icons/static-files/index.mdx +5 -0
  18. package/docs/icons/static-files/pdf.mdx +15 -0
  19. package/docs/icons/static-files/png.mdx +31 -0
  20. package/docs/icons/static-files/svg.mdx +85 -0
  21. package/docs/illustrations/index.mdx +8 -0
  22. package/docs/illustrations/introduction/contents.mdx +77 -0
  23. package/docs/illustrations/introduction/customization.mdx +1198 -0
  24. package/docs/illustrations/introduction/index.mdx +5 -0
  25. package/docs/illustrations/introduction/license.mdx +90 -0
  26. package/docs/img/browsers/brave.svg +1 -0
  27. package/docs/img/browsers/chrome.svg +1 -0
  28. package/docs/img/browsers/edge.svg +1 -0
  29. package/docs/img/browsers/electron.svg +1 -0
  30. package/docs/img/browsers/firefox.svg +1 -0
  31. package/docs/img/browsers/internet-explorer.svg +1 -0
  32. package/docs/img/browsers/opera.svg +1 -0
  33. package/docs/img/browsers/safari.svg +1 -0
  34. package/docs/img/browsers/vivaldi.svg +1 -0
  35. package/docs/img/cover-illustrations-dark.png +0 -0
  36. package/docs/img/cover-illustrations.png +0 -0
  37. package/docs/img/cover-tabler-dark.png +0 -0
  38. package/docs/img/cover-tabler.png +0 -0
  39. package/docs/img/icons/figma-plugin.png +0 -0
  40. package/docs/img/icons/package-angular-dark.png +0 -0
  41. package/docs/img/icons/package-angular.png +0 -0
  42. package/docs/img/icons/package-eps-dark.png +0 -0
  43. package/docs/img/icons/package-eps.png +0 -0
  44. package/docs/img/icons/package-js-dark.png +0 -0
  45. package/docs/img/icons/package-js.png +0 -0
  46. package/docs/img/icons/package-pdf-dark.png +0 -0
  47. package/docs/img/icons/package-pdf.png +0 -0
  48. package/docs/img/icons/package-png-dark.png +0 -0
  49. package/docs/img/icons/package-png.png +0 -0
  50. package/docs/img/icons/package-preact-dark.png +0 -0
  51. package/docs/img/icons/package-preact.png +0 -0
  52. package/docs/img/icons/package-react-dark.png +0 -0
  53. package/docs/img/icons/package-react-native-dark.png +0 -0
  54. package/docs/img/icons/package-react-native.png +0 -0
  55. package/docs/img/icons/package-react.png +0 -0
  56. package/docs/img/icons/package-solidjs-dark.png +0 -0
  57. package/docs/img/icons/package-solidjs.png +0 -0
  58. package/docs/img/icons/package-sprite-dark.png +0 -0
  59. package/docs/img/icons/package-sprite.png +0 -0
  60. package/docs/img/icons/package-svelte-dark.png +0 -0
  61. package/docs/img/icons/package-svelte.png +0 -0
  62. package/docs/img/icons/package-svg-dark.png +0 -0
  63. package/docs/img/icons/package-svg.png +0 -0
  64. package/docs/img/icons/package-vue-dark.png +0 -0
  65. package/docs/img/icons/package-vue.png +0 -0
  66. package/docs/img/icons/package-webfont-dark.png +0 -0
  67. package/docs/img/icons/package-webfont.png +0 -0
  68. package/docs/index.mdx +16 -0
  69. package/docs/ui/base/colors.mdx +83 -0
  70. package/docs/ui/base/index.mdx +6 -0
  71. package/docs/ui/base/typography.mdx +311 -0
  72. package/docs/ui/components/alerts.mdx +406 -0
  73. package/docs/ui/components/autosize.mdx +25 -0
  74. package/docs/ui/components/avatars.mdx +227 -0
  75. package/docs/ui/components/badges.mdx +112 -0
  76. package/docs/ui/components/breadcrumb.mdx +199 -0
  77. package/docs/ui/components/buttons.mdx +1213 -0
  78. package/docs/ui/components/cards.mdx +417 -0
  79. package/docs/ui/components/carousel.mdx +459 -0
  80. package/docs/ui/components/charts.mdx +697 -0
  81. package/docs/ui/components/countup.mdx +165 -0
  82. package/docs/ui/components/datagrid.mdx +120 -0
  83. package/docs/ui/components/divider.mdx +68 -0
  84. package/docs/ui/components/dropdowns.mdx +302 -0
  85. package/docs/ui/components/dropzone.mdx +88 -0
  86. package/docs/ui/components/empty.mdx +149 -0
  87. package/docs/ui/components/icons.mdx +392 -0
  88. package/docs/ui/components/index.mdx +6 -0
  89. package/docs/ui/components/inline-player.mdx +58 -0
  90. package/docs/ui/components/modals.mdx +297 -0
  91. package/docs/ui/components/offcanvas.mdx +70 -0
  92. package/docs/ui/components/placeholder.mdx +273 -0
  93. package/docs/ui/components/popover.mdx +142 -0
  94. package/docs/ui/components/progress.mdx +241 -0
  95. package/docs/ui/components/range-slider.mdx +32 -0
  96. package/docs/ui/components/ribbons.mdx +207 -0
  97. package/docs/ui/components/segmented-control.mdx +401 -0
  98. package/docs/ui/components/spinners.mdx +135 -0
  99. package/docs/ui/components/statuses.mdx +322 -0
  100. package/docs/ui/components/steps.mdx +174 -0
  101. package/docs/ui/components/switch-icon.mdx +386 -0
  102. package/docs/ui/components/tables.mdx +397 -0
  103. package/docs/ui/components/tabs.mdx +396 -0
  104. package/docs/ui/components/timelines.mdx +697 -0
  105. package/docs/ui/components/tinymce.mdx +46 -0
  106. package/docs/ui/components/toasts.mdx +126 -0
  107. package/docs/ui/components/tooltips.mdx +65 -0
  108. package/docs/ui/components/tracking.mdx +548 -0
  109. package/docs/ui/components/vector-maps.mdx +166 -0
  110. package/docs/ui/forms/form-color-check.mdx +220 -0
  111. package/docs/ui/forms/form-elements.mdx +632 -0
  112. package/docs/ui/forms/form-fieldset.mdx +45 -0
  113. package/docs/ui/forms/form-helpers.mdx +91 -0
  114. package/docs/ui/forms/form-image-check.mdx +213 -0
  115. package/docs/ui/forms/form-input-mask.mdx +61 -0
  116. package/docs/ui/forms/form-selectboxes.mdx +398 -0
  117. package/docs/ui/forms/form-validation.mdx +62 -0
  118. package/docs/ui/forms/index.mdx +6 -0
  119. package/docs/ui/getting-started/browser-support.mdx +28 -0
  120. package/docs/ui/getting-started/customize.mdx +28 -0
  121. package/docs/ui/getting-started/download.mdx +44 -0
  122. package/docs/ui/getting-started/faq.mdx +30 -0
  123. package/docs/ui/getting-started/how-to-contribute.mdx +84 -0
  124. package/docs/ui/getting-started/index.mdx +16 -0
  125. package/docs/ui/getting-started/installation.mdx +67 -0
  126. package/docs/ui/getting-started/license.mdx +30 -0
  127. package/docs/ui/index.mdx +8 -0
  128. package/docs/ui/layout/index.mdx +6 -0
  129. package/docs/ui/layout/navbars.mdx +164 -0
  130. package/docs/ui/layout/navs-tabls.mdx +201 -0
  131. package/docs/ui/layout/page-headers.mdx +365 -0
  132. package/docs/ui/layout/page-layouts.mdx +213 -0
  133. package/docs/ui/plugins/flags.mdx +316 -0
  134. package/docs/ui/plugins/index.mdx +6 -0
  135. package/docs/ui/plugins/payments.mdx +152 -0
  136. package/docs/ui/plugins/social-icons.mdx +135 -0
  137. package/docs/ui/utilities/borders.mdx +260 -0
  138. package/docs/ui/utilities/cursors.mdx +63 -0
  139. package/docs/ui/utilities/index.mdx +5 -0
  140. package/docs/ui/utilities/interactions.mdx +26 -0
  141. package/docs/ui/utilities/margins.mdx +234 -0
  142. package/docs/ui/utilities/vertical-align.mdx +66 -0
  143. package/docs/ui/utilities/visually-hidden.mdx +12 -0
  144. package/package.json +6 -6
  145. 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
+ ![](/docs/cover-tabler.png)
@@ -0,0 +1,6 @@
1
+ ---
2
+ title: Layout
3
+ order: 3
4
+ description: Structure your UI effectively.
5
+ summary: The layout section covers essential tools and techniques for structuring content and organizing UI elements, helping you build visually appealing and functional designs.
6
+ ---
@@ -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
+ ```