Skip to content

useTemplateRefsList ​

Category
Export Size
177 B
Last Changed
last month

Shorthand for binding refs to template elements and components inside v-for.

WARNING

This function only works for Vue 3

Demo ​

12345
Open the console to see the output

Usage ​

vue
<script setup lang="ts">
import { useTemplateRefsList } from '@vueuse/core'
import { onUpdated } from 'vue'

const refs = useTemplateRefsList<HTMLDivElement>()

onUpdated(() => {
  console.log(refs)
})
</script>

<template>
  <div v-for="i of 5" :key="i" :ref="refs.set" />
</template>

Type Declarations ​

typescript
export type TemplateRefsList<T> = T[] & {
  set: (el: object | null) => void
}
export declare function useTemplateRefsList<T = Element>(): Readonly<
  Ref<Readonly<TemplateRefsList<T>>>
>

Source ​

Source • Demo • Docs

Contributors ​

Anthony Fu
Anthony Fu
bjym

Changelog ​

v12.0.0-beta.1 on 11/21/2024
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
v10.8.0 on 2/20/2024
a086e - fix: stricter types

Released under the MIT License.