useTextareaAutosize ​
Automatically update the height of a textarea depending on the content.
Demo ​
Type, the textarea will grow:
Usage ​
Simple example ​
vue
<script setup lang="ts">
const { textarea, input } = useTextareaAutosize()
</script>
<template>
<textarea
ref="textarea"
v-model="input"
class="resize-none"
placeholder="What's on your mind?"
/>
</template>
INFO
It's recommended to reset the scrollbar styles for the textarea element to avoid incorrect height values for large amounts of text.
css
textarea {
-ms-overflow-style: none;
scrollbar-width: none;
}
textarea::-webkit-scrollbar {
display: none;
}
With rows
attribute ​
If you need support for the rows attribute on a textarea element, then you should set the styleProp
option to minHeight
.
vue
<script setup lang="ts">
const { textarea, input } = useTextareaAutosize({ styleProp: 'minHeight' })
</script>
<template>
<textarea
ref="textarea"
v-model="input"
class="resize-none"
placeholder="What's on your mind?"
rows="3"
/>
</template>
Type Declarations ​
Show Type Declarations
typescript
export interface UseTextareaAutosizeOptions {
/** Textarea element to autosize. */
element?: MaybeRef<HTMLTextAreaElement | undefined>
/** Textarea content. */
input?: MaybeRef<string>
/** Watch sources that should trigger a textarea resize. */
watch?: WatchSource | Array<WatchSource>
/** Function called when the textarea size changes. */
onResize?: () => void
/** Specify style target to apply the height based on textarea content. If not provided it will use textarea it self. */
styleTarget?: MaybeRef<HTMLElement | undefined>
/** Specify the style property that will be used to manipulate height. Can be `height | minHeight`. Default value is `height`. */
styleProp?: "height" | "minHeight"
}
export declare function useTextareaAutosize(
options?: UseTextareaAutosizeOptions,
): {
textarea: Ref<
HTMLTextAreaElement | undefined,
HTMLTextAreaElement | undefined
>
input: Ref<string, string>
triggerResize: () => void
}
export type UseTextareaAutosizeReturn = ReturnType<typeof useTextareaAutosize>
Source ​
Contributors ​
Anthony Fu
axuj
Anthony Fu
Mutter
huiliangShen
yakudik
leex
JD Solanki
Dominik Pschenitschni
Jelf
Enzo Innocenzi
Changelog ​
v12.1.0
on 12/22/2024v12.0.0-beta.1
on 11/21/2024v11.0.0-beta.2
on 7/17/2024v10.10.0
on 5/27/2024v10.8.0
on 2/20/2024v10.2.0
on 6/16/2023v10.0.0-beta.0
on 3/14/2023v9.7.0
on 12/16/2022ea497
- fix: reference