nebula-sidebar-layout
A collapsible sidebar layout.
[ This description is mirrored from README.md at github.com/arsnebula/nebula-sidebar-layout on 2019-05-22 ]
<nebula-sidebar-layout>
A responsive sidebar layout with animated drawer.
- Two-column application layout using slots
- Fixed sidebar container on the left, fluid content container on the right
- Sidebar collapses to an animated slide-out drawer at a specified breakpoint
Installation
$ bower install -S arsnebula/nebula-sidebar-layout
Getting Started
Import the element:
<link rel="import" href="/bower_components/nebula-sidebar-layout/nebula-sidebar-layout.html">
The element utilizes offscreen positioning for the drawer when collapsed, so the body
and and other parent elements should be set to fill the browser screen. The following is a sample stylesheet for ensuring the body matches the viewport.
<head>
<style>
html, body {
position: relative;
border: 0;
margin: 0;
padding: 0;
min-height: 100vh;
width: 100%;
height: 100%;
overflow: hidden;
overflow-y: auto;
box-sizing: border-box;
}
</style>
</head>
Add the element.
<nebula-sidebar-layout
breakpoint="(max-width: 960px)"
collapsed="{{collapsed}}"
opened="{{opened}}"
on-changed="_onChanged">
<div slot="sidebar"></div>
<div slot="content"></div>
</nebula-sidebar-layout>
Style the element.
nebula-sidebar-layout {
--nebula-sidebar-layout-backdrop-color: hsla(0, 0%, 0%, 0.6);
--nebula-sidebar-layout-animation-duration: 250ms;
}
For more information, see the API documentation.
Contributing
We welcome and appreciate feedback from the community. Here are a few ways that you can show your appreciation for this package:
Give us a Star on GitHub from either webcomponents.org or directly on GitHub.
Submit a feature request, or a defect report on the Issues List.
Become a Patreon. It takes a lot of time and effort to develop, document, test and support the elements in our Nebula Essentials collection. Your financial contribution will help ensure that our entire collection continues to grow and improve.
If you are a developer, and are interested in making a code contribution, consider opening an issue first to describe the change, and discuss with the core repository maintainers. Once you are ready, prepare a pull request:
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
Change Log
See CHANGELOG
License
See LICENSE
Links
Compatibility
Was this helpful? Need more help?
Leave a comment or a question below. You can also join
the chat on Discord or
ask questions on StackOverflow.
Version
Dependencies
- polymer#Polymer/polymer#^2.0.0
- nebula-element-mixin#arsnebula/nebula-element-mixin#^2.0.0
- nebula-media-query#arsnebula/nebula-media-query#^2.0.0
- Released
- 2017-05-23
- Maturity
- IMPORTED
- License
- ISC License
Compatibility
- Framework
- Polymer 2.0+
- Polymer 1.0+ in 2.0.0
- Browser
- Browser Independent