Skip to content

Modal Media (Media Library) ​

ue-modal-media opens a fullscreen media library dialog. It combines ue-filter, ue-dropdown-filter, ue-uploader, and a media grid, allowing users to search, filter, upload, and select media files.

Usage ​

html
<ue-modal-media :type="mediaType" @insert="handleInsert">
  <template #activator="{ props }">
    <v-btn v-bind="props">Open Media Library</v-btn>
  </template>
</ue-modal-media>

Key Props ​

PropTypeDescription
typeObject|StringMedia type configuration or type key. Controls which media types are shown and the upload endpoint
typesArrayMultiple media type tabs — renders type-filter chips
authorizedBooleanWhether the current user can delete/modify media
connectorBooleanWhether to show the "Insert" button (used when selecting for a form field)
extraMetadatasArrayExtra metadata fields shown in the media sidebar
translatableMetadatasArrayMetadata fields with per-locale values
filterSchemaObject|Arrayue-dropdown-filter schema for advanced filtering

Events ​

EventDescription
insertEmitted with the selected media items when the user confirms their selection

Slots ​

SlotScopeDescription
activator{ props }Element that opens the media library modal

Behaviour ​

  • Fetches media from the configured endpoint using ue-filter search and ue-dropdown-filter advanced filters.
  • Uploads are handled by ue-uploader and immediately available in the grid after completion.
  • The "Insert" footer button only appears when connector is true and at least one item is selected.
  • Closes automatically after Insert is clicked.