Giter VIP home page Giter VIP logo

headroom.js-freeze-unfreeze-methods's Introduction

Headroom.js: freeze/unfreeze methods

Extends Headroom.js plugin (https://github.com/WickyNilliams/headroom.js) by adding methods to freeze/unfreeze the current headroom's state.

  • freeze method: When called, this method will freeze the current headroom's state (pinned or unpinned). Headroom will not react to the user's scroll. If you wish to re-enable the headroom's default behaviour, you can call unfreeze method.

  • unfreeze method: When called, this method will resume headroom's default behaviour. Headroom will pin or unpin when the user scrolls the page. By default, Headroom is not freezed and calling this method before freeze will do nothing.

Compatibility

Headroom.js version lower than v0.10.0. This methods are integrated in Headroom.js for versions greater than v0.10.0.

Setup

Include headroom-freeze-unfreeze-methods.js after headroom.js file:

<script src="headroom.js"></script>
<script src="headroom-freeze-unfreeze-methods.js"></script>

Usage

With plain JS

Call the methods on an instance of Headroom:

// grab an element
var myElement = document.querySelector("header");
// construct an instance of Headroom, passing the element
var headroom  = new Headroom(myElement);
// initialise
headroom.init();

// freeze 
headroom.freeze();

// unfreeze
headroom.unfreeze();

With jQuery

$("#header").headroom();

// freeze method
$("#header").headroom('freeze');

// unfreeze method
$("#header").headroom('unfreeze');

Options

There is a new property for the classes option:

{
  // ... other options
  classes: {
    // ... other classes
    frozen : 'headroom--frozen'
  }
}

Styling (CSS)

Add some CSS to the new class headroom--frozen:

.headroom--frozen {
  opacity: 0.8;
}

Example

headroom.js-freeze-unfreeze-methods's People

Contributors

andreivictor avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.