README
nuxt-viewport
Define custom viewports for your Nuxt️ project
Features
- ⚡️ Fast & Light with MatchMedia API ⚡️
- 🕶 Auto detects the device viewport from Cookie & User-Agent
- 👌 Zero configuration to start
- 👴️ Supports IE9+
Quick Setup
- Add
nuxt-viewport
dependency to your project
# Using npm
npm install --save-dev nuxt-viewport
# Using yarn
yarn add --dev nuxt-viewport
- Add
nuxt-viewport
to themodules
section ofnuxt.config.js
{
modules: [
[
'nuxt-viewport', {
/* Viewport options */
}
],
]
}
using top level options
{
modules: [
'nuxt-viewport',
],
viewport: {
/* Viewport options */
},
}
@nuxtjs/composition-api
Usage with import { defineComponent, useContext, watch } from '@nuxtjs/composition-api'
export default defineComponent({
setup() {
// Context.
const context = useContext()
// Viewport module.
const viewport = context.$viewport
// Watch breakpoint for updates.
watch(() => viewport.breakpoint, (newBreakpoint, oldBreakpoint) => {
console.log('Breakpoint updated:', oldBreakpoint, '->', newBreakpoint)
})
},
})
Typescript
If using typescript or running typescript language server to check the code (for example through Vetur), add types to types
array in your tsconfig.json
:
{
"compilerOptions": {
"types": [
"@nuxt/types",
"nuxt-viewport",
]
}
}
Configuration
breakpoints
- Type: Object
An object where the key is the name of the viewport, and the value is the viewport size.
cookieName
- Type: String
- Default:
viewport
The key for the document cookie.
defaultBreakpoints
- Type: Object
- Detectable devices:
console
,desktop
,embedded
,mobile
,smarttv
,tablet
,wearable
An object where the key is the name of the detected device, and the value is the breakpoint key.
fallbackBreakpoint
- Type: String
- Default:
viewport
The breakpoint key to be used, if the device was not detected.
Default configuration
{
// ...
viewport: {
breakpoints: {
desktop: 1024,
desktopMedium: 1280,
desktopWide: 1600,
mobile: 320,
mobileMedium: 375,
mobileWide: 425,
tablet: 768,
},
cookieName: 'viewport',
defaultBreakpoints: {
desktop: 'desktop',
mobile: 'mobile',
tablet: 'tablet',
},
fallbackBreakpoint: 'desktop',
},
// ...
}
Example configuration for Tailwind CSS
{
// ...
viewport: {
breakpoints: {
xs: 320,
sm: 640,
md: 768,
lg: 1024,
xl: 1280,
'2xl': 1536,
},
defaultBreakpoints: {
desktop: 'lg',
mobile: 'xs',
tablet: 'md',
},
fallbackBreakpoint: 'lg'
},
// ...
}
API
$viewport.breakpoint
- Type: String
Current breakpoint.
$viewport.isGreaterThan
- Type: Boolean
// Example: $viewport.breakpoint is "mobile".
$viewport.isGreaterThan('mobile') // Result: false.
$viewport.isGreaterThan('desktop') // Result: false.
$viewport.isGreaterOrEquals
- Type: Boolean
// Example: $viewport.breakpoint is "mobile".
$viewport.isGreaterOrEquals('mobile') // Result: true.
$viewport.isGreaterOrEquals('desktop') // Result: false.
$viewport.isLessThan
- Type: Boolean
// Example: $viewport.breakpoint is "desktop".
$viewport.isLessThan('desktopWide') // Result: true.
$viewport.isLessThan('mobile') // Result: false.
$viewport.match
- Type: Boolean
// Example: $viewport.breakpoint is "tablet".
$viewport.match('tablet') // Result: true.
$viewport.match('desktop') // Result: false.
$viewport.matches
- Type: Boolean
// Example: $viewport.breakpoint is "mobileWide".
$viewport.matches('tablet', 'mobileWide') // Result: true.
$viewport.matches('mobile', 'tablet') // Result: false.
Contributing
You can contribute to this module online with CodeSandBox:
Or locally:
- Clone this repository
- Install dependencies using
yarn install
ornpm install
- Start development server using
yarn dev
ornpm run dev
License
Copyright (c) mvrlin mvrlin@pm.me