LoopOS UI v1.1.26.2

Previews

No matching results.

x
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
<turbo-frame id="multiple_image_images_pokemon_1_full">
  <div data-controller="images" data-images-editable-value="true" data-images-with-attached-value="false" data-images-turbo-frame-id-value="multiple_image_images_pokemon_1_full" data-images-unique-id-value="multiple_image_images_pokemon_1_full" data-images-list-view-value="false" data-images-has-many-value="true" data-images-force-new-value="false" data-images-urls-value="{"attach":"/loopos_ui/images","detach":"/loopos_ui/images"}">
    <div class="lui-image lui-image--full" data-images-target="imageComponent" data-action="pubsub:action@window->images#executeAction">
      <div role="status" class="hidden lui-image__loader" data-images-target="loader">
        <button class="lui-button lui-button--neutral--secondary lui-button--size-tiny lui-button--disabled w-fit w-fit" data-controller="lui--button" disabled="disabled">
          <i class="lui-button__icon lui-button__icon--tiny fa-regular fa-spinner" data-lui--button-target="leadingIcon"></i>
        </button>
      </div>
      <img class="hidden lui-image__image" data-images-target="image" src="" />
      <div class="lui-image__placeholder lui-image__placeholder--editable flex" data-images-target="placeholder">
        <div class="lui-icon h-[16px] w-[16px]">
          <i class="fa-regular fa-image lui-icon__icon" style="font-size: 16px; color: white;"></i>
        </div>
      </div>
      <div class="overflow-visible lui-image__image-edit">
        <form data-images-target="form" enctype="multipart/form-data" action="#" accept-charset="UTF-8" method="post"><input type="hidden" name="authenticity_token" value="xkbT8D-540GkarFZYiUaox7VhDrXAuqLtHrKRH6h7nR21uDZj7BMw1fsSnuATiPRitGxO3KCsBmzysRzgABbvA" autocomplete="off" />
          <input type="hidden" name="authenticity_token" id="authenticity_token" value="x1lHEv_0fr7i24MOlF7I0bAuidLZSghumN-kEKELNqrsOXxYC2rjEQ6kkbHJzsdlGx_eAcm-P9S1QjMC-9jpmg" autocomplete="off" />
          <input type="hidden" name="context" id="context" value="wZojhhRlTnpGAFF52Fqhm2+WQQat39e1FF+2uyJZF/WeD54VJdVdrRkifZV3zeFr1MTFs5Pp1tXKtbCtQZFJ7gC5foVSb5NI6NW9NHzsJ5AmyQPCz7ESPOwSqQNT92Nm8Ik1UoKLvYM=--piex7JbRQrl2vNEV--vLlL4n0l2FRrij1T66OBgQ==" autocomplete="off" />
          <div class="hidden" data-images-target="noImageUploader">
            <button class="lui-button lui-button--neutral--secondary lui-button--size-tiny w-fit w-fit" data-controller="lui--button" data-action="click->images#openFilePickerMultiple">
              <div class="lui-tooltip hidden"
    data-controller="tooltips"
    data-tooltips-tippy-target-id-value=""
    data-tooltips-position-value="top"
    data-tooltips-interactive-value="false"
  >
                <div class="lui-tooltip__title">
                  Upload images here
                </div>
              </div>
              <i class="lui-button__icon lui-button__icon--tiny fa-regular fa-upload" data-lui--button-target="leadingIcon"></i>
            </button>
          </div>
          <div class="hidden" data-images-target="withImageUploader">
            <div
  data-controller="action-menu"
  data-action="modal:open@window->action-menu#disableTippy modal:close@window->action-menu#enableTippy"
              class="lui-action-menu">
              <div data-action-menu-target="trigger">
                <button class="lui-button lui-button--neutral--secondary lui-button--size-tiny w-fit w-fit" data-controller="lui--button" type="button">
                  <i class="lui-button__icon lui-button__icon--tiny fa-regular fa-ellipsis-vertical" data-lui--button-target="leadingIcon"></i>
                </button>
              </div>
              <div data-action-menu-target="menu" class="hidden lui-action-menu__wrapper" data-controller="modal form-submit pubsub">
                <div class="lui-action-menu__options" role="menu" aria-orientation="vertical" aria-labelledby="options-menu">
                  <div class="lui-action-menu__option " data-action="click->pubsub#publish" data-pubsub-unique-id-param="multiple_image_images_pokemon_1_full" data-pubsub-action-param="openFilePicker">
                    <div class="lui-action-menu__option-text cursor-default">
                      <i class="fa-regular fa-arrows-rotate"></i>
                      <span>Upload new image</span>
                    </div>
                  </div>
                  <div class="lui-action-menu__option " data-action="click->pubsub#publish" data-pubsub-unique-id-param="multiple_image_images_pokemon_1_full" data-pubsub-action-param="openFilePickerMultiple">
                    <div class="lui-action-menu__option-text cursor-default">
                      <i class="fa-regular fa-plus"></i>
                      <span>Add more images</span>
                    </div>
                  </div>
                  <div class="lui-action-menu__option " data-action="click->pubsub#publish" data-pubsub-unique-id-param="multiple_image_images_pokemon_1_full" data-pubsub-action-param="detachImage">
                    <div class="lui-action-menu__option-text cursor-default">
                      <i class="fa-regular fa-trash"></i>
                      <span>Remove image</span>
                    </div>
                  </div>
                </div>
              </div>
            </div>
          </div>
          <input accept="image/jpeg,image/png,image/webp" class="hidden" data-images-target="file" data-action="change->images#previewAndSubmit" data-direct-upload-url="https://loopos-ui.theloop.pt/rails/active_storage/direct_uploads" type="file" name="file" id="file" />
          <input name="files[][]" type="hidden" value="" autocomplete="off" /><input accept="image/jpeg,image/png,image/webp" multiple="multiple" class="hidden" data-images-target="fileMultiple" data-action="change->images#previewAndSubmitMultiple" data-direct-upload-url="https://loopos-ui.theloop.pt/rails/active_storage/direct_uploads" type="file" name="files[][]" id="files[]" />
          <input type="submit" name="commit" value="Save" data-images-target="submit" data-disable-with="Save" class="hidden" />
        </form>
          </div>
    </div>
      <span class="lui-image__error" data-images-target="error">Error message</span>
  </div>
</turbo-frame>

No Usage documentation to display.

1
2
3
4
5
6
7
8
9
10
11
12
13
<%
    pokemon = Pokemon.first
    pokemon_args = {
        model: pokemon,
        association: :images,
        # size: :small,
        list_view: params[:list_view] || false,
    }
%>
<% pokemon.images.purge if params.delete(:delete_all_images).present? %>
<%= render LooposUi::V2::Image.new(**pokemon_args, editable: true) %>

No notes provided.

Param Description Input

—

—

Description

The Image V2 component is an enhanced version of the base Image component that provides image upload and management capabilities. It supports both single and multiple image handling, with options for different sizes, shapes, and editing capabilities.

Arguments

Property Default Description
model nil ActiveRecord model that the image belongs to
association nil Name of the image association on the model (:image or :images)
editable false Enables image upload and management controls
size :full Size of the image container (:full or :small)
rounded false Makes the image circular when true
image_url nil Direct URL to an image (alternative to model association)
accept configurable Array of accepted file types (e.g., [:jpeg, :png, "image/svg+xml"]), or :all for all registerer image MIME types
list_view false Enables list view mode for multiple images
path loopos_ui.images_path Path to backend controller. Use when you want to extend the current LoopOS UI one

accept get its default value from LooposUi.config.image_default_accept_formats, by default it accepts png, jpeg and webp. You can change this in the initializer.

When extending the LoopOS UI images controller, set the ActiveSupport::Callbacks needed in your own controller, and then call run_callbacks around the block you want your changes to act. These callbacks have to be named :create or :destroy, since those are the hooks available. Each of them allowing the programmer to insert operations before and after their respective methods.

# Your custom controller
class LooposUi::ExtendedImagesController < LooposUi::ImagesController
   #We can declare using Lambda, or methods
   set_callback :create, :before, -> { Rails.logger.info "Before" }
   set_callback :destroy, :after, :foo
   def foo
      Rails.logger.info "After" 
   end
end

Features

  1. Single Image Upload

    • Default placeholder for empty state
    • Upload button appears on hover when editable
    • Supports direct image URLs
    • Configurable accepted file types

  2. Multiple Image Upload

    • Supports ActiveStorage has_many relationships
    • Optional list view mode
    • Bulk upload capability
    • Image deletion functionality

  3. Styling Options

    • Two size options: full and small
    • Optional rounded/circular display
    • Responsive design
    • Hover states for interactive elements

Validations

The accept option is used to validate the file type during upload.

  • In the frontend: checking the declared MIME type
  • In the backend: checking the actual uploaded content type

In the case of multiple upload, the accept option is applied to each uploaded file, and the upload will fail if any of the files does not match the declared MIME type.

Leaving the accept option empty will allow all image MIME types to be uploaded (image/*), and in the backend will check if the uploaded MIME type is an image.

Note: This component uses it's own controller to handle the upload, using Direct Uploads. It also modifies the blob directly, so the model validation will not trigger. In a future version, this can change.