Midday

NOTE: This module is a port of a jQuery plugin using just Javascript.

The original author is Aerolab.

The original plugin's repository can be found here.

Description: A module that switches between multiple header designs as you scroll, so you always have a header that looks great with the content below it.

Installation

Midday is available on NPM as midday.js:

``
npm install midday.js
`

Quick start

Create your fixed nav (or header) as you typically would. For an example, something like this (you can use whatever markup suits you)

`html



`

Make sure the header works well with position:fixed

After that, take any sections of your page that need a different nav and add data-midday="your-class" to it, where your-class is the class you are going to use to style that header. If you don't use the property or just leave it blank, the .default header will be used for that section.

`html


A section with a dark background, so a white nav would look better here


`

Multiple headers as necessary will be created based on the classes declared in these sections.

You can style it in your css using the class .middayHeader.your-class (replace your-class with the correct one). For example:


`css
.middayHeader.default {
background: none;
color: black;
}
.middayHeader.white {
background: white;
color: black;
}
.middayHeader.blue {
background: blue;
color: white;
}
.middayHeader.red {
background: red;
color: white;
}
`


To initialize, just load midday and initialize it

`js
import Midday from 'midday.js';

// Change this to the correct selector for your nav.
const fixedNav = new Midday(document.getElementById('fixedNav'), {});
`




Using custom markup

Let's say you want to create a special header with a butterfly in it, which needs some extra markup. You need to do two things:

* First, add a div with the class .middayHeader.default . This will be the header that's used for every section (that doesn't have a specific style) and duplicated as necessary, automatically replacing .default with the correct class.

* Then, add a div with the class .middayHeader.your-class (like .butterfly). This will be used in that case instead, so you can use some custom markup in that case. Repeat this step for any other header with custom markup.

* Keep in mind that all headers need to be the same height. Take that into account when styling your headers. If you have one that's larger than usual, we recommend you make all the headers the same height and try to handle it with additional markup.


`html



`

Options

You can use a variety of custom options when using midday:

`js
import Midday from 'midday.js';

const fixedNav = new Midday(document.getElementById('fixedNav'), {
// The class that wraps each header. Used as a clipping mask.
headerClass: 'middayHeader',
// The class that wraps the contents of each header. Also used as a clipping mask.
innerClass: 'middayInner',
// The class used by the default header (useful when adding multiple headers with different markup).
defaultClass: 'default'
});
`




Running Multiple Instances with Different Breakpoints

If you want to run multiple instances of midday with different breakpoints, you can use the sectionSelector option to choose where each nav is going to be split.

By default, the plugin will look for all the sections with the data-midday attribute, which is the default, but you can change this to suit your needs. For example:

`js
import Midday from 'midday.js';

const fixedNavOne = new Midday(document.getElementById('fixedNavOne'), {
// By default, sectionSelector is 'midday'. It will switch only on elements that have the data-midday attribute.
sectionSelector: 'midday'
});

const fixedNavTwo = new Midday(document.getElementById('fixedNavTwo'), {
// We want this nav to switch only on elements that have the data-noon attribute.
sectionSelector: 'noon'
});
``

Known Issues

On iOS <7 and older Android devices scrollTop isn't updated fluently, which creates a choppy effect. It can be fixed somewhat by wrapping the body in container and detecting touch events, but we're leaving that as an open issue. We'll probably disable the effect on older mobile devices due to bad performance.

You shouldn't add any sort of padding, margin or offset (top/left/right/bottom) to the nav, since it causes issues with rendering.