vue-detachable-header

0.4.0 • Public • Published

vue-detachable-header

Wrap your header in this to get it to reveal itself in a detached state on scroll up. Elegantly handles the transition back to a docked state on scroll back to top.

Usage

import Vue from 'vue'
import DetachableHeader from 'vue-detachable-header'
import 'vue-detachable-header/index.css'
Vue.component('detachable-header', DetachableHeader)
<detachable-header :height="80">
  <desktop-header>...</desktop-header>
</detachable-header>
.desktop-header {

  /* Fill the height of the detachable-header */
  height: 100%;

  /* Make the header text white at the top of the page */
  color: white;
  background: transparent;
}

/* Switch to inverterd styling when detached */
.show-background .desktop-header {
  color: black;
  background: white;
}

Props

Name Default Description
height undefined The height of the header as an integer.
offset 0 Adjusts the top of the header by this amount when at the top of the page. Useful when the site has a notification bar above the header; you would set this value to the height of the notification bar.
no-offset-when-detached false When false, if there is an offset, the header respects the offset when detached (aka, when you have scrolled down the page a ways and then scrolled back up). This is useful for notification bars that don't hide on scrol. When true, the header has a top of 0 when it's detached.
reveal-transition "translate" How the header enters when detached. Supports "translate" and "fade".
force-background false Forces show-background class.
force-reveal false Forces reveal of detached state.
scroll undefined Manually pass in the current scroll value. This could be useful when used with a smooth scrolling library.
off-screen-pad 0 Adds additional padding to the offscreen height to account for headers that may have overflow on the lower edge

Readme

Keywords

none

Package Sidebar

Install

npm i vue-detachable-header

Weekly Downloads

18

Version

0.4.0

License

MIT

Unpacked Size

29 kB

Total Files

7

Last publish

Collaborators

  • weotch
  • sjstark