Teleport for Bootstrap 3
Grid layouts without sacrificing source order

Sponsored by Terracoding

Why?

Float-based grid systems (like Bootstrap's) are great for quickly creating column-based layouts but sometimes rely on source order to position things correctly.

Until Bootstrap 4 is released with flexbox support, Teleport is a simple way to construct layouts not possible with standard responsive design.

Desired Result (with Teleport)

✔ Mobile

✔ Desktop

Try resizing the page to see the boxes stack correctly on mobile

Source order: 1
Source order: 2
Source order: 3

Maintaining source order (without Teleport)

✔ Mobile

✖ Desktop

Boxes stack correctly on mobile but the desired layout isn't possible for desktop

Source order: 1
Source order: 2
Source order: 3

Sacrificing source order (without Teleport)

✖ Mobile

✔ Desktop

We have our desired layout on desktop but our single-column hierarchy is wrong on mobile (and for screen readers)

Source order: 1
Source order: 2
Source order: 3

How?

Teleport is a simple bit of Javascript that relocates DOM nodes between placeholders in the HTML as the viewport is resized.

Here is the HTML for the Desired Result example above:

<div class="row">
  <div class="col-sm-4">
    <p>Source order: 1</p>
    <div data-teleport="red sm"></div>
  </div>
  <div class="col-sm-8">
    <p>Source order: 2</p>
  </div>
  <div class="col-xs-12" data-teleport="red xs">
    <p>Source order: 3</p>
  </div>
</div>

The content from red xs is teleported to red sm when the viewport crosses the $screen-sm-min Bootstrap breakpoint. You can define as many placeholder elements as you like with an identifier (.e.g red) followed by xs, sm, md or lg.

Setup

You'll need:

I've been lazy packaging up the assets for others to use. Shout at me on Twitter if you need them in another format and I'll see what I can do.

Flash of Pre-Teleport Layout

If you find a teleporting element is causing a nasty flash of incorrect layout until Javascript has loaded, you can use Bootstrap's responsive utility classes to limit its visibility to appropriate breakpoints.

For example, if your content is in the XS placeholder by default (which I recommend - mobile first) then you can do:

<div class="visible-xs-block" data-teleport="id xs">

But beware: The above example will mean users on desktop with Javascript disabled will never see the content (as it won't get teleported out of the XS block). It would be possible to solve that with some overriding CSS wrapped in <noscript> if necessary though.