OLD | NEW |
| (Empty) |
1 # paper-header-panel | |
2 | |
3 `paper-header-panel` contains a header section and a content panel section. | |
4 | |
5 __Important:__ The `paper-header-panel` will not display if its parent does not
have a height. | |
6 | |
7 Using [layout classes](http://www.polymer-project.org/docs/polymer/layout-attrs.
html), you can make | |
8 the `paper-header-panel` fill the screen | |
9 | |
10 ```html | |
11 <body class="fullbleed layout vertical"> | |
12 <paper-header-panel class="flex"> | |
13 <paper-toolbar> | |
14 <div>Hello World!</div> | |
15 </paper-toolbar> | |
16 </paper-header-panel> | |
17 </body> | |
18 ``` | |
19 | |
20 Special support is provided for scrolling modes when one uses a `paper-toolbar`
or equivalent for the header section. For example: | |
21 | |
22 ```html | |
23 <paper-header-panel> | |
24 <paper-toolbar>Header</paper-toolbar> | |
25 <div>Content goes here...</div> | |
26 </paper-header-panel> | |
27 ``` | |
28 | |
29 If you want to use other than `paper-toolbar` for the header, add `paper-header`
class to that | |
30 element: | |
31 | |
32 ```html | |
33 <paper-header-panel> | |
34 <div class="paper-header">Header</div> | |
35 <div>Content goes here...</div> | |
36 </paper-header-panel> | |
37 ``` | |
38 | |
39 To have the content fit to the main area, use the `fit` class: | |
40 | |
41 ```html | |
42 <paper-header-panel> | |
43 <div class="paper-header">standard</div> | |
44 <div class="content fit">content fits 100% below the header</div> | |
45 </paper-header-panel> | |
46 ``` | |
47 | |
48 ### Mode | |
49 | |
50 Controls header and scrolling behavior. Options are `standard`, `seamed`, `water
fall`, `waterfall-tall`, `scroll` and | |
51 `cover`. Default is `standard`. | |
52 | |
53 Mode | Description | |
54 ----------------|------------- | |
55 `standard` | The header is a step above the panel. The header will consume the p
anel at the point of entry, preventing it from passing through to the opposite s
ide. | |
56 `seamed` | The header is presented as seamed with the panel. | |
57 `waterfall` | Similar to standard mode, but header is initially presented as sea
med with panel, but then separates to form the step. | |
58 `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 conde
nsing (`tall` class is removed from the header). | |
59 `scroll` | The header keeps its seam with the panel, and is pushed off screen. | |
60 `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 co
vering the header. | |
61 | |
62 Example: | |
63 | |
64 ```html | |
65 <paper-header-panel mode="waterfall"> | |
66 <div class="paper-header">standard</div> | |
67 <div class="content fit">content fits 100% below the header</div> | |
68 </paper-header-panel> | |
69 ``` | |
70 | |
71 ### Styling header panel: | |
72 | |
73 To change the shadow that shows up underneath the header: | |
74 | |
75 ```css | |
76 paper-header-panel { | |
77 --paper-header-panel-shadow: { | |
78 height: 6px; | |
79 bottom: -6px; | |
80 box-shadow: inset 0px 5px 6px -3px rgba(0, 0, 0, 0.4); | |
81 }; | |
82 } | |
83 ``` | |
84 | |
85 To change the panel container: | |
86 | |
87 ```css | |
88 paper-slider { | |
89 --paper-header-panel-standard-container: { | |
90 border: 1px solid gray; | |
91 }; | |
92 | |
93 --paper-header-panel-cover-container: { | |
94 border: 1px solid gray; | |
95 }; | |
96 | |
97 --paper-header-panel-waterfall-container: { | |
98 border: 1px solid gray; | |
99 }; | |
100 | |
101 --paper-header-panel-waterfall-tall-container: { | |
102 border: 1px solid gray; | |
103 }; | |
104 } | |
105 ``` | |
OLD | NEW |