mirror of
https://github.com/Fechin/reference.git
synced 2026-11-21 05:24:10 +03:00
Every other file's format which was automatically converted correctly. Each has been manually checked and they should all be visually the same.
425 lines
5.7 KiB
Markdown
425 lines
5.7 KiB
Markdown
---
|
|
title: Sass
|
|
date: 2020-12-20 22:15:43
|
|
background: bg-[#ba6993]
|
|
label: CSS
|
|
tags:
|
|
- css
|
|
categories:
|
|
- Programming
|
|
intro: |
|
|
This is a quick reference cheat sheet that lists the most useful features of [SASS](https://sass-lang.com).
|
|
plugins:
|
|
- copyCode
|
|
---
|
|
|
|
## Sass Basics
|
|
|
|
### Introduction
|
|
|
|
- [Documentation](https://sass-lang.com/documentation) _(sass-lang.com)_
|
|
- [Learn X in Y minutes](https://learnxinyminutes.com/docs/sass/) _(learnxinyminutes.com)_
|
|
|
|
### Variables
|
|
|
|
```scss
|
|
$defaultLinkColor: #46eac2;
|
|
|
|
a {
|
|
color: $defaultLinkColor;
|
|
}
|
|
```
|
|
|
|
### String interpolation
|
|
|
|
```scss
|
|
$wk: -webkit-;
|
|
|
|
.rounded-box {
|
|
#{$wk}border-radius: 4px;
|
|
}
|
|
```
|
|
|
|
### Comments
|
|
|
|
```scss
|
|
/*
|
|
Block comments
|
|
Block comments
|
|
Block comments
|
|
*/
|
|
|
|
// Line comments
|
|
```
|
|
|
|
### Mixins
|
|
|
|
```scss
|
|
@mixin heading-font {
|
|
font-family: sans-serif;
|
|
font-weight: bold;
|
|
}
|
|
h1 {
|
|
@include heading-font;
|
|
}
|
|
```
|
|
|
|
See: [Mixins](#sass-mixins)
|
|
|
|
### Nesting {.row-span-2}
|
|
|
|
```scss
|
|
.markdown-body {
|
|
a {
|
|
color: blue;
|
|
&:hover {
|
|
color: red;
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
#### to properties
|
|
|
|
```scss
|
|
text: {
|
|
// like text-align: center
|
|
align: center;
|
|
// like text-transform: uppercase
|
|
transform: uppercase;
|
|
}
|
|
```
|
|
|
|
### Extend
|
|
|
|
```scss
|
|
.button {
|
|
···
|
|
}
|
|
```
|
|
|
|
```scss
|
|
.push-button {
|
|
@extend .button;
|
|
}
|
|
```
|
|
|
|
### @import
|
|
|
|
```scss
|
|
@import "./other_sass_file";
|
|
@import "/code", "lists";
|
|
|
|
// Plain CSS @imports
|
|
@import "theme.css";
|
|
@import url(theme);
|
|
```
|
|
|
|
The `.sass` or `.sass` extension is optional.
|
|
|
|
## Sass Mixins
|
|
|
|
### Parameters
|
|
|
|
```scss
|
|
@mixin font-size($n) {
|
|
font-size: $n * 1.2em;
|
|
}
|
|
```
|
|
|
|
```scss
|
|
body {
|
|
@include font-size(2);
|
|
}
|
|
```
|
|
|
|
### Default values
|
|
|
|
```scss
|
|
@mixin pad($n: 10px) {
|
|
padding: $n;
|
|
}
|
|
```
|
|
|
|
```scss
|
|
body {
|
|
@include pad(15px);
|
|
}
|
|
```
|
|
|
|
### Default variable
|
|
|
|
```scss
|
|
$default-padding: 10px;
|
|
|
|
@mixin pad($n: $default-padding) {
|
|
padding: $n;
|
|
}
|
|
|
|
body {
|
|
@include pad(15px);
|
|
}
|
|
```
|
|
|
|
## Sass Color functions {.cols-2}
|
|
|
|
### rgba
|
|
|
|
```scss
|
|
rgb(100, 120, 140)
|
|
rgba(100, 120, 140, .5)
|
|
rgba($color, .5)
|
|
```
|
|
|
|
### Mixing
|
|
|
|
```scss
|
|
mix($a, $b, 10%) // 10% a, 90% b
|
|
```
|
|
|
|
### Modifying HSLA
|
|
|
|
```scss
|
|
darken($color, 5%)
|
|
lighten($color, 5%)
|
|
```
|
|
|
|
```scss
|
|
saturate($color, 5%)
|
|
desaturate($color, 5%)
|
|
grayscale($color)
|
|
```
|
|
|
|
```scss
|
|
adjust-hue($color, 15deg)
|
|
complement($color) // like adjust-hue(_, 180deg)
|
|
invert($color)
|
|
```
|
|
|
|
```scss
|
|
fade-in($color, .5) // aka opacify()
|
|
fade-out($color, .5) // aka transparentize()
|
|
rgba($color, .5) // sets alpha to .5
|
|
```
|
|
|
|
### Getting individual values
|
|
|
|
#### HSLA
|
|
|
|
```scss
|
|
hue($color) // 0deg..360deg
|
|
saturation($color) // 0%..100%
|
|
lightness($color) // 0%..100%
|
|
alpha($color) // 0..1 (aka opacity())
|
|
```
|
|
|
|
#### RGB
|
|
|
|
```scss
|
|
red($color) // 0..255
|
|
green($color)
|
|
blue($color)
|
|
```
|
|
|
|
See: [hue()](http://sass-lang.com/documentation/Sass/Script/Functions.html#hue-instance_method),
|
|
[red()](http://sass-lang.com/documentation/Sass/Script/Functions.html#red-instance_method)
|
|
|
|
### Adjustments
|
|
|
|
```scss
|
|
// Changes by fixed amounts
|
|
adjust-color($color, $blue: 5)
|
|
adjust-color($color, $lightness: -30%) // darken(_, 30%)
|
|
adjust-color($color, $alpha: -0.4) // fade-out(_, .4)
|
|
adjust-color($color, $hue: 30deg) // adjust-hue(_, 15deg)
|
|
```
|
|
|
|
```scss
|
|
// Changes via percentage
|
|
scale-color($color, $lightness: 50%)
|
|
```
|
|
|
|
```scss
|
|
// Changes one property completely
|
|
change-color($color, $hue: 180deg)
|
|
change-color($color, $blue: 250)
|
|
```
|
|
|
|
Supported: `$red`, `$green`, `$blue`, `$hue`, `$saturation`, `$lightness`, `$alpha`
|
|
|
|
## Sass Other functions {.cols-2}
|
|
|
|
### Strings
|
|
|
|
```scss
|
|
unquote('hello')
|
|
quote(hello)
|
|
```
|
|
|
|
```scss
|
|
to-upper-case(hello)
|
|
to-lower-case(hello)
|
|
```
|
|
|
|
```scss
|
|
str-length(hello world)
|
|
str-slice(hello, 2, 5) // "ello" - it's 1-based, not 0-based
|
|
str-insert("abcd", "X", 1) // "Xabcd"
|
|
```
|
|
|
|
### Units
|
|
|
|
```scss
|
|
unit(3em) // 'em'
|
|
unitless(100px) // false
|
|
```
|
|
|
|
### Numbers
|
|
|
|
```scss
|
|
floor(3.5)
|
|
ceil(3.5)
|
|
round(3.5)
|
|
abs(3.5)
|
|
```
|
|
|
|
```scss
|
|
min(1, 2, 3)
|
|
max(1, 2, 3)
|
|
```
|
|
|
|
```scss
|
|
percentage(.5) // 50%
|
|
random(3) // 0..3
|
|
```
|
|
|
|
### Misc
|
|
|
|
```scss
|
|
variable-exists(red) // checks for $red
|
|
mixin-exists(red-text) // checks for @mixin red-text
|
|
function-exists(redify)
|
|
```
|
|
|
|
```scss
|
|
global-variable-exists(red)
|
|
```
|
|
|
|
```scss
|
|
selector-append('.menu', 'li', 'a') // .menu li a
|
|
selector-nest('.menu', '&:hover li') // .menu:hover li
|
|
selector-extend(...)
|
|
selector-parse(...)
|
|
selector-replace(...)
|
|
selector-unify(...)
|
|
```
|
|
|
|
## Sass Feature checks {.cols-2}
|
|
|
|
### Feature check
|
|
|
|
```scss
|
|
feature-exists(global-variable-shadowing)
|
|
```
|
|
|
|
### Features
|
|
|
|
- global-variable-shadowing
|
|
- extend-selector-pseudoclass
|
|
- units-level-3
|
|
- at-error
|
|
|
|
## Sass Loops
|
|
|
|
### For loops
|
|
|
|
```scss
|
|
@for $i from 1 through 4 {
|
|
.item-#{$i} {
|
|
left: 20px * $i;
|
|
}
|
|
}
|
|
```
|
|
|
|
### Each loops (simple)
|
|
|
|
```scss
|
|
$menu-items: home about contact;
|
|
|
|
@each $item in $menu-items {
|
|
.photo-#{$item} {
|
|
background: url("#{$item}.jpg");
|
|
}
|
|
}
|
|
```
|
|
|
|
### Each loops (nested)
|
|
|
|
```scss
|
|
$backgrounds: (home, "home.jpg"), (about, "about.jpg");
|
|
|
|
@each $id, $image in $backgrounds {
|
|
.photo-#{$id} {
|
|
background: url($image);
|
|
}
|
|
}
|
|
```
|
|
|
|
### While loops
|
|
|
|
```scss
|
|
$i: 6;
|
|
@while $i > 0 {
|
|
.item-#{$i} {
|
|
width: 2em * $i;
|
|
}
|
|
$i: $i - 2;
|
|
}
|
|
```
|
|
|
|
## Sass Other features
|
|
|
|
### Conditionals {.row-span-2}
|
|
|
|
```scss
|
|
@if $position == "left" {
|
|
position: absolute;
|
|
left: 0;
|
|
} @else if $position == "right" {
|
|
position: absolute;
|
|
right: 0;
|
|
} @else {
|
|
position: static;
|
|
}
|
|
```
|
|
|
|
### Interpolation
|
|
|
|
```scss
|
|
.#{$klass} { ... } // Class
|
|
call($function-name) // Functions
|
|
|
|
@media #{$tablet}
|
|
font: #{$size}/#{$line-height}
|
|
url("#{$background}.jpg")
|
|
```
|
|
|
|
### Lists
|
|
|
|
```scss
|
|
$list: (a b c);
|
|
|
|
nth($list, 1) // starts with 1
|
|
length($list)
|
|
|
|
@each $item in $list { ... }
|
|
```
|
|
|
|
### Maps {.col-span-2}
|
|
|
|
```scss
|
|
$map: (key1: value1, key2: value2, key3: value3);
|
|
|
|
map-get($map, key1)
|
|
```
|