feat(modal-property): additional exit functionality (#169)

fix(accessibility): aria-label the close button for screenreaders
docs: adds an example and escapable info section to documentation
This commit is contained in:
Nick Adams
2023-07-15 02:56:15 -06:00
committed by GitHub
parent 7569ca63be
commit 10be366d17
4 changed files with 65 additions and 5 deletions

View File

@@ -1,6 +1,7 @@
<script setup>
import ModalExample from './modal/examples/ModalExample.vue';
import ModalSizeExample from './modal/examples/ModalSizeExample.vue';
import ModalEscapableExample from './modal/examples/ModalEscapableExample.vue';
</script>
# Vue Modal - Flowbite
@@ -53,7 +54,7 @@ function showModal() {
</template>
```
## Sizes
## Size
You can use four different modal sizing options starting from small to extra large, but keep in mind that the width of these modals will remain the same when browsing on smaller devices.
@@ -75,3 +76,28 @@ import { Modal } from 'flowbite-vue'
<Modal size="5xl" />
</template>
```
## Escapable
The escapable property is true by default to improve user experience and accessibility.
This means that you may close the modal by
- Using the close button on the modal
- Clicking outside of the modal
- Pressing the escape key
In some situations, your user may be required to interact with the modal content. If this is the case, you can set the `escapable` property to false. The developer can then choose when they want to close the modal.
Demo:
<ModalEscapableExample/>
```vue
<script setup>
import { Modal } from 'flowbite-vue'
</script>
<template>
<Modal />
<Modal :escapable="false" />
</template>
```