Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 234 lines (228 sloc) 9.202 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta http-equiv="x-ua-compatible" content="ie=edge" />
<meta name="viewport" content="width=device-width; initial-scale=1; minimum-scale=1; maximum-scale=1" />
<meta name="author" content="Nathan Smith" />
<meta name="copyright" content="Licensed under GPL and MIT." />
<meta name="description" content="Adapt.js serves CSS based on screen width." />
<title>Adapt.js - Adaptive CSS</title>
<link rel="stylesheet" href="assets/css/master.css" />
<noscript>
<link rel="stylesheet" href="assets/css/mobile.min.css" />
</noscript>
<script>
// Edit to suit your needs.
var ADAPT_CONFIG = {
  // Where is your CSS?
  path: 'assets/css/',

  // false = Only run once, when page first loads.
  // true = Change on window resize and page tilt.
  dynamic: true,

  // First range entry is the minimum.
  // Last range entry is the maximum.
  // Separate ranges by "to" keyword.
  range: [
    '0px to 760px = mobile.min.css',
    '760px to 980px = 720.min.css',
    '980px to 1280px = 960.min.css',
    '1280px to 1600px = 1200.min.css',
    '1600px to 1920px = 1560.min.css',
    '1920px = fluid.min.css'
  ]

  beforeAdapt: function() {
    // (Optional) Code to be called before a stylesheet change
  }

  afterAdapt: function() {
    // (Optional) Code to be called after a stylesheet change
  }
};
</script>
<script src="assets/js/adapt.min.js"></script>
</head>
<body>
<div class="container_12 clearfix">
  <div class="grid_12">
    <h1>
      Adapt.js - Adaptive CSS
    </h1>
  </div>
  <div class="grid_7">
    <h2>
      What is this?
    </h2>
    <p>
      <a href="https://github.com/nathansmith/adapt/blob/master/assets/js/adapt.js">Adapt.js</a> is a lightweight (801 bytes <a href="https://github.com/nathansmith/adapt/blob/master/assets/js/adapt.min.js">minified</a>) JavaScript file that determines which CSS file to load before the browser renders a page. If the browser tilts or resizes, Adapt.js simply checks its width, and serves only the CSS that is needed, when it is needed.
    </p>
    <p>
      A potential drawback of Adapt.js is the possibility of a brief flash of unstyled content as a new stylesheet is being fetched (think of it as “Ajax” for CSS). I have done my best to mitigate this by keeping CSS files small (3 KB). It is worth noting this is a proposed, not prescribed, approach to a problem with multiple solutions.
    </p>
    <p>
      Other methods include: Build a <a href="http://mobify.me/">separate</a> site for <a href="http://html5boilerplate.com/mobile/">mobile</a>. Or, use <a href="http://www.w3.org/TR/css3-mediaqueries/">media queries</a> to adjust layout, with a <a href="https://github.com/scottjehl/Respond">polyfill</a> for older browser support, and conditional Internet Explorer <a href="http://adactio.com/journal/4494/">comments</a> for Windows phones. Also a factor is how to handle multiple image resolutions without adding file size. Filament Group is advocating <a href="http://filamentgroup.com/lab/responsive_images_experimenting_with_context_aware_image_sizing/">context aware</a> image sizing.
    </p>
  </div>
  <div class="grid_5">
    <table class="data">
      <caption>
        Default CSS Files &amp; Widths
      </caption>
      <thead>
        <tr>
          <th>
            File Name
          </th>
          <th>
            Screen Width
          </th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <th>
            <a href="assets/css/mobile.css">mobile.css</a>
          </th>
          <td>
            below 760px
          </td>
        </tr>
        <tr>
          <th>
            <a href="assets/css/720.css">720.css</a>
          </th>
          <td>
            760px to 980px
          </td>
        </tr>
        <tr>
          <th>
            <a href="assets/css/960.css">960.css</a>
          </th>
          <td>
            980px to 1280px
          </td>
        </tr>
        <tr>
          <th>
            <a href="assets/css/1200.css">1200.css</a>
          </th>
          <td>
            1280px to 1600px
          </td>
        </tr>
        <tr>
          <th>
            <a href="assets/css/1560.css">1560.css</a>
          </th>
          <td>
            1600 to 1920px
          </td>
        </tr>
        <tr>
          <th>
            <a href="assets/css/fluid.css">fluid.css</a>
          </th>
          <td>
            above 1920px
          </td>
        </tr>
      </tbody>
    </table>
    <p class="notice">
      <b><a href="https://github.com/nathansmith/adapt/zipball/master">DOWNLOAD</a></b> &mdash; This page’s demo code.
    </p>
  </div>
  <hr class="grid_12">
  <div class="grid_7">
<pre>// Edit to suit your needs.
var ADAPT_CONFIG = {
  // Where is your CSS?
  path: 'assets/css/',

  // false = Only run once, when page first loads.
  // true = Change on window resize and page tilt.
  dynamic: true,

  // First range entry is the minimum.
  // Last range entry is the maximum.
  // Separate ranges by "to" keyword.
  range: [
    '0px to 760px = mobile.css',
    '760px to 980px = 720.css',
    '980px to 1280px = 960.css',
    '1280px to 1600px = 1200.css',
    '1600px to 1920px = 1560.css',
    '1920px = fluid.css'
  ]
};</pre>
  </div>
  <div class="grid_5">
    <h3>
      Configuration
    </h3>
    <p>
      To use Adapt.js, all you have to do is set up a few parameters: <code>path</code> is the directory structure in which your stylesheets reside, <code>dynamic</code> is a boolean (<code>true</code> or <code>false</code>) that tells Adapt.js whether to watch the <code>window</code> for its <code>resize</code> event, also triggered by tablet or phone tilt. Lastly, <code>range</code> defines the screen widths to associate with various CSS files. The defaults are shown in the adjacent code example.
    </p>
    <hr />
    <h3>
      Open Source
    </h3>
    <p>
      Just like the <a href="http://960.gs/">960 Grid System</a> itself, Adapt.js is licensed under <a href="http://www.gnu.org/licenses/gpl.html">GPL</a> and <a href="http://www.opensource.org/licenses/mit-license.php">MIT</a>. That means it is free, as in speech. If you want to use it in a product that is already licensed under the GPL, you can. Or, if you want to use it in a commercial product, you can choose the MIT license instead. No strings attached.
    </p>
    <p>
      The code is available via <a href="https://github.com/nathansmith/adapt">GitHub</a>.
    </p>
  </div>
  <hr class="grid_12" />
  <div class="grid_4">
    <h4>
      Fallback
    </h4>
    <p>
      In the case of JavaScript being purposefully disabled or unavailable, stylesheet defaults can be served via <code>&lt;noscript&gt;</code>, which is perfectly valid in the <code>&lt;head&gt;</code> for <a href="http://www.w3.org/TR/html5/scripting-1.html#the-noscript-element">HTML5</a>. Taking a <a href="http://www.lukew.com/ff/entry.asp?933">mobile first</a> approach, I specified the mobile.css file, assuming devices without JS capabilities are likely to be less capable “feature” phones.
    </p>
  </div>
  <div class="grid_4 push_4">
    <h4>
      “It Depends”
    </h4>
    <p>
      As with any field in which technological methods are open for debate, there is the danger of religious fanaticism, where we each rally behind a respective technique and defend it vehemently. I would advise you to consider your audience, weigh the options, and find an approach that makes sense for that particular context.
    </p>
  </div>
  <div class="grid_4 pull_4">
    <h4>
      Background
    </h4>
    <p>
      This whole browser resizing craze was started by none other than the inestimable <a href="http://ethanmarcotte.com/">Ethan Marcotte</a>, when he wrote his seminal article for A List Apart, entitled <a href="http://www.alistapart.com/articles/responsive-web-design/">Responsive Web Design</a>. Since then, some have <a href="http://tripleodeon.com/2010/10/not-a-mobile-web-merely-a-320px-wide-one/">criticized</a> <code>@media</code> queries as <a href="http://www.cloudfour.com/css-media-query-for-mobile-is-fools-gold/">fool’s gold</a>. Also worth reading are <a href="http://adactio.com/journal/1716/">One Web</a> and <a href="http://unstoppablerobotninja.com/entry/toffee-nosed/">Toffee-Nosed</a>, further defining responsiveness.
    </p>
  </div>
  <hr class="grid_12" />
  <div class="grid_3">
    <p>
      <small>
        Licensed under <a href="http://www.gnu.org/licenses/gpl.html">GPL</a> and <a href="http://www.opensource.org/licenses/mit-license.php">MIT</a>.
      </small>
    </p>
  </div>
  <div class="grid_6 align_center">
    <p>
      <small>
        Powered by <a href="https://github.com/nathansmith/adapt/blob/master/assets/js/adapt.js">Adapt.js</a> + <a href="http://960.gs/">960.gs</a>.
        &nbsp;
        |
        &nbsp;
        Repository at <a href="https://github.com/nathansmith/adapt">GitHub</a>.
      </small>
    </p>
  </div>
  <div class="grid_3 align_right">
    <p>
      <small>
        Custom grids via <a href="http://grids.heroku.com/">SprySoft</a>.
      </small>
    </p>
  </div>
</div>
</body>
</html>
Something went wrong with that request. Please try again.