---
title: "useAos"
description: "Vue composable to access the AOS plugin instance (animations on scroll) in your components, to refresh or trigger the animations"
package: "maz-ui"
url: "https://maz-ui.com/composables/use-aos"
---

# useAos

> Vue composable to access the AOS plugin instance (animations on scroll) in your components, to refresh or trigger the animations

- Package: `maz-ui`
- Import: `import { useAos } from 'maz-ui/composables/useAos'`
- Nuxt: auto-imported by `@maz-ui/nuxt` when `mazUi.plugins.aos` is enabled
- Web: https://maz-ui.com/composables/use-aos

**Warning:**

You must install the [aos plugin](../plugins/aos.md#install) before you start using it

**Tip:**

More info about the [aos plugin](../plugins/aos.md) can be found in its documentation

## Usage

```vue
<script lang="ts" setup>
import { useAos } from 'maz-ui/composables'

const aos = useAos()

onMounted(() => {
  aos.runAnimations()
})
</script>

<template>
  <img data-maz-aos="scale-in">
</template>
```