The less-css-helper-library for css, less and frontend projects. Related (css) key value pairs often used together are stored in css classes for easy use, reuse and to help quickly structure your projects. Styles or classes do not reflect personal preference(s), built-in css styles are only made accessible in your projects just by adding a class to an html element.
v1.0.0 contains some reset styles and classes which you can apply on html elements:
.block
.block-auto
.b-container
.grid
.grid-auto-1-auto-row
.flex
.flex-space-btw
.flex-auto
.flex-space-btw-auto
.flex-center
.flex-j-center
.flex-a-center
.x-auto
.img-wrapper
.img-wrapper-rounded
.img-default
Install package from npm:
npm install less-css-helper-library
- For css project:
./node_modules/less-css-helper-library/css/styles.css
- For less project:
node_modules/less-css-helper-library/less/styles.less
You can just reference both in your project if you use less
& may need to switch to or mix with css
. Make sure to add the reference(s) before that of your own css and/or less files.
From the class names, it's easy to tell what they do. See effect when added to an html element below:
.block
only sets display to block..grid
only sets display to grid..flex
only sets display to flex..flex center
sets display to flex, justify-content & align-items are set to center..flex-j-center
only sets display to flex & justify-content to center..flex-a-center
only sets display to flex & justify-content to center..flex-space-btw
sets display to flex & justify-content to space-between.- Class names with suffix
-auto
uses same styles as their look-alikes above, but make use ofmargin: 0 auto;
. When applied on an element (with width changed to less than 100%), the element is horizontally centered. .b-container
uses same style asblock-auto
, but with width set & is responsive already. To be used on the body element or html element(s) acting as outermost containers.- Exception:
x-auto
sets overflow to auto. .grid-auto-1-auto-row
sets display to grid, grid-template-rows toauto 1fr auto
, grid-template-columns to1fr
& also sets the height of the element to 100%..img-wrapper
has same qualities of.flex-center
, but with overflow set to hidden - to be used on the parent of animg
element..img-wrapper-rounded
has same qualities of.img-wrapper
but with border-radius set to 50% - to be used on the parent of animg
element..img-default
is same as our reset style for images. It sets animg
element's max-width to 100% and height to auto. Note: Animg
element inside a parent that uses.img-wrapper
or.img-wrapper-rounded
must be set to the reset style, therefore always add the.img-default
class to such img element.
You have total control over what the width of the element (and margin in the case of -auto
) should be. More details & tutorial coming soon on this topic.
At the moment it is maintained by just one person - @Ifycode. Meaning that more features will be added only when needed. If you like and have started using the library in your projects but doesn't contain what you need (yet), you can help speed up the process by raising it as an issue or send a pull request.
Please take note of the following:
- Group property-value pairs that are related or are often used together in one class so that it is reusable.
- The styles or classes (names) you propose must give good idea of the property-value pairs stored in it.
- Styles or classes proposed must be usable in any section inside the body of html documents.
- Styles or classes proposed must not reflect personal preference(s). The aim is to make built-in css styles accessible in the user's projects just by adding a class to an html element.
- Do not make changes directly in the
main
ordevelop
branches. See development environment & git workflow on how to make changes to the code base and submit pull request.