Skip to content

mghiozzi/ionic-ios-header

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ionic iOS Header

Simple ionic module that emulates iOS 11 headers. Still in development 😎

Try it on StackBlitz!

Features:

  • Easy to setup 🏂
  • Searchbar support 🔍
  • Android fallback 🤖
  • Customizable 👨‍🎨️

How do I install it?

Install it from npm:

npm i --save ionic-ios-header

You just need to import the module:

import { IonicIOSHeaderModule } from 'ionic-ios-header';
@NgModule({
  ...
  imports: [
    IonicIOSHeaderModule
  ]
  ...
});

How do I use it?

It's easy! Just use the header-content component, instead of ion-header and ion-content, in your page!

<header-content search="true" [(query)]="query" title="Photos">
  //What you put here will be placed inside ion-content
  <ion-card *ngFor="let photo of photos;  let i = index">
    <img [src]="photo"/>
  </ion-card>
</header-content>

This is a pretty complete example:

  • search attribute displays a searchbar if set.
  • query attribute 2-way-binds a variable to the search input: no need to manage events!
  • title attribute is self-explanatory

Styles:

You can use pre-made styles make the header even cooler! At the moment there are two:

  • blur-overlay which is my attempt at emulating the native blur effect found in iOS 11 headers.
  • white-noborder which displays a white background header whith no borders.

Simply import one in your src/theme/variables.css

@import "../../node-modules/ionic-ios-header/scss/blur-overlay";
@import "ionic.globals";

It is also possible to change default variables for the blur overlay:

$filter: blur(300px);
$background: rgba(255,255,255,0.3);
@import "../../node-modules/ionic-ios-header/scss/blur-overlay";
@import "ionic.globals";

Work in progress:

  • Unit Tests
  • Custom templates
  • Code cleaning, missing types
  • Complete documentation

Releases

No releases published

Packages

No packages published