useScrollLock
Lock scrolling of the element.
Demo
TopLeft
BottomLeft
TopRight
BottomRight
Scroll Me
isLocked false
Usage
<script setup lang="ts">
import { useScrollLock } from '@vueuse/core'
const el = ref<HTMLElement | null>(null)
const isLocked = useScrollLock(el)
isLocked.value = true // lock
isLocked.value = false // unlock
</script>
<template>
<div ref="el"></div>
</template>
<script setup lang="ts">
import { useScrollLock } from '@vueuse/core'
const el = ref<HTMLElement | null>(null)
const isLocked = useScrollLock(el)
isLocked.value = true // lock
isLocked.value = false // unlock
</script>
<template>
<div ref="el"></div>
</template>
Directive Usage
This function also provides a directive version via the
@vueuse/components
package. Learn more about the usage.
<script setup lang="ts">
import { vScrollLock } from '@vueuse/components'
const data = ref([1, 2, 3, 4, 5, 6])
const isLocked = ref(false)
const toggleLock = useToggle(isLocked)
</script>
<template>
<div v-scroll-lock="isLocked">
<div v-for="item in data" :key="item">
{{ item }}
</div>
</div>
<button @click="toggleLock()">
Toggle lock state
</button>
</template>
<script setup lang="ts">
import { vScrollLock } from '@vueuse/components'
const data = ref([1, 2, 3, 4, 5, 6])
const isLocked = ref(false)
const toggleLock = useToggle(isLocked)
</script>
<template>
<div v-scroll-lock="isLocked">
<div v-for="item in data" :key="item">
{{ item }}
</div>
</div>
<button @click="toggleLock()">
Toggle lock state
</button>
</template>
Type Declarations
/**
* Lock scrolling of the element.
*
* @see https://vueuse.org/useScrollLock
* @param element
*/
export declare function useScrollLock(
element: MaybeRef<
HTMLElement | SVGElement | Window | Document | null | undefined
>,
initialState?: boolean
): WritableComputedRef<boolean>
/**
* Lock scrolling of the element.
*
* @see https://vueuse.org/useScrollLock
* @param element
*/
export declare function useScrollLock(
element: MaybeRef<
HTMLElement | SVGElement | Window | Document | null | undefined
>,
initialState?: boolean
): WritableComputedRef<boolean>
Source
Contributors
Anthony Fu
webfansplz
Ayaka Rizumu
Jelf
wheat
Changelog
v8.4.2
on 5/5/2022v8.0.0-beta.1
on 3/5/2022v7.7.1
on 3/5/2022v7.3.0
on 12/12/2021v7.1.0
on 11/24/2021