0.2.1 • Published 3 years ago

vue-div-100vh v0.2.1

Weekly downloads
634
License
-
Repository
github
Last release
3 years ago

Vue100vh Vue component

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

Originally forked from react-div-100vh by mvasin.

CSS Only Fix

If you only need to be able to use 100vh, then the postcss-100vh-fix plugin may be a better solution.

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'}}><Vue100vh>
Page cropped by bottom Safari chromePage cropped by bottom Safari chrome

API

  • Install it: npm install --save vue-div-100vh or yarn add vue-div-100vh
  • Import the component and wrap your stuff with <Vue100vh> 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

<template>
  <Vue100vh>
    <marquee>Your stuff goes here</marquee>
  </Vue100vh>
</template>

<script>
import Vue100vh from 'vue-div-100vh'

export default {
  ...,
  components: { Vue100vh },
}
</script>

Using vvh units

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

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

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

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

<Vue100vh
  :style="{ maxHeight: '70vvh', color: 'blue'}"
  @click.native="() => { console.log('hi') }"
>
  <p>my content here</p>
</Vue100vh>

The rest of the props are passed unchanged to the underlying div that Vue100vh 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.

0.2.1

3 years ago

0.2.0

3 years ago

0.1.2

5 years ago

0.1.1

5 years ago

0.1.0

5 years ago