Skip to content

Instantly share code, notes, and snippets.

@anthonyshort
Created March 13, 2012 10:37
Show Gist options
  • Save anthonyshort/2028061 to your computer and use it in GitHub Desktop.
Save anthonyshort/2028061 to your computer and use it in GitHub Desktop.
Media Queries in Sass
// Media Queries in Sass 3.2
//
// These mixins make media queries a breeze with Sass.
// The media queries from mobile up until desktop all
// trigger at different points along the way
//
// And important point to remember is that and width
// over the portrait width is considered to be part of the
// landscape width. This allows us to capture widths of devices
// that might not fit the dimensions exactly. This means the break
// points are seamless.
$mq-mobile-portrait : 320px !default;
$mq-mobile-landscape : 480px !default;
$mq-tablet-portrait : 768px !default;
$mq-tablet-landscape : 1024px !default;
$mq-desktop : 1382px !default;
// Both portrait and landscape
@mixin mobile-only {
@media (max-width : $mq-mobile-landscape) {
@content;
}
}
// Everything up to and including the portrait width of the phone
// Since it's the smallest query it doesn't need a min
@mixin mobile-portrait-only {
@media (max-width : $mq-mobile-portrait) {
@content;
}
}
// Everything up to and including the mobile portrait
@mixin mobile-portrait-and-below {
@media (max-width : $mq-mobile-portrait) {
@content;
}
}
// Everything above and including the mobile portrait
@mixin mobile-portrait-and-up {
@media (min-width : $mq-mobile-portrait) {
@content;
}
}
// Everthing larger than a portrait mobile up until mobile landscape
@mixin mobile-landscape-only {
@media only screen and (min-width : $mq-mobile-portrait + 1) and (max-width : $mq-mobile-landscape) {
@content;
}
}
// Everything up to and including the mobile landscape width
@mixin mobile-landscape-and-below {
@media only screen and (max-width : $mq-mobile-landscape) {
@content;
}
}
// Everything above and including the mobile landscape width
@mixin mobile-landscape-and-up {
@media only screen and (min-width : $mq-mobile-portrait + 1) {
@content;
}
}
// Both the portrait and landscape width of the tablet
// Larger than a landscape mobile but less than or equal to a landscape tablet
@mixin tablet-only {
@media only screen and (min-width : $mq-mobile-landscape + 1) and (max-width : $mq-tablet-landscape) {
@content;
}
}
// Everything larger than mobile landscape up until the portrait width of the tablet
@mixin tablet-portrait-only {
@media only screen and (min-width : $mq-mobile-landscape + 1) and (max-width : $mq-tablet-portrait) {
@content;
}
}
// Everything below and including the portrait width of the tablet
@mixin tablet-portrait-and-below {
@media only screen and (max-width : $mq-tablet-portrait) {
@content;
}
}
// Everything above and including the portrait width of the tablet
@mixin tablet-portrait-and-up {
@media only screen and (min-width : $mq-mobile-landscape + 1) {
@content;
}
}
// Larger than portrait but less than or equal to the landscape width
@mixin tablet-landscape-only {
@media only screen and (min-width : $mq-tablet-portrait + 1) and (max-width : $mq-tablet-landscape) {
@content;
}
}
// Up to and including the tablet landscape
@mixin tablet-landscape-and-below {
@media only screen and (max-width : $mq-tablet-landscape) {
@content;
}
}
// Everything larger than portrait tablet
@mixin tablet-landscape-and-up {
@media only screen and (min-width : $mq-tablet-portrait + 1) {
@content;
}
}
// Everything larger than a landscape tablet
@mixin desktop-and-up {
@media only screen and (min-width : $mq-tablet-landscape + 1) {
@content;
}
}
// Everything below and including the desktop
@mixin desktop-and-below {
@media only screen and (max-width : $mq-desktop) {
@content;
}
}
// Everything larger than a landscape tablet but less than or equal to the desktop
@mixin desktop-only {
@media only screen and (min-width : $mq-tablet-landscape + 1) and (max-width : $mq-desktop) {
@content;
}
}
// Retina screens have a 1.5 pixel ratio, not 2
@mixin retina {
@media only screen and (-webkit-min-device-pixel-ratio : 1.5), only screen and (min-device-pixel-ratio : 1.5) {
@content;
}
}
@hagenburger
Copy link

Like it. I often use it the other way round: I serve the phone layout for everything smaller than a tablet instead of serving the tablet layout for everything bigger than a phone.

@andresgutgon
Copy link

How use that. Can you post an example please ?

Ej.:
+retina(content) ??????

@moeffju
Copy link

moeffju commented Mar 13, 2012

@andresgutgon:

+retina
  selector
    more-content: yes
  your-content: here

@anthonyshort
Copy link
Author

.module {
    @include mobile-only {
        width:auto;
        font-size:12px;
    }
    @include tablet-landscape-and-below {
        width:600px;
        font-size:14px;
        .sidebar {
            display:none;
        }
    }
    @include desktop-only {
        width:400px;
        .sidebar {
            width:200px;
        }
    }
}

@anthonyshort
Copy link
Author

@hagenburger I'm trying to accommodate for that style too by using -up, -only and -below. This should let you control how the media query properties affect larger and smaller displays. That way you can have styles that target mobile phones specifically or avoid them completely.

@MoOx
Copy link

MoOx commented Mar 13, 2012

Why did you use only screen ?

  • What about "Do not design for device, design for screen size" ? :p
    I will post something similar I'm working on, using variables.

@anthonyshort
Copy link
Author

Good point, the screen limitation should be ditched I think.

@emrecamasuvi
Copy link

Looks nice.
But are we supposed to use that much, media query mixins?
4 or 5 is ideal, imho.

@anthonyshort
Copy link
Author

In a single stylesheet, yeah, you'd be stupid to use all of these at once. I've included a lot of them so that it can support many use cases. People use media queries in a lot of different ways.

@emrecamasuvi
Copy link

gotcha. i'll take four; widescreen (including retina), default, "tablet portrait" and iphone.
btw if you've time can i ask you sth? foundation fw from zurb, has some cool classes like "hide on tablet" and "show on phone"; any thoughts on how they did that?

@anthonyshort
Copy link
Author

Something like this

.show-on-phone {
    display:none;
    @include mobile-only {
        display:block;
    }
}

 .hide-on-tablet { 
    display:block;
    @include tablet-only {
        display:none;
    }
}

@hagenburger
Copy link

@MoOx: I think “table”, “phone”, … are more easy to understand than M, L, XL, …—especially for new devs in the team.

@MoOx
Copy link

MoOx commented Mar 14, 2012

@hagenburger You're right & I know that. What I've done is clearly not finished. I'm not happy with this names.
I've plan to add shortcut more verbose.
But as I said before, we have to design for screen sizes, not for devices.

  • I've to add more examples on how to use these media queries in a concret showcase.

@anthonyshort
Copy link
Author

We are still designing for screen sizes, it's just using semantics that are easier for people to understand. 'phone' is extra small, 'tablet' is small, 'desktop' is medium and so forth. If we're basically aiming for those devices we might as well use names we can remember :)

But there's definitely some parts that I'll borrow from yours. Might want to check and see if that compiles though. I know in the current version of sass you can't do variables in media queries. That might be fixed up now though.

@MoOx
Copy link

MoOx commented Mar 14, 2012

You'r right.
Maybe semantics name are not bad after all. I will add verbose mixins with name like this.
You can use variable in media queries with the latest sass 3.2 available.

@anthonyshort
Copy link
Author

Bit more research to do with common device widths: http://www.metaltoad.com/blog/simple-device-diagram-responsive-design-planning

Specifically, this image - http://www.metaltoad.com/sites/default/files/Responsive-Widths_0.png

Judging from this I'd say it would be best to use the points:

  • 320
  • 600
  • 800
  • 1024
  • 1280

I'll need to do some more testing though.

@MoOx
Copy link

MoOx commented Mar 15, 2012

Really interesting source.I like the "6 layouts". Maybe I will do something fluid enough to be able to use 3, 4 or 6 layouts as you wish. Hard to code maybe.

@anointed
Copy link

Having a few issues on my end trying to implement this concept.
To start I am running Sass 3.2.0alpha.94 bleeding edge

I started by copying the gist above and saving it to my project as _media-queries.scss

When I simply @import "media-queries" into my working scss file I get the following error:
Syntax error: Invalid CSS after "................*/": expected selector or at-rule, was ......

It seems to get stuck at the initial import rule. Is there a different vs. of Sass or something that I should be using to solve this error?

@anthonyshort
Copy link
Author

@anointed I'm fairly sure you'll need a more recent version of the Sass alpha

@anointed
Copy link

thnx, all sorted now

@bhargav2785
Copy link

are you updating it right now ?

@jpweller
Copy link

Are you still using this? I just implemented it and love it so far. Just curious if you still use it in your work flow. The only drawback I found is it generates a ton of excess media queries once compiled. But I found a Grunt plugin to combine them so its ok.

@davidnormo
Copy link

Thanks anthonyshort, very helpful little gist.
What do you think of this as an improvement to the API?
https://gist.github.com/davidnormo/d6f93cf94b445640de80

To summerise:

  • Removed -only suffixes as they are superflous
  • Changed -below to -down as down is the opposite to up, therefore makes the naming more intuitive (also reduces length by 1 char, bonus!).

@hdodov
Copy link

hdodov commented Jun 8, 2017

Here is my take on a media query mixin. There's less hardcoding involved and it supports as many screen sizes as you wish because it utilizes maps and functions. It's not that better than this gist, but is DRYer.

@gempir
Copy link

gempir commented Feb 23, 2018

@anthonyshort what is this licensed under?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment