Giter Club home page Giter Club logo

app-layout's Introduction

App Layout Build Status Published on webcomponents.org

A collection of elements, along with guidelines and templates that can be used to structure your app’s layout.

<app-header reveals>
  <app-toolbar>
    <paper-icon-button icon="menu" onclick="drawer.toggle()"></paper-icon-button>
    <div main-title>My app</div>
    <paper-icon-button icon="delete"></paper-icon-button>
    <paper-icon-button icon="search"></paper-icon-button>
    <paper-icon-button icon="close"></paper-icon-button>
    <paper-progress value="10" indeterminate bottom-item></paper-progress>
  </app-toolbar>
</app-header>
<app-drawer id="drawer" swipe-open></app-drawer>
<sample-content size="10"></sample-content>

Install

$ bower install PolymerElements/app-layout --save

Import

<link rel="import" href="/bower_components/app-layout/app-layout.html">

What is inside

Elements

  • app-box - A container element that can have scroll effects - visual effects based on scroll position.

  • app-drawer - A navigation drawer that can slide in from the left or right.

  • app-drawer-layout - A wrapper element that positions an app-drawer and other content.

  • app-grid - A helper class useful for creating responsive, fluid grid layouts using custom properties.

  • app-header - A container element for app-toolbars at the top of the screen that can have scroll effects - visual effects based on scroll position.

  • app-header-layout - A wrapper element that positions an app-header and other content.

  • app-toolbar - A horizontal toolbar containing items that can be used for label, navigation, search and actions.

Templates

The templates are a means to define, illustrate and share best practices in App Layout. Pick a template and customize it:

Patterns

Sample code for various UI patterns:

  • Transform navigation: As more screen space is available, side navigation can transform into tabs. (Demo - Source)

  • Expand Card: Content cards may expand to take up more horizontal space. (Demo - Source)

  • Material Design Responsive Toolbar: Toolbar changes its height and padding to adapt mobile screen size. (Demo - Source)

Users

Here are some web apps built with App Layout:

Tools and References

Changes in App Layout 2.0

  • Distribution is now done with slots, so things have changed because of that,

    app-drawer-layout

    1.x

    <app-drawer-layout>
      <app-drawer>...</app-drawer>
      <div>content</div>
    </app-drawer-layout>
    

    2.0

    <app-drawer-layout>
      <app-drawer slot="drawer">...</app-drawer>
      <div>content</div>
    </app-drawer-layout>
    
    app-header-layout

    1.x

    <app-header-layout>
      <app-header>...</app-header>
      <div>content</div>
    </app-header-layout>
    

    2.0

    <app-header-layout>
      <app-header slot="header">...</app-header>
      <div>content</div>
    </app-header-layout>
    
    app-box

    1.x

    <app-box effects="...">
      <img background ...>
    </app-box>
    

    2.0

    <app-box effects="...">
      <img slot="background" ...>
    </app-box>
    
  • In app-drawer-layout, the drawer-toggle element needs to be manually hidden when app-drawer-layout is not in narrow layout. To add this, add the following CSS rule where app-drawer-layout is used:

    app-drawer-layout:not([narrow]) [drawer-toggle] {
      display: none;
    }
  • In app-drawer-layout, if you specify a value for --app-drawer-width, that value must be accessible by both app-drawer and app-drawer-layout. This can be done by defining the value on the :host that contains (or html if outside a shadow root):

    :host {
      --app-drawer-width: 300px;
    }
  • app-scrollpos-control has been removed from App Layout in favor of using multiple scrolling regions to preserve the scroll position. In terms of UX, document.rootScroller is a new web platform API that will allow non-document scroll to hide the address bar on mobile.

app-layout's People

Contributors

43081j avatar abdonrd avatar abrahamic-god avatar ahaasler avatar aomarks avatar bicknellr avatar blasten avatar dfreedm avatar diegohaz avatar e111077 avatar ebidel avatar felixzapata avatar frankiefu avatar garlicnation avatar keanulee avatar ktiedt avatar lozandier avatar mgiuffrida avatar notwaldorf avatar pdesjardins90 avatar rictic avatar robrez avatar rubenstolk avatar samuelli avatar shahraship avatar tedium-bot avatar timbrockman avatar timvdlippe avatar valdrinkoshi avatar zecat 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.