Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

react-div-100vh

Package Overview
Dependencies
Maintainers
1
Versions
29
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

react-div-100vh

A React component that aims to solve '100vh' issue in mobile browsers

  • 0.3.2
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
70K
increased by5.86%
Maintainers
1
Weekly downloads
 
Created
Source

Div100vh React component

CircleCI

This is a workaround for iOS Safari and other mobile browsers.

The problem

At the top of the page, mobile browsers cover bottom of 100vh page with "browser chrome" (that's the name for browser navigation/context buttons, don't confuse with the browser from Google), effectively cropping it. If you have something important at the bottom of your splash screen, chances are it will not be visible/available until user scrolls.

More on this issue here.

The solution

iOS screenshots

<div style={{height: '100vh'}}><Div100vh>
Page cropped by bottom Safari chromePage cropped by bottom Safari chrome

The demo

Browse https://react-div-100vh.netlify.com on your phone!

API

  • Install it: npm install --save react-div-100vh or yarn add react-div-100vh
  • Import the component and wrap your stuff with <Div100vh> as you would with a normal <div style={{height: '100vh'}}>, but this time mobile browsers should display the whole page on load:

The default behavior

import Div100vh from 'react-div-100vh'

const MyFullscreenComponent = () => (
  <Div100vh>
    <marquee>Your stuff goes here</marquee>
  </Div100vh>
)

Using rvh units

If you want to set min-height (or any other property) instead, you can use made up rvh ("real viewport height") units in values of an object passed to style prop. Div100vh will find any style declarations with this unit and calculate the value as a percentage of window.innerHeight:

  <Div100vh style={{minHeight: '50rvh'}}>
    <marquee>This is inside a div that takes at least 50% of viewport height.</marquee>
  </Div100vh>

If you don't specify style prop, it works as if you specified {height: '100rvh'}; <Div100vh> is equivalent to <Div100vh style={{height: '100rvh'}}>.

If you do pass anything to the style prop, no implicit style is applied. You can do something like:

<Div100vh
  style={{maxHeight: '70rvh', color: 'blue'}}
  onClick={() => console.log('hi')}
>
  <p>my content here</p>
</Div100vh>

The rest of the props are passed unchanged to the underlying div that Div100vh renders.

Additional considerations

Please note that most likely you will want to set body {margin: 0} css, unless you use some css reset that does it for you.

FAQs

Package last updated on 28 Oct 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc