Fields

Image

Inherits from File.

* has the same capabilities

The Image field is an extension of File that allows previewing uploaded images.

Image uses the same allowed extension settings as File: it inherits the global allowed_extensions list unless allowedExtensions() is called on the field. It does not automatically restrict uploads to image formats. Set an image extension list globally or on the field when needed.

 namespaces
use MoonShine\UI\Fields\Image;
 
Image::make('Thumbnail')
 namespaces
use MoonShine\UI\Fields\Image;
 
Image::make('Thumbnail')
<x-moonshine::form.file
    :imageable="true"
    name="thumbnail"
/>
<x-moonshine::form.file
    :imageable="true"
    name="thumbnail"
/>

If you need to customize a modal window with an image in "preview" mode, then you can use the extraAttributes() method.

Image::make('avatar')
    ->extraAttributes(
        fn(string $filename, int $index): ?FileItemExtra => new FileItemExtra(wide: false, auto: true, styles: 'width: 250px;')
    )
Image::make('avatar')
    ->extraAttributes(
        fn(string $filename, int $index): ?FileItemExtra => new FileItemExtra(wide: false, auto: true, styles: 'width: 250px;')
    )
  • wide - XL size of the modal window,
  • auto - The window size will adjust to the size of the content,
  • styles - Additional styles for the image in the modal window.