@xtayr/corner-label
v1.0.0
Published
Responsive labels appearing as ribbons around the corner of their parent
Downloads
3
Maintainers
Readme
Corner label
from 360 bytes minified & gzipped
Attention-seeking labels for when generic, horizontal titles just aren't enough.
<span class="corner-label-container">
<span class="corner-label">
I'm a default label!
</span>
<span class="corner-label corner-label--top-right">
I'm up on the top right!
</span>
</span>
<span class="corner-label-container corner-label-container--tight">
<span class="corner-label corner-label--dark">
I'm all dark and tight…
</span>
</span>
Why 2 divs for this simple little label, you ask?
Well, the first, containing span crops the corners off've the labels, making them look that awesome labely shape and not like big blocks clawing onto your container. That's why.
Notice that, because the container is the one controlling the cropping, you can have as many of the same tightness labels inside of a single container as you'd like! Neato… right? right? right?
Using your own colours in your own CSS files
Make sure the parent of the labels is position: relative | absolute | fixed;
.
Use the css/corner-labels.css
file directly for instant super-yellow and garish-red (--dark
) labels.
Or, better still, set the $corner-label-x
variables to your hearts' desire and then use:
@import "path/to/tools/_print-all-label-styles";
$corner-label-colors: (
default: (
color: black,
background-color: yellow,
hover-background-color: orange,
shadow-color: darkorange,
),
dark: (
color: white,
background-color: blue,
hover-background-color: darkblue,
shadow-color: navy,
),
);
@include print-all-label-styles;
Customisation
Colours
$corner-label-colors
Often you won't want to use bright yellow and medium blue banners. (We get it. Managers can be super uptight about branding an all that. It's cool, we've got ya back!)
This accepts an object which describes all the colours of label you'll want to use in your app.
For example, if you only have one label colour:
$corner-label-colors: (
colour-class-suffix: (
color: $color,
background-color: $background-color,
hover-background-color: $hover-background-color,
shadow-color: $shadow-color,
),
);
colour-class-suffix
is the secondary class you would use on your label in the HTML.
ie. <span class="corner-label corner-label--colour-class-suffix">
color
is the text colour of the labelbackground-color
the base background colour of the labelhover-background-color
the background colour of the label when hovered - ignored if$corner-label-change-background-on-hover
is falseshadow-color
the background colour of label folds
Selectors
$corner-label-label-selector
$corner-label-container-selector
I heard you came to us to fix your styles, not dirty up your beautiful HTML with our dirty, dirty classes. That's ok. we can help! …maybe …at least a little.
You'll still need both of the elements, but at least you can change the base classes to better fit the rest of your code.
Try something like:
For example, if you only have one label colour:
@import "path/to/tools/_print-all-label-styles";
$corner-ribbon-ribbon-selector: "i";
$corner-ribbon-container-selector: "b";
@include print-all-label-styles;
And you can cut your markup down to as little as:
<b><i>Look at my ribbons!</i></b>
However, please bear in mind that in order to use colours and tightnesses other than the default you'll need to use .class
es as the selectors.
plus, disregaring that fact, this markup is horribly unreadable…
Alignment
You don't like your labels on the top left? Oh, come on. … ok, fine. We'll allow you to move it to the top right.
Use this markup instead:
<span class="corner-label-container">
<span class="corner-label corner-label--dark corner-label--top-right">
Look at my labels!
</span>
</span>
What's that you say? Your labels are mostly top-right, so you don't want to type all of that? Ok, cool, then revert your markup back to the default and add this variable to your sass:
@import "path/to/tools/_print-all-label-styles";
$default-alignment: top-right;
@include print-all-label-styles;
You what? Your labels are ALWAYS top-right, so you don't even want to include the (5 lines of) CSS for the top left? I'm still with ya! Do this instead:
@import "path/to/tools/_print-all-label-styles";
@include print-label-styles-for(top-right);
On the bottom, you say? Well… do WE have a solution for you?!
… no. No is the answer there. If enough requests come in, I'll look into it, though!
MHOAR OPTIONS!!!
Whoa! Ha… you're getting a little excited there… and just a tad scary… could you brush your teeth before you do that again, please?
There actually ARE more options… but I'll let you find them for yourself as they're all quite edge case and, hopefully, quite easy to decipher.
Look through the files in scss/settings
and you should be flying.
License
Copyright © 2018 Brook Jordan Licensed under the MIT license.