1.1.4 • Published 6 months ago

@geomatico/react-swipeable-bottom-sheet v1.1.4

Weekly downloads
-
License
-
Repository
github
Last release
6 months ago

Swipeable Bottom Sheet

WARNING

This only works with node 0.10

A swipeable material's bottom sheet implementation, that uses react-swipeable-views. This can be used to reproduce Material Design's Bottom Sheet guidelines

Alt text

Installation

npm i -S react-swipeable-bottom-sheet

Demo & Examples

Usage

import SwipeableBottomSheet from 'react-swipeable-bottom-sheet';

<SwipeableBottomSheet overflowHeight={64}>
	<div style={{ height: '240px' }}>
		Here goes the content of your bottom sheet
	</div>
</SwipeableBottomSheet>

The bottom sheet's height (when open) scales automatically with its content. If it exceeds the window height, content become scrollable.

Props

NameTypeDefaultDescription
overflowHeightnumber0The height (in px) of the sheet when closed.
openboolUse this property to enable controlled mode. If true, it will open the sheet.
defaultOpenboolfalseIf true, the sheet is open at component mount.
onChangefunction(isOpen)The callback that fires after sheet opens or closes.
onTransitionEndfunction()The callback that fires after opening or closing animation.
fullScreenboolfalseIf true, the sheet takes the full height of the window when open.
marginTopnumber0The top margin applied to the top of the sheet when open. Use this prop to prevent navbar overflow.
shadowTipbooltrueIf true, a box shadow is displayed at sheet bottom when closed. This is used to show that content is hidden below.
topShadowbooltrueIf true, a box shadow is displayed at sheet top border.
overlaybooltrueIf true, an overlay is displayed behind sheet when open. A click on the overlay closes the sheet.
scrollTopAtClosebooltrueIf true, the content is scrolled to the top when sheet closes.
swipeableViewsPropsobject{}Props passed to SwipeableViews component (see documentation).
styleobject{}Style applied on the root (non-swiped) component.
bodyStyleobject{}Style applied on the body of the bottom sheet.
overlayStyleobject{}Style applied on the overlay.

Development (src, lib and the build process)

NOTE: The source code for the component is in src. A transpiled CommonJS version (generated with Babel) is available in lib for use with node.js, browserify and webpack. A UMD bundle is also built to dist, which can be included without the need for any build system.

To build the examples locally, run:

npm install
npm start

Then open localhost:8000 in a browser.

To build, watch and serve the examples (which will also watch the component source), run npm start. If you just want to watch changes to src and rebuild lib, run npm run watch (this is useful if you are working with npm link).

License

MIT