com.vaadin.polymer.public.bower_components.paper-header-panel.README.md Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of vaadin-gwt-polymer-elements Show documentation

vaadin-gwt-polymer-elements

There is a newer version: 1.9.3.1

Show newest version

# paper-header-panel

`paper-header-panel` contains a header section and a content panel section.

__Important:__ The `paper-header-panel` will not display if its parent does not have a height.

Using [layout classes](http://www.polymer-project.org/docs/polymer/layout-attrs.html), you can make
the `paper-header-panel` fill the screen

```html

  
    
      Hello World!
    
  

```

Special support is provided for scrolling modes when one uses a `paper-toolbar` or equivalent for the header section. For example:

```html

  Header
  Content goes here...

```

If you want to use other than `paper-toolbar` for the header, add `paper-header` class to that
element:

```html

  Header
  Content goes here...

```

To have the content fit to the main area, use the `fit` class:

```html

  standard
  content fits 100% below the header

```

### Mode

Controls header and scrolling behavior. Options are `standard`, `seamed`, `waterfall`, `waterfall-tall`, `scroll` and
`cover`. Default is `standard`.

Mode | Description
----------------|-------------
`standard` | The header is a step above the panel. The header will consume the panel at the point of entry, preventing it from passing through to the opposite side.
`seamed` | The header is presented as seamed with the panel.
`waterfall` | Similar to standard mode, but header is initially presented as seamed with panel, but then separates to form the step.
`waterfall-tall` | The header is initially taller (`tall` class is added to the header). As the user scrolls, the header separates (forming an edge) while condensing (`tall` class is removed from the header).
`scroll` | The header keeps its seam with the panel, and is pushed off screen.
`cover` | The panel covers the whole `paper-header-panel` including the header. This allows user to style the panel in such a way that the panel is partially covering the header.

Example: 

```html

  standard
  content fits 100% below the header

```

### Styling header panel:

To change the shadow that shows up underneath the header:

```css
paper-header-panel {
  --paper-header-panel-shadow: {
      height: 6px;
      bottom: -6px;
      box-shadow: inset 0px 5px 6px -3px rgba(0, 0, 0, 0.4);
  };
}
```

To change the panel container:

```css
paper-slider {
  --paper-header-panel-standard-container: {
    border: 1px solid gray;
  };

  --paper-header-panel-cover-container: {
    border: 1px solid gray;
  };

  --paper-header-panel-waterfall-container: {
    border: 1px solid gray;
  };

  --paper-header-panel-waterfall-tall-container: {
    border: 1px solid gray;
  };
}
```