Want to build websites that look beautiful on any and all devices, but also load fast on mobile connections? Then mini.css is the right tool for you! Its tiny size (under 10KB gzipped), along with its responsive grid and modern components ensures that all your users are satisfied and can access your website anytime, anywhere. Bridging the gap between fully-featured frameworks (e.g. Bootstrap and Semantic UI) and micro frameworks (e.g. Milligram and Pure.CSS), mini.css packs a lot of features in a small package, while it relies solely on CSS, meaning you do not have to worry about any conflicts with other Javascript libraries you might be using.
-
-
-
-
-
-
Tailored to Your Needs
-
Creating a CSS framework that caters to everyone's needs is no easy task, but mini.css manages to rise to the occasion by providing extensive and coherent documentation in combination with templates, examples and semantic HTML5 markup. Modern UX patterns and accessibility guidelines are well-documented and can be used out of the box, using one of the unique flavors that the framework provides. If you still want more, you can create your own custom flavor or tweak an existing one just by opening its CSS file and changing a few custom properties. It's that simple!
-
-
-
-
-
Get started now!
-
Head over to the documentation to learn how to get started using mini.css, as well as what flavors and components are availble and how to use them to create the website or web app you've always wanted. If you like the framework and want to support it, remember to to star it on Github. It means a lot to us and it only takes a couple of seconds!
Want to build websites that look beautiful on any and all devices, but also load fast on mobile connections? Then mini.css is the right tool for you! Its tiny size (under 10KB gzipped), along with its responsive grid and modern components ensures that all your users are satisfied and can access your website anytime, anywhere. Bridging the gap between fully-featured frameworks (e.g. Bootstrap and Semantic UI) and micro frameworks (e.g. Milligram and Pure.CSS), mini.css packs a lot of features in a small package, while it relies solely on CSS, meaning you do not have to worry about any conflicts with other Javascript libraries you might be using.
+
+
+
+
+
+
Tailored to Your Needs
+
Creating a CSS framework that caters to everyone's needs is no easy task, but mini.css manages to rise to the occasion by providing extensive and coherent documentation in combination with templates, examples and semantic HTML5 markup. Modern UX patterns and accessibility guidelines are well-documented and can be used out of the box, using one of the unique flavors that the framework provides. If you still want more, you can create your own custom flavor or tweak an existing one just by opening its CSS file and changing a few custom properties. It's that simple!
+
+
+
+
+
Get started now!
+
Head over to the documentation to learn how to get started using mini.css, as well as what flavors and components are availble and how to use them to create the website or web app you've always wanted. If you like the framework and want to support it, remember to to star it on Github. It means a lot to us and it only takes a couple of seconds!
Buttons and button-like input elements have been styled by default to be consistent across browsers. You can also style other elements, such as links or form labels, to look like buttons, using the appropriate class (.button) or the button role.
`],
- notes: [
- `It is recommended to use the button role instead of the provided class, if you want your custom buttons to be fully accessible.`
- ],
- customization: [
- `Text color for buttons can be changed by changing the value of the --button-fore-color variable.`,
- `Background color for buttons can be changed by changing the value of the --button-back-color variable.`,
- `Border color for buttons can be changed by changing the value of the --button-border-color variable.`,
- `Background and border color for focused buttons can be changed by changing the values of the --button-hover-back-color and --button-hover-border-color variables respectively.`,
- `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : 'Color variants',
- description: '
To make your buttons stand out, you can give them a primary (.primary), secondary (.secondary), tertiary (.tertiary) or inversed (.inverse) color palette.
`]
- }
- ],
- dos: [{
- description: `File upload inputs are not styled by default, due to inconsistencies in how browsers handle them. If you want them to look like other buttons, you can hide them and use a linked label.`,
- sample: `
Buttons and button-like input elements have been styled by default to be consistent across browsers. You can also style other elements, such as links or form labels, to look like buttons, using the appropriate class (.button) or the button role.
`],
+ notes: [
+ `It is recommended to use the button role instead of the provided class, if you want your custom buttons to be fully accessible.`
+ ],
+ customization: [
+ `Text color for buttons can be changed by changing the value of the --button-fore-color variable.`,
+ `Background color for buttons can be changed by changing the value of the --button-back-color variable.`,
+ `Border color for buttons can be changed by changing the value of the --button-border-color variable.`,
+ `Background and border color for focused buttons can be changed by changing the values of the --button-hover-back-color and --button-hover-border-color variables respectively.`,
+ `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Color variants',
+ description: '
To make your buttons stand out, you can give them a primary (.primary), secondary (.secondary), tertiary (.tertiary) or inversed (.inverse) color palette.
`]
+ }
+ ],
+ dos: [{
+ description: `File upload inputs are not styled by default, due to inconsistencies in how browsers handle them. If you want them to look like other buttons, you can hide them and use a linked label.`,
+ sample: `
Card content is usually organized in smaller sections (.section) to be more easily digestible. A card section can be any valid HTML5 element with the appropriate class applied to it.
`],
- notes: [
- `While not mandatory, it is highly suggested that you wrap all of your cards' contents in one or more sections.`,
- `Remember that a section can be any valid HTML5 element, so you can apply them to headings, paragraphs, input elements etc.`,
- `Media sections have a default height of 200px.`,
- `Due to the media sections using object-fit, you might want to use a polyfill for better browser support (recommended: image polyfill, video polyfill).`,
- `Depending on the source website, some embedded videos might not display properly as media sections.`
- ],
- customization: [
- `Text color for cards and card sections can be changed by changing the value of the --card-fore-color variable.`,
- `Background color for cards and card sections can be changed by changing the value of the --card-back-color variable.`,
- `Border color for cards and card sections can be changed by changing the value of the --card-border-color variable.`,
- `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`
- ],
- modifiers: [
- {
- title : 'Media sections',
- description: '
You can create sections for media (.media), such as images or videos (using an <img> or a <iframe> element respectively). These sections are styled appropriately for presentation of media content, meaning that the content will scale appropriately to fill up the available space.
Card content is usually organized in smaller sections (.section) to be more easily digestible. A card section can be any valid HTML5 element with the appropriate class applied to it.
`],
+ notes: [
+ `While not mandatory, it is highly suggested that you wrap all of your cards' contents in one or more sections.`,
+ `Remember that a section can be any valid HTML5 element, so you can apply them to headings, paragraphs, input elements etc.`,
+ `Media sections have a default height of 200px.`,
+ `Due to the media sections using object-fit, you might want to use a polyfill for better browser support (recommended: image polyfill, video polyfill).`,
+ `Depending on the source website, some embedded videos might not display properly as media sections.`
+ ],
+ customization: [
+ `Text color for cards and card sections can be changed by changing the value of the --card-fore-color variable.`,
+ `Background color for cards and card sections can be changed by changing the value of the --card-back-color variable.`,
+ `Border color for cards and card sections can be changed by changing the value of the --card-border-color variable.`,
+ `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Media sections',
+ description: '
You can create sections for media (.media), such as images or videos (using an <img> or a <iframe> element respectively). These sections are styled appropriately for presentation of media content, meaning that the content will scale appropriately to fill up the available space.
mini.css provides you with cards (.card), general-purpose containers that help you organize the content of your web apps. Cards should be used in combination with the grid system, meaning that they need to be placed inside a grid's rows to work properly. Layouts created with cards are responsive, realigning according to the available size on the screen.
`],
- notes: [`Due to the fact that fluid cards stretch to fill their parent container, they might not fully respect their margins sometimes, although this should not cause any noticable problems in your web apps' layouts.`],
- customization: [
- `Text color for cards can be changed by changing the value of the --card-fore-color variable.`,
- `Background color for cards can be changed by changing the value of the --card-back-color variable.`,
- `Border color for cards can be changed by changing the value of the --card-border-color variable.`,
- `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : 'Alternative sizes',
- description: `
You can create small (.small, 240px wide) or large (.large, 480px wide) cards by applying the appropriate modifiers to a card. Apart from that, you can also create fluid (.fluid) cards, that take up as much space as is available, however you will have to place these cards inside a grid layout's columns, effectively adding one extra step for them to display properly.
`,
- example: `
-
Small Card
Small cards are 240px wide.
-
Large Card
Large cards are 480px wide.
-
-
Fluid Card
Fluid cards scale their width based on the column that contains them.
`
- },
- {
- description: `Never forget to wrap your cards inside a row and your fluid cards inside a row and a column.`,
- sample: `
<div>
-<divclass="card"></div>
-</div>
`
- },
- {
- description: `Try not to combine fixed-width and fluid cards. Instead, combine fixed-width cards with columns and place fluid cards inside them.`,
- sample: `
mini.css provides you with cards (.card), general-purpose containers that help you organize the content of your web apps. Cards should be used in combination with the grid system, meaning that they need to be placed inside a grid's rows to work properly. Layouts created with cards are responsive, realigning according to the available size on the screen.
`],
+ notes: [`Due to the fact that fluid cards stretch to fill their parent container, they might not fully respect their margins sometimes, although this should not cause any noticable problems in your web apps' layouts.`],
+ customization: [
+ `Text color for cards can be changed by changing the value of the --card-fore-color variable.`,
+ `Background color for cards can be changed by changing the value of the --card-back-color variable.`,
+ `Border color for cards can be changed by changing the value of the --card-border-color variable.`,
+ `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Alternative sizes',
+ description: `
You can create small (.small, 240px wide) or large (.large, 480px wide) cards by applying the appropriate modifiers to a card. Apart from that, you can also create fluid (.fluid) cards, that take up as much space as is available, however you will have to place these cards inside a grid layout's columns, effectively adding one extra step for them to display properly.
`,
+ example: `
+
Small Card
Small cards are 240px wide.
+
Large Card
Large cards are 480px wide.
+
+
Fluid Card
Fluid cards scale their width based on the column that contains them.
`
+ },
+ {
+ description: `Never forget to wrap your cards inside a row and your fluid cards inside a row and a column.`,
+ sample: `
<div>
+<divclass="card"></div>
+</div>
`
+ },
+ {
+ description: `Try not to combine fixed-width and fluid cards. Instead, combine fixed-width cards with columns and place fluid cards inside them.`,
+ sample: `
Code blocks and quotation elements are styled using custom rules that help make them stand out from the rest of the text, while inline code and keyboard input tags are minimally styled, aiming not to break the flow of regular text.
',
- example: `
This is some text with some inline source code and some keyboard input.
-
function sum(num1, num2){
- return num1 + num2;
-}
-
This is some text quoted from elsewhere.
`,
- samples: [
-`
<p>This is some text with some inline <code>source code</code> and some keyboard <kbd>input</kbd>.</p>
-<pre>function sum(num1, num2){
- return num1 + num2;
-}</pre>
-<blockquotecite="www.quotation.source">This is some text quoted from elsewhere.</blockquote>
`
- ],
- notes: [
-`The cite attribute of <blockquote> elements is not mandatory and can be omitted. The element's sizing will be automatically adjusted according to the presence of the cite attribute.`
- ],
- customization: [
- `Text color can be changed globally by changing the value of the --fore-color variable. This will affect the text color of <code> and <pre> elements and background color of <kbd> elements.`,
- `Background color can be changed globally by changing the value of the --back-color variable. This will affect the background color of <blockquote> elements and text color of <kbd>.`,
- `You can change the background color of <code> and <pre> elements by changing the value of the --secondary-back-color variable.`,
- `You can change the text color of <blockquote> elements by changing the value of the --secondary-fore-color variable.`,
- `You can change the border color of <pre> and <blockquote> elements by changing the value of the --secondary-border-color variable.`,
- `You can change the border color of the left border of <pre> elements by changing the value of the --pre-color variable.`,
- `You can change the border color of the left border of <blockquote> elements by changing the value of the --blockquote-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [],
- dos: [],
- donts: []
-}
-
-/*
- Modifiers:
- {
- title : '',
- description: '',
- example: '',
- samples: []
- }
- Dos/Donts:
- {
- description: '',
- sample: ''
- }
-*/
+module.exports = {
+ id: 'code-and-quotations',
+ title: 'Code & quotations',
+ keywords: [`code`, `pre`, `kbd`, `blockquote`, `quotation`],
+ description: '
Code blocks and quotation elements are styled using custom rules that help make them stand out from the rest of the text, while inline code and keyboard input tags are minimally styled, aiming not to break the flow of regular text.
',
+ example: `
This is some text with some inline source code and some keyboard input.
+
function sum(num1, num2){
+ return num1 + num2;
+}
+
This is some text quoted from elsewhere.
`,
+ samples: [
+`
<p>This is some text with some inline <code>source code</code> and some keyboard <kbd>input</kbd>.</p>
+<pre>function sum(num1, num2){
+ return num1 + num2;
+}</pre>
+<blockquotecite="www.quotation.source">This is some text quoted from elsewhere.</blockquote>
`
+ ],
+ notes: [
+`The cite attribute of <blockquote> elements is not mandatory and can be omitted. The element's sizing will be automatically adjusted according to the presence of the cite attribute.`
+ ],
+ customization: [
+ `Text color can be changed globally by changing the value of the --fore-color variable. This will affect the text color of <code> and <pre> elements and background color of <kbd> elements.`,
+ `Background color can be changed globally by changing the value of the --back-color variable. This will affect the background color of <blockquote> elements and text color of <kbd>.`,
+ `You can change the background color of <code> and <pre> elements by changing the value of the --secondary-back-color variable.`,
+ `You can change the text color of <blockquote> elements by changing the value of the --secondary-fore-color variable.`,
+ `You can change the border color of <pre> and <blockquote> elements by changing the value of the --secondary-border-color variable.`,
+ `You can change the border color of the left border of <pre> elements by changing the value of the --pre-color variable.`,
+ `You can change the border color of the left border of <blockquote> elements by changing the value of the --blockquote-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
+
+/*
+ Modifiers:
+ {
+ title : '',
+ description: '',
+ example: '',
+ samples: []
+ }
+ Dos/Donts:
+ {
+ description: '',
+ sample: ''
+ }
+*/
diff --git a/docs/doc-fragments/commonTextualElements.js b/docs/doc-fragments/commonTextualElements.js
index 4735642..b56f896 100644
--- a/docs/doc-fragments/commonTextualElements.js
+++ b/docs/doc-fragments/commonTextualElements.js
@@ -1,39 +1,39 @@
-module.exports = {
- id: 'common-textual-elements',
- title: 'Common textual elements',
- tag: 'p',
- keywords: ['p', 'paragraph', 'text', 'textual elements', 'strong', 'bold', 'b', 'em', 'i', 'emphasis', 'italics', 'small', 'a', 'link', 'hr', 'horizontal rule', 'sub', 'subscript', 'sup', 'exponent', 'superscript', 'normalize', 'reset'],
- description: `
mini.css utilizes the ruleset of Normalize.css v7.0.0 to reliably deal with inconsistencies between browsers, while applying some tasteful defaults on top, such as using native font stack to figure out the best font for each device, setting the background and foreground colors, as well as the size of the text to 16px and its line height to 1.5.
-
All of the most common HTML5 elements, such as paragraphs, links, bold, small and slanted text, have been styled by default using clean, modern typography to make your pages look cool and stand out from the rest of the internet.
`,
- example: `
This is a paragraph with some sample text. Did you know that the latest version of mini.css is codenamed Gluon? Well, now you do!
Remember that mini.css is totally free, no fine print involved!
`,
- samples: [
-`
<p>This is a paragraph. with some <strong>bold text</strong> and some <em>italics text</em>.</p>
-<ahref="#">This is a link.</a>
-<small>This is some small text.</small>
-<sub>Subscript</sub>
-<sup>Superscript</sup>
-<hr/>
`
- ],
- notes: [
-
- ],
- customization: [
- `Text color can be changed globally by changing the value of the --fore-color variable.`,
- `Background color can be changed globally by changing the value of the --back-color variable.`,
- `Border color can be changed globally by changing the value of the --border-color variable. This affects the color of <hr> elements.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `You can change the color of links by changing the values of the --a-link-color and --a-visited-color variables.`
- ],
- modifiers: [],
- dos: [],
- donts: [
- {description: `Avoid altering the base font size of 16px directly in your CSS code, as it can cause problems with the display of certain elements.`,
- sample:
-`
/* Do not do this (use Sass instead) */
-html {
- font-size: 14px;
-}
mini.css utilizes the ruleset of Normalize.css v7.0.0 to reliably deal with inconsistencies between browsers, while applying some tasteful defaults on top, such as using native font stack to figure out the best font for each device, setting the background and foreground colors, as well as the size of the text to 16px and its line height to 1.5.
+
All of the most common HTML5 elements, such as paragraphs, links, bold, small and slanted text, have been styled by default using clean, modern typography to make your pages look cool and stand out from the rest of the internet.
`,
+ example: `
This is a paragraph with some sample text. Did you know that the latest version of mini.css is codenamed Gluon? Well, now you do!
Remember that mini.css is totally free, no fine print involved!
`,
+ samples: [
+`
<p>This is a paragraph. with some <strong>bold text</strong> and some <em>italics text</em>.</p>
+<ahref="#">This is a link.</a>
+<small>This is some small text.</small>
+<sub>Subscript</sub>
+<sup>Superscript</sup>
+<hr/>
`
+ ],
+ notes: [
+
+ ],
+ customization: [
+ `Text color can be changed globally by changing the value of the --fore-color variable.`,
+ `Background color can be changed globally by changing the value of the --back-color variable.`,
+ `Border color can be changed globally by changing the value of the --border-color variable. This affects the color of <hr> elements.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `You can change the color of links by changing the values of the --a-link-color and --a-visited-color variables.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: [
+ {description: `Avoid altering the base font size of 16px directly in your CSS code, as it can cause problems with the display of certain elements.`,
+ sample:
+`
/* Do not do this (use Sass instead) */
+html {
+ font-size: 14px;
+}
mini.css provides you with animated loading indicators (.spinner), which you can use to indicate that some content is loading.
`,
- example: ``,
- samples: [`
<divclass="spinner"></div>
`],
- notes: [`You can use either a <div> or a <span> element to create a donut spinner.`,
- `You can add the role="progressbar" attribute to spinner donut elements to increase accessibility.`,
- `You can inline donut spinners inside a paragraph or some other textual content.`],
- customization: [
- `Foreground color for donut spinners can be changed by changing the value of the --spinner-fore-color variable.`,
- `Background color for donut spinners can be changed by changing the value of the --spinner-back-color variable.`,
- `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`
- ],
- modifiers: [
- {
- title : 'Color variants',
- description: `
You can create primary, secondary or tertiary (.primary, .secondary, .tertiary) donut spinners, simply by adding the appropriate color modifier.
mini.css provides you with animated loading indicators (.spinner), which you can use to indicate that some content is loading.
`,
+ example: ``,
+ samples: [`
<divclass="spinner"></div>
`],
+ notes: [`You can use either a <div> or a <span> element to create a donut spinner.`,
+ `You can add the role="progressbar" attribute to spinner donut elements to increase accessibility.`,
+ `You can inline donut spinners inside a paragraph or some other textual content.`],
+ customization: [
+ `Foreground color for donut spinners can be changed by changing the value of the --spinner-fore-color variable.`,
+ `Background color for donut spinners can be changed by changing the value of the --spinner-back-color variable.`,
+ `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`
+ ],
+ modifiers: [
+ {
+ title : 'Color variants',
+ description: `
You can create primary, secondary or tertiary (.primary, .secondary, .tertiary) donut spinners, simply by adding the appropriate color modifier.
The drawer component of mini.css is used to create responsive navigation menus for your web apps. It is composed of three components - the drawer, the toggle button and the close button:
-
To create a drawer, simply create a checkbox input, applying the appropriate class to it (.drawer), immediately followed by a container of your liking (e.g. a <div> or <nav>). The former serves as your drawer's control, while the latter is the actual drawer container.
-
Create a label anywhere outside your drawer's container for the checkbox controlling your drawer, applying the appropriate class (.drawer-toggle). This will serve as the toggle button for your drawer menu.
-
Finally, inside your drawer's container, add another label for the checkbox controlling your drawer, applying the appropriate class (.drawer-close). This will serve as the close button for your drawer menu.
`
- ],
- notes: [
- `Drawer menus are responsive by default and will expand into normal containers on screens larger or equal to 768px wide.`,
- `It is highly recommended to place your drawer's toggle button inside your web app's header element.`,
- `You can combine the navigation bar element with the drawer menu for better results.`,
- `Remember to apply the appropriate classes to any and all elements, as indicated in the examples. Failing to do so will result in the drawer menu not rendering or behaving properly.`
- ],
- customization: [
- `Text color can be changed globally by changing the value of the --fore-color variable. This will affect the text color of the toggle button and items inside the drawer container.`,
- `Background color for the drawer container can be changed by changing the value of the --drawer-back-color variable.`,
- `Border color for the drawer container can be changed by changing the value of the --drawer-border-color variable.`,
- `Text color for the drawer close button can be changed by changing the values of the --drawer-close-color.`,
- `Background color for the drawer close button when focused or hovered over can be changed by changing the values of the --drawer-hover-back-color.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : `Persistent drawer`,
- description: `
If you want your drawer menus to not expand into normal containers on larger screens, simply add the appropriate modifier (.persistent) on the checkbox controlling the drawer and its toggle button.
`
- ]
- }
- ],
- dos: [
- {
- description: `You can combine the drawer menu with the grid system to create responsive menus that are part of the layout of your web app.`,
- sample: `
`
- }
- ],
- donts: [
- {
- description: `You should not place anything between the checkbox controlling the drawer and the container.`,
- sample: `
<inputtype="checkbox"id="drawer-control"class="drawer">
-<!-- Do not place other stuff between these -->
-<div>
-<labelfor="drawer-control"class="drawer-close"></label>
-<ahref="#">Home</a>
-</div>
The drawer component of mini.css is used to create responsive navigation menus for your web apps. It is composed of three components - the drawer, the toggle button and the close button:
+
To create a drawer, simply create a checkbox input, applying the appropriate class to it (.drawer), immediately followed by a container of your liking (e.g. a <div> or <nav>). The former serves as your drawer's control, while the latter is the actual drawer container.
+
Create a label anywhere outside your drawer's container for the checkbox controlling your drawer, applying the appropriate class (.drawer-toggle). This will serve as the toggle button for your drawer menu.
+
Finally, inside your drawer's container, add another label for the checkbox controlling your drawer, applying the appropriate class (.drawer-close). This will serve as the close button for your drawer menu.
`
+ ],
+ notes: [
+ `Drawer menus are responsive by default and will expand into normal containers on screens larger or equal to 768px wide.`,
+ `It is highly recommended to place your drawer's toggle button inside your web app's header element.`,
+ `You can combine the navigation bar element with the drawer menu for better results.`,
+ `Remember to apply the appropriate classes to any and all elements, as indicated in the examples. Failing to do so will result in the drawer menu not rendering or behaving properly.`
+ ],
+ customization: [
+ `Text color can be changed globally by changing the value of the --fore-color variable. This will affect the text color of the toggle button and items inside the drawer container.`,
+ `Background color for the drawer container can be changed by changing the value of the --drawer-back-color variable.`,
+ `Border color for the drawer container can be changed by changing the value of the --drawer-border-color variable.`,
+ `Text color for the drawer close button can be changed by changing the values of the --drawer-close-color.`,
+ `Background color for the drawer close button when focused or hovered over can be changed by changing the values of the --drawer-hover-back-color.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : `Persistent drawer`,
+ description: `
If you want your drawer menus to not expand into normal containers on larger screens, simply add the appropriate modifier (.persistent) on the checkbox controlling the drawer and its toggle button.
`
+ ]
+ }
+ ],
+ dos: [
+ {
+ description: `You can combine the drawer menu with the grid system to create responsive menus that are part of the layout of your web app.`,
+ sample: `
`
+ }
+ ],
+ donts: [
+ {
+ description: `You should not place anything between the checkbox controlling the drawer and the container.`,
+ sample: `
<inputtype="checkbox"id="drawer-control"class="drawer">
+<!-- Do not place other stuff between these -->
+<div>
+<labelfor="drawer-control"class="drawer-close"></label>
+<ahref="#">Home</a>
+</div>
You can apply generic borders, shadows or border radiuses to any element, by using the appropriate class (.bordered, .shadowed, .rounded or .circular).
`],
- notes: [
- 'Element decorators use !important declarations to override any other styles, so exercise caution when using them.',
- 'Element decorators can be used with pretty much every element or component that is available.'
- ],
- customization: [
- `Boder color for the generic border decorator can be changed by changing the value of the --generic-border-color variable.`,
- `Box shadow style for the generic shadow can be changed by changing the value of the --generic-box-shadow variable.`
- ],
- modifiers: [],
- dos: [],
- donts: [
- {
- description: `Avoid applying the .rounded and .circular decorators on the same element.`,
- sample: `
<spanclass="rounded circular">Do not do this.</span>
You can apply generic borders, shadows or border radiuses to any element, by using the appropriate class (.bordered, .shadowed, .rounded or .circular).
`],
+ notes: [
+ 'Element decorators use !important declarations to override any other styles, so exercise caution when using them.',
+ 'Element decorators can be used with pretty much every element or component that is available.'
+ ],
+ customization: [
+ `Boder color for the generic border decorator can be changed by changing the value of the --generic-border-color variable.`,
+ `Box shadow style for the generic shadow can be changed by changing the value of the --generic-box-shadow variable.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: [
+ {
+ description: `Avoid applying the .rounded and .circular decorators on the same element.`,
+ sample: `
<spanclass="rounded circular">Do not do this.</span>
The footer element has been minimally styled, aiming to provide you with a clean base to create your web apps' footers.
`,
- example: ``,
- samples: [`
<footer>
-<p>Footer text</p>
-</footer>
`],
- notes: [],
- customization: [
- `Text color for the footer can be changed by changing the value of the --footer-fore-color variable.`,
- `Background color for the footer can be changed by changing the value of the --footer-back-color variable.`,
- `Border color for the footer can be changed by changing the value of the --footer-border-color variable.`,
- `Text color for links inside the footer can be changed by changing the value of the --footer-link-color variable.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`
- ],
- modifiers: [
- {
- title : 'Sticky footer',
- description: `
You can make your web app's footer sticky (.sticky), by applying the appropriate modifier.
The footer element has been minimally styled, aiming to provide you with a clean base to create your web apps' footers.
`,
+ example: ``,
+ samples: [`
<footer>
+<p>Footer text</p>
+</footer>
`],
+ notes: [],
+ customization: [
+ `Text color for the footer can be changed by changing the value of the --footer-fore-color variable.`,
+ `Background color for the footer can be changed by changing the value of the --footer-back-color variable.`,
+ `Border color for the footer can be changed by changing the value of the --footer-border-color variable.`,
+ `Text color for links inside the footer can be changed by changing the value of the --footer-link-color variable.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Sticky footer',
+ description: `
You can make your web app's footer sticky (.sticky), by applying the appropriate modifier.
Forms, labels and common HTML5 input elements have been styled using clean, modern rules, improving the accessibility and usability of your web apps' forms.
`],
- notes: [
- `Using the <fieldset> and <legend> elements is highly recommended, as it improves semantic markup and accessibility.`,
- `Some input elements, such as date & time, color and range types, are not supported and, as a result, do not have a default style defined for them. You can define said styles manually if you need to use them in your web app.`
- ],
- customization: [
- `Text color for forms and legend elements can be changed by changing the value of the --form-fore-color variable.`,
- `Background color for forms can be changed by changing the value of the --form-back-color variable.`,
- `Border color for forms and fieldset elements can be changed by changing the value of the --form-border-color variable.`,
- `Text color for input elements can be changed by changing the value of the --input-fore-color variable.`,
- `Background color for input elements can be changed by changing the value of the --input-back-color variable.`,
- `Border color for input elements can be changed by changing the value of the --input-border-color variable.`,
- `Border color for focused and invalid input elements can be changed by changing the value of the --input-focus-color and --input-invalid-color variables respectively.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [],
- dos: [
- {
- description: 'Form inputs are inline by defaut, however you can combine forms with the grid system to create aligned forms.',
- sample: `
Forms, labels and common HTML5 input elements have been styled using clean, modern rules, improving the accessibility and usability of your web apps' forms.
`],
+ notes: [
+ `Using the <fieldset> and <legend> elements is highly recommended, as it improves semantic markup and accessibility.`,
+ `Some input elements, such as date & time, color and range types, are not supported and, as a result, do not have a default style defined for them. You can define said styles manually if you need to use them in your web app.`
+ ],
+ customization: [
+ `Text color for forms and legend elements can be changed by changing the value of the --form-fore-color variable.`,
+ `Background color for forms can be changed by changing the value of the --form-back-color variable.`,
+ `Border color for forms and fieldset elements can be changed by changing the value of the --form-border-color variable.`,
+ `Text color for input elements can be changed by changing the value of the --input-fore-color variable.`,
+ `Background color for input elements can be changed by changing the value of the --input-back-color variable.`,
+ `Border color for input elements can be changed by changing the value of the --input-border-color variable.`,
+ `Border color for focused and invalid input elements can be changed by changing the value of the --input-focus-color and --input-invalid-color variables respectively.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [],
+ dos: [
+ {
+ description: 'Form inputs are inline by defaut, however you can combine forms with the grid system to create aligned forms.',
+ sample: `
You can get started using mini.css in one of many ways. It is published on npm and yarn, so you can easily download it, using your preferred package manager:
-
npm install mini.css
yarn add mini.css
-
Alternatively, you can use either rawgit or cdnjs to import mini.css into your HTML page's <head> tag:
mini.css is crafted with long-term support in mind, so expect it to be compatible with all modern browsers, as well as their future versions. However, most legacy and proxy browsers, such as Internet Explorer, Opera Mini, IE Mobile and UC Browser are not officially supported, meaning certain features may not be displayed properly or behave exactly as expected.
You can get started using mini.css in one of many ways. It is published on npm and yarn, so you can easily download it, using your preferred package manager:
+
npm install mini.css
yarn add mini.css
+
Alternatively, you can use either rawgit or cdnjs to import mini.css into your HTML page's <head> tag:
mini.css is crafted with long-term support in mind, so expect it to be compatible with all modern browsers, as well as their future versions. However, most legacy and proxy browsers, such as Internet Explorer, Opera Mini, IE Mobile and UC Browser are not officially supported, meaning certain features may not be displayed properly or behave exactly as expected.
The grid system of mini.css utilizes the Flexbox layout to provide you with a simple, modern, responsive layout system for your web apps. Like most modern CSS frameworks' grid systems, it is composed of three main components - containers, rows and columns:
-
The container (.container) is the outermost layer of the grid system and serves as a fluid wrapper, which can be used as the basis for your layout.
-
Inside the container, you can add one or more rows (.row), which will in turn house the columns.
-
Columns (col-*-*) are placed inside rows and they can be customized to display differently on different screen sizes, make use of fluid layouts, use offsets or change ordering.
You can use the grid system to create a responsive media object in one of many ways. Below is a simple example of a two-column media object with an image and some text:
-
`
-],
- notes: [
- `mini.css uses a mobile-first approach in its grid system, so you do not have to rewrite the same layout for all three screen sizes. Leaving a column's size, offset or order unspecified for a screen size will use the style applied for the previous largest screen size recursively. This also applies to predefined layouts.`,
- `The specific breakpoints for small, medium and large screen sizes are as follows:
-
-
small: less than 768px wide
-
medium: more than or equal to 768px wide and less than 1280px wide
-
large: 1280px wide or more
-
`,
- `In many cases, you can omit the container and just use rows and columns. You only need to make sure that all of your rows have the same parent element.`,
- `You can use fluid columns to create columns whose width is not a multiple of 1/12th of the screen's width (e.g. if you have 7 fluid columns in a row, each one of them will be 1/7th of the screen's width).`,
- `Predefined layouts can be combined with most of the features of the grid system, such as offsets and reordering, however they do not combine very well with regular columns.`,
- `You should only apply offset and reordering modifiers to the columns that you need and for the screen sizes that are necessary. Remember to also specify a column width or use a predefined layout before applying these modifiers.`
- ],
- customization: [
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable. This only affects the padding of the container.`
-],
- modifiers: [
- {
- title: `Screen sizes and width`,
- description: `
Each column class is defined by specifying a screen size (small - sm, medium - md or large - lg) and a column width (a value between 1 and 12 or you can omit it for a fluid column), separated by dashes (e.g. .col-sm-6 for a 6-wide column on a small screen). Using these you can apply different layouts for different screen sizes, by altering the width of columns, using multiple classes. Note that column widths are applied recursively, meaning that if you do not specify a width for a specific screen size the column will use the width applied for the previous largest screen size.
Rows can be modified to apply predefined layouts to the columns inside them, effectively reducing the amount of work required for simple layouts. To create a predefined layout, you can add a class to a row (.cols-*-*), specifying a screen size and width for the columns inside it (or omitting the width for fluid columns), similarly to the way columns are defined (e.g. .row.cols-sm-6 will cause all elements inside the row to be 6-wide on a small screen). Columns inside a predefined layout do not require any further classes to display and, much like normal column layouts, their widths are applied recursively.
`,
- example: '',
- samples: [`
<divclass="row cols-sm-6">
-<div>
-<p>This paragraph is inside a 6-wide column.</p>
-</div>
-<div>
-<p>This paragraph is inside a 6-wide column.</p>
-</div>
-</div>
Columns can be moved to the right, by applying offset classes (.col-*-offset-*), defining a screen size and an offset (a value between 0 and 11, e.g. .col-sm-offset-3 will move a column 25% to the right on a small screen). Like all other column modifiers, offsets are applied recursively.
Columns can be reordered on different screen sizes, by applying a reordering class (.col-*-*), defining a screen size and the order (first, normal or last, e.g. .col-sm-last will move a column to the end of its row on a small screen). Like all other column modifiers, reordering is applied recursively.
`]
- }
- ],
- dos: [
- {
- description: `A column can contain a container or a row inside it, or even be a row at the same time. In the latter case, it will act as a column for its parent row and as a row for its children.`,
- sample: `
`
- },
- {
- description: `You can mix fluid columns with fixed, if you like. Fluid columns will adapt to the size of the container left for them. You can also use columns whose total width exceeds 12 (100%). The remaining content will flow below the rest, allowing you to specify multiple blocks of content inside the same row if you need to.`,
- sample: `
`
- },
- {
- description: `You can change the layout of your content for different displays, laying out your content vertically on smaller screens or horizontally on larger screens. If your columns exceed a total width of 12 (100%) on some displays, they will wrap accordingly.`,
- sample: `
`
- },
- {
- description: `You do not need to specify a column's width or reapply offset and reordering modifiers if they are the same as the previous screen size.`,
- sample: `
`
- },
- {
- description: `To remove a previously applied offset from a column (i.e. one applied from the layout from a smaller screen size) or to make sure no offsets are active on a column, you can set its offset to 0 for a specific screen size. Similarly, to remove previously applied reordering modifiers from a column, you can set its order to normal.`,
- sample: `
`
- },
- {
- description: `Avoid mixing rows and columns with normal content that is not wrapped on the respective level of the grid layout.`,
- sample: `
<divclass="container">
-<divclass="row">
-<divclass="col-sm"></div>
-<p>Do not do this.</p>
-</div>
-<p>Do not do this.</p>
-</div>
`
- },
- {
- description: `Never omit the class that specifies a column's width for the small screen size. You can omit all other classes and modifiers, except for this. This also applies to predefined layouts.`,
- sample: `
`
- },
- {
- description: `Avoid combining normal column width modifiers with predefined layouts, as the predefined layout will most likely override the width modifier of the column.`,
- sample: `
The grid system of mini.css utilizes the Flexbox layout to provide you with a simple, modern, responsive layout system for your web apps. Like most modern CSS frameworks' grid systems, it is composed of three main components - containers, rows and columns:
+
The container (.container) is the outermost layer of the grid system and serves as a fluid wrapper, which can be used as the basis for your layout.
+
Inside the container, you can add one or more rows (.row), which will in turn house the columns.
+
Columns (col-*-*) are placed inside rows and they can be customized to display differently on different screen sizes, make use of fluid layouts, use offsets or change ordering.
You can use the grid system to create a responsive media object in one of many ways. Below is a simple example of a two-column media object with an image and some text:
+
`
+],
+ notes: [
+ `mini.css uses a mobile-first approach in its grid system, so you do not have to rewrite the same layout for all three screen sizes. Leaving a column's size, offset or order unspecified for a screen size will use the style applied for the previous largest screen size recursively. This also applies to predefined layouts.`,
+ `The specific breakpoints for small, medium and large screen sizes are as follows:
+
+
small: less than 768px wide
+
medium: more than or equal to 768px wide and less than 1280px wide
+
large: 1280px wide or more
+
`,
+ `In many cases, you can omit the container and just use rows and columns. You only need to make sure that all of your rows have the same parent element.`,
+ `You can use fluid columns to create columns whose width is not a multiple of 1/12th of the screen's width (e.g. if you have 7 fluid columns in a row, each one of them will be 1/7th of the screen's width).`,
+ `Predefined layouts can be combined with most of the features of the grid system, such as offsets and reordering, however they do not combine very well with regular columns.`,
+ `You should only apply offset and reordering modifiers to the columns that you need and for the screen sizes that are necessary. Remember to also specify a column width or use a predefined layout before applying these modifiers.`
+ ],
+ customization: [
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable. This only affects the padding of the container.`
+],
+ modifiers: [
+ {
+ title: `Screen sizes and width`,
+ description: `
Each column class is defined by specifying a screen size (small - sm, medium - md or large - lg) and a column width (a value between 1 and 12 or you can omit it for a fluid column), separated by dashes (e.g. .col-sm-6 for a 6-wide column on a small screen). Using these you can apply different layouts for different screen sizes, by altering the width of columns, using multiple classes. Note that column widths are applied recursively, meaning that if you do not specify a width for a specific screen size the column will use the width applied for the previous largest screen size.
Rows can be modified to apply predefined layouts to the columns inside them, effectively reducing the amount of work required for simple layouts. To create a predefined layout, you can add a class to a row (.cols-*-*), specifying a screen size and width for the columns inside it (or omitting the width for fluid columns), similarly to the way columns are defined (e.g. .row.cols-sm-6 will cause all elements inside the row to be 6-wide on a small screen). Columns inside a predefined layout do not require any further classes to display and, much like normal column layouts, their widths are applied recursively.
`,
+ example: '',
+ samples: [`
<divclass="row cols-sm-6">
+<div>
+<p>This paragraph is inside a 6-wide column.</p>
+</div>
+<div>
+<p>This paragraph is inside a 6-wide column.</p>
+</div>
+</div>
Columns can be moved to the right, by applying offset classes (.col-*-offset-*), defining a screen size and an offset (a value between 0 and 11, e.g. .col-sm-offset-3 will move a column 25% to the right on a small screen). Like all other column modifiers, offsets are applied recursively.
Columns can be reordered on different screen sizes, by applying a reordering class (.col-*-*), defining a screen size and the order (first, normal or last, e.g. .col-sm-last will move a column to the end of its row on a small screen). Like all other column modifiers, reordering is applied recursively.
`]
+ }
+ ],
+ dos: [
+ {
+ description: `A column can contain a container or a row inside it, or even be a row at the same time. In the latter case, it will act as a column for its parent row and as a row for its children.`,
+ sample: `
`
+ },
+ {
+ description: `You can mix fluid columns with fixed, if you like. Fluid columns will adapt to the size of the container left for them. You can also use columns whose total width exceeds 12 (100%). The remaining content will flow below the rest, allowing you to specify multiple blocks of content inside the same row if you need to.`,
+ sample: `
`
+ },
+ {
+ description: `You can change the layout of your content for different displays, laying out your content vertically on smaller screens or horizontally on larger screens. If your columns exceed a total width of 12 (100%) on some displays, they will wrap accordingly.`,
+ sample: `
`
+ },
+ {
+ description: `You do not need to specify a column's width or reapply offset and reordering modifiers if they are the same as the previous screen size.`,
+ sample: `
`
+ },
+ {
+ description: `To remove a previously applied offset from a column (i.e. one applied from the layout from a smaller screen size) or to make sure no offsets are active on a column, you can set its offset to 0 for a specific screen size. Similarly, to remove previously applied reordering modifiers from a column, you can set its order to normal.`,
+ sample: `
`
+ },
+ {
+ description: `Avoid mixing rows and columns with normal content that is not wrapped on the respective level of the grid layout.`,
+ sample: `
<divclass="container">
+<divclass="row">
+<divclass="col-sm"></div>
+<p>Do not do this.</p>
+</div>
+<p>Do not do this.</p>
+</div>
`
+ },
+ {
+ description: `Never omit the class that specifies a column's width for the small screen size. You can omit all other classes and modifiers, except for this. This also applies to predefined layouts.`,
+ sample: `
`
+ },
+ {
+ description: `Avoid combining normal column width modifiers with predefined layouts, as the predefined layout will most likely override the width modifier of the column.`,
+ sample: `
The header element has been minimally styled, allowing you to create modern headers for your web apps. A header can include a logo element (.logo), as well as buttons, links and labels, styled as buttons (.button).
`],
- notes: [`The header element is partially responsive on smaller screens, displaying a scrollbar indicating that there is more content off-screen.`,
- `The header element can be a row in a grid system, allowing you to create responsive headers.`],
- customization: [
- `Text color for the header can be changed by changing the value of the --header-fore-color variable.`,
- `Background color for the header can be changed by changing the value of the --header-back-color variable.`,
- `Border color for the header can be changed by changing the value of the --header-border-color variable.`,
- `Background color for focused buttons inside the header can be changed by changing the value of the --header-hover-back-color variable.`
- ],
- modifiers: [
- {
- title : 'Sticky header',
- description: `
You can make your web app's header sticky (.sticky), by applying the appropriate modifier.
`]
- }
- ],
- dos: [],
- donts: [
- {
- description: `You should not apply a .button class to the logo of your header, but you must make sure that all other elements inside the header are styled as buttons.`,
- sample: `
The header element has been minimally styled, allowing you to create modern headers for your web apps. A header can include a logo element (.logo), as well as buttons, links and labels, styled as buttons (.button).
`],
+ notes: [`The header element is partially responsive on smaller screens, displaying a scrollbar indicating that there is more content off-screen.`,
+ `The header element can be a row in a grid system, allowing you to create responsive headers.`],
+ customization: [
+ `Text color for the header can be changed by changing the value of the --header-fore-color variable.`,
+ `Background color for the header can be changed by changing the value of the --header-back-color variable.`,
+ `Border color for the header can be changed by changing the value of the --header-border-color variable.`,
+ `Background color for focused buttons inside the header can be changed by changing the value of the --header-hover-back-color variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Sticky header',
+ description: `
You can make your web app's header sticky (.sticky), by applying the appropriate modifier.
`]
+ }
+ ],
+ dos: [],
+ donts: [
+ {
+ description: `You should not apply a .button class to the logo of your header, but you must make sure that all other elements inside the header are styled as buttons.`,
+ sample: `
All of the HTML5 heading elements are styled, using a customizable ratio and simple rules, providing a clean base for your web app's titles. Apart from the headings themselves, customized rules are provided for displaying subheadings or explanatory text below your web app's headings.
-`
- ],
- notes: [],
- customization: [
- `Text color can be changed globally by changing the value of the --fore-color variable. This will affect the color of the headings' main text.`,
- `Secondary text color can be changed globally by changing the value of the --secondary-fore-color variable. This will affect the color of subheadings.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `You can change the ratio of headings' size by chaning the value of the --heading-ratio variable. Bear in mind that the value of this variable must be unitless to work properly.`
- ],
- modifiers: [],
- dos: [],
- donts: []
-}
+module.exports = {
+ id: 'heading',
+ title: 'Headings',
+ keywords: [`heading`, `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, `small`, `title`, `subtitle`, `subheading`],
+ description: `
All of the HTML5 heading elements are styled, using a customizable ratio and simple rules, providing a clean base for your web app's titles. Apart from the headings themselves, customized rules are provided for displaying subheadings or explanatory text below your web app's headings.
+`
+ ],
+ notes: [],
+ customization: [
+ `Text color can be changed globally by changing the value of the --fore-color variable. This will affect the color of the headings' main text.`,
+ `Secondary text color can be changed globally by changing the value of the --secondary-fore-color variable. This will affect the color of subheadings.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `You can change the ratio of headings' size by chaning the value of the --heading-ratio variable. Bear in mind that the value of this variable must be unitless to work properly.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
diff --git a/docs/doc-fragments/icons.js b/docs/doc-fragments/icons.js
index 51fd3a7..3b0702f 100644
--- a/docs/doc-fragments/icons.js
+++ b/docs/doc-fragments/icons.js
@@ -1,73 +1,73 @@
-module.exports = {
- id: 'icons',
- title: 'Icons',
- keywords: [`icon`, `svg`, `feather`, `icons`],
- description: `
mini.css comes with a set of 20 commonly-used icons (courtesy of Feather) that you can use anywhere in your web apps, utilizing the appropriate class for each icon.
`],
- notes: [`You can only use a <span> element to create an icon.`,
- `You can inline icons inside a paragraph or pretty much any other textual content. Icons scale relative to their parent element.`],
- customization: [
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`
- ],
- modifiers: [
- {
- title : 'Color variants',
- description: `
You can create secondary or inverse (.secondary, .inverse) icons, simply by adding the appropriate color modifier.
`,
- example: `
This is a secondary icon, which has a lighter color.
mini.css comes with a set of 20 commonly-used icons (courtesy of Feather) that you can use anywhere in your web apps, utilizing the appropriate class for each icon.
`],
+ notes: [`You can only use a <span> element to create an icon.`,
+ `You can inline icons inside a paragraph or pretty much any other textual content. Icons scale relative to their parent element.`],
+ customization: [
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`
+ ],
+ modifiers: [
+ {
+ title : 'Color variants',
+ description: `
You can create secondary or inverse (.secondary, .inverse) icons, simply by adding the appropriate color modifier.
`,
+ example: `
This is a secondary icon, which has a lighter color.
Image elements are responsive by default, automatically scaling down as necessary to display properly on smaller devices. Images retain their original aspect ratio and they will never scale above their original size.
-
If you want to add captions to images, you can use HTML5 figure elements, along with their related captions.
`],
- notes: [`While not mandatory, it is considered a good practice to always add a alt attribute to image elements on your web apps.`],
- customization: [
- `You can change the text color of <figcaption> elements by changing the value of the --secondary-fore-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`
- ],
- modifiers: [],
- dos: [],
- donts: []
-}
+module.exports = {
+ id: 'images-captions',
+ title: 'Images & captions',
+ keywords: [`img`, `image`, `responsive`, `responsiveness`, `caption`, `figure`, `figcaption`],
+ description: `
Image elements are responsive by default, automatically scaling down as necessary to display properly on smaller devices. Images retain their original aspect ratio and they will never scale above their original size.
+
If you want to add captions to images, you can use HTML5 figure elements, along with their related captions.
`],
+ notes: [`While not mandatory, it is considered a good practice to always add a alt attribute to image elements on your web apps.`],
+ customization: [
+ `You can change the text color of <figcaption> elements by changing the value of the --secondary-fore-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
diff --git a/docs/doc-fragments/inputGrouping.js b/docs/doc-fragments/inputGrouping.js
index e5ef292..c65f248 100644
--- a/docs/doc-fragments/inputGrouping.js
+++ b/docs/doc-fragments/inputGrouping.js
@@ -1,68 +1,68 @@
-module.exports = {
- id: 'input-grouping',
- title: 'Input grouping',
- keywords: [`input group`, `input-group`, `vertical`, `fluid`, `input`, `button`, `button group`, `button-group`],
- description: `
You can ensure that input elements and labels display together on the same line, by grouping them together (.input-group). You can also group buttons together, using a different grouping class (.button-group).
`
- ],
- notes: [`It is highly recommended that you do not place checkboxes or radio buttons inside fluid or vertical input groups.`,
- `Button groups will display horizontally on medium and large screens, but collapse into a vertical view on small screens.`],
- customization: [],
- modifiers: [
- {
- title : `Fluid & vertical grouping`,
- description: `
You can make your input groups fluid (.fluid) or vertical (.vertical), by applying the appropriate modifiers.
You can ensure that input elements and labels display together on the same line, by grouping them together (.input-group). You can also group buttons together, using a different grouping class (.button-group).
`
+ ],
+ notes: [`It is highly recommended that you do not place checkboxes or radio buttons inside fluid or vertical input groups.`,
+ `Button groups will display horizontally on medium and large screens, but collapse into a vertical view on small screens.`],
+ customization: [],
+ modifiers: [
+ {
+ title : `Fluid & vertical grouping`,
+ description: `
You can make your input groups fluid (.fluid) or vertical (.vertical), by applying the appropriate modifiers.
List elements, both unordered and ordered, are minimally styled to match with the rest of the framework's aesthetics. Their margins and padding are reset to properly align with the rest of the common HTML5 elements, providing a stable foundation for all of your web app's lists.
`],
- notes: [],
- customization: [
- `Text color can be changed globally by changing the value of the --fore-color variable.`,
- `Background color can be changed globally by changing the value of the --back-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`
- ],
- modifiers: [],
- dos: [],
- donts: []
-}
+module.exports = {
+ id: 'lists',
+ title: 'Lists',
+ keywords: [`list`, `ul`, `ol`, `li`],
+ description: `
List elements, both unordered and ordered, are minimally styled to match with the rest of the framework's aesthetics. Their margins and padding are reset to properly align with the rest of the common HTML5 elements, providing a stable foundation for all of your web app's lists.
`],
+ notes: [],
+ customization: [
+ `Text color can be changed globally by changing the value of the --fore-color variable.`,
+ `Background color can be changed globally by changing the value of the --back-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
diff --git a/docs/doc-fragments/modalDialogs.js b/docs/doc-fragments/modalDialogs.js
index 943d71f..9b22691 100644
--- a/docs/doc-fragments/modalDialogs.js
+++ b/docs/doc-fragments/modalDialogs.js
@@ -1,62 +1,62 @@
-module.exports = {
- id: 'modal-dialogs',
- title: 'Modal dialogs',
- keywords: [`modal`, `dialog`, `contextual`, `alert`, `notification`],
- description: `
mini.css provides you with a modal dialog component to display messages to users. It is composed of three components - the modal dialog, the toggle button and the close button:
-
To create a modal dialog, simply create a checkbox input, applying the appropriate class to it (.modal), immediately followed by a <div> container. The former serves as your modal dialog's control, while the latter is the actual modal dialog container.
-
Create a label anywhere outside your modal dialog's container for the checkbox controlling your modal dialog. This will serve as the toggle button for your modal dialog.
-
Finally, inside your modal dialog's container, add another label for the checkbox controlling your modal dialog, applying the appropriate class (.modal-close). This will serve as the close button for your modal dialog.
-
`,
- example: `
Modal
This is a modal dialog!
`,
- samples: [`
<labelfor="modal-control">Show modal</label>
-
-<inputtype="checkbox"id="modal-control"class="modal">
-<div>
-<divclass="card">
-<labelfor="modal-control"class="modal-close"></label>
-<h3class="section">Modal</h3>
-<pclass="section">This is a modal dialog!</p>
-</div>
-</div>
`],
- notes: [
- `Modal dialogs should be used in combination with the card component for best results.`,
- `Remember to apply the appropriate classes to any and all elements, as indicated in the examples. Failing to do so will result in the modal dialog not rendering or behaving properly.`,
- `You can omit the toggle for the modal dialog and use Javascript to show/hide it, instead. You can also use any correctly linked label inside the modal dialog to change its state.`
- ],
- customization: [
- `Background color for the modal dialog overlay can be changed by changing the value of --modal-overlay-color.`,
- `Text color for the modal dialog close button can be changed by changing the value of the --modal-close-color.`,
- `Background color for the modal dialog close button when focused or hovered over can be changed by changing the value of the --modal-close-hover-color.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [],
- dos: [
- {
- description: `You can use the role="dialog" to add accessibility to your modal dialogs. Remember to properly label it and manage keyboard focus, as required.`,
- sample: `
<inputtype="checkbox"id="modal-control"class="modal">
-<divrole="dialog"aria-labelledby="dialog-title">
-<divclass="card">
-<labelfor="modal-control"class="modal-close"></label>
-<h3class="section"id="dialog-title">Modal</h3>
-<pclass="section">This is a modal dialog!</p>
-</div>
-</div>
`
- }
- ],
- donts: [
- {
- description: `You should not place anything between the checkbox controlling the modal dialog and the container.`,
- sample: `
<inputtype="checkbox"id="modal-control"class="modal">
-<!-- Do not place other stuff between these -->
-<div>
-<divclass="card">
-<labelfor="modal-control"class="modal-close"></label>
-<h3class="section">Modal</h3>
-<pclass="section">This is a modal dialog!</p>
-</div>
-</div>
mini.css provides you with a modal dialog component to display messages to users. It is composed of three components - the modal dialog, the toggle button and the close button:
+
To create a modal dialog, simply create a checkbox input, applying the appropriate class to it (.modal), immediately followed by a <div> container. The former serves as your modal dialog's control, while the latter is the actual modal dialog container.
+
Create a label anywhere outside your modal dialog's container for the checkbox controlling your modal dialog. This will serve as the toggle button for your modal dialog.
+
Finally, inside your modal dialog's container, add another label for the checkbox controlling your modal dialog, applying the appropriate class (.modal-close). This will serve as the close button for your modal dialog.
+
`,
+ example: `
Modal
This is a modal dialog!
`,
+ samples: [`
<labelfor="modal-control">Show modal</label>
+
+<inputtype="checkbox"id="modal-control"class="modal">
+<div>
+<divclass="card">
+<labelfor="modal-control"class="modal-close"></label>
+<h3class="section">Modal</h3>
+<pclass="section">This is a modal dialog!</p>
+</div>
+</div>
`],
+ notes: [
+ `Modal dialogs should be used in combination with the card component for best results.`,
+ `Remember to apply the appropriate classes to any and all elements, as indicated in the examples. Failing to do so will result in the modal dialog not rendering or behaving properly.`,
+ `You can omit the toggle for the modal dialog and use Javascript to show/hide it, instead. You can also use any correctly linked label inside the modal dialog to change its state.`
+ ],
+ customization: [
+ `Background color for the modal dialog overlay can be changed by changing the value of --modal-overlay-color.`,
+ `Text color for the modal dialog close button can be changed by changing the value of the --modal-close-color.`,
+ `Background color for the modal dialog close button when focused or hovered over can be changed by changing the value of the --modal-close-hover-color.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [],
+ dos: [
+ {
+ description: `You can use the role="dialog" to add accessibility to your modal dialogs. Remember to properly label it and manage keyboard focus, as required.`,
+ sample: `
<inputtype="checkbox"id="modal-control"class="modal">
+<divrole="dialog"aria-labelledby="dialog-title">
+<divclass="card">
+<labelfor="modal-control"class="modal-close"></label>
+<h3class="section"id="dialog-title">Modal</h3>
+<pclass="section">This is a modal dialog!</p>
+</div>
+</div>
`
+ }
+ ],
+ donts: [
+ {
+ description: `You should not place anything between the checkbox controlling the modal dialog and the container.`,
+ sample: `
<inputtype="checkbox"id="modal-control"class="modal">
+<!-- Do not place other stuff between these -->
+<div>
+<divclass="card">
+<labelfor="modal-control"class="modal-close"></label>
+<h3class="section">Modal</h3>
+<pclass="section">This is a modal dialog!</p>
+</div>
+</div>
The navigation bar element has been minimally styled, allowing you to create simple vertical navigation menus for your web apps. Apart from styling from links, custom classes (.sublink-1 and .sublink-2) are provided for creating navigation trees.
`],
- notes: [`It is recommended that you combine the navigation bar element with the grid system to create responsive navigation menus for your web apps.`],
- customization: [
- `Text color for navigation bars can be changed by changing the value of the --nav-fore-color variable.`,
- `Background color for navigation bars can be changed by changing the value of the --nav-back-color variable.`,
- `Border color for navigation bars can be changed by changing the value of the --nav-border-color variable.`,
- `Background color for focused buttons inside navigation bars can be changed by changing the value of the --nav-hover-back-color variable.`,
- `Text color for links inside navigation bars can be changed by changing the value of the --nav-link-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [],
- dos: [],
- donts: []
-}
-
-/*
- Modifiers:
- {
- title : '',
- description: '',
- example: '',
- samples: []
- }
- Dos/Donts:
- {
- description: '',
- sample: ''
- }
-*/
+module.exports = {
+ id: 'navigation-bar',
+ title: 'Navigation bar',
+ keywords: [`navigation`, `bar`, `nav`, `link`],
+ description: `
The navigation bar element has been minimally styled, allowing you to create simple vertical navigation menus for your web apps. Apart from styling from links, custom classes (.sublink-1 and .sublink-2) are provided for creating navigation trees.
`],
+ notes: [`It is recommended that you combine the navigation bar element with the grid system to create responsive navigation menus for your web apps.`],
+ customization: [
+ `Text color for navigation bars can be changed by changing the value of the --nav-fore-color variable.`,
+ `Background color for navigation bars can be changed by changing the value of the --nav-back-color variable.`,
+ `Border color for navigation bars can be changed by changing the value of the --nav-border-color variable.`,
+ `Background color for focused buttons inside navigation bars can be changed by changing the value of the --nav-hover-back-color variable.`,
+ `Text color for links inside navigation bars can be changed by changing the value of the --nav-link-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
+
+/*
+ Modifiers:
+ {
+ title : '',
+ description: '',
+ example: '',
+ samples: []
+ }
+ Dos/Donts:
+ {
+ description: '',
+ sample: ''
+ }
+*/
diff --git a/docs/doc-fragments/progressBars.js b/docs/doc-fragments/progressBars.js
index 2a3b2d1..8e437b6 100644
--- a/docs/doc-fragments/progressBars.js
+++ b/docs/doc-fragments/progressBars.js
@@ -1,44 +1,44 @@
-module.exports = {
- id: 'progress-bars',
- title: 'Progress bars',
- keywords: [`progress`, `bar`, `primary`, `secondary`, `tertiary`, `inline`],
- description: `
Progress bars are minimally styled to match with the rest of the framework's aesthetics and be consistent across all modern browsers.
`,
- example: ``,
- samples: [`
<progressvalue="450"max="1000"></progress>
`],
- notes: [`Progress bars are designed to work with a max="1000" attribute, as this covers the most common use-cases.`],
- customization: [
- `Foreground color for progress bars can be changed by changing the value of the --progress-fore-color variable.`,
- `Background color for progress bars can be changed by changing the value of the --progress-back-color variable.`,
- `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : 'Inline progress bars',
- description: `
You can create inline progress bars (.inline), by applying the appropriate modifier.
`]
- }
- ],
- dos: [],
- donts: [
- {
- description: `Avoid using different values than 1000 for progress bars' max attribute, as well as floating point values for either max or value.`,
- sample: `
Progress bars are minimally styled to match with the rest of the framework's aesthetics and be consistent across all modern browsers.
`,
+ example: ``,
+ samples: [`
<progressvalue="450"max="1000"></progress>
`],
+ notes: [`Progress bars are designed to work with a max="1000" attribute, as this covers the most common use-cases.`],
+ customization: [
+ `Foreground color for progress bars can be changed by changing the value of the --progress-fore-color variable.`,
+ `Background color for progress bars can be changed by changing the value of the --progress-back-color variable.`,
+ `You can customize the colors of different color variants by changing the values of the related variables in their respective definitions.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Inline progress bars',
+ description: `
You can create inline progress bars (.inline), by applying the appropriate modifier.
`]
+ }
+ ],
+ dos: [],
+ donts: [
+ {
+ description: `Avoid using different values than 1000 for progress bars' max attribute, as well as floating point values for either max or value.`,
+ sample: `
`],
- notes: [
- 'Responsive spacing and sizing modifiers use !important declarations to override any other styles, so exercise caution when using them.',
- 'Responsive spacing and sizing modifiers are independent, meaning that hiding or visually hiding an element in one screen size will not affect its visibility in any other screen size.'
- ],
- customization: [
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable, affecting the responsive spacing modifier. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable, affecting the responsive sizing modifier.`
-],
- modifiers: [],
- dos: [],
- donts: []
-}
+module.exports = {
+ id: 'responsive-spacing-sizing',
+ title: 'Responsive spacing & sizing',
+ keywords: ['responsiveness', 'margin', 'padding', 'responsive-margin', 'responsive-margin'],
+ description: '
You can make elements\' spacing or sizing responsive by applying the appropriate class (.responsive-margin or .responsive-padding).
`],
+ notes: [
+ 'Responsive spacing and sizing modifiers use !important declarations to override any other styles, so exercise caution when using them.',
+ 'Responsive spacing and sizing modifiers are independent, meaning that hiding or visually hiding an element in one screen size will not affect its visibility in any other screen size.'
+ ],
+ customization: [
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable, affecting the responsive spacing modifier. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable, affecting the responsive sizing modifier.`
+],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
diff --git a/docs/doc-fragments/spoilersAndAccordions.js b/docs/doc-fragments/spoilersAndAccordions.js
index 8a0d7f3..f3b8285 100644
--- a/docs/doc-fragments/spoilersAndAccordions.js
+++ b/docs/doc-fragments/spoilersAndAccordions.js
@@ -1,68 +1,68 @@
-module.exports = {
- id: 'spoilers-and-accordions',
- title: 'Spoilers & accordions',
- keywords: [`spoiler`, `collapse`, `accordion`, `contextual`, `vertical tabs`],
- description: `
mini.css provides you with accessible spoilers and accordions. They are composed of two components - the wrapper, the toggle button and the content container:
-
To create a collapsible spoiler, simply create a <div>, applying the appropriate class to it (.collapse). This serves as the wrapper for the collapsible spoiler.
-
Inside the wrapper, create a checkbox or radio input, immediately followed by a <label> for the checkbox. The former serves as your collapsible spoiler's control, while the latter is the toggle button for your collapsible spoiler.
-
Create a <div> right after the <label>. This will serve as the container for the collapsible content.
-
-
If you want to create an accordion, simply repeat the last two steps above for each section of the accordion. In order to make collapsible spoilers and accordions fully accessible, it is highly recommended to add the aria-hidden="true" attribute to all labels and inputs that control the behavior of these components.
`,
- example: `
This is the first section of the collapse
This is the second section of the collapse
-
This is the first section of the accordion
This is the second section of the accordion
`,
- samples: [`
<divclass="collapse">
-<inputtype="checkbox"id="collapse-section1"checkedaria-hidden="true">
-<labelfor="collapse-section1"aria-hidden="true">Collapse section 1</label>
-<div>
-<p>This is the first section of the collapse</p>
-</div>
-<inputtype="checkbox"id="collapse-section2"aria-hidden="true">
-<labelfor="collapse-section2"aria-hidden="true">Collapse section 2</label>
-<div>
-<p>This is the second section of the collapse</p>
-</div>
-</div>
`,
- `
<divclass="collapse">
-<inputtype="radio"id="accordion-section1"checkedaria-hidden="true"name="accordion">
-<labelfor="accordion-section1"aria-hidden="true">Accordion section 1</label>
-<div>
-<p>This is the first section of the accordion</p>
-</div>
-<inputtype="radio"id="accordion-section2"aria-hidden="true"name="accordion">
-<labelfor="accordion-section2"aria-hidden="true">Accordion section 2</label>
-<div>
-<p>This is the second section of the accordion</p>
-</div>
-</div>
`],
- notes: [
- `Make sure all the radio buttons in the same accordion have the same name.`,
- `If you want a collapsible spoiler or an accordion section to be expanded by default, you can add the checked attribute to the respective collapsible spooiler's or section's control.`,
- `The max-height of the content container is 400px.`,
- `Using the aria-hidden="true" attribute is highly recommended, as screen readers will ignore the controls of the collapsible spoiler or accordion and read all the contained content normally.`
- ],
- customization: [
- `Background color, text color and background color on hover for the collapsible spoiler's labels can be changed by changing the values of --collapse-label-back-color, --collapse-label-fore-color and --collapse-label-hover-back-color respectively.`,
- `Border color for the collapsible spoiler can be changed by changing the value of the --collapse-border-color.`,
- `Background color for the collapsible spoiler's content can be changed by changing the value of the --collapse-content-back-color.`,
- `Background color and border for the spoiler's content selected labels can be changed by changing the values of the --collapse-selected-label-back-color and --collapse-selected-label-border-color respectively.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [],
- dos: [],
- donts: [
- {
- description: `You should not place anything between the checkbox controlling the collapsible spoiler and its label or between the label and the content container.`,
- sample: `
<divclass="collapse">
-<inputtype="checkbox"id="collapse-section1"checkedaria-hidden="true">
-<!-- Do not place other stuff between these -->
-<labelfor="collapse-section1"aria-hidden="true">Collapse section 1</label>
-<!-- Do not place other stuff between these -->
-<div>
-<p>This is the first section of the collapse</p>
-</div>
-</div>
mini.css provides you with accessible spoilers and accordions. They are composed of two components - the wrapper, the toggle button and the content container:
+
To create a collapsible spoiler, simply create a <div>, applying the appropriate class to it (.collapse). This serves as the wrapper for the collapsible spoiler.
+
Inside the wrapper, create a checkbox or radio input, immediately followed by a <label> for the checkbox. The former serves as your collapsible spoiler's control, while the latter is the toggle button for your collapsible spoiler.
+
Create a <div> right after the <label>. This will serve as the container for the collapsible content.
+
+
If you want to create an accordion, simply repeat the last two steps above for each section of the accordion. In order to make collapsible spoilers and accordions fully accessible, it is highly recommended to add the aria-hidden="true" attribute to all labels and inputs that control the behavior of these components.
`,
+ example: `
This is the first section of the collapse
This is the second section of the collapse
+
This is the first section of the accordion
This is the second section of the accordion
`,
+ samples: [`
<divclass="collapse">
+<inputtype="checkbox"id="collapse-section1"checkedaria-hidden="true">
+<labelfor="collapse-section1"aria-hidden="true">Collapse section 1</label>
+<div>
+<p>This is the first section of the collapse</p>
+</div>
+<inputtype="checkbox"id="collapse-section2"aria-hidden="true">
+<labelfor="collapse-section2"aria-hidden="true">Collapse section 2</label>
+<div>
+<p>This is the second section of the collapse</p>
+</div>
+</div>
`,
+ `
<divclass="collapse">
+<inputtype="radio"id="accordion-section1"checkedaria-hidden="true"name="accordion">
+<labelfor="accordion-section1"aria-hidden="true">Accordion section 1</label>
+<div>
+<p>This is the first section of the accordion</p>
+</div>
+<inputtype="radio"id="accordion-section2"aria-hidden="true"name="accordion">
+<labelfor="accordion-section2"aria-hidden="true">Accordion section 2</label>
+<div>
+<p>This is the second section of the accordion</p>
+</div>
+</div>
`],
+ notes: [
+ `Make sure all the radio buttons in the same accordion have the same name.`,
+ `If you want a collapsible spoiler or an accordion section to be expanded by default, you can add the checked attribute to the respective collapsible spooiler's or section's control.`,
+ `The max-height of the content container is 400px.`,
+ `Using the aria-hidden="true" attribute is highly recommended, as screen readers will ignore the controls of the collapsible spoiler or accordion and read all the contained content normally.`
+ ],
+ customization: [
+ `Background color, text color and background color on hover for the collapsible spoiler's labels can be changed by changing the values of --collapse-label-back-color, --collapse-label-fore-color and --collapse-label-hover-back-color respectively.`,
+ `Border color for the collapsible spoiler can be changed by changing the value of the --collapse-border-color.`,
+ `Background color for the collapsible spoiler's content can be changed by changing the value of the --collapse-content-back-color.`,
+ `Background color and border for the spoiler's content selected labels can be changed by changing the values of the --collapse-selected-label-back-color and --collapse-selected-label-border-color respectively.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: [
+ {
+ description: `You should not place anything between the checkbox controlling the collapsible spoiler and its label or between the label and the content container.`,
+ sample: `
<divclass="collapse">
+<inputtype="checkbox"id="collapse-section1"checkedaria-hidden="true">
+<!-- Do not place other stuff between these -->
+<labelfor="collapse-section1"aria-hidden="true">Collapse section 1</label>
+<!-- Do not place other stuff between these -->
+<div>
+<p>This is the first section of the collapse</p>
+</div>
+</div>
Tables are styled in a minimal, modern and responsive manner, allowing users on all devices to easily browse tabular data, taking advantage of the Flexbox layout's capabilities. To make tabular data properly display on mobile devices, remember to specify a data-label attribute for each <> element (usually same as the heading of the column).
`],
- notes: [`Remember to always specify a data-label attribute for all of your <td> elements, otherwise they will not display properly on mobile.`,
- `Due to the way tables are displayed, the <tfoot> element is not supported.`,
- `Tables are vertically scrollable by default, with a max-height property of 400px.`],
- customization: [
- `Text color for <th> and <td> elements can be changed by changing the values of the --table-head-fore-color and --table-body-fore-color variables respectively.`,
- `Background color for <th> and <td> elements can be changed by changing the values of the --table-head-back-color and --table-body-back-color variables respectively.`,
- `Border color for tables can be changed by changing the value of the --table-border-color variable.`,
- `Border color for the separator between a table's heading and a table's body can be changed by changing the value of the --table-border-separator-color variable.`,
- `Alternative background color for <td> elements in striped tables can be changed by changing the value of the --table-body-alt-back-color variable.`,
- `Hover background color for <tr> elements in hoverable tables can be changed by changing the value of the --table-body-hover-back-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : 'Horizontal tables',
- description: `
You can create horizontal tables (.horizontal), by applying the appropriate class.
`]
- }
- ],
- dos: [],
- donts: [
- {
- description: `Avoid placing <td> elements in the <thead> of your tables, as well as placing <th> elements in the <tbody>.`,
- sample: `
Tables are styled in a minimal, modern and responsive manner, allowing users on all devices to easily browse tabular data, taking advantage of the Flexbox layout's capabilities. To make tabular data properly display on mobile devices, remember to specify a data-label attribute for each <> element (usually same as the heading of the column).
`],
+ notes: [`Remember to always specify a data-label attribute for all of your <td> elements, otherwise they will not display properly on mobile.`,
+ `Due to the way tables are displayed, the <tfoot> element is not supported.`,
+ `Tables are vertically scrollable by default, with a max-height property of 400px.`],
+ customization: [
+ `Text color for <th> and <td> elements can be changed by changing the values of the --table-head-fore-color and --table-body-fore-color variables respectively.`,
+ `Background color for <th> and <td> elements can be changed by changing the values of the --table-head-back-color and --table-body-back-color variables respectively.`,
+ `Border color for tables can be changed by changing the value of the --table-border-color variable.`,
+ `Border color for the separator between a table's heading and a table's body can be changed by changing the value of the --table-border-separator-color variable.`,
+ `Alternative background color for <td> elements in striped tables can be changed by changing the value of the --table-body-alt-back-color variable.`,
+ `Hover background color for <tr> elements in hoverable tables can be changed by changing the value of the --table-body-hover-back-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Horizontal tables',
+ description: `
You can create horizontal tables (.horizontal), by applying the appropriate class.
`]
+ }
+ ],
+ dos: [],
+ donts: [
+ {
+ description: `Avoid placing <td> elements in the <thead> of your tables, as well as placing <th> elements in the <tbody>.`,
+ sample: `
The native HTML5 mark element has been minimally styled to allow for easy text highlighting.
`,
- example: `
This is a paragraph with some highlighted text.
`,
- samples: [`
<p>This is some <mark>highlighted text</mark>.</p>
`],
- notes: [
- `Highlighted text scales according to its parent element, so it can be used inside any kind of element (headings, forms, paragraphs etc.).`
- ],
- customization: [
- `Text color for highlighted text can be changed by changing the value of the --mark-fore-color variable.`,
- `Background color for highlighted text can be changed by changing the value of the --mark-back-color variable.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : 'Color variants',
- description: '
You can change the color of highlighted text, based on context by applying the appropriate class (secondary - .secondary or tertiary - .tertiary).
',
- example: `
This is a secondary highlight and this is a tertiary highlight.
`,
- samples: [`
<p>This is a <markclass="secondary">secondary highlight</mark> and this is a <markclass="tertiary">tertiary highlight</mark>.</p>
You can make highlights look like tags (.tag) or display as inline blocks (.inline-block), by applying the appropriate class.
`,
- example: `
This is a highlight styled as a tag.
This is some highlighted text that is displayed as an inline block.
`,
- samples: [`
<p>This is a highlight styled as a <markclass="tag">tag</mark>.</p>
-<p><markclass="inline-block">This is some highlighted text that is displayed as an inline block.</mark></p>
`]
- }
- ],
- dos: [{
- description: `You can nest a highlight inside another one, if the outer one is displayed as an inline-block.`,
- sample: `
<markclass="inline-block"><markclass="secondary">Secondary highlight</mark> inside a inline block.</mark>
`
- }],
- donts: [
- {
- description: `Avoid applying multiple color modifiers on the same highlight.`,
- sample: `
The native HTML5 mark element has been minimally styled to allow for easy text highlighting.
`,
+ example: `
This is a paragraph with some highlighted text.
`,
+ samples: [`
<p>This is some <mark>highlighted text</mark>.</p>
`],
+ notes: [
+ `Highlighted text scales according to its parent element, so it can be used inside any kind of element (headings, forms, paragraphs etc.).`
+ ],
+ customization: [
+ `Text color for highlighted text can be changed by changing the value of the --mark-fore-color variable.`,
+ `Background color for highlighted text can be changed by changing the value of the --mark-back-color variable.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Color variants',
+ description: '
You can change the color of highlighted text, based on context by applying the appropriate class (secondary - .secondary or tertiary - .tertiary).
',
+ example: `
This is a secondary highlight and this is a tertiary highlight.
`,
+ samples: [`
<p>This is a <markclass="secondary">secondary highlight</mark> and this is a <markclass="tertiary">tertiary highlight</mark>.</p>
You can make highlights look like tags (.tag) or display as inline blocks (.inline-block), by applying the appropriate class.
`,
+ example: `
This is a highlight styled as a tag.
This is some highlighted text that is displayed as an inline block.
`,
+ samples: [`
<p>This is a highlight styled as a <markclass="tag">tag</mark>.</p>
+<p><markclass="inline-block">This is some highlighted text that is displayed as an inline block.</mark></p>
`]
+ }
+ ],
+ dos: [{
+ description: `You can nest a highlight inside another one, if the outer one is displayed as an inline-block.`,
+ sample: `
<markclass="inline-block"><markclass="secondary">Secondary highlight</mark> inside a inline block.</mark>
`
+ }],
+ donts: [
+ {
+ description: `Avoid applying multiple color modifiers on the same highlight.`,
+ sample: `
mini.css provides you with toast messages (.toast), allowing you to display native-looking notifications on mobile devices.
`,
- example: `
This is a toast message!
`,
- samples: [`
<spanclass="toast">This is a toast message!</span>
`],
- notes: [
- `Toast elements do not have any pre-defined behavior, but you can use Javascript to add functionality to them.`
- ],
- customization: [
- `Text color for toast messages can be changed by changing the value of the --toast-fore-color variable.`,
- `Background color for toast messages can be changed by changing the value of the --toast-back-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [],
- dos: [],
- donts: []
-}
+module.exports = {
+ id: 'toasts',
+ title: 'Toasts',
+ keywords: [`span`, `toast`, `mobile`, `contextual`, `message`],
+ description: `
mini.css provides you with toast messages (.toast), allowing you to display native-looking notifications on mobile devices.
`,
+ example: `
This is a toast message!
`,
+ samples: [`
<spanclass="toast">This is a toast message!</span>
`],
+ notes: [
+ `Toast elements do not have any pre-defined behavior, but you can use Javascript to add functionality to them.`
+ ],
+ customization: [
+ `Text color for toast messages can be changed by changing the value of the --toast-fore-color variable.`,
+ `Background color for toast messages can be changed by changing the value of the --toast-back-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [],
+ dos: [],
+ donts: []
+}
diff --git a/docs/doc-fragments/tooltips.js b/docs/doc-fragments/tooltips.js
index 062a9b7..a29e51a 100644
--- a/docs/doc-fragments/tooltips.js
+++ b/docs/doc-fragments/tooltips.js
@@ -1,28 +1,28 @@
-module.exports = {
- id: 'tooltips',
- title: 'Tooltips',
- keywords: [`tooltip`, `aria-label`, `contextual`, `bottom`, `span`],
- description: `
You can utilize the aria-label property to create accessible tooltips (.tooltip), allowing you to display explanatory text for different elements.
`,
- example: `
Hover over this text to see a tooltip!
`,
- samples: [`
<spanclass="tooltip"aria-label="Tooltip text">Hover over text to see tooltip</span>
`],
- notes: [
- `Tooltips depend on the aria-label property, so they are fully accessible on screen readers.`
- ],
- customization: [
- `Text color for tooltips can be changed by changing the value of the --tooltip-fore-color variable.`,
- `Background color for tooltips can be changed by changing the value of the --tooltip-back-color variable.`,
- `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
- `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
- `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
- ],
- modifiers: [
- {
- title : 'Position variant',
- description: '
You can make tooltips display below the related text, by adding the appropriate class (.bottom).
',
- example: `
Hover over this text to see a tooltip!
`,
- samples: [`
<spanclass="tooltip bottom"aria-label="Tooltip text">Hover over text to see tooltip</span>
You can utilize the aria-label property to create accessible tooltips (.tooltip), allowing you to display explanatory text for different elements.
`,
+ example: `
Hover over this text to see a tooltip!
`,
+ samples: [`
<spanclass="tooltip"aria-label="Tooltip text">Hover over text to see tooltip</span>
`],
+ notes: [
+ `Tooltips depend on the aria-label property, so they are fully accessible on screen readers.`
+ ],
+ customization: [
+ `Text color for tooltips can be changed by changing the value of the --tooltip-fore-color variable.`,
+ `Background color for tooltips can be changed by changing the value of the --tooltip-back-color variable.`,
+ `Universal margin for elements can be changed globally by changing the value of the --universal-margin variable. As a rule of thumb, consider the universal margin to be the distance you want your paragraphs to have from the sides of the screen.`,
+ `Universal padding for elements can be changed globally by changing the value of the --universal-padding variable.`,
+ `Universal border radius for elements can be changed globally by changing the value of the --universal-border-radius variable.`
+ ],
+ modifiers: [
+ {
+ title : 'Position variant',
+ description: '
You can make tooltips display below the related text, by adding the appropriate class (.bottom).
',
+ example: `
Hover over this text to see a tooltip!
`,
+ samples: [`
<spanclass="tooltip bottom"aria-label="Tooltip text">Hover over text to see tooltip</span>
You can use visibility helper classes to hide elements for all users (.hidden) or for users not on screen readers (.visually-hidden). There are also responsive visibility helpers provided, for hiding or visually hiding content only for specific screen sizes (.hidden-sm, .hidden-md, .hidden-lg and .visually-hidden-sm, .visually-hidden-md and .visually-hidden-lg respectively).
',
- example: '',
- samples: [`
<pclass="hidden">Not visible for any users.</p>
-<pclass="visually-hidden">Visible only for screen readers.</p>
-<pclass="hidden-sm">Not visible for users on screens under 768px wide.</p>
-<pclass="hidden-md">Not visible for users on screens 768px-1280px wide.</p>
-<pclass="hidden-lg">Not visible for users on screens wider than 1280px.</p>
-<pclass="visually-hidden-sm">Visible only for screen readers under 768px wide.</p>
-<pclass="visually-hidden-md">Visible only for screen readers 768px-1280px wide.</p>
-<pclass="visually-hidden-lg">Visible only for screen readers wider than 1280px.</p>
`],
- notes: [
- 'Visibility helpers use !important declarations to override any other styles, so exercise caution when using them.',
- 'The specific breakpoints for small, medium and large screen sizes are as follows:
small: less than 768px wide
medium: more than or equal to 768px wide and less than 1280px wide
large: 1280px wide or more
',
- 'Responsive visibility helper classes are independent, meaning that hiding or visually hiding an element in one screen size will not affect its visibility in any other screen size.'
- ],
- customization: [],
- modifiers: [],
- dos: [
- {
- description: `You can apply multiple responsive visibility helpers on the same element.`,
- sample: `
<pclass="hidden-sm hidden-md">Not visible for users on screens under 1280px wide.</p>
`
- }
- ],
- donts: [
- {
- description: `Avoid combining .hidden and .visually-hidden or responsive helpers for the same screen size.`,
- sample: `
<pclass="hidden visually-hidden">Do not do this.</p>
You can use visibility helper classes to hide elements for all users (.hidden) or for users not on screen readers (.visually-hidden). There are also responsive visibility helpers provided, for hiding or visually hiding content only for specific screen sizes (.hidden-sm, .hidden-md, .hidden-lg and .visually-hidden-sm, .visually-hidden-md and .visually-hidden-lg respectively).
',
+ example: '',
+ samples: [`
<pclass="hidden">Not visible for any users.</p>
+<pclass="visually-hidden">Visible only for screen readers.</p>
+<pclass="hidden-sm">Not visible for users on screens under 768px wide.</p>
+<pclass="hidden-md">Not visible for users on screens 768px-1280px wide.</p>
+<pclass="hidden-lg">Not visible for users on screens wider than 1280px.</p>
+<pclass="visually-hidden-sm">Visible only for screen readers under 768px wide.</p>
+<pclass="visually-hidden-md">Visible only for screen readers 768px-1280px wide.</p>
+<pclass="visually-hidden-lg">Visible only for screen readers wider than 1280px.</p>
`],
+ notes: [
+ 'Visibility helpers use !important declarations to override any other styles, so exercise caution when using them.',
+ 'The specific breakpoints for small, medium and large screen sizes are as follows:
small: less than 768px wide
medium: more than or equal to 768px wide and less than 1280px wide
large: 1280px wide or more
',
+ 'Responsive visibility helper classes are independent, meaning that hiding or visually hiding an element in one screen size will not affect its visibility in any other screen size.'
+ ],
+ customization: [],
+ modifiers: [],
+ dos: [
+ {
+ description: `You can apply multiple responsive visibility helpers on the same element.`,
+ sample: `
<pclass="hidden-sm hidden-md">Not visible for users on screens under 1280px wide.</p>
`
+ }
+ ],
+ donts: [
+ {
+ description: `Avoid combining .hidden and .visually-hidden or responsive helpers for the same screen size.`,
+ sample: `
<pclass="hidden visually-hidden">Do not do this.</p>
The contextual module provides you with simple tags, marks and highlights for your pages, allowing you to easily emphasize parts of your text. Contextual toasts, tooltips and modals are also provided, aiming to help deliver important information to users. HTML5 elements and simple rules are used in order to make important messages and pieces of content stand out easily.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Almost every website present on the web has some sort of content that needs highlighting in one way or another. The contextual module provides you with simple semantic text highlighting that utilises the <mark> HTML element. Apart from that, this module contains styles and definitions for a simple .toast container, that you can use to display toast messages on your websites and web apps. Toasts mimic the native application notifications of certain devices, making them mobile friendly. Finally, a simple accessible .tooltip implementation is included along with an implementation for .modal dialogs. All components in this module are fully accessible, so that's another thing not to worry about.
-
-
-
Quick start
-
To use the contextual module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
Apart from the primary highlight style, there are also secondary and tertiary styles for highlighting.
-
If you want to highlight a longer piece of text, without line breaks, you can turn the highlight into an inline-block like you see this piece of text being displayed.
-
Finally, you can create contextual tags like this or 7.
-
-
-
-
To add simple highlights in your text, you can use the <mark> HTML element. These highlights come pre-styled to use the default primary color, but if you would rather use another color for your highlight you can easily add the .secondary or .tertiary class to a <mark> element. For longer pieces of text that need highlighting, consider adding the .inline-block class to make them stand out even more. Finally, you can create contextual tags, using the .tag class.
Try to use elements with the .inline-block class only when absolutely necessary, as they break the normal text flow of the document. Avoid using this class on shorter pieces of text that span a few words and contain no line breaks.
-
<mark> elements, along with their supporting classes (except for .inline-block) can be easily used in paragraphs, headings and other elements, as they scale according to their parent element.
Do: You can only nest a <mark> inside another if the outer one is of the .inline-block class. You can color the inner <mark> using any of the contextual color classes or even make it a .tag. Be careful, however, to not make the inner <mark> an .inline-block as well.
Don't: Avoid using nested <mark> elements, unless the outer <mark> element is an .inline-block.
-
-
-
-
-
-
-
-
-
-
Toasts
-
-
-
- I'm a toast message!
- I'm a small toast message!
- I'm a large toast message!
-
-
-
-
Toasts aim to help bridge the gap between web and native applications on mobile devices, by displaying native-looking toast messages. To create a toast, wrap some text inside a <span> element with the .toast class. Toasts appear at the bottom of the screen on top of everything else. If you want to create smaller or larger toast messasges, you can add the .small or .large classes respectively.
-
Sample code
-
<span class="toast">This is a normal toast message!</span>
-<span class="toast small">This is a large toast message!</span>
-<span class="toast large">This is a small toast message!</span>
-
-
-
-
Notes
-
-
Toast elements do not have any pre-defined behavior. You should use your own Javascript code and interactive HTML elements to deal with showing and hiding them as necessary.
-
If you want to create your own color or size variants for toast messages, check out the customization page.
-
-
-
-
<span class="toast small large">Not a good toast</span>
-
Don't: Avoid combining two toast size variants, as this might cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Tooltips
-
-
-
-
Hover over this text to see a tooltip!
-
Hover over this text to see a reverse tooltip!
-
-
-
-
Tooltips can be used to convey context-sensitive information when the user hovers over some text. To create a tooltip, simply wrap the text you want users to hover over in an element with the .tooltip class (our choice is usually a <span> element, but your needs may differ) and add an aria-label in that element, setting its value to the content of your tooltip. Tooltips display at the top of the hovered text by default, so if you want to show them below the text, add the .bottom class to them.
-
Sample code
-
<span class="tooltip" aria-label="This is a tooltip">Hover over this text to see a tooltip!</span>
-<span class="tooltip bottom" aria-label="This is a tooltip">Hover over this text to see a reverse tooltip!</span>
-
-
-
-
Notes
-
-
Tooltips are built to be accessible and should display properly on screenreaders.
-
If you are not satisfied with the default tooltip colors, please check out the customization page for instuctions on how to create your own tooltip variants.
-
Remember to always add the aria-label attribute, otherwise your tooltip will not have any text to show.
-
-
-
-
-
-
-
-
-
Modals
-
-
-
-
-
-
-
-
-
Modal
-
-
This is a modal window!
-
-
-
-
-
-
-
-
Modal dialogs are pretty ease to make. Simply create an <input type="checkbox"> element, immediately followed by a <div> element with the .modal class. Inside this element, you can add a .card element with your modal dialog's contents. Remember to add a <label> element linked to your modal dialog's <input type="checkbox"> to let users close the dialog. You can also apply the .close class to a <label> element to display a close icon at the top right of the modal dialog.
You can use any styles you want from the card module to create different dialogs based on context (e.g. alerts, warnings etc.).
-
Remember to add a <label> linked to your modal dialog's <input type="checkbox"> or use Javascript to alter its state, otherwise users will not be able to close the dialog.
-
You can place your modal dialog anywhere on your page, as long as the structure is not altered. You can also toggle it from anywhere on a page.
The contextual module provides you with simple tags, marks and highlights for your pages, allowing you to easily emphasize parts of your text. Contextual toasts, tooltips and modals are also provided, aiming to help deliver important information to users. HTML5 elements and simple rules are used in order to make important messages and pieces of content stand out easily.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Almost every website present on the web has some sort of content that needs highlighting in one way or another. The contextual module provides you with simple semantic text highlighting that utilises the <mark> HTML element. Apart from that, this module contains styles and definitions for a simple .toast container, that you can use to display toast messages on your websites and web apps. Toasts mimic the native application notifications of certain devices, making them mobile friendly. Finally, a simple accessible .tooltip implementation is included along with an implementation for .modal dialogs. All components in this module are fully accessible, so that's another thing not to worry about.
+
+
+
Quick start
+
To use the contextual module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
Apart from the primary highlight style, there are also secondary and tertiary styles for highlighting.
+
If you want to highlight a longer piece of text, without line breaks, you can turn the highlight into an inline-block like you see this piece of text being displayed.
+
Finally, you can create contextual tags like this or 7.
+
+
+
+
To add simple highlights in your text, you can use the <mark> HTML element. These highlights come pre-styled to use the default primary color, but if you would rather use another color for your highlight you can easily add the .secondary or .tertiary class to a <mark> element. For longer pieces of text that need highlighting, consider adding the .inline-block class to make them stand out even more. Finally, you can create contextual tags, using the .tag class.
Try to use elements with the .inline-block class only when absolutely necessary, as they break the normal text flow of the document. Avoid using this class on shorter pieces of text that span a few words and contain no line breaks.
+
<mark> elements, along with their supporting classes (except for .inline-block) can be easily used in paragraphs, headings and other elements, as they scale according to their parent element.
Do: You can only nest a <mark> inside another if the outer one is of the .inline-block class. You can color the inner <mark> using any of the contextual color classes or even make it a .tag. Be careful, however, to not make the inner <mark> an .inline-block as well.
Don't: Avoid using nested <mark> elements, unless the outer <mark> element is an .inline-block.
+
+
+
+
+
+
+
+
+
+
Toasts
+
+
+
+ I'm a toast message!
+ I'm a small toast message!
+ I'm a large toast message!
+
+
+
+
Toasts aim to help bridge the gap between web and native applications on mobile devices, by displaying native-looking toast messages. To create a toast, wrap some text inside a <span> element with the .toast class. Toasts appear at the bottom of the screen on top of everything else. If you want to create smaller or larger toast messasges, you can add the .small or .large classes respectively.
+
Sample code
+
<span class="toast">This is a normal toast message!</span>
+<span class="toast small">This is a large toast message!</span>
+<span class="toast large">This is a small toast message!</span>
+
+
+
+
Notes
+
+
Toast elements do not have any pre-defined behavior. You should use your own Javascript code and interactive HTML elements to deal with showing and hiding them as necessary.
+
If you want to create your own color or size variants for toast messages, check out the customization page.
+
+
+
+
<span class="toast small large">Not a good toast</span>
+
Don't: Avoid combining two toast size variants, as this might cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Tooltips
+
+
+
+
Hover over this text to see a tooltip!
+
Hover over this text to see a reverse tooltip!
+
+
+
+
Tooltips can be used to convey context-sensitive information when the user hovers over some text. To create a tooltip, simply wrap the text you want users to hover over in an element with the .tooltip class (our choice is usually a <span> element, but your needs may differ) and add an aria-label in that element, setting its value to the content of your tooltip. Tooltips display at the top of the hovered text by default, so if you want to show them below the text, add the .bottom class to them.
+
Sample code
+
<span class="tooltip" aria-label="This is a tooltip">Hover over this text to see a tooltip!</span>
+<span class="tooltip bottom" aria-label="This is a tooltip">Hover over this text to see a reverse tooltip!</span>
+
+
+
+
Notes
+
+
Tooltips are built to be accessible and should display properly on screenreaders.
+
If you are not satisfied with the default tooltip colors, please check out the customization page for instuctions on how to create your own tooltip variants.
+
Remember to always add the aria-label attribute, otherwise your tooltip will not have any text to show.
+
+
+
+
+
+
+
+
+
Modals
+
+
+
+
+
+
+
+
+
Modal
+
+
This is a modal window!
+
+
+
+
+
+
+
+
Modal dialogs are pretty ease to make. Simply create an <input type="checkbox"> element, immediately followed by a <div> element with the .modal class. Inside this element, you can add a .card element with your modal dialog's contents. Remember to add a <label> element linked to your modal dialog's <input type="checkbox"> to let users close the dialog. You can also apply the .close class to a <label> element to display a close icon at the top right of the modal dialog.
You can use any styles you want from the card module to create different dialogs based on context (e.g. alerts, warnings etc.).
+
Remember to add a <label> linked to your modal dialog's <input type="checkbox"> or use Javascript to alter its state, otherwise users will not be able to close the dialog.
+
You can place your modal dialog anywhere on your page, as long as the structure is not altered. You can also toggle it from anywhere on a page.
The core module contains basic reset and fix rules, based on Normalize.css v5.0.0, along with lots of custom typography rules. Most textual HTML5 elements are styled by this module, so you can start writing your pages immediately without worrying about font families, weights, sizes, line heights, paddings and the like.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Before applying any typography and styling rules, some resets need to be applied to make sure that different elements display consistently on all browsers. The core module utilizes the ruleset of Normalize.css v5.0.0 to apply those much needed resets and fixes. However, to keep the framework small, we removed some rules that only help with legacy browser support and also tweaked a lot of the rules around to use customizable variables so no duplicate rules are applied, taking up unnecessary space. The typography rules in core deal with a page's basics, like fonts and styling of headings and paragraphs, horizontal rules, colors, margins, padding etc.
-
-
-
Quick start
-
To use the core module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
For the basic typography rules we did the following, along with other things presented below:
-
-
We use a native font stack to figure out the best font for your device.
-
We set the colors to background: #f8f8f8; and color: #212121;.
-
We use a font-size of 16px for the root element.
-
We set line-height to 1.5.
-
-
-
-
-
Notes
-
-
Fluid typography is also included, but not enabled by default. If you want to try it out, check out the out the customization page.
-
-
-
-
-
-
-
-
-
Headings
-
-
-
Heading 1Subheading
-
Heading 2Subheading
-
Heading 3Subheading
-
Heading 4Subheading
-
Heading 5Subheading
-
Heading 6Subheading
-
-
-
All six of the HTML headings (<h1> - <h6>) are styled with simple rules, providing a clean base for your pages' headings. Apart from the headings themselves, complementary rules are provided for <small> elements inside headings, allowing you to define subheadings or explanatory text for those headings. These subheadings are stylized to display below the headings in smaller, lighter type.
This is a paragraph with some sample text. Did you know mini.css v2 is codenamed Fermion? No? Well, now you do! Oh, by the way, that was some Bold text and here is some text in Italics. Maybe you want to know what our inline elements look like. For example a link to the GitHub repository of mini.css looks like that! Neat, right? Maybe you want to see some inline code or some sample input. Oh, also small text is cool, along with its siblings: the subscripthi! and the superscripthello!. Finally, check out the horizontal rule, preformatted code block and quotation below.
-
function sum(num1, num2) {
- var num3 = num1 + num2;
- console.log('Result: ' + num3);
-}
-
This is some quoted text from elsewhere.
-
-
-
-
The most common HTML5 elements must be things like <p>aragraphs, bold (<strong>) & italics (<em>) text, links (<a>), horizontal rules (<hr>) and <small> text. These, along with a few others, are styled by default using clean, modern design to make your pages look cool and stand out from the rest of the internet.
-
Sample code
-
<p>This is a paragraph with some <strong>bold text</strong> and some <em>italics text</em>.</p>
-<a href="#">This is a link.</a>
-<small>This is some small text.</small>
-<sub>Subscript</sub>
-<sup>Superscript</sup>
-<code>Inline code</code>
-<kbd>Keyboard Input</kbd>
-<hr>
-<pre>This is some preformatted text.</pre>
-<blockquote cite="www.quotation.source">
- This is some quoted text from another website or person.
-</blockquote>
-
-
-
-
-
-
-
-
-
Lists
-
-
-
-
-
Apple
-
Orange
-
Strawberry
-
-
-
Wake up
-
Eat breakfast
-
Go to work
-
-
-
-
-
Lists are also very commonly used in websites and apps. We tweaked a few margins and paddings to save some space and make them align properly with the rest of the common HTML elements that we use, but both unordered lists (<ul>) and ordered lists (<ol>) are minimally pre-styled to make things a little bit easier for you.
Image elements (<img>) are responsive by default, without the need for any special classes or anything else. We made sure they will scale down as necessary to display properly on smaller devices, while keeping their original aspect ratio, but they will never scale up above their original size.
On a side note, if you want to add captions to images, you can use a <figcaption> element, while wrapping both the image and it inside a <figure>.
The core module contains basic reset and fix rules, based on Normalize.css v5.0.0, along with lots of custom typography rules. Most textual HTML5 elements are styled by this module, so you can start writing your pages immediately without worrying about font families, weights, sizes, line heights, paddings and the like.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Before applying any typography and styling rules, some resets need to be applied to make sure that different elements display consistently on all browsers. The core module utilizes the ruleset of Normalize.css v5.0.0 to apply those much needed resets and fixes. However, to keep the framework small, we removed some rules that only help with legacy browser support and also tweaked a lot of the rules around to use customizable variables so no duplicate rules are applied, taking up unnecessary space. The typography rules in core deal with a page's basics, like fonts and styling of headings and paragraphs, horizontal rules, colors, margins, padding etc.
+
+
+
Quick start
+
To use the core module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
For the basic typography rules we did the following, along with other things presented below:
+
+
We use a native font stack to figure out the best font for your device.
+
We set the colors to background: #f8f8f8; and color: #212121;.
+
We use a font-size of 16px for the root element.
+
We set line-height to 1.5.
+
+
+
+
+
Notes
+
+
Fluid typography is also included, but not enabled by default. If you want to try it out, check out the out the customization page.
+
+
+
+
+
+
+
+
+
Headings
+
+
+
Heading 1Subheading
+
Heading 2Subheading
+
Heading 3Subheading
+
Heading 4Subheading
+
Heading 5Subheading
+
Heading 6Subheading
+
+
+
All six of the HTML headings (<h1> - <h6>) are styled with simple rules, providing a clean base for your pages' headings. Apart from the headings themselves, complementary rules are provided for <small> elements inside headings, allowing you to define subheadings or explanatory text for those headings. These subheadings are stylized to display below the headings in smaller, lighter type.
This is a paragraph with some sample text. Did you know mini.css v2 is codenamed Fermion? No? Well, now you do! Oh, by the way, that was some Bold text and here is some text in Italics. Maybe you want to know what our inline elements look like. For example a link to the GitHub repository of mini.css looks like that! Neat, right? Maybe you want to see some inline code or some sample input. Oh, also small text is cool, along with its siblings: the subscripthi! and the superscripthello!. Finally, check out the horizontal rule, preformatted code block and quotation below.
+
function sum(num1, num2) {
+ var num3 = num1 + num2;
+ console.log('Result: ' + num3);
+}
+
This is some quoted text from elsewhere.
+
+
+
+
The most common HTML5 elements must be things like <p>aragraphs, bold (<strong>) & italics (<em>) text, links (<a>), horizontal rules (<hr>) and <small> text. These, along with a few others, are styled by default using clean, modern design to make your pages look cool and stand out from the rest of the internet.
+
Sample code
+
<p>This is a paragraph with some <strong>bold text</strong> and some <em>italics text</em>.</p>
+<a href="#">This is a link.</a>
+<small>This is some small text.</small>
+<sub>Subscript</sub>
+<sup>Superscript</sup>
+<code>Inline code</code>
+<kbd>Keyboard Input</kbd>
+<hr>
+<pre>This is some preformatted text.</pre>
+<blockquote cite="www.quotation.source">
+ This is some quoted text from another website or person.
+</blockquote>
+
+
+
+
+
+
+
+
+
Lists
+
+
+
+
+
Apple
+
Orange
+
Strawberry
+
+
+
Wake up
+
Eat breakfast
+
Go to work
+
+
+
+
+
Lists are also very commonly used in websites and apps. We tweaked a few margins and paddings to save some space and make them align properly with the rest of the common HTML elements that we use, but both unordered lists (<ul>) and ordered lists (<ol>) are minimally pre-styled to make things a little bit easier for you.
Image elements (<img>) are responsive by default, without the need for any special classes or anything else. We made sure they will scale down as necessary to display properly on smaller devices, while keeping their original aspect ratio, but they will never scale up above their original size.
On a side note, if you want to add captions to images, you can use a <figcaption> element, while wrapping both the image and it inside a <figure>.
One of the core ideas behind mini.css is its flavor system. A flavor is the final compiled stylesheet a website or web app uses. When you start using mini.css, you usually try out the default flavor, using one of the following references inside your HTML page's <head> tag:
The default flavor for mini.css uses a light gray background and gray-black foreground color. Certain containers, such as cards and tabs use white-gray backgrounds. The grid system has 12 columns and most of the components and modules use sharp corners and light border colors. All of the colors used in this flavor are loosely based on Google's Material design color palette.
The dark version of the default flavor, Dark uses a dark gray background with light gray foreground color. All modules are the same as in the default flavor, but with a dark palette, loosely based on Google's Material design color palette.
Lite is a light flavor that uses the default palette (light gray background and gray-black foreground color). It uses the default naming conventions (.primary, .secondary etc.). The grid system has 12 columns and most components use sharp corners without shadows. To make the flavor lighter, button groups, horizontal and vertical tables, certain card and progress styles, along with spinner donuts, tooltips, navigation bars, modals, drawers and toasts are not included.
Sucroa is a full flavor that uses a yellow-pink-lilac background color palette with dark purple-black foreground colors. It uses the default naming conventions (.primary, .secondary etc.). The grid system has 12 columns and most components use soft shadows combined with rounded corners. The card module's .dark and .darker classes have been replaced by the .light and .lighter classes respectively. Finally, the .shadowed class is replaced by varying degrees of generic shadows (.shadow-none, .shadow-small, .shadow-medium and .shadow-large).
Nord is a full flavor that uses the Nord color palette (arctic, north-bluish color palette). It uses the default naming conventions (.primary, .secondary etc.). The grid system has 12 columns and most components use soft shadows combined with rounded corners. All modules and components that are available in the default flavor are also available in Nord. Finally, the .shadowed class is replaced by varying degrees of generic shadows (.shadow-none, .shadow-small, .shadow-medium and .shadow-large).
The Progressive Web App flavor follows the Google Material Design Guidelines and targets mobile devices and especially those based on the Android operating system. It uses mostly the default naming conventions (.primary etc.). The grid system has 12 columns and most components use rounded corners with soft shadows. To make the flavor lighter, button groups, horizontal and vertical tables, certain card styles, the entirety of the progress and tab modules, along with tooltips, navigation bars, modals and most style variants are not included. Finally, the card module's .dark class has been replaced by the .accent class.
One of the core ideas behind mini.css is its flavor system. A flavor is the final compiled stylesheet a website or web app uses. When you start using mini.css, you usually try out the default flavor, using one of the following references inside your HTML page's <head> tag:
The default flavor for mini.css uses a light gray background and gray-black foreground color. Certain containers, such as cards and tabs use white-gray backgrounds. The grid system has 12 columns and most of the components and modules use sharp corners and light border colors. All of the colors used in this flavor are loosely based on Google's Material design color palette.
The dark version of the default flavor, Dark uses a dark gray background with light gray foreground color. All modules are the same as in the default flavor, but with a dark palette, loosely based on Google's Material design color palette.
Lite is a light flavor that uses the default palette (light gray background and gray-black foreground color). It uses the default naming conventions (.primary, .secondary etc.). The grid system has 12 columns and most components use sharp corners without shadows. To make the flavor lighter, button groups, horizontal and vertical tables, certain card and progress styles, along with spinner donuts, tooltips, navigation bars, modals, drawers and toasts are not included.
Sucroa is a full flavor that uses a yellow-pink-lilac background color palette with dark purple-black foreground colors. It uses the default naming conventions (.primary, .secondary etc.). The grid system has 12 columns and most components use soft shadows combined with rounded corners. The card module's .dark and .darker classes have been replaced by the .light and .lighter classes respectively. Finally, the .shadowed class is replaced by varying degrees of generic shadows (.shadow-none, .shadow-small, .shadow-medium and .shadow-large).
Nord is a full flavor that uses the Nord color palette (arctic, north-bluish color palette). It uses the default naming conventions (.primary, .secondary etc.). The grid system has 12 columns and most components use soft shadows combined with rounded corners. All modules and components that are available in the default flavor are also available in Nord. Finally, the .shadowed class is replaced by varying degrees of generic shadows (.shadow-none, .shadow-small, .shadow-medium and .shadow-large).
The Progressive Web App flavor follows the Google Material Design Guidelines and targets mobile devices and especially those based on the Android operating system. It uses mostly the default naming conventions (.primary etc.). The grid system has 12 columns and most components use rounded corners with soft shadows. To make the flavor lighter, button groups, horizontal and vertical tables, certain card styles, the entirety of the progress and tab modules, along with tooltips, navigation bars, modals and most style variants are not included. Finally, the card module's .dark class has been replaced by the .accent class.
The grid module provides you with a modern, responsive grid system based on the Flexible Layout Module (commonly known as flexbox). The structure of the grid is simple and logical, allowing you to quickly build your pages from scratch. Setting the layout for a page is easy and will behave the way you want them to on mobile devices and smaller screens.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Easy page layout is one of the main advantages of using a CSS framework over writing your own styles. The grid module utilizes the Flexbox Layout to provide you with a modern and responsive layout grid system for all your needs. Rules in the grid module help you create basic fluid containers for your grid and allow you to design layouts that work well on all screen sizes using a simple row and column structure. The grid system contains definitions for both fluid columns that resize according to their siblings and columns with preset sizes on different screen sizes, as well as rules that allow you to offset or move certain columns to the first or last place on the grid's row on different devices, helping you present the page in a different layout without duplicating any content. All of the rules in the module are built around accessibility, so screen readers can easily read you pages.
-
-
-
Quick start
-
To use the grid module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
The grid system's basic layout is composed of three components, presented below in the order they should be added to the DOM tree:
-
-
The grid's .container is the outermost layer of your grid system. It is a fluid container that wraps the flexible grid system inside it.
-
Inside the container, .rows are added to specify each row of the grid layout. Rows serve to provide you with a simple basis for your layout's columns.
-
Finally, inside the rows, .col- elements are added for the columns. The columns are a little bit more complex than the container and rows, as they are what makes the layout respond to changes. There are two basic ways to define a column for your layout:
-
-
using .col-SCR_SZ to specify fluid columns, replacing SCR_SZ with one of the available screen size names (sm for smaller screens, md for medium-sized screens or lg for larger screens).
-
using .col-SCR_SZ-COL_WD to specify columns with fixed width, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the column (1 meaning 1/12 of the width of the row and 12 meaning 100% of the width of the row).
-
-
-
-
Sample code
-
The sample code is a bit lengthy, so we hid it by default to make it easier for mobile device users to read this page. Click or tap on Show sample code below to see the code sample for this example. Also, the example presented showcases the grid system's syntax for smaller screens, but you can do the same thing for any screen size.
mini.css uses a mobile-first approach in its grid system. This means that specifying a layout for smaller device sizes will apply the same layout on medium-sized and larger screens, so you do not have to rewrite the same layout for all three screen sizes. However, if you want to change the layout on different screen sizes, check the section below.
-
The grid module is compatible with modern browsers, but might not display properly in older browsers.
-
The specific breakpoints for small, medium and large screen sizes are as follows:
-
-
small: less than 768px wide
-
medium: more than or equal to 768px wide but less than 1280px wide
-
large: 1280px wide or more
-
-
-
Fluid columns can be used for sizes that are not of the form 100%/12×X where X an integer value between 1 and 12. For example, if you have 7 .col-sm elements in one row, each of the elements will have a width of 1/7th the width of the row.
Don't: Avoid using columns inside columns without a row wrapping them. Either make the outer column a row in itself or wrap the inside columns in a row.
Do: A column can also be a row at the same time, if you want to include sub-columns inside it. You can make the same element both a column in its own row and a row for its containing columns. The same idea can be applied for the container. Containers can, however, be omitted, when already inside a grid.
-
-
-
-
<div class="row">
- <p>Content without columns...</p>
-</div>
-
Don't: Avoid using rows with content inside that is not wrapped in columns. Try to use a single .col-sm to wrap the content inside these, otherwise there might be unexpected behavior.
Do: Mix fluid columns with fixed, if you like. Fluid columns will adapt to the size of the container left for them. You can also use columns with a total size of more than 12, meaning with a total width of over 100%. The remaining content will flow below the rest, allowing you to specify multiple blocks of content inside the same row if you need to.
Don't: Avoid mixing rows and columns with normal content that is not wrapped on the respective level of the grid system. Always wrap content inside the proper containers (container, row or column) in your grid layout.
-
-
-
-
-
-
-
-
-
-
Screen-specific layouts
-
-
-
-
-
-
Small screen layout
-
-
-
-
-
-
Medium/Large screen layout
-
-
-
-
-
-
-
-
-
You can specify different layouts for your pages and web apps, using the grid system's columns. To do this add classes to your columns for different screen sizes, using either the fluid column syntax (.col-SCR_SZ) or the fixed width column syntax (.col-SCR_SZ-COL_WD) or even both.
Leaving a column's size unspecified for a resolution will use the style applied for the previous largest resolution recursively.
-
Changing the layout for different screen sizes can sometimes require complex content realignment, offsetting and reordering. For these features, check the sections below.
Do: You can radically change the layout of your content for different displays. Laying out your content vertically in .col-sm-12s for small devices and then compacting it to .col-md-6s for medium displays is pretty common. If your columns exceed a total size of 12 on some displays, they will wrap accordingly, so do not worry.
Don't: If you want to place two columns side by side on some displays, but not on others (e.g. placing them vertically on smaller displays, then next to each other on medium-sized or larger displays), place them in one row, not multiple, otherwise you will not achieve the desired effect.
Do: Specify only the screen-specific column sizes that you need. You can omit the medium-sized screens' size from a column if its layout on smaller screens is fluid or should be the same as in medium-sized displays. Or, if your larger screen layout is the same as your medium-sized screen layout, you can omit the class for the larger screen.
Don't: Never omit the class needed for the smallest screen size you have (.col-sm or .col-sm-COL_WD), otherwise the column's layout on smaller displays might behave unexpectedly. You can, however, omit layout for the other two screen sizes if you want.
-
-
-
-
-
-
-
-
-
-
Predefined layouts
-
-
-
Some simple grid layout problems can be solved using predefined layouts. To use a predefined layout, simply add a predefined layout class to a .row element. Predefined classes can be written using one of two syntaxes, similar to normal column classes:
-
-
fluid column layouts can be specified using .cols-SCR_SZ, replacing SCR_SZ with one of the available screen size names.
-
fixed width columns layouts can be specified using .col-SCR_SZ-COL_WD, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the columns.
Don't: Avoid using the normal column classes in conjunction with predefined layouts, as they will most likely not apply and can sometimes cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Column offsets
-
-
-
-
size = 8, offset = 2
-
size = 6, offset = 3
-
size = 4, offset = 4
-
-
size = 4, offset = 1
-
size = 4, offset = 2
-
-
-
-
-
If you want to move columns to the right, you can use the offset classes on your columns. Offset classes use the .col-SCR_SZ-offset-COL_WD syntax, where SCR_SZ is one of the available screen size names (sm, md or lg) and COL_WD a number from 0 to 11 specifying the width of the column's offset. Offsets can also be used in combination with screen-specific layouts and column sizes, providing you with greater flexibility when spacing out your content.
-
Sample code
-
The example presented below showcases the grid system's offsetting syntax for smaller screens, but you can do the same thing for any screen size.
Do: You can specify offset classes when you need them and omit them otherwise. This means that, if you want to offset a column only on a medium-sized or a larger screen, you can just specify the offset for that specific screen. Specifying an offset for a smaller screen, however, will apply it to medium-sized and larger screens as well, medium-sized screen offsets will apply to larger screens etc. similar to how the layout system works.
Do: To remove a previously applied offset from a column (i.e. one applied from the layout from a smaller screen size) or to make sure no offsets are active on a column, you can use the .col-SCR_SZ-offset-0 class, replacing SCR_SZ with the desired screen size, effectively resetting all offsets.
-
-
-
-
-
-
-
-
-
-
Column reordering
-
-
-
-
-
-
first
-
-
-
-
-
-
normal
-
-
-
-
-
-
-
last
-
-
-
-
-
Additionally, if you want to reorder your columns, you can do that to some extent using the .col-SCR_SZ-first, .col-SCR_SZ-last and .col-SCR_SZ-normal classes to your columns, replacing SCR_SZ with one of the available screen size names (sm, md or lg). These classes will change the ordering of your columns appropriately to allow you to move content around any way you want (e.g. moving a navigation sidebar from the left of the content on larger displays to the end of the content on smaller displays).
Columns are ordered by default in order of appearance. You should only apply column reordering classes to the columns you want to reorder on the screen-specific layouts you need them.
-
Remember to specify a basic layout and/or screen specific layouts in addition to the column reordering classes.
-
Column reordering is applied from smaller to larger screens, similar to how column layout and offsetting work.
Do: You can use multiple .col-SCR_SZ-firsts and .col-SCR_SZ-lasts, replacing SCR_SZ with the desired screen size, in the same row for the same screen size. If you specify more than one column to be first or last, the columns with the same order will be placed at the beggining or end of the row and the order between them will be determined based on their order of appearance in the DOM tree afterwards.
Do: To remove a previously applied reorder from a column (i.e. one applied from the layout from a smaller screen size) or to make sure no reordering is active on a column, you can use the .col-SCR_SZ-normal class, replacing SCR_SZ with the desired screen size, effectively resetting all reorders. You do not, however, need to add this class to all other columns or use it when there are no reorders applied.
-
-
-
-
-
-
-
-
-
-
Media object pattern
-
-
-
-
-
-
-
-
-
Media object heading
-
This is an example implementation of the popular media object pattern, using simple grid rules.
-
-
-
-
-
-
-
Last, but not least, you can use the grid system's classes to create a media object in one of many ways, based on your needs. The simplest way to implement a media object is using two columns, one for the media (i.e. <img>) and one for the textual content next to the media.
The media object is not a different component, but rather a popular pattern that can be implemented using the standard grid system classes.
-
You can use many different elements for your media object. For example, you can make the right side of the media object contain a form or an input field.
Do: You can align the media object's content to the left of the image (instead of the other way round), using the .col-SCR_SZ-normal class, replacing SCR_SZ with the desired screen size.
Don't: Do not apply a column class directly to the media element (e.g.<img>) or the content of the media object, as this can cause problems with certain elements. Wrap your media objects columns in <div> elements and apply the grid classes to them, instead.
-
-
-
-
-
-
-
-
-
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The grid module provides you with a modern, responsive grid system based on the Flexible Layout Module (commonly known as flexbox). The structure of the grid is simple and logical, allowing you to quickly build your pages from scratch. Setting the layout for a page is easy and will behave the way you want them to on mobile devices and smaller screens.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Easy page layout is one of the main advantages of using a CSS framework over writing your own styles. The grid module utilizes the Flexbox Layout to provide you with a modern and responsive layout grid system for all your needs. Rules in the grid module help you create basic fluid containers for your grid and allow you to design layouts that work well on all screen sizes using a simple row and column structure. The grid system contains definitions for both fluid columns that resize according to their siblings and columns with preset sizes on different screen sizes, as well as rules that allow you to offset or move certain columns to the first or last place on the grid's row on different devices, helping you present the page in a different layout without duplicating any content. All of the rules in the module are built around accessibility, so screen readers can easily read you pages.
+
+
+
Quick start
+
To use the grid module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
The grid system's basic layout is composed of three components, presented below in the order they should be added to the DOM tree:
+
+
The grid's .container is the outermost layer of your grid system. It is a fluid container that wraps the flexible grid system inside it.
+
Inside the container, .rows are added to specify each row of the grid layout. Rows serve to provide you with a simple basis for your layout's columns.
+
Finally, inside the rows, .col- elements are added for the columns. The columns are a little bit more complex than the container and rows, as they are what makes the layout respond to changes. There are two basic ways to define a column for your layout:
+
+
using .col-SCR_SZ to specify fluid columns, replacing SCR_SZ with one of the available screen size names (sm for smaller screens, md for medium-sized screens or lg for larger screens).
+
using .col-SCR_SZ-COL_WD to specify columns with fixed width, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the column (1 meaning 1/12 of the width of the row and 12 meaning 100% of the width of the row).
+
+
+
+
Sample code
+
The sample code is a bit lengthy, so we hid it by default to make it easier for mobile device users to read this page. Click or tap on Show sample code below to see the code sample for this example. Also, the example presented showcases the grid system's syntax for smaller screens, but you can do the same thing for any screen size.
mini.css uses a mobile-first approach in its grid system. This means that specifying a layout for smaller device sizes will apply the same layout on medium-sized and larger screens, so you do not have to rewrite the same layout for all three screen sizes. However, if you want to change the layout on different screen sizes, check the section below.
+
The grid module is compatible with modern browsers, but might not display properly in older browsers.
+
The specific breakpoints for small, medium and large screen sizes are as follows:
+
+
small: less than 768px wide
+
medium: more than or equal to 768px wide but less than 1280px wide
+
large: 1280px wide or more
+
+
+
Fluid columns can be used for sizes that are not of the form 100%/12×X where X an integer value between 1 and 12. For example, if you have 7 .col-sm elements in one row, each of the elements will have a width of 1/7th the width of the row.
Don't: Avoid using columns inside columns without a row wrapping them. Either make the outer column a row in itself or wrap the inside columns in a row.
Do: A column can also be a row at the same time, if you want to include sub-columns inside it. You can make the same element both a column in its own row and a row for its containing columns. The same idea can be applied for the container. Containers can, however, be omitted, when already inside a grid.
+
+
+
+
<div class="row">
+ <p>Content without columns...</p>
+</div>
+
Don't: Avoid using rows with content inside that is not wrapped in columns. Try to use a single .col-sm to wrap the content inside these, otherwise there might be unexpected behavior.
Do: Mix fluid columns with fixed, if you like. Fluid columns will adapt to the size of the container left for them. You can also use columns with a total size of more than 12, meaning with a total width of over 100%. The remaining content will flow below the rest, allowing you to specify multiple blocks of content inside the same row if you need to.
Don't: Avoid mixing rows and columns with normal content that is not wrapped on the respective level of the grid system. Always wrap content inside the proper containers (container, row or column) in your grid layout.
+
+
+
+
+
+
+
+
+
+
Screen-specific layouts
+
+
+
+
+
+
Small screen layout
+
+
+
+
+
+
Medium/Large screen layout
+
+
+
+
+
+
+
+
+
You can specify different layouts for your pages and web apps, using the grid system's columns. To do this add classes to your columns for different screen sizes, using either the fluid column syntax (.col-SCR_SZ) or the fixed width column syntax (.col-SCR_SZ-COL_WD) or even both.
Leaving a column's size unspecified for a resolution will use the style applied for the previous largest resolution recursively.
+
Changing the layout for different screen sizes can sometimes require complex content realignment, offsetting and reordering. For these features, check the sections below.
Do: You can radically change the layout of your content for different displays. Laying out your content vertically in .col-sm-12s for small devices and then compacting it to .col-md-6s for medium displays is pretty common. If your columns exceed a total size of 12 on some displays, they will wrap accordingly, so do not worry.
Don't: If you want to place two columns side by side on some displays, but not on others (e.g. placing them vertically on smaller displays, then next to each other on medium-sized or larger displays), place them in one row, not multiple, otherwise you will not achieve the desired effect.
Do: Specify only the screen-specific column sizes that you need. You can omit the medium-sized screens' size from a column if its layout on smaller screens is fluid or should be the same as in medium-sized displays. Or, if your larger screen layout is the same as your medium-sized screen layout, you can omit the class for the larger screen.
Don't: Never omit the class needed for the smallest screen size you have (.col-sm or .col-sm-COL_WD), otherwise the column's layout on smaller displays might behave unexpectedly. You can, however, omit layout for the other two screen sizes if you want.
+
+
+
+
+
+
+
+
+
+
Predefined layouts
+
+
+
Some simple grid layout problems can be solved using predefined layouts. To use a predefined layout, simply add a predefined layout class to a .row element. Predefined classes can be written using one of two syntaxes, similar to normal column classes:
+
+
fluid column layouts can be specified using .cols-SCR_SZ, replacing SCR_SZ with one of the available screen size names.
+
fixed width columns layouts can be specified using .col-SCR_SZ-COL_WD, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the columns.
Don't: Avoid using the normal column classes in conjunction with predefined layouts, as they will most likely not apply and can sometimes cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Column offsets
+
+
+
+
size = 8, offset = 2
+
size = 6, offset = 3
+
size = 4, offset = 4
+
+
size = 4, offset = 1
+
size = 4, offset = 2
+
+
+
+
+
If you want to move columns to the right, you can use the offset classes on your columns. Offset classes use the .col-SCR_SZ-offset-COL_WD syntax, where SCR_SZ is one of the available screen size names (sm, md or lg) and COL_WD a number from 0 to 11 specifying the width of the column's offset. Offsets can also be used in combination with screen-specific layouts and column sizes, providing you with greater flexibility when spacing out your content.
+
Sample code
+
The example presented below showcases the grid system's offsetting syntax for smaller screens, but you can do the same thing for any screen size.
Do: You can specify offset classes when you need them and omit them otherwise. This means that, if you want to offset a column only on a medium-sized or a larger screen, you can just specify the offset for that specific screen. Specifying an offset for a smaller screen, however, will apply it to medium-sized and larger screens as well, medium-sized screen offsets will apply to larger screens etc. similar to how the layout system works.
Do: To remove a previously applied offset from a column (i.e. one applied from the layout from a smaller screen size) or to make sure no offsets are active on a column, you can use the .col-SCR_SZ-offset-0 class, replacing SCR_SZ with the desired screen size, effectively resetting all offsets.
+
+
+
+
+
+
+
+
+
+
Column reordering
+
+
+
+
+
+
first
+
+
+
+
+
+
normal
+
+
+
+
+
+
+
last
+
+
+
+
+
Additionally, if you want to reorder your columns, you can do that to some extent using the .col-SCR_SZ-first, .col-SCR_SZ-last and .col-SCR_SZ-normal classes to your columns, replacing SCR_SZ with one of the available screen size names (sm, md or lg). These classes will change the ordering of your columns appropriately to allow you to move content around any way you want (e.g. moving a navigation sidebar from the left of the content on larger displays to the end of the content on smaller displays).
Columns are ordered by default in order of appearance. You should only apply column reordering classes to the columns you want to reorder on the screen-specific layouts you need them.
+
Remember to specify a basic layout and/or screen specific layouts in addition to the column reordering classes.
+
Column reordering is applied from smaller to larger screens, similar to how column layout and offsetting work.
Do: You can use multiple .col-SCR_SZ-firsts and .col-SCR_SZ-lasts, replacing SCR_SZ with the desired screen size, in the same row for the same screen size. If you specify more than one column to be first or last, the columns with the same order will be placed at the beggining or end of the row and the order between them will be determined based on their order of appearance in the DOM tree afterwards.
Do: To remove a previously applied reorder from a column (i.e. one applied from the layout from a smaller screen size) or to make sure no reordering is active on a column, you can use the .col-SCR_SZ-normal class, replacing SCR_SZ with the desired screen size, effectively resetting all reorders. You do not, however, need to add this class to all other columns or use it when there are no reorders applied.
+
+
+
+
+
+
+
+
+
+
Media object pattern
+
+
+
+
+
+
+
+
+
Media object heading
+
This is an example implementation of the popular media object pattern, using simple grid rules.
+
+
+
+
+
+
+
Last, but not least, you can use the grid system's classes to create a media object in one of many ways, based on your needs. The simplest way to implement a media object is using two columns, one for the media (i.e. <img>) and one for the textual content next to the media.
The media object is not a different component, but rather a popular pattern that can be implemented using the standard grid system classes.
+
You can use many different elements for your media object. For example, you can make the right side of the media object contain a form or an input field.
Do: You can align the media object's content to the left of the image (instead of the other way round), using the .col-SCR_SZ-normal class, replacing SCR_SZ with the desired screen size.
Don't: Do not apply a column class directly to the media element (e.g.<img>) or the content of the media object, as this can cause problems with certain elements. Wrap your media objects columns in <div> elements and apply the grid classes to them, instead.
+
+
+
+
+
+
+
+
+
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The input_control module contains rules that affect forms, input elements, buttons, checkboxes and radio buttons. All of these elements' styles are predefined, allowing you to create modern, responsive forms quickly. Layout alternatives are also provided if you want your forms to look a certain way.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
The presentation of forms, input fields, buttons and other interactive elements is always very important for any website or app. The input_control module provides you with much needed styling improvements for all of these elements, while keeping everything simple to use and understand, as well as combine with the other modules. Forms and input elements have a clean, modern design, while some elements like checkoxes and radio buttons get a much needed facelift. Buttons have also been stylized to look the same in all browsers, while keeping their design clean and allowing for a few color and size variants. Grouping inputs and labels or buttons is also part of this module and, as always, responsiveness is an important feature. Finally, all of the components are accessible, with a few minor caveats, that are discussed in their respective section in this page.
-
-
-
Quick start
-
To use the input_control module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
Forms are structured the same way you would structure a normal form in HTML5. Simply create a root <form> element and add your <input> elements inside. Link them to <label> elements for ease of access and you are pretty much set. We highly recommend using the <fieldset> and <legend> elements to annotate your forms as well, but you can skip them if you wish.
-
Forms are inline by default. Use the .input-group class on a <div> wrapping inside it an <input> and <label> pair to make sure they always display together in one line. You can make your .input-groups respond to viewport changes, by adding the .fluid class to them or you can align them vertically by adding the .vertical class. Finally, if you want to create aligned forms with a preset layout, you can utilize the grid module's rows and columns.
Using the <fieldset> and <legend> elements is highly recommended for a better presentational effect. Using these elements is a matter of personal preference, however try to keep your forms consistent (i.e. either use them in all forms or no forms as to not confuse users).
-
Some <input> elements, such as date & time, color and range types, are not supported and, as a result, do not have a default style defined for them. You can define said styles manually if you need to use them in your website or app.
-
Checkboxes and radio buttons are not stylized the same way as most of the other elements, nor do they follow the exact same stucture for layout. Please refer to the next section for information on how to use those.
-
Try not to combine the grid module's classes with .fluid or .vertical.input-groups, as this might cause certain styles to overlap and not display exactly like you want them to.
Do: You can use .row and .col-SCR_SZ or .col-SCR_SZ-COL_WD (replacing SCR_SZ with one of the available screen size names (sm for smaller screens, md for medium-sized screens or lg for larger screens and COL_WD with a number from 1 to 12 specifying the width of the column) to set specific layouts for your aligned forms. You can also use the same column classes to make them responsive for different screen sizes.
Do: Apart from using .row and .col-SCR_SZ or .col-SCR_SZ-COL_WD for responsiveness, you can also use other classes from the grid module such as the offset classes to make your form layouts more interesting.
Do: When creating aligned forms using the grid module's classes, labels might be off-center vertically compared to their inline counterparts. Use a simple styling for their parent .row element, if you want to adjust their vertical alignment.
Don't: Avoid using the .input-group class when creating aligned forms. This might cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Checkboxes & radio buttons
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Checkboxes and radio buttons come pre-styled, using the checkbox hack, while remaining fully accessible. To create a checkbox or radio button, start using a <div> that implements the .input-group class, and then add an <input> of the proper type inside it ("checkbox" or "radio"), followed immediately by a <label> linking to it. Remember to add tabindex="0" to your <input>, so that it will register properly for screen readers.
Do: You can add multiple radio buttons inside one .input-group, as long as they follow the syntax shown above. In fact, we strongly recommend grouping controls that are relevant to each other in this manner.
Don't: The structure of checkboxes and radio buttons is very strict, meaning that the <label> should always be after the <input> and never before, otherwise the checkbox or radio button will not display properly.
Don't: When using multiple radio buttons inside an .input-group, remember to use the usual structure of the radio button component for each radio button (i.e. the <input> and <label>). Not doing so will cause the radio buttons to not display properly.
Don't: Never leave a checkbox or radio button without a <label>. The <label> is essential to properly display the checkbox or radio button.
-
-
-
-
-
-
-
-
-
-
Switches
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Switches are almost identical in structure to checkboxes and radio buttons (an .input-group containing an <input> of the proper type inside it ("checkbox" or "radio"), followed immediately by a <label> linking to it), their only difference being that you need to add the .switch class to <label> element to turn your input into a switch. Remember to apply tabindex="0" to your <input> to make it accessible.
You can create your own color variants for the .switch component. For more information, check out the customization page.
-
-
-
-
<div class="input-group">
- <label for="switch1">Switch with text on its left</label>
- <input type="checkbox" id="switch1" tabindex="0">
- <label for="switch1" class="switch"></label>
-</div>
-
Do: By using two <label> elements, you can move the actual .switch to the right of the label's text, effectively allowing you to change the layout. Remember to not add any text to your second <label> that implements the .switch class. You might want, however, to add a few trailing spaces to the first <label> element to make sure the text does not get covered by the component.
-
-
-
-
-
-
-
-
-
-
Buttons & button groups
-
-
-
-
-
-
-
-
-
-
-
Button group
-
-
-
-
All button types have been stylized by default, while maintaining accessiblity. Simply add any <button> or an <input> with a button type (i.e. "button", "submit" or "reset") and they will be styled accordingly. You can also use the .button class or the role="button" attribute for links, labels and other elements of your choice to make them look like buttons.
-
Color variants are available in the form of the .primary, .secondary, .tertiary and .inverse classes. Size variants are available as well in the form of .small and .large classes.
-
Finally, you can create responsive groups of buttons by wrapping them inside a <div> with the .button-group class.
If you want more color or size variants for your buttons, check out the customization page.
-
The .button-group component is compatible with modern browsers, but might not display properly in older browsers.
-
.button-groups will display as a horizontal container with all their buttons in one row on medium-sized and larger displays, however they will collapse into a column view for smaller displays.
Don't: Avoid using button size variants inside a .button-group, as this might result in unexpected behavior.
-
-
-
-
-
-
-
-
-
-
File upload buttons
-
-
-
-
-
-
-
-
-
-
-
File upload buttons are commonly a sore spot in CSS frameworks. We try to remedy this problem by hiding the <input type="file">, while maintaining accessibility and using a linked <label> of the .button class to display it in a modern way.
The icon displayed in the example above is not part of the button styling.
-
File upload buttons do not change their text to the name of the file after the user has selected a file to upload. You can, however, add this functionality using a few lines of Javascript.
-
File upload buttons cannot be focused (i.e. have a :focus state) using the keyboard and this applies to linked labels, too. You can use Javascript to add this functionality, if you wish.
The input_control module contains rules that affect forms, input elements, buttons, checkboxes and radio buttons. All of these elements' styles are predefined, allowing you to create modern, responsive forms quickly. Layout alternatives are also provided if you want your forms to look a certain way.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
The presentation of forms, input fields, buttons and other interactive elements is always very important for any website or app. The input_control module provides you with much needed styling improvements for all of these elements, while keeping everything simple to use and understand, as well as combine with the other modules. Forms and input elements have a clean, modern design, while some elements like checkoxes and radio buttons get a much needed facelift. Buttons have also been stylized to look the same in all browsers, while keeping their design clean and allowing for a few color and size variants. Grouping inputs and labels or buttons is also part of this module and, as always, responsiveness is an important feature. Finally, all of the components are accessible, with a few minor caveats, that are discussed in their respective section in this page.
+
+
+
Quick start
+
To use the input_control module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
Forms are structured the same way you would structure a normal form in HTML5. Simply create a root <form> element and add your <input> elements inside. Link them to <label> elements for ease of access and you are pretty much set. We highly recommend using the <fieldset> and <legend> elements to annotate your forms as well, but you can skip them if you wish.
+
Forms are inline by default. Use the .input-group class on a <div> wrapping inside it an <input> and <label> pair to make sure they always display together in one line. You can make your .input-groups respond to viewport changes, by adding the .fluid class to them or you can align them vertically by adding the .vertical class. Finally, if you want to create aligned forms with a preset layout, you can utilize the grid module's rows and columns.
Using the <fieldset> and <legend> elements is highly recommended for a better presentational effect. Using these elements is a matter of personal preference, however try to keep your forms consistent (i.e. either use them in all forms or no forms as to not confuse users).
+
Some <input> elements, such as date & time, color and range types, are not supported and, as a result, do not have a default style defined for them. You can define said styles manually if you need to use them in your website or app.
+
Checkboxes and radio buttons are not stylized the same way as most of the other elements, nor do they follow the exact same stucture for layout. Please refer to the next section for information on how to use those.
+
Try not to combine the grid module's classes with .fluid or .vertical.input-groups, as this might cause certain styles to overlap and not display exactly like you want them to.
Do: You can use .row and .col-SCR_SZ or .col-SCR_SZ-COL_WD (replacing SCR_SZ with one of the available screen size names (sm for smaller screens, md for medium-sized screens or lg for larger screens and COL_WD with a number from 1 to 12 specifying the width of the column) to set specific layouts for your aligned forms. You can also use the same column classes to make them responsive for different screen sizes.
Do: Apart from using .row and .col-SCR_SZ or .col-SCR_SZ-COL_WD for responsiveness, you can also use other classes from the grid module such as the offset classes to make your form layouts more interesting.
Do: When creating aligned forms using the grid module's classes, labels might be off-center vertically compared to their inline counterparts. Use a simple styling for their parent .row element, if you want to adjust their vertical alignment.
Don't: Avoid using the .input-group class when creating aligned forms. This might cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Checkboxes & radio buttons
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Checkboxes and radio buttons come pre-styled, using the checkbox hack, while remaining fully accessible. To create a checkbox or radio button, start using a <div> that implements the .input-group class, and then add an <input> of the proper type inside it ("checkbox" or "radio"), followed immediately by a <label> linking to it. Remember to add tabindex="0" to your <input>, so that it will register properly for screen readers.
Do: You can add multiple radio buttons inside one .input-group, as long as they follow the syntax shown above. In fact, we strongly recommend grouping controls that are relevant to each other in this manner.
Don't: The structure of checkboxes and radio buttons is very strict, meaning that the <label> should always be after the <input> and never before, otherwise the checkbox or radio button will not display properly.
Don't: When using multiple radio buttons inside an .input-group, remember to use the usual structure of the radio button component for each radio button (i.e. the <input> and <label>). Not doing so will cause the radio buttons to not display properly.
Don't: Never leave a checkbox or radio button without a <label>. The <label> is essential to properly display the checkbox or radio button.
+
+
+
+
+
+
+
+
+
+
Switches
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Switches are almost identical in structure to checkboxes and radio buttons (an .input-group containing an <input> of the proper type inside it ("checkbox" or "radio"), followed immediately by a <label> linking to it), their only difference being that you need to add the .switch class to <label> element to turn your input into a switch. Remember to apply tabindex="0" to your <input> to make it accessible.
You can create your own color variants for the .switch component. For more information, check out the customization page.
+
+
+
+
<div class="input-group">
+ <label for="switch1">Switch with text on its left</label>
+ <input type="checkbox" id="switch1" tabindex="0">
+ <label for="switch1" class="switch"></label>
+</div>
+
Do: By using two <label> elements, you can move the actual .switch to the right of the label's text, effectively allowing you to change the layout. Remember to not add any text to your second <label> that implements the .switch class. You might want, however, to add a few trailing spaces to the first <label> element to make sure the text does not get covered by the component.
+
+
+
+
+
+
+
+
+
+
Buttons & button groups
+
+
+
+
+
+
+
+
+
+
+
Button group
+
+
+
+
All button types have been stylized by default, while maintaining accessiblity. Simply add any <button> or an <input> with a button type (i.e. "button", "submit" or "reset") and they will be styled accordingly. You can also use the .button class or the role="button" attribute for links, labels and other elements of your choice to make them look like buttons.
+
Color variants are available in the form of the .primary, .secondary, .tertiary and .inverse classes. Size variants are available as well in the form of .small and .large classes.
+
Finally, you can create responsive groups of buttons by wrapping them inside a <div> with the .button-group class.
If you want more color or size variants for your buttons, check out the customization page.
+
The .button-group component is compatible with modern browsers, but might not display properly in older browsers.
+
.button-groups will display as a horizontal container with all their buttons in one row on medium-sized and larger displays, however they will collapse into a column view for smaller displays.
Don't: Avoid using button size variants inside a .button-group, as this might result in unexpected behavior.
+
+
+
+
+
+
+
+
+
+
File upload buttons
+
+
+
+
+
+
+
+
+
+
+
File upload buttons are commonly a sore spot in CSS frameworks. We try to remedy this problem by hiding the <input type="file">, while maintaining accessibility and using a linked <label> of the .button class to display it in a modern way.
The icon displayed in the example above is not part of the button styling.
+
File upload buttons do not change their text to the name of the file after the user has selected a file to upload. You can, however, add this functionality using a few lines of Javascript.
+
File upload buttons cannot be focused (i.e. have a :focus state) using the keyboard and this applies to linked labels, too. You can use Javascript to add this functionality, if you wish.
mini.css uses modules as its base building blocks. Each module contains one or more components that affect the same part of the user experience. Below you can see a quick overview of all the modules that compose mini.css.
-
-
-
-
-
-
Core
-
The core module contains basic reset and fix rules, based on Normalize.css v5.0.0, along with lots of custom typography rules. Most textual HTML5 elements are styled by this module, so you can start writing your pages immediately without worrying about font families, weights, sizes, line heights, paddings and the like. More specifically, the core module contains:
The grid module provides you with a modern, responsive grid system based on the Flexible Layout Module (commonly known as flexbox). The structure of the grid is simple and logical, allowing you to quickly build your pages from scratch. Setting the layout for a page is easy and will behave the way you want them to on mobile devices and smaller screens. More specifically, the grid module contains:
The input_control module contains rules that affect forms, input elements, buttons, checkboxes and radio buttons. All of these elements's styles are predefined, allowing you to create modern, responsive forms quickly. Layout alternatives are also provided if you want your forms to look a certain way. More specifically, the input_control module contains:
The navigation module seeks to remedy the problems of vertical and horizontal navigation design paradigms, by combining the two for a better presentational effect. HTML5 navigational elements are at the heart of the module, allowing you to quickly build your navigation menus. More specifically, the navigation module contains:
The table module provides styling and responsiveness for tables. Simple rules and accessible design paradigms have been used to make creating tables quick and easy. Large tables will collapse to cards when on smaller devices or, if you don't want that, they can be locked into their default, desktop view. More specifically, the table module contains:
The card module provides you with modern, responsive, general-purpose containers for your page's contents. They are very easy to use and their structure is really simple and versatile. Layouts will respond to smaller screens, realigning the cards in a manner that makes your page mobile-friendly. More specifically, the card module contains:
The tab module aims to combine multiple components and design paradigms, like collapses, accordions, carousels and tabs, into one general-purpose component. Tabs are very simple in structure, responsive on mobile and they allow for layout customization so that you can turn them into accordions or collapses whenever you want. More specifically, the tab module contains:
The contextual module provides you with simple tags, marks and highlights for your pages, allowing you to easily emphasize parts of your text. Contextual toasts, tooltips and modals are also provided, aiming to help deliver important information to users. HTML5 elements and simple rules are used in order to make important messages and pieces of content stand out easily. More specifically, the contextual module contains:
The progress module gives you full control over the presentation of progress and loading on your pages. Apart from progress bars and color variants for them, spinner elements are provided to help communicate that something is loading. More specifically, the progress module contains:
The utility module contains all the utilities and helper classes that you might want when designing a website or application. They solve common design problems efficiently and provide you with generic rules you can easily apply everywhere. More specifically, the utility module contains:
mini.css uses modules as its base building blocks. Each module contains one or more components that affect the same part of the user experience. Below you can see a quick overview of all the modules that compose mini.css.
+
+
+
+
+
+
Core
+
The core module contains basic reset and fix rules, based on Normalize.css v5.0.0, along with lots of custom typography rules. Most textual HTML5 elements are styled by this module, so you can start writing your pages immediately without worrying about font families, weights, sizes, line heights, paddings and the like. More specifically, the core module contains:
The grid module provides you with a modern, responsive grid system based on the Flexible Layout Module (commonly known as flexbox). The structure of the grid is simple and logical, allowing you to quickly build your pages from scratch. Setting the layout for a page is easy and will behave the way you want them to on mobile devices and smaller screens. More specifically, the grid module contains:
The input_control module contains rules that affect forms, input elements, buttons, checkboxes and radio buttons. All of these elements's styles are predefined, allowing you to create modern, responsive forms quickly. Layout alternatives are also provided if you want your forms to look a certain way. More specifically, the input_control module contains:
The navigation module seeks to remedy the problems of vertical and horizontal navigation design paradigms, by combining the two for a better presentational effect. HTML5 navigational elements are at the heart of the module, allowing you to quickly build your navigation menus. More specifically, the navigation module contains:
The table module provides styling and responsiveness for tables. Simple rules and accessible design paradigms have been used to make creating tables quick and easy. Large tables will collapse to cards when on smaller devices or, if you don't want that, they can be locked into their default, desktop view. More specifically, the table module contains:
The card module provides you with modern, responsive, general-purpose containers for your page's contents. They are very easy to use and their structure is really simple and versatile. Layouts will respond to smaller screens, realigning the cards in a manner that makes your page mobile-friendly. More specifically, the card module contains:
The tab module aims to combine multiple components and design paradigms, like collapses, accordions, carousels and tabs, into one general-purpose component. Tabs are very simple in structure, responsive on mobile and they allow for layout customization so that you can turn them into accordions or collapses whenever you want. More specifically, the tab module contains:
The contextual module provides you with simple tags, marks and highlights for your pages, allowing you to easily emphasize parts of your text. Contextual toasts, tooltips and modals are also provided, aiming to help deliver important information to users. HTML5 elements and simple rules are used in order to make important messages and pieces of content stand out easily. More specifically, the contextual module contains:
The progress module gives you full control over the presentation of progress and loading on your pages. Apart from progress bars and color variants for them, spinner elements are provided to help communicate that something is loading. More specifically, the progress module contains:
The utility module contains all the utilities and helper classes that you might want when designing a website or application. They solve common design problems efficiently and provide you with generic rules you can easily apply everywhere. More specifically, the utility module contains:
The navigation module seeks to remedy the problems of vertical and horizontal navigation design paradigms, by combining the two for a better presentational effect. HTML5 navigational elements are at the heart of the module, allowing you to quickly build your navigation menus.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Menus and navigation are some of the most important elements for any website or web app and their design and ease-of-use are key factors that can determine a page's bounce rates. The navigation module takes a step back from the complicated menu and navigation design paradigms of the modern web, using HTML5 elements (i.e. header, nav and footer) for basic navigation, while providing fully accessibility for screen readers. Apart from the simple horizontal navigation (headers) and vertical menus (sidebars), we opted to add a responsive slide-in drawer menu that works well with any page layout. Finally, footers are also part of the navigation module, as they can often provide the user with useful information and/or links that are very important to enhancing their experience.
-
-
-
Quick start
-
To use the navigation module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
The <header> HTML element is used for a page's top horizontal navigation menu. It can contain a unique .logo element as its first child (this structure is not mandatory, but still recommended as a best practice), which can be either text (with or without a link) or an image. The rest of the elements inside the <header> must be button elements (i.e. <button>, <input type="button">, role="button" or .button) in order to be styled properly. Textual separators between those can be added using <span> elements.
The <header> element is partially responsive on smaller screen devices. More specifically, when the content inside it exceeds the width of the viewport (ie. overflows to the right), users will be able to scroll horizontally in order to see the rest of the menu.
-
The <header> element does not display as fixed by default. You can, however, alter this CSS property manually, if you so desire.
Don't: The .logo element should not be a <button> element, have the .button class or the role="button" attribute. On the other hand, links and labels in the <header> should not be without a .button class or a role="button" attribute. Ignoring this rule might cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Navigation bar
-
-
-
-
-
-
-
-
To add vertical navigation to your websites, use the <nav> HTML element. Adding links is pretty simple, just use <a> elements, no lists or anything else required. In order to add subcategories to your vertical navigation, use any normal textual element as the title of the subcategory and follow it with its links as normal, adding the .sublink-1 class to them. Similarly, you can create a subcategory with a depth of 2, using a similar structure and the .sublink-2 class.
Subcategories and their links support a depth of 2 by default. If, however, you need more than that, we recommend you check the customization page for instructions on how to add more depth to the vertical navigation.
-
We strongly suggest you do not add irrelevant things inside your <nav> element, like images or text that are not part of the navigation menu.
Do: We strongly recommend using the <nav> element in combination with the grid module to make your layouts more responsive. For example, you could make your sidebar appear on the left side of your content in medium-sized and larger screens, but move to the very bottom of your content on smaller screens.
-
-
-
-
-
-
-
-
-
-
Drawer
-
-
-
-
-
-
-
-
-
-
The drawer component is used to create responsive and collapsible navigation menus. To create the drawer system, follow the steps presented below:
-
-
Inside your <header> element, add a <label> element with the .drawer-toggle class (remember to add the .button class to apply the necessary styles).
-
Create an <input type="checkbox"> element. Give it an id to be able to link it to the necessary interactive elements.
-
Immediately after the previous <input type="checkbox">, create a <div> element with the .drawer class. This is where you will put your menu's contents.
-
Add an empty <label> element inside your .drawer, adding the .close class to it.
-
Finally, link the .drawer-toggle and .close elements to the id of your <input type="checkbox">.
-
-
Drawers are responsive and will expand into normal containers on larger screens. If you want to avoid this, add the .persistent class to both your .drawer-toggle and .drawer elements. You can also change the position of the drawer from the left side of the screen to the right by applying the .right class to your .drawer element.
The .drawer component can be easily and effectively combined with the grid module's system and classes, as well as the utility module's responsive visibility helper classes to create fully responsive navigation menus.
-
It's best to use the .drawer component in combination with a <header> element that has the .sticky class (check the last section of this page).
Do: You can combine the .drawer component with the grid system, similarly to any other element or component. The .drawer will be displayed as a slide-in menu on smaller screens, but it's part of the layout on medium-sized and larger screens.
Don't: Remember to apply the .persistent class to the .drawer-toggle and .drawer elements to avoid unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Footer
-
-
-
-
-
-
-
-
The <footer> element is used to create your page's footer. As normal, add the <footer> at or near the end of your <body> element and add content to it like you would otherwise.
Sticky headers and footers are compatible with modern browsers, but might not display properly in older browsers. Support is being added over time, so be sure to check out if your target platforms support position:sticky.
-
-
-
-
-
-
-
-
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The navigation module seeks to remedy the problems of vertical and horizontal navigation design paradigms, by combining the two for a better presentational effect. HTML5 navigational elements are at the heart of the module, allowing you to quickly build your navigation menus.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Menus and navigation are some of the most important elements for any website or web app and their design and ease-of-use are key factors that can determine a page's bounce rates. The navigation module takes a step back from the complicated menu and navigation design paradigms of the modern web, using HTML5 elements (i.e. header, nav and footer) for basic navigation, while providing fully accessibility for screen readers. Apart from the simple horizontal navigation (headers) and vertical menus (sidebars), we opted to add a responsive slide-in drawer menu that works well with any page layout. Finally, footers are also part of the navigation module, as they can often provide the user with useful information and/or links that are very important to enhancing their experience.
+
+
+
Quick start
+
To use the navigation module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
The <header> HTML element is used for a page's top horizontal navigation menu. It can contain a unique .logo element as its first child (this structure is not mandatory, but still recommended as a best practice), which can be either text (with or without a link) or an image. The rest of the elements inside the <header> must be button elements (i.e. <button>, <input type="button">, role="button" or .button) in order to be styled properly. Textual separators between those can be added using <span> elements.
The <header> element is partially responsive on smaller screen devices. More specifically, when the content inside it exceeds the width of the viewport (ie. overflows to the right), users will be able to scroll horizontally in order to see the rest of the menu.
+
The <header> element does not display as fixed by default. You can, however, alter this CSS property manually, if you so desire.
Don't: The .logo element should not be a <button> element, have the .button class or the role="button" attribute. On the other hand, links and labels in the <header> should not be without a .button class or a role="button" attribute. Ignoring this rule might cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Navigation bar
+
+
+
+
+
+
+
+
To add vertical navigation to your websites, use the <nav> HTML element. Adding links is pretty simple, just use <a> elements, no lists or anything else required. In order to add subcategories to your vertical navigation, use any normal textual element as the title of the subcategory and follow it with its links as normal, adding the .sublink-1 class to them. Similarly, you can create a subcategory with a depth of 2, using a similar structure and the .sublink-2 class.
Subcategories and their links support a depth of 2 by default. If, however, you need more than that, we recommend you check the customization page for instructions on how to add more depth to the vertical navigation.
+
We strongly suggest you do not add irrelevant things inside your <nav> element, like images or text that are not part of the navigation menu.
Do: We strongly recommend using the <nav> element in combination with the grid module to make your layouts more responsive. For example, you could make your sidebar appear on the left side of your content in medium-sized and larger screens, but move to the very bottom of your content on smaller screens.
+
+
+
+
+
+
+
+
+
+
Drawer
+
+
+
+
+
+
+
+
+
+
The drawer component is used to create responsive and collapsible navigation menus. To create the drawer system, follow the steps presented below:
+
+
Inside your <header> element, add a <label> element with the .drawer-toggle class (remember to add the .button class to apply the necessary styles).
+
Create an <input type="checkbox"> element. Give it an id to be able to link it to the necessary interactive elements.
+
Immediately after the previous <input type="checkbox">, create a <div> element with the .drawer class. This is where you will put your menu's contents.
+
Add an empty <label> element inside your .drawer, adding the .close class to it.
+
Finally, link the .drawer-toggle and .close elements to the id of your <input type="checkbox">.
+
+
Drawers are responsive and will expand into normal containers on larger screens. If you want to avoid this, add the .persistent class to both your .drawer-toggle and .drawer elements. You can also change the position of the drawer from the left side of the screen to the right by applying the .right class to your .drawer element.
The .drawer component can be easily and effectively combined with the grid module's system and classes, as well as the utility module's responsive visibility helper classes to create fully responsive navigation menus.
+
It's best to use the .drawer component in combination with a <header> element that has the .sticky class (check the last section of this page).
Do: You can combine the .drawer component with the grid system, similarly to any other element or component. The .drawer will be displayed as a slide-in menu on smaller screens, but it's part of the layout on medium-sized and larger screens.
Don't: Remember to apply the .persistent class to the .drawer-toggle and .drawer elements to avoid unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Footer
+
+
+
+
+
+
+
+
The <footer> element is used to create your page's footer. As normal, add the <footer> at or near the end of your <body> element and add content to it like you would otherwise.
Sticky headers and footers are compatible with modern browsers, but might not display properly in older browsers. Support is being added over time, so be sure to check out if your target platforms support position:sticky.
+
+
+
+
+
+
+
+
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The progress module gives you full control over the presentation of progress and loading on your pages. Apart from progress bars and color variants for them, spinner elements are provided to help communicate that something is loading.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Progress indicators are very common UI elements for almost any website and web app, as they help communicate vital information such as the fact that a process is being executed in the background, informing the user that they should wait for it to complete before proceeding. The progress module provides you with two essential tools to communicate this information: the <progress> HTML element, which is pre-styled and compatible with modern browsers to help you communicate information about the percentage of a task and the .spinner-donut class that allows you to create an animated spinner that communicates that something is loading currently and will continue doing so for an indefinite amount of time. Both elements come with their own color and size variants and are fully accessible.
-
-
-
Quick start
-
To use the progress module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
To create a progress bar, use the <progress> HTML element, specify the preset maximum of max="1000" and set a value between 0 and 1000. Update your <progress> element using some Javascript code, by changing its value to any integer in the same range.
We made sure that the <progress> element displays properly on all modern browsers, using browser-specific rules. However, there might be some irregularities with older browsers, especially legacy versions of Internet Explorer.
-
If the preset max="1000" does not suit your needs, you should check the customization page for instructions on how to set your own maximum value for the <progress> element.
-
-
-
-
<progress value="80" max="100"></progress>
-
Don't: Avoid using different values for the <progress> element's max, except for the preset one (1000).
-
-
-
<progress value="450.5" max="1000.0"></progress>
-
Don't: Try not to use floating point values for either the <progress> element's value or max. During testing of the module, we found that floating point values could cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Progress bar variants
-
-
-
Secondary process is 60% complete!
-
Tertiary process is 30% complete!
-
Inline progress bar:
-
-
-
Apart from the default style for the <progress> element, we have also included a couple of variants for it. As with many other elements, you can change the color of your progress bars, based on the context, using the .secondary or .tertiary class. You can also make a <progress> element display inline, using the .inline class.
Don't: Avoid mixing two classes of the same type (i.e. two color classes or two size classes).
-
-
-
-
-
-
-
-
-
-
Donut spinner
-
-
-
-
-
-
-
-
Donut spinners can be used to indicate that something is loading or that a process is running in the background. To create a donut spinner, add the .spinner-donut class to an element of your liking. We would recommend using a <div> element for most cases, but <span> elements should work pretty well, too.
-
Sample code
-
<div class="spinner-donut"></div>
-
-
-
-
Notes
-
-
The .spinner-donut is an animated component, meaning that if a browsers does not support animation, this element might display incorrectly.
-
In certain cases, it might be useful to add the role="progressbar" attribute to increase donut spinner accessibility.
Do: You can place a .spinner-donut inside a paragraph or some other textual context and it will display inline.
-
-
-
<div class="spinner-donut">Loading...</div>
-
Don't: Avoid inserting text inside the .spinner-donut, as this might cause unexpected bahavior and will probably make the text spin along with it.
-
-
-
-
-
-
-
-
-
-
Donut spinner variants
-
-
-
-
-
-
-
-
Apart from the default donut spinner style, there are also two more contextual color classes: .secondary and .tertiary. If your donut spinners are too small, you can also use the .large class to make it pop out a little bit more.
The progress module gives you full control over the presentation of progress and loading on your pages. Apart from progress bars and color variants for them, spinner elements are provided to help communicate that something is loading.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Progress indicators are very common UI elements for almost any website and web app, as they help communicate vital information such as the fact that a process is being executed in the background, informing the user that they should wait for it to complete before proceeding. The progress module provides you with two essential tools to communicate this information: the <progress> HTML element, which is pre-styled and compatible with modern browsers to help you communicate information about the percentage of a task and the .spinner-donut class that allows you to create an animated spinner that communicates that something is loading currently and will continue doing so for an indefinite amount of time. Both elements come with their own color and size variants and are fully accessible.
+
+
+
Quick start
+
To use the progress module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
To create a progress bar, use the <progress> HTML element, specify the preset maximum of max="1000" and set a value between 0 and 1000. Update your <progress> element using some Javascript code, by changing its value to any integer in the same range.
We made sure that the <progress> element displays properly on all modern browsers, using browser-specific rules. However, there might be some irregularities with older browsers, especially legacy versions of Internet Explorer.
+
If the preset max="1000" does not suit your needs, you should check the customization page for instructions on how to set your own maximum value for the <progress> element.
+
+
+
+
<progress value="80" max="100"></progress>
+
Don't: Avoid using different values for the <progress> element's max, except for the preset one (1000).
+
+
+
<progress value="450.5" max="1000.0"></progress>
+
Don't: Try not to use floating point values for either the <progress> element's value or max. During testing of the module, we found that floating point values could cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Progress bar variants
+
+
+
Secondary process is 60% complete!
+
Tertiary process is 30% complete!
+
Inline progress bar:
+
+
+
Apart from the default style for the <progress> element, we have also included a couple of variants for it. As with many other elements, you can change the color of your progress bars, based on the context, using the .secondary or .tertiary class. You can also make a <progress> element display inline, using the .inline class.
Don't: Avoid mixing two classes of the same type (i.e. two color classes or two size classes).
+
+
+
+
+
+
+
+
+
+
Donut spinner
+
+
+
+
+
+
+
+
Donut spinners can be used to indicate that something is loading or that a process is running in the background. To create a donut spinner, add the .spinner-donut class to an element of your liking. We would recommend using a <div> element for most cases, but <span> elements should work pretty well, too.
+
Sample code
+
<div class="spinner-donut"></div>
+
+
+
+
Notes
+
+
The .spinner-donut is an animated component, meaning that if a browsers does not support animation, this element might display incorrectly.
+
In certain cases, it might be useful to add the role="progressbar" attribute to increase donut spinner accessibility.
Do: You can place a .spinner-donut inside a paragraph or some other textual context and it will display inline.
+
+
+
<div class="spinner-donut">Loading...</div>
+
Don't: Avoid inserting text inside the .spinner-donut, as this might cause unexpected bahavior and will probably make the text spin along with it.
+
+
+
+
+
+
+
+
+
+
Donut spinner variants
+
+
+
+
+
+
+
+
Apart from the default donut spinner style, there are also two more contextual color classes: .secondary and .tertiary. If your donut spinners are too small, you can also use the .large class to make it pop out a little bit more.
If you are familiar with mini.css and want a cheat sheet, you've come to the right place. Below you will find a quick overview of the framework and examples to help you brush up on your website-building skills. For more detailed instructions on modules, check out the modules page.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
Setup & usage
-
-
You can download mini.css using npm, yarn or Bower:
-
-
npm installmini.css
-
yarn addmini.css
-
bower installmini.css
-
-
You can import the default flavor of mini.css in your webpage by simply adding one of the following references inside your HTML page's <head> tag:
<p>This is a paragraph with some <strong>bold text</strong> and some <em>italics text</em>.</p>
-<a href="#">This is a link.</a>
-<small>This is some small text.</small>
-<sub>Subscript</sub>
-<sup>Superscript</sup>
-<code>Inline code</code>
-<kbd>Keyboard Input</kbd>
-<hr>
-<pre>This is some preformatted text.</pre>
-<blockquote cite="Quotation source">
- This is some quoted text from another website or person.
-</blockquote>
Available both as fluid column layouts, using .cols-SCR_SZ, replacing SCR_SZ with one of the available screen size names and fixed width column layouts, using .col-SCR_SZ-COL_WD, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the columns
-
Can define screen-specific predefined layouts
-
Can be combined with offsets and reordering, but not normal grid layout classes
Use the same structure as checkboxes and radios, add .switch to the <label> element
-
Add tabindex="0" to the <input> element for accessibility
-
You can add two <label> elements inside the .input-group, the first one containing the text and the second one the .switch component to reverse the switch's layout
<label> element with the .drawer-toggle class in the <header> element, linked to the id of the <input type="checkbox"> used to toggle the drawer component
-
<input type="checkbox"> element with a unique id
-
<div> element with the .drawer class immediately after the <input type="checkbox">
-
Empty <label> element with the .close class inside the .drawer, linked to the id of the <input type="checkbox">
-
-
Drawers are left-aligned and expand on non-mobile screen sizes by default
-
Use .right to create right-aligned drawers or .persistent for non-responsive drawers.
-
Apply the .drawer class on a navigation bar and combine with grid classes for best results
-
Use the syntax exactly as presented in the examples, do not add elements between the checkbox and the container
<span class="toast">This is a normal toast message!</span>
-<span class="toast small">This is a large toast message!</span>
-<span class="toast large">This is a small toast message!</span>
-
-
-
Notes
-
-
Use the .toast class on <span> elements to create toast messages
-
Size variants available using the .small and .large classes
-
Toasts have no pre-defined behavior, use Javascript
-
Toasts display at the bottom of the screen on top of everything else
<span class="tooltip" aria-label="This is a tooltip">Hover over this text to see a tooltip!</span>
-<span class="tooltip bottom" aria-label="This is a tooltip">Hover over this text to see a reverse tooltip!</span>
-
-
-
Notes
-
-
Create using the .tooltip class
-
Put tooltip text in the aria-label attribute's value
-
Use the .bottom class to make a tooltip display at the bottom of its context
If you are familiar with mini.css and want a cheat sheet, you've come to the right place. Below you will find a quick overview of the framework and examples to help you brush up on your website-building skills. For more detailed instructions on modules, check out the modules page.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
Setup & usage
-
-
You can download mini.css using npm, yarn or Bower:
-
-
npm installmini.css
-
yarn addmini.css
-
bower installmini.css
-
-
You can import the default flavor of mini.css in your webpage by simply adding one of the following references inside your HTML page's <head> tag:
<p>This is a paragraph with some <strong>bold text</strong> and some <em>italics text</em>.</p>
-<a href="#">This is a link.</a>
-<small>This is some small text.</small>
-<sub>Subscript</sub>
-<sup>Superscript</sup>
-<code>Inline code</code>
-<kbd>Keyboard Input</kbd>
-<hr>
-<pre>This is some preformatted text.</pre>
-<blockquote cite="Quotation source">
- This is some quoted text from another website or person.
-</blockquote>
Available both as fluid column layouts, using .cols-SCR_SZ, replacing SCR_SZ with one of the available screen size names and fixed width column layouts, using .col-SCR_SZ-COL_WD, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the columns
-
Can define screen-specific predefined layouts
-
Can be combined with offsets and reordering, but not normal grid layout classes
Use the same structure as checkboxes and radios, add .switch to the <label> element
-
Add tabindex="0" to the <input> element for accessibility
-
You can add two <label> elements inside the .input-group, the first one containing the text and the second one the .switch component to reverse the switch's layout
<label> element with the .drawer-toggle class in the <header> element, linked to the id of the <input type="checkbox"> used to toggle the drawer component
-
<input type="checkbox"> element with a unique id
-
<div> element with the .drawer class immediately after the <input type="checkbox">
-
Empty <label> element with the .close class inside the .drawer, linked to the id of the <input type="checkbox">
-
-
Drawers are left-aligned and expand on non-mobile screen sizes by default
-
Use .right to create right-aligned drawers or .persistent for non-responsive drawers.
-
Apply the .drawer class on a navigation bar and combine with grid classes for best results
-
Use the syntax exactly as presented in the examples, do not add elements between the checkbox and the container
<span class="toast">This is a normal toast message!</span>
-<span class="toast small">This is a large toast message!</span>
-<span class="toast large">This is a small toast message!</span>
-
-
-
Notes
-
-
Use the .toast class on <span> elements to create toast messages
-
Size variants available using the .small and .large classes
-
Toasts have no pre-defined behavior, use Javascript
-
Toasts display at the bottom of the screen on top of everything else
<span class="tooltip" aria-label="This is a tooltip">Hover over this text to see a tooltip!</span>
-<span class="tooltip bottom" aria-label="This is a tooltip">Hover over this text to see a reverse tooltip!</span>
-
-
-
Notes
-
-
Create using the .tooltip class
-
Put tooltip text in the aria-label attribute's value
-
Use the .bottom class to make a tooltip display at the bottom of its context
If you are familiar with mini.css and want a cheat sheet, you've come to the right place. Below you will find a quick overview of the framework and examples to help you brush up on your website-building skills. For more detailed instructions on modules, check out the modules page.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
Setup & usage
+
+
You can download mini.css using npm, yarn or Bower:
+
+
npm installmini.css
+
yarn addmini.css
+
bower installmini.css
+
+
You can import the default flavor of mini.css in your webpage by simply adding one of the following references inside your HTML page's <head> tag:
<p>This is a paragraph with some <strong>bold text</strong> and some <em>italics text</em>.</p>
+<a href="#">This is a link.</a>
+<small>This is some small text.</small>
+<sub>Subscript</sub>
+<sup>Superscript</sup>
+<code>Inline code</code>
+<kbd>Keyboard Input</kbd>
+<hr>
+<pre>This is some preformatted text.</pre>
+<blockquote cite="Quotation source">
+ This is some quoted text from another website or person.
+</blockquote>
Available both as fluid column layouts, using .cols-SCR_SZ, replacing SCR_SZ with one of the available screen size names and fixed width column layouts, using .col-SCR_SZ-COL_WD, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the columns
+
Can define screen-specific predefined layouts
+
Can be combined with offsets and reordering, but not normal grid layout classes
Use the same structure as checkboxes and radios, add .switch to the <label> element
+
Add tabindex="0" to the <input> element for accessibility
+
You can add two <label> elements inside the .input-group, the first one containing the text and the second one the .switch component to reverse the switch's layout
<label> element with the .drawer-toggle class in the <header> element, linked to the id of the <input type="checkbox"> used to toggle the drawer component
+
<input type="checkbox"> element with a unique id
+
<div> element with the .drawer class immediately after the <input type="checkbox">
+
Empty <label> element with the .close class inside the .drawer, linked to the id of the <input type="checkbox">
+
+
Drawers are left-aligned and expand on non-mobile screen sizes by default
+
Use .right to create right-aligned drawers or .persistent for non-responsive drawers.
+
Apply the .drawer class on a navigation bar and combine with grid classes for best results
+
Use the syntax exactly as presented in the examples, do not add elements between the checkbox and the container
<span class="toast">This is a normal toast message!</span>
+<span class="toast small">This is a large toast message!</span>
+<span class="toast large">This is a small toast message!</span>
+
+
+
Notes
+
+
Use the .toast class on <span> elements to create toast messages
+
Size variants available using the .small and .large classes
+
Toasts have no pre-defined behavior, use Javascript
+
Toasts display at the bottom of the screen on top of everything else
<span class="tooltip" aria-label="This is a tooltip">Hover over this text to see a tooltip!</span>
+<span class="tooltip bottom" aria-label="This is a tooltip">Hover over this text to see a reverse tooltip!</span>
+
+
+
Notes
+
+
Create using the .tooltip class
+
Put tooltip text in the aria-label attribute's value
+
Use the .bottom class to make a tooltip display at the bottom of its context
If you are familiar with mini.css and want a cheat sheet, you've come to the right place. Below you will find a quick overview of the framework and examples to help you brush up on your website-building skills. For more detailed instructions on modules, check out the modules page.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
Setup & usage
+
+
You can download mini.css using npm, yarn or Bower:
+
+
npm installmini.css
+
yarn addmini.css
+
bower installmini.css
+
+
You can import the default flavor of mini.css in your webpage by simply adding one of the following references inside your HTML page's <head> tag:
<p>This is a paragraph with some <strong>bold text</strong> and some <em>italics text</em>.</p>
+<a href="#">This is a link.</a>
+<small>This is some small text.</small>
+<sub>Subscript</sub>
+<sup>Superscript</sup>
+<code>Inline code</code>
+<kbd>Keyboard Input</kbd>
+<hr>
+<pre>This is some preformatted text.</pre>
+<blockquote cite="Quotation source">
+ This is some quoted text from another website or person.
+</blockquote>
Available both as fluid column layouts, using .cols-SCR_SZ, replacing SCR_SZ with one of the available screen size names and fixed width column layouts, using .col-SCR_SZ-COL_WD, replacing SCR_SZ with one of the available screen size names and COL_WD with a number from 1 to 12 specifying the width of the columns
+
Can define screen-specific predefined layouts
+
Can be combined with offsets and reordering, but not normal grid layout classes
Use the same structure as checkboxes and radios, add .switch to the <label> element
+
Add tabindex="0" to the <input> element for accessibility
+
You can add two <label> elements inside the .input-group, the first one containing the text and the second one the .switch component to reverse the switch's layout
<label> element with the .drawer-toggle class in the <header> element, linked to the id of the <input type="checkbox"> used to toggle the drawer component
+
<input type="checkbox"> element with a unique id
+
<div> element with the .drawer class immediately after the <input type="checkbox">
+
Empty <label> element with the .close class inside the .drawer, linked to the id of the <input type="checkbox">
+
+
Drawers are left-aligned and expand on non-mobile screen sizes by default
+
Use .right to create right-aligned drawers or .persistent for non-responsive drawers.
+
Apply the .drawer class on a navigation bar and combine with grid classes for best results
+
Use the syntax exactly as presented in the examples, do not add elements between the checkbox and the container
<span class="toast">This is a normal toast message!</span>
+<span class="toast small">This is a large toast message!</span>
+<span class="toast large">This is a small toast message!</span>
+
+
+
Notes
+
+
Use the .toast class on <span> elements to create toast messages
+
Size variants available using the .small and .large classes
+
Toasts have no pre-defined behavior, use Javascript
+
Toasts display at the bottom of the screen on top of everything else
<span class="tooltip" aria-label="This is a tooltip">Hover over this text to see a tooltip!</span>
+<span class="tooltip bottom" aria-label="This is a tooltip">Hover over this text to see a reverse tooltip!</span>
+
+
+
Notes
+
+
Create using the .tooltip class
+
Put tooltip text in the aria-label attribute's value
+
Use the .bottom class to make a tooltip display at the bottom of its context
The tab module aims to combine multiple components and design paradigms, like collapses, accordions, carousels and tabs, into one general-purpose component. Tabs are very simple in structure, responsive on mobile and they allow for layout customization so that you can turn them into accordions or collapses whenever you want.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Spoilers, collapses, accordions, tabs, carousels have been a staple of modern design for quite a long time. All of these elements are implemented using the tab module's single generic container. The tab container replaces all of these design paradigms with one component that is very flexible and responsive in order to let you present your website or app's content any way you like. Tabbed navigation is very easy to implement, while collapse, accordion and carousel components use the stacked architecture of tabs. As usual, the tab container is responsive and accessible, allowing you to deliver your content properly to all devices and users.
-
-
-
Quick start
-
To use the tab module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
The tab container's basic syntax is composed of two components, presented below in the order they should be added to the DOM tree:
-
-
At the outermost level of the tab container is a <div> element implementing the .tabs class. This serves as the wrapper of the tab container.
-
Inside the .tabs container, add a set of the following three elements for each tab:
-
-
First, add an <input type="radio"> element. Give it a name and an id in order to be able to link to it and group it with the rest of the radio buttons in the container.
-
Follow the <input> element with a <label> element linking to it. Inside this element, add the text you want to be shown as the title of your tab.
-
Finally, add a <div> immediately after the <label>'s closing tag. This will be the panel that contains the tab's content. Inside this element, you can add all the content you want in your tab (headings, images, text).
-
-
-
-
Tabs are responsive and will collapse into a stacked display on smaller screens, allowing the user to view the actual content more easily. The tab container's syntax is accessible, but parts of it might confuse screen readers, so we suggest adding the aria-hidden="true" attribute to all the <input> and <label> elements inside the .tabs container.
-
Sample code
-
<div class="tabs">
- <input type="radio" name="tab-group" id="tab1" checked aria-hidden="true">
- <label for="tab1" aria-hidden="true">Tab 1</label>
- <div>
- <h3>Tab 1</h3>
- <p>This is the first tab's content.</p>
- </div>
- <input type="radio" name="tab-group" id="tab2" aria-hidden="true">
- <label for="tab2" aria-hidden="true">Tab 2</label>
- <div>
- <h3>Tab 2</h3>
- <p>This is the second tab's content.</p>
- </div>
- <input type="radio" name="tab-group" id="tab3" aria-hidden="true">
- <label for="tab3" aria-hidden="true">Tab 3</label>
- <div>
- <h3>Tab 3</h3>
- <p>This is the third tab's content.</p>
- </div>
-</div>
-
-
-
-
Notes
-
-
Tabs are compatible with modern browsers, but might not display properly in older browsers.
-
Remember to add the checked attribute to one of your <input>s if you want that tab to be the one displayed by default. If none is specified, the first one will be displayed.
-
The height of the tab container's panel area is 400px. If you want to change this default size, please check out the customization page.
-
Using the method described above for making tabs accessible, screen readers will ignore tab controls and only read the content of tabs.
Don't: Do not use checkboxes inside the default .tabs container, otherwise you might notice unexpected behavior. If you want to use an <input type="checkbox">, check out the next section.
Don't: You can add a single tab in a .tabs container, but what use would that be? You should probably read the next section to see what you can do with a stacked tab container instead.
Don't: Remember to use the aria-hidden="true" attribute to make your tabs fully accessible.
-
-
-
-
-
-
-
-
-
-
Stacked tabs
-
-
-
-
-
-
Section 1
This is the first accordion section's content.
-
-
-
Section 2
This is the second accordion section's content.
-
-
-
-
-
This is the first collapse section's content.
-
-
-
This is the second collapse section's content.
-
-
-
-
Apart from the normal tab layout, you can make your tabs stacked instead, using the .stacked class in your .tabs container element. Stacked tabs are more versatile, allowing you to use checkboxes and/or radio buttons to implement collapses, accordions and spoilers. Carousel-styled elements can also be displayed in this fashion, if you wish. Remember to use the aria-hidden="true" attribute to make your tabs fully accessible, as before.
-
Sample code
-
<div class="tabs stacked">
- <input type="radio" name="accordion" id="a1" checked aria-hidden="true">
- <label for="a1" aria-hidden="true">Accordion section 1</label>
- <div>
- <h3>Section 1</h3>
- <p>This is the first accordion section's content.</p>
- </div>
- <input type="radio" name="accordion" id="a2"aria-hidden="true">
- <label for="a2" aria-hidden="true">Accordion section 2</label>
- <div>
- <h3>Section 2</h3>
- <p>This is the second accordion section's content.</p>
- </div>
-</div>
-
-<div class="tabs stacked">
- <input type="checkbox" id="c1" aria-hidden="true">
- <label for="c1" aria-hidden="true">Collapse section 1</label>
- <div>
- <p>This is the first collapse section's content.</p>
- </div>
- <input type="checkbox" id="c2" aria-hidden="true">
- <label for="c2" aria-hidden="true">Collapse section 2</label>
- <div>
- <p>This is the second collapse section's content.</p>
- </div>
-</div>
-
-
-
-
Notes
-
-
.stacked tabs can be used with either checkboxes or radio buttons.
-
You can mix and match checkboxes and radio buttons, but we suggest you do not do so, unless you think it is necessary for your design.
The tab module aims to combine multiple components and design paradigms, like collapses, accordions, carousels and tabs, into one general-purpose component. Tabs are very simple in structure, responsive on mobile and they allow for layout customization so that you can turn them into accordions or collapses whenever you want.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Spoilers, collapses, accordions, tabs, carousels have been a staple of modern design for quite a long time. All of these elements are implemented using the tab module's single generic container. The tab container replaces all of these design paradigms with one component that is very flexible and responsive in order to let you present your website or app's content any way you like. Tabbed navigation is very easy to implement, while collapse, accordion and carousel components use the stacked architecture of tabs. As usual, the tab container is responsive and accessible, allowing you to deliver your content properly to all devices and users.
+
+
+
Quick start
+
To use the tab module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
The tab container's basic syntax is composed of two components, presented below in the order they should be added to the DOM tree:
+
+
At the outermost level of the tab container is a <div> element implementing the .tabs class. This serves as the wrapper of the tab container.
+
Inside the .tabs container, add a set of the following three elements for each tab:
+
+
First, add an <input type="radio"> element. Give it a name and an id in order to be able to link to it and group it with the rest of the radio buttons in the container.
+
Follow the <input> element with a <label> element linking to it. Inside this element, add the text you want to be shown as the title of your tab.
+
Finally, add a <div> immediately after the <label>'s closing tag. This will be the panel that contains the tab's content. Inside this element, you can add all the content you want in your tab (headings, images, text).
+
+
+
+
Tabs are responsive and will collapse into a stacked display on smaller screens, allowing the user to view the actual content more easily. The tab container's syntax is accessible, but parts of it might confuse screen readers, so we suggest adding the aria-hidden="true" attribute to all the <input> and <label> elements inside the .tabs container.
+
Sample code
+
<div class="tabs">
+ <input type="radio" name="tab-group" id="tab1" checked aria-hidden="true">
+ <label for="tab1" aria-hidden="true">Tab 1</label>
+ <div>
+ <h3>Tab 1</h3>
+ <p>This is the first tab's content.</p>
+ </div>
+ <input type="radio" name="tab-group" id="tab2" aria-hidden="true">
+ <label for="tab2" aria-hidden="true">Tab 2</label>
+ <div>
+ <h3>Tab 2</h3>
+ <p>This is the second tab's content.</p>
+ </div>
+ <input type="radio" name="tab-group" id="tab3" aria-hidden="true">
+ <label for="tab3" aria-hidden="true">Tab 3</label>
+ <div>
+ <h3>Tab 3</h3>
+ <p>This is the third tab's content.</p>
+ </div>
+</div>
+
+
+
+
Notes
+
+
Tabs are compatible with modern browsers, but might not display properly in older browsers.
+
Remember to add the checked attribute to one of your <input>s if you want that tab to be the one displayed by default. If none is specified, the first one will be displayed.
+
The height of the tab container's panel area is 400px. If you want to change this default size, please check out the customization page.
+
Using the method described above for making tabs accessible, screen readers will ignore tab controls and only read the content of tabs.
Don't: Do not use checkboxes inside the default .tabs container, otherwise you might notice unexpected behavior. If you want to use an <input type="checkbox">, check out the next section.
Don't: You can add a single tab in a .tabs container, but what use would that be? You should probably read the next section to see what you can do with a stacked tab container instead.
Don't: Remember to use the aria-hidden="true" attribute to make your tabs fully accessible.
+
+
+
+
+
+
+
+
+
+
Stacked tabs
+
+
+
+
+
+
Section 1
This is the first accordion section's content.
+
+
+
Section 2
This is the second accordion section's content.
+
+
+
+
+
This is the first collapse section's content.
+
+
+
This is the second collapse section's content.
+
+
+
+
Apart from the normal tab layout, you can make your tabs stacked instead, using the .stacked class in your .tabs container element. Stacked tabs are more versatile, allowing you to use checkboxes and/or radio buttons to implement collapses, accordions and spoilers. Carousel-styled elements can also be displayed in this fashion, if you wish. Remember to use the aria-hidden="true" attribute to make your tabs fully accessible, as before.
+
Sample code
+
<div class="tabs stacked">
+ <input type="radio" name="accordion" id="a1" checked aria-hidden="true">
+ <label for="a1" aria-hidden="true">Accordion section 1</label>
+ <div>
+ <h3>Section 1</h3>
+ <p>This is the first accordion section's content.</p>
+ </div>
+ <input type="radio" name="accordion" id="a2"aria-hidden="true">
+ <label for="a2" aria-hidden="true">Accordion section 2</label>
+ <div>
+ <h3>Section 2</h3>
+ <p>This is the second accordion section's content.</p>
+ </div>
+</div>
+
+<div class="tabs stacked">
+ <input type="checkbox" id="c1" aria-hidden="true">
+ <label for="c1" aria-hidden="true">Collapse section 1</label>
+ <div>
+ <p>This is the first collapse section's content.</p>
+ </div>
+ <input type="checkbox" id="c2" aria-hidden="true">
+ <label for="c2" aria-hidden="true">Collapse section 2</label>
+ <div>
+ <p>This is the second collapse section's content.</p>
+ </div>
+</div>
+
+
+
+
Notes
+
+
.stacked tabs can be used with either checkboxes or radio buttons.
+
You can mix and match checkboxes and radio buttons, but we suggest you do not do so, unless you think it is necessary for your design.
The table module provides styling and responsiveness for tables. Simple rules and accessible design paradigms have been used to make creating tables quick and easy. Large tables will collapse to cards when on smaller devices or, if you don't want that, they can be locked into their default, desktop view.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Presenting information the right way is very important, especially so when dealing with large amounts of data. The table module reinvents tabular data presentation, using modern styling and responsiveness to help make tables fun again for all users no matter the device size. Tables can be either vertical or horizontal, both collapsing to a card view on smaller devices, so that they are easier to view properly. Horizontal tables are also flexible, allowing you to take as little space as possible, while still providing your users with a pleasant way to view their data. Finally, like in most CSS frameworks nowadays, you can stripe your tables to make reading them slightly less tiresome for your users' eyes. Note that all of the table variants are fully accessible.
-
-
-
Quick start
-
To use the table module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
Table layout utilizes the <table> HTML element with the following structure (usual tabular structure):
-
-
On the outermost level, there is the <table> element.
-
If you want to include a <caption> element, it must by the first element inside the <table> element.
-
Following the above, you need to add a <thead> element. Inside it, you should usually add one <tr> element, which contains one or more <th> elements.
-
Immediately after the <thead> element, you can add a <tfoot> element, if you want to. Inside it, you should usually add one or more <tr> elements, which contain one or more <td> elements.
-
Finally, add your <tbody> element. Inside it, you should usually add one or more <tr> elements, which contain one or more <td> elements. For each <td> element, specify a data-label attribute equal to the heading of the column. This enables responsibility for your table, so that the values in the columns will be properly labeled on mobile devices.
Tables are responsive by default and will change to a card-like view below a certain screen width. If you'd rather not make them responsive, check the last section on this page.
-
Specifying the data-label attribute is essential for the responsive version of a table to display properly. You can, however, use a value different from the column's name. Make sure it does not confuse your users, though.
-
We strongly suggest you avoid adding multiple rows in your <thead> element, as it could cause problems with accessibility. However, if you absolutely must, you might want to check this codepen for an idea on how to deal with irregular border styling.
Don't: Remember to always add a data-label attribute to your <td> elements, as the table's card view is very dependent on them to display properly. <th> elements, however, do not require or utilize this attribute.
Don't: Avoid inserting <th> elements inside your <tbody> element. If you want to make your tables horizontal or preset their styling in a manner different from the one shown in the previous examples, check the below sections.
Don't: Avoid using <td> elements inside your <thead>. You should use a <tbody> element instead.
-
-
-
-
-
-
-
-
-
-
-
Scrollable tables
-
-
-
-
-
-
People
-
-
Name
Surname
Alias
-
-
-
Chad
Wilberts
MrOne
-
Adam
Smith
TheSmith
-
Sophia
Canderson
Candee
-
Nick
Thomson
NickThom
-
Mark
Gerkis
Markie
-
John
Fergusson
Fergujohn
-
Sylvia
Pouleau
Sylver
-
Norman
Jones
NormalJones
-
Trevor
Heidel
Heidi
-
-
-
-
-
-
Scrollable tables can be created by simply adding the .scrollable class to the root element of your table (i.e. the <table> element). Scrollable tables are flexible, so they can accommodate any amount of data rows and, if there is a lot of data, they will make their overflow scrollable. Remember to add the data-label attribute, as shown in the previous section, to allow your tables to be responsive without any errors. Keep in mind, however, that .horizontal tables do not support the <tfoot> element.
Due to .scrollable tables utilizing the Flexbox Layout, some older browsers may not properly display these tables. This is especially true with legacy versions of Internet Explorer.
-
Mixing the Flexible Layout Module with <table> elements seems to upset some browsers. We noticed this on an older mobile version of Firefox, where our implementation should work in theory, given the fact that both features are properly supported. If you notice any problems with .scrollable tables, feel free to submit a new issue on GitHub.
-
.scrollable tables have a default maximum height of 400px. If you want to change this, you should check out the customization page.
-
-
-
-
-
<table class="scrollable">
- <!-- ... -->
- <tfoot>
- <!-- Do not do this! -->
- </tfoot>
- <!-- ... -->
-</table>
-
Don't: We already explicitly stated that, due to the way .scrollable tables are styled, the <tfoot> element is not supported. Please refer to the last section of this page if you need to use this element and you want to have a scrollable table layout.
-
-
-
-
-
-
-
-
-
-
-
Horizontal tables
-
-
-
-
-
-
People
-
-
Name
Surname
Alias
-
-
-
Chad
Wilberts
MrOne
-
Adam
Smith
TheSmith
-
Sophia
Canderson
Candee
-
Nick
Thomson
NickThom
-
-
-
-
-
-
Scrollable tables are very similar to horizontal ones and can be created by simply adding the .scrollable class to the root element of your table (i.e. the <table> element). Similarly to horizontal ones, they can accommodate as many data rows as you like, making their overflow scrollable, while they do not support the <tfoot> element. As usual, remember to add the data-label attribute, as shown in the previous section, to allow your tables to be responsive without any errors.
Due to .horizontal tables utilizing the Flexbox Layout, some older browsers may not properly display these tables. This is especially true with legacy versions of Internet Explorer.
-
Mixing the Flexible Layout Module with <table> elements seems to upset some browsers. We noticed this on an older mobile version of Firefox, where our implementation should work in theory, given the fact that both features are properly supported. If you notice any problems with .horizontal tables, feel free to submit a new issue on GitHub.
Don't: Avoid comibing the .horizontal and .scrollable classes on the same element, as this can cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Table variants & matrices
-
-
-
-
-
Star Wars Character Alignment Table
-
-
Lawful
Neutral
Chaotic
-
Good
Yoda
Luke Skywalker
Chewbacca
-
Neutral
C-3PO
Boba Fett
Han Solo
-
Bad
Darth Vader
Emperor Palpatine
Jabba the Hutt
-
-
-
-
-
-
Tables are responsive by default, however you can disable this functionality for one or more tables (normal or .horizontal), using the .preset class. This class can also be used for a multitude of things, like dealing with tables not allowing you to have <th> elements inside the <tbody> element, building matrices (i.e. tables with a header column and a header row) etc. Finally, you can make your tables use a different color for every other row, using the .striped class.
-
Sample code
-
The sample code is a bit lengthy, so we hid it by default to make it easier for mobile device users to read this page. Click or tap on Show sample code below to see the code sample for this example. By the way, we present a sample for a matrix table in he first example, but you can use the same principles and classes to create any table layout you wish.
Making a table .striped also affects the color of the cards in their responsive view on mobile devices.
-
If you create a .preset table, which you do not want to alter via Javascript to be responsive at any time in the future, you can omit the data-label attributes.
Do: The first row in a preset matrix table or any table without a <thead> element will have an extra border at the top. You can use a generic class to set border-top: 0; for the elements inside that row to fix this.
Do: You can combine any two of the following classes without any problems: .horizontal, .preset, .striped. Just make sure you respect each one's specific rules.
-
-
-
-
-
-
-
-
-
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The table module provides styling and responsiveness for tables. Simple rules and accessible design paradigms have been used to make creating tables quick and easy. Large tables will collapse to cards when on smaller devices or, if you don't want that, they can be locked into their default, desktop view.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Presenting information the right way is very important, especially so when dealing with large amounts of data. The table module reinvents tabular data presentation, using modern styling and responsiveness to help make tables fun again for all users no matter the device size. Tables can be either vertical or horizontal, both collapsing to a card view on smaller devices, so that they are easier to view properly. Horizontal tables are also flexible, allowing you to take as little space as possible, while still providing your users with a pleasant way to view their data. Finally, like in most CSS frameworks nowadays, you can stripe your tables to make reading them slightly less tiresome for your users' eyes. Note that all of the table variants are fully accessible.
+
+
+
Quick start
+
To use the table module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
Table layout utilizes the <table> HTML element with the following structure (usual tabular structure):
+
+
On the outermost level, there is the <table> element.
+
If you want to include a <caption> element, it must by the first element inside the <table> element.
+
Following the above, you need to add a <thead> element. Inside it, you should usually add one <tr> element, which contains one or more <th> elements.
+
Immediately after the <thead> element, you can add a <tfoot> element, if you want to. Inside it, you should usually add one or more <tr> elements, which contain one or more <td> elements.
+
Finally, add your <tbody> element. Inside it, you should usually add one or more <tr> elements, which contain one or more <td> elements. For each <td> element, specify a data-label attribute equal to the heading of the column. This enables responsibility for your table, so that the values in the columns will be properly labeled on mobile devices.
Tables are responsive by default and will change to a card-like view below a certain screen width. If you'd rather not make them responsive, check the last section on this page.
+
Specifying the data-label attribute is essential for the responsive version of a table to display properly. You can, however, use a value different from the column's name. Make sure it does not confuse your users, though.
+
We strongly suggest you avoid adding multiple rows in your <thead> element, as it could cause problems with accessibility. However, if you absolutely must, you might want to check this codepen for an idea on how to deal with irregular border styling.
Don't: Remember to always add a data-label attribute to your <td> elements, as the table's card view is very dependent on them to display properly. <th> elements, however, do not require or utilize this attribute.
Don't: Avoid inserting <th> elements inside your <tbody> element. If you want to make your tables horizontal or preset their styling in a manner different from the one shown in the previous examples, check the below sections.
Don't: Avoid using <td> elements inside your <thead>. You should use a <tbody> element instead.
+
+
+
+
+
+
+
+
+
+
+
Scrollable tables
+
+
+
+
+
+
People
+
+
Name
Surname
Alias
+
+
+
Chad
Wilberts
MrOne
+
Adam
Smith
TheSmith
+
Sophia
Canderson
Candee
+
Nick
Thomson
NickThom
+
Mark
Gerkis
Markie
+
John
Fergusson
Fergujohn
+
Sylvia
Pouleau
Sylver
+
Norman
Jones
NormalJones
+
Trevor
Heidel
Heidi
+
+
+
+
+
+
Scrollable tables can be created by simply adding the .scrollable class to the root element of your table (i.e. the <table> element). Scrollable tables are flexible, so they can accommodate any amount of data rows and, if there is a lot of data, they will make their overflow scrollable. Remember to add the data-label attribute, as shown in the previous section, to allow your tables to be responsive without any errors. Keep in mind, however, that .horizontal tables do not support the <tfoot> element.
Due to .scrollable tables utilizing the Flexbox Layout, some older browsers may not properly display these tables. This is especially true with legacy versions of Internet Explorer.
+
Mixing the Flexible Layout Module with <table> elements seems to upset some browsers. We noticed this on an older mobile version of Firefox, where our implementation should work in theory, given the fact that both features are properly supported. If you notice any problems with .scrollable tables, feel free to submit a new issue on GitHub.
+
.scrollable tables have a default maximum height of 400px. If you want to change this, you should check out the customization page.
+
+
+
+
+
<table class="scrollable">
+ <!-- ... -->
+ <tfoot>
+ <!-- Do not do this! -->
+ </tfoot>
+ <!-- ... -->
+</table>
+
Don't: We already explicitly stated that, due to the way .scrollable tables are styled, the <tfoot> element is not supported. Please refer to the last section of this page if you need to use this element and you want to have a scrollable table layout.
+
+
+
+
+
+
+
+
+
+
+
Horizontal tables
+
+
+
+
+
+
People
+
+
Name
Surname
Alias
+
+
+
Chad
Wilberts
MrOne
+
Adam
Smith
TheSmith
+
Sophia
Canderson
Candee
+
Nick
Thomson
NickThom
+
+
+
+
+
+
Scrollable tables are very similar to horizontal ones and can be created by simply adding the .scrollable class to the root element of your table (i.e. the <table> element). Similarly to horizontal ones, they can accommodate as many data rows as you like, making their overflow scrollable, while they do not support the <tfoot> element. As usual, remember to add the data-label attribute, as shown in the previous section, to allow your tables to be responsive without any errors.
Due to .horizontal tables utilizing the Flexbox Layout, some older browsers may not properly display these tables. This is especially true with legacy versions of Internet Explorer.
+
Mixing the Flexible Layout Module with <table> elements seems to upset some browsers. We noticed this on an older mobile version of Firefox, where our implementation should work in theory, given the fact that both features are properly supported. If you notice any problems with .horizontal tables, feel free to submit a new issue on GitHub.
Don't: Avoid comibing the .horizontal and .scrollable classes on the same element, as this can cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Table variants & matrices
+
+
+
+
+
Star Wars Character Alignment Table
+
+
Lawful
Neutral
Chaotic
+
Good
Yoda
Luke Skywalker
Chewbacca
+
Neutral
C-3PO
Boba Fett
Han Solo
+
Bad
Darth Vader
Emperor Palpatine
Jabba the Hutt
+
+
+
+
+
+
Tables are responsive by default, however you can disable this functionality for one or more tables (normal or .horizontal), using the .preset class. This class can also be used for a multitude of things, like dealing with tables not allowing you to have <th> elements inside the <tbody> element, building matrices (i.e. tables with a header column and a header row) etc. Finally, you can make your tables use a different color for every other row, using the .striped class.
+
Sample code
+
The sample code is a bit lengthy, so we hid it by default to make it easier for mobile device users to read this page. Click or tap on Show sample code below to see the code sample for this example. By the way, we present a sample for a matrix table in he first example, but you can use the same principles and classes to create any table layout you wish.
Making a table .striped also affects the color of the cards in their responsive view on mobile devices.
+
If you create a .preset table, which you do not want to alter via Javascript to be responsive at any time in the future, you can omit the data-label attributes.
Do: The first row in a preset matrix table or any table without a <thead> element will have an extra border at the top. You can use a generic class to set border-top: 0; for the elements inside that row to fix this.
Do: You can combine any two of the following classes without any problems: .horizontal, .preset, .striped. Just make sure you respect each one's specific rules.
+
+
+
+
+
+
+
+
+
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The utility module contains all the utilities and helper classes that you might want when designing a website or application. They solve common design problems efficiently and provide you with generic rules you can easily apply everywhere.
-
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
-
-
-
-
-
-
-
Quick overview
-
Every website or app has different needs and no CSS framework can predict them all. The utility module addresses this issue by providing you with a handful of utility and helper classes to make common, repetitive declarations easier. These classes include, but are not limited to, generic border styling and shadows, some responsive sizing and spacing utilities and a few other things, like a close icon, breadcrumbs styling and visiblity helpers for screen readers.
-
-
-
Quick start
-
To use the utility module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
You can hide content for all your users, using the default hidden attribute. However, we provide you with the .hidden class for the same purpose, as well as the .visually-hidden class which will make your content hidden, except for screen readers.
Both classes utilize !important declarations, so be careful when and how to use them.
-
-
-
-
<span class="hidden visually-hidden">Not a good idea</span>
-
Don't: Avoid using both classes at the same time. Instead, use .hidden to hide content for all users, .visually-hidden to hide it for non-screen-reader users or aria-hidden="true" to hide it for screen-reader-only users.
-
-
-
-
-
-
-
-
-
-
Generic borders & shadows
-
-
-
-
-
This is a paragraph with a piece of bordered text.
-
-
-
This is an element that casts a shadow.
-
-
-
-
Use the .bordered class to apply a generic black border with 25% opacity to any element. Apart from that you can use the .rounded and .circular classes to create generic border radiuses. Finally, you can use the .shadowed class to add a generic box-shadow to any element.
All of these classes utilize !important declarations, so be careful when and how to use them.
-
The .bordered class was originally created with elements such as buttons in mind, to allow users highlighting certain elements in their designs, without having to change any default styles.
-
All of the above classes can be used with most modern HTML elements.
Don't: Avoid combining two classes of the same type (i.e. two radii or two shadow styles), as they might overwrite each other and cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Responsive sizing & spacing classes
-
-
-
Helper classes for the padding and margin attributes are provided in the form of .responsive-margin and .responsive-padding classes. Both of these classes are responsive, allowing you to collapse the spacing and size of elements on different displays to make better use of the device's viewport.
If the default values of these classes are not suited to your needs, check out the customization page.
-
Both classes utilize !important declarations, so be careful when and how to use them.
-
-
-
-
<div class="responsive-padding responsive-margin">Responsive padding and margin</div>
-
Do: You can use both of these classes to make certain element adapt to changes. This could be especially useful for certain grid layouts.
-
-
-
-
-
-
-
-
-
-
Responsive visibility helpers
-
-
-
You can hide content (either fully or only visually) for certain screens, using the responsive visibility helpers. To hide elements completely use the .hidden-SCR_SZ syntax, replacing SCR_SZ with one of the available screen size names (sm for smaller screens, md for medium-sized screens or lg for larger screens). If you want to hide certains elements for all users, except screen readers, replace .hidden with .visually-hidden, followed by the screen size name.
-
Sample code
-
<span class="hidden-sm">Hidden in smaller screens</span>
-<span class="hidden-md">Hidden in medium-sized screens</span>
-<span class="hidden-lg">Hidden in larger screens</span>
-
-<span class="visually-hidden-sm">Visually hidden in smaller screens</span>
-<span class="visually-hidden-md">Visually hidden in medium-sized screens</span>
-<span class="visually-hidden-lg">Visually hidden in larger screens</span>
-
-
-
-
Notes
-
-
Responsive visibility helper classes utilize !important declarations, so be careful when and how to use them.
-
The specific breakpoints for small, medium and large screen sizes are as follows:
-
-
small: less than 768px wide
-
medium: more than or equal to 768px wide but less than 1280px wide
-
large: 1280px wide or more
-
-
-
Responsive visibility helper classes are independent, meaning that hiding an element in one screen size will not affect it visibility in any other screen size.
-
-
-
-
<span class="hidden-sm hidden-md">Hidden in smaller and medium-sized screens, visible in larger screens</span>
-<!-- or -->
-<span class="visually-hidden-md visually-hidden-lg">Visually hidden in medium-sized and larger screens, visible in smaller screens</span>
-<!-- or -->
-<span class="hidden-sm visually-hidden-lg">Hidden in smaller screens, visually hidden in larger screens, visible in medium-sized screens</span>
-
Do: You can combine responsive visibility helpers for different sizes, based on your needs.
-
-
-
<span class="hidden-sm visually-hidden-sm">Not a good idea</span>
-
Don't: Avoid combining responsive visibility helpers for the same screen size. Combining both of them might cause unexpected behavior.
Breadcrumbs are usually used to show the navigational hierarchy of pages or folders. To use them, simply create a <ul> element that implements the .breadcrumbs class. Inside this unordered list, add as many <li> elements as needed to show your hierarchy. You can add links to the list elements, as necessary.
The separators between breadcrumbs are added using some tricky CSS rules. Due to that, there might be a few browser versions or devices where you can see part of the seams between the element separators.
-
Breadcrumbs show a hierarchy, an ordered list. However, we do not use the <ol> element, as it might conflict with some custom styles we've seen people use.
-
If you want to add some accesibility to your breadcrumbs, you can add the role="navigation" attribute, although it is not required.
Don't: Avoid nesting lists, breadcrumbs or a combination of the two inside the .breadcrumbs list, as this might cause unexpected behavior.
-
-
-
-
-
-
-
-
-
-
Close icon
-
-
-
-
-
-
-
-
-
-
To create a close icon, simply add an element implementing the .close class.
-
Sample code
-
<span class="close"></span>
-
-
-
-
Notes
-
-
The close icon behaves similar to a button when hovering over it or otherwise focusing or selecting it.
-
-
-
-
<div class="close"></div>
-
Do: You can use a handful of other HTML elements instead of the <span> element showcased in the example above, most commonly <div> elements.
-
-
-
<button class="close"></button>
-
Do: If you want your close icon to behave like a button (i.e. register as a button on screen readers and have the required logic attached to it), you can apply the .close class to a <button> element instead. You can even apply any of the button color variant classes.
-
-
-
-
-
-
-
-
-
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
The utility module contains all the utilities and helper classes that you might want when designing a website or application. They solve common design problems efficiently and provide you with generic rules you can easily apply everywhere.
+
All examples showcased refer to the mini-default flavor, some class names and styles might differ based on the flavor you're using.
+
+
+
+
+
+
+
Quick overview
+
Every website or app has different needs and no CSS framework can predict them all. The utility module addresses this issue by providing you with a handful of utility and helper classes to make common, repetitive declarations easier. These classes include, but are not limited to, generic border styling and shadows, some responsive sizing and spacing utilities and a few other things, like a close icon, breadcrumbs styling and visiblity helpers for screen readers.
+
+
+
Quick start
+
To use the utility module, simply include the link to the flavor you are using and start writing your HTML page as usual. One suggestion we will make is to add the following line inside your HTML page's <head> to utilize the viewport meta tag:
You can hide content for all your users, using the default hidden attribute. However, we provide you with the .hidden class for the same purpose, as well as the .visually-hidden class which will make your content hidden, except for screen readers.
Both classes utilize !important declarations, so be careful when and how to use them.
+
+
+
+
<span class="hidden visually-hidden">Not a good idea</span>
+
Don't: Avoid using both classes at the same time. Instead, use .hidden to hide content for all users, .visually-hidden to hide it for non-screen-reader users or aria-hidden="true" to hide it for screen-reader-only users.
+
+
+
+
+
+
+
+
+
+
Generic borders & shadows
+
+
+
+
+
This is a paragraph with a piece of bordered text.
+
+
+
This is an element that casts a shadow.
+
+
+
+
Use the .bordered class to apply a generic black border with 25% opacity to any element. Apart from that you can use the .rounded and .circular classes to create generic border radiuses. Finally, you can use the .shadowed class to add a generic box-shadow to any element.
All of these classes utilize !important declarations, so be careful when and how to use them.
+
The .bordered class was originally created with elements such as buttons in mind, to allow users highlighting certain elements in their designs, without having to change any default styles.
+
All of the above classes can be used with most modern HTML elements.
Don't: Avoid combining two classes of the same type (i.e. two radii or two shadow styles), as they might overwrite each other and cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Responsive sizing & spacing classes
+
+
+
Helper classes for the padding and margin attributes are provided in the form of .responsive-margin and .responsive-padding classes. Both of these classes are responsive, allowing you to collapse the spacing and size of elements on different displays to make better use of the device's viewport.
If the default values of these classes are not suited to your needs, check out the customization page.
+
Both classes utilize !important declarations, so be careful when and how to use them.
+
+
+
+
<div class="responsive-padding responsive-margin">Responsive padding and margin</div>
+
Do: You can use both of these classes to make certain element adapt to changes. This could be especially useful for certain grid layouts.
+
+
+
+
+
+
+
+
+
+
Responsive visibility helpers
+
+
+
You can hide content (either fully or only visually) for certain screens, using the responsive visibility helpers. To hide elements completely use the .hidden-SCR_SZ syntax, replacing SCR_SZ with one of the available screen size names (sm for smaller screens, md for medium-sized screens or lg for larger screens). If you want to hide certains elements for all users, except screen readers, replace .hidden with .visually-hidden, followed by the screen size name.
+
Sample code
+
<span class="hidden-sm">Hidden in smaller screens</span>
+<span class="hidden-md">Hidden in medium-sized screens</span>
+<span class="hidden-lg">Hidden in larger screens</span>
+
+<span class="visually-hidden-sm">Visually hidden in smaller screens</span>
+<span class="visually-hidden-md">Visually hidden in medium-sized screens</span>
+<span class="visually-hidden-lg">Visually hidden in larger screens</span>
+
+
+
+
Notes
+
+
Responsive visibility helper classes utilize !important declarations, so be careful when and how to use them.
+
The specific breakpoints for small, medium and large screen sizes are as follows:
+
+
small: less than 768px wide
+
medium: more than or equal to 768px wide but less than 1280px wide
+
large: 1280px wide or more
+
+
+
Responsive visibility helper classes are independent, meaning that hiding an element in one screen size will not affect it visibility in any other screen size.
+
+
+
+
<span class="hidden-sm hidden-md">Hidden in smaller and medium-sized screens, visible in larger screens</span>
+<!-- or -->
+<span class="visually-hidden-md visually-hidden-lg">Visually hidden in medium-sized and larger screens, visible in smaller screens</span>
+<!-- or -->
+<span class="hidden-sm visually-hidden-lg">Hidden in smaller screens, visually hidden in larger screens, visible in medium-sized screens</span>
+
Do: You can combine responsive visibility helpers for different sizes, based on your needs.
+
+
+
<span class="hidden-sm visually-hidden-sm">Not a good idea</span>
+
Don't: Avoid combining responsive visibility helpers for the same screen size. Combining both of them might cause unexpected behavior.
Breadcrumbs are usually used to show the navigational hierarchy of pages or folders. To use them, simply create a <ul> element that implements the .breadcrumbs class. Inside this unordered list, add as many <li> elements as needed to show your hierarchy. You can add links to the list elements, as necessary.
The separators between breadcrumbs are added using some tricky CSS rules. Due to that, there might be a few browser versions or devices where you can see part of the seams between the element separators.
+
Breadcrumbs show a hierarchy, an ordered list. However, we do not use the <ol> element, as it might conflict with some custom styles we've seen people use.
+
If you want to add some accesibility to your breadcrumbs, you can add the role="navigation" attribute, although it is not required.
Don't: Avoid nesting lists, breadcrumbs or a combination of the two inside the .breadcrumbs list, as this might cause unexpected behavior.
+
+
+
+
+
+
+
+
+
+
Close icon
+
+
+
+
+
+
+
+
+
+
To create a close icon, simply add an element implementing the .close class.
+
Sample code
+
<span class="close"></span>
+
+
+
+
Notes
+
+
The close icon behaves similar to a button when hovering over it or otherwise focusing or selecting it.
+
+
+
+
<div class="close"></div>
+
Do: You can use a handful of other HTML elements instead of the <span> element showcased in the example above, most commonly <div> elements.
+
+
+
<button class="close"></button>
+
Do: If you want your close icon to behave like a button (i.e. register as a button on screen readers and have the required logic attached to it), you can apply the .close class to a <button> element instead. You can even apply any of the button color variant classes.
+
+
+
+
+
+
+
+
+
If you want to learn more about mini.css's modules, go back to the modules page and choose another module to see its documentation.
+
+
+
+
+
+
diff --git a/docs/vinf.js b/docs/vinf.js
index da58039..f0f22ab 100644
--- a/docs/vinf.js
+++ b/docs/vinf.js
@@ -1,4 +1,4 @@
-// Get the current version of the Gluon branch.
-module.exports = {
- version: 'v3.0.0-alpha.3'
-}
+// Get the current version of the Gluon branch.
+module.exports = {
+ version: 'v3.0.0-alpha.3'
+}
diff --git a/src/_v2/flavors/mini-dark.scss b/src/_v2/flavors/mini-dark.scss
index 93237be..db6fd7e 100644
--- a/src/_v2/flavors/mini-dark.scss
+++ b/src/_v2/flavors/mini-dark.scss
@@ -1,644 +1,644 @@
-// This is a flavor file. Duplicate it and edit it to create your own flavor. Read instructions carefully.
-// Single-line comments, starting with '//' will not be included in your final CSS file. Multiline comments,
-// structured like the flavor description below, will be included in your final CSS file.
-/*
- Flavor name: Dark (mini-dark)
- Author: Angelos Chalaris (chalarangelo@gmail.com)
- Maintainers: Angelos Chalaris
- mini.css version: v2.3.7
-*/
-// Basic rules for body and typography
-$fore-color: #d0d0d0; // Text and general foreground color
-$back-color: #232e33; // Body background color
-$base-font-family: // Default font stack for all elements:
- '-apple-system, BlinkMacSystemFont,\"Segoe UI\",\"Roboto\", \"Droid Sans\",\"Helvetica Neue\", Helvetica, Arial, sans-serif';
-// OS X and iOS system fonts (San Francisco) -> Windows system fonts -> Android system fonts (newer and older) -> Fallback fonts
-$base-root-font-size: 16px; // Root font sizing for all elements [1]
-$_1px: (1px/$base-root-font-size) * 1rem; // Calculated rem value of 1px [1]
-$base-font-size: 1rem; // Default font sizing for all elements [2]
-$base-line-height: 1.5; // Default line height for all elements.
-$use-fluid-typography: false; // Should fluid typography be used at the root element? (`true`/`false`)
-$body-margin: 0; // Margin for the body
-$apply-defaults-to-all: true; // Should default values be applied to all elements? (`true` or `false`) [3]
-$h1-font-size: 2rem; // Font size of h1
-$h2-font-size: 1.6875rem; // Font size for h2
-$h3-font-size: 1.4375rem; // Font size for h3
-$h4-font-size: 1.1875rem; // Font size for h4
-$h5-font-size: 1rem; // Font size for h5
-$h6-font-size: 0.8125rem; // Font size for h6
-$heading-line-height: 1.2em; // Line height for all headings
-$heading-margin: 0.75rem 0.5rem; // Margin for all headings
-$heading-font-weight: 500; // Font weight for all headings
-$heading-smalltext-fore-color: #acacac; // color in headings
-$make-heading-smalltext-block: true; // Should elements in headings be displayed as blocks (`true`/`false`) [4]
-$heading-smalltext-b-font-size: 0.75em; // Font size of block elements in headings
-$heading-smalltext-b-top-margin:-0.25rem; // Top margin of block elements in headings
-$paragraph-margin: 0.5rem; // Margin for
elements
-$list-margin: 0.5rem; // Margin for
and
elements
-$list-left-padding: 1rem; // Left padding for and
elements
-$bold-font-weight: 700; // Font weight for and
-$horizontal-rule-line-height: 1.25em; // line height
-$horizontal-rule-margin: 0.5rem; // margin
-$horizontal-rule-border-style: $_1px solid #9e9e9e;// Border style for horizontal rules (used in the element's border-top)
-$horizontal-rule-fancy-style: true; // Should a fancy styling be applied for the element (`true`/`false`) [5]
-$horizontal-rule-fancy-gradient:"to right, #616161, #9e9e9e, #616161"; // Gradient style for fancy horizontal rule
-$blockquote-back-color: #232e33; // Background color for
-$blockquote-fore-color: $fore-color; // Text color for
-$blockquote-margin: 0.5rem; // Margin for
-$blockquote-padding: 0.5rem 0.5rem 1.5rem;// Padding for
-$blockquote-sidebar-style: 4*$_1px solid #192024;// Style for the sidebar of
-$blockquote-cite-font-size: 0.875rem; // Font size for citation of
-$blockquote-cite-fore-color: #acacac; // Text color for citation of
-$blockquote-cite-left-position: 0.625rem; // Left padding for citation of
-$blockquote-cite-bottom-position: 0; // Bottom padding for citation of
-$blockquote-border-style: 0; // Border style for
-$blockquote-border-radius: 0 2*$_1px 2*$_1px 0; // Border radius for
-$blockquote-box-shadow: none; // Box shadow for
-$use-default-code-fonts: true; // Should default font choice (monospace) be used for code elements? (`true`/`false`) [6]
-//$code-font-family: monospace, monospace; // Fonts for code elements if not default
-$code-element-padding: 0.125rem 0.25rem; // Padding for
-$code-element-fore-color: $fore-color; // Text color for
-$code-element-back-color: #20292e; // Background color for
-$code-element-border-style: 0; // Border style for
-$code-element-border-radius: 2*$_1px; // Border radius for
-$code-element-box-shadow: none; // Box shadow for
-$pre-element-padding: 0.75rem; // Padding for
-$pre-element-fore-color: $code-element-fore-color; // Text color for
-$pre-element-back-color: $code-element-back-color; // Background color for
-$pre-element-border-style: 0; // Border style for
-$pre-element-border-radius: 0 2*$_1px 2*$_1px 0; // Border radius for
-$pre-element-margin: 0.5rem; // Margin for
-$pre-element-box-shadow: none; // Box shadow for
-$add-pre-element-sidebar: true; // Should a fancy sidebar be added to the left side of
(`true`/`false`) [7]
-$pre-element-sidebar-style: 4*$_1px solid #01579b;// Style of the sidebar of
- 
- 
