Galeria

Ustawienia modułu

Ustawianie galerii zdjęć

Ustawienia galerii Opis wszystkich ustawień modułu

Opis wszystkich ustawień wraz z domyślnymi wartościami znajduje się w poniższej instancji. Dodatkowo, artykuł zawiera tabelę prezentującą poszczególne opcje wraz z  dostępnymi wariantami. Konstrukcja aplikacji pozwala umieścić wiele instancji z różną konfiguracją ustawień.

    <!-- Treść strony -->
    <script src="compsoul.js"></script>
    <script src="gallery.js"></script>
    <script>
      new Gallery(".gallery-item").options({
        galleryClassContainer: "compsoul-gallery-container",
        galleryClassContent: "compsoul-gallery-content",
        galleryClassClose: "compsoul-gallery-close",
        galleryClassNext: "compsoul-gallery-next",
        galleryClassPrev: "compsoul-gallery-prev",
        galleryClassProgress: "compsoul-gallery-progress",
        galleryClassItem: "compsoul-gallery-item",
        galleryClassImage: "compsoul-gallery-image",
        galleryClassComment: "compsoul-gallery-comment",
        galleryClassZoom: "compsoul-gallery-zoom",
        galleryClassFullScreen: "compsoul-gallery-full-screen",

        thumbnailsClassContainer: "thumbnails-container",
        thumbnailsClassContent: "thumbnails-content",
        thumbnailsClassToggle: "thumbnails-toggle",
        thumbnailsClassShow: "thumbnails-show",
        thumbnailsClassImage: "thumbnails-image",

        classActive: "compsoul-active",
        classInactive: "compsoul-inactive",
        classNext: "compsoul-next",
        classPrev: "compsoul-prev",
        classFade: "compsoul-fade",
        classPast: "compsoul-past",
        classReady: "compsoul-ready",
        classResize: "compsoul-resize",
        classLoader: "compsoul-loader",
        classLoading: "compsoul-loading",
        classLoaded: "compsoul-loaded",
        classError: "compsoul-error",
        classZoom: "compsoul-zoom",
        classZoomOut: "compsoul-zoom-out",
        classOverflow: "compsoul-overflow",
        classDirectionNext: "compsoul-direction-next",
        classDirectionPrev: "compsoul-direction-prev",
        classPlay: "compsoul-play",
        classHidden: "compsoul-hidden",
        classUnset: "compsoul-unset",
        classDrag: "compsoul-drag",
        classDisorderly: "compsoul-disorderly",
        classLogo: "compsoul-logo",
        selector: selector,

        close: true,
        closeDelay: 200,
        next: true,
        prev: true,

        album: false,
        albumStart: 0,
        preload: true,
        counter: true,
        loop: true,
        zoom: true,
        zoomDelay: 400,
        overflow: true,
        hash: true,
        thumbnails: true,

        keyNext: ["ArrowRight", "d", "KeyD"],
        keyPrev: ["ArrowLeft", "a", "KeyA"],
        keyClose: ["Escape", "x", "KeyX"],
        keyCounter: ["Space"],
        keyThumbnails: ["t", "KeyT"],
        keyZoom: ["z", "KeyZ"],
        responsive: {
          400: {
            loop: false
          },
          800: {
            loop: true
          },
          1300: {
            loop: false
          }
        }
      }).init();
    </script>
  </body>
</html>

Tabela zawierająca opis ustawień

Dodana tabela zawiera dokładny opis ustawień galerii, wraz z ich przeznaczeniem oraz dostępnymi wariantami. Istnieje możliwość swobodnej rozbudowy modułu poprzez edycję pliku gallery.js. Wybrane opcje posiadają dedykowane podstrony, gdzie zostały szerzej omówione.

Nazwa właściwości Domyślna wartość Dostępne warianty Opis
close true boolean (true, false) Opcja odpowiedzialna za zamykanie okna galerii
closeDelay 200 number (liczby) Czas niezbędny na wykonanie animacji zamknięcia okna galerii
next true boolean (true, false) Opcja odpowiedzialna za uruchamianie następnego zdjęcia
prev true boolean (true, false) Opcja odpowiedzialna za uruchamianie poprzedniego zdjęcia
album false boolean (true, false) Opcja odpowiedzialna za wczytywanie listy zdjęć z innych stron
albumStart 0 number (liczby) Opcja wskazujące pierwsze zdjęcie albumu
preload false boolean (true, false) Opcja odpowiedzialna za prewencyjne wczytywanie zdjęć. Jest to opcja testowa i należy używać jej ostrożnie, gdyż Chromium nie blokuje możliwości wczytywania nieskończonej liczby zdjęć. Przy dużych galeriach, można w łatwy sposób pozbawić użytkownika zasobów pamięci RAM.
counter true boolean (true, false) Opcja odpowiedzialna za pokaz slajdów
loop true boolean (true, false) Opcja umożliwiająca zapętlanie galerii
zoom true boolean (true, false) Opcja umożliwiająca maksymalne powiększanie zdjęcia
zoomDelay 400 number (liczby) Czas niezbędny na wykonanie animacji zamknięcia maksymalnie powiększonego zdjęcia
overflow true boolean (true, false) Opcja ukrywająca pasek przewijania strony
overflow true boolean (true, false) Opcja otwierająca galerię na podstawie ukrytej zmiennej w pasku URL
thumbnails true boolean (true, false) Opcja odpowiedzialna za wyświetlanie miniatur
keyNext ["ArrowRight", "d", "KeyD"] array (tablica) Opcja zawierająca tablicę kodową nazw klawiszy klawiatury, odpowiedzialnych za zmianę zdjęcia
keyPrev ["ArrowLeft", "a", "KeyA"] array (tablica) Opcja zawierająca tablicę kodową nazw klawiszy klawiatury, odpowiedzialnych za zmianę zdjęcia
keyClose ["Escape", "x", "KeyX"] array (tablica) Opcja zawierająca tablicę kodową nazw klawiszy klawiatury, odpowiedzialnych za zamknięcie galerii
keyCounter ["Space"] array (tablica) Opcja zawierająca tablicę kodową nazw klawiszy klawiatury, odpowiedzialnych za kontrolowanie pokazu slajdów
keyThumbnails ["t", "KeyT"] array (tablica) Opcja zawierająca tablicę kodową nazw klawiszy klawiatury, odpowiedzialnych za kontrolowanie listy miniatur
keyZoom ["z", "KeyZ"] array (tablica) Opcja zawierająca tablicę kodową nazw klawiszy klawiatury, odpowiedzialnych za kontrolowanie funkcji maksymalnego powiększania zdjęcia
responsive {} object (obiekt) Obiekt przechowujący szereg ustawień odpowiedzialnych za zmianę zachowania modułu na poszczególnych rozdzielczościach. Więcej informacji w zakładce: RWD

Nomenklatura modułu

Nazwa właściwości Domyślna wartość Dostępne warianty Opis
galleryClassContainer "compsoul-gallery-container" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość galerii
galleryClassContent "compsoul-gallery-content" string (tekst) Nazwa klasy CSS elementu reprezentującego listę zdjęć
galleryClassClose "compsoul-gallery-close" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za zamykanie galerii
galleryClassNext "compsoul-gallery-next" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za zmianę slajdu
galleryClassPrev "compsoul-gallery-prev" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za zmianę slajdu
galleryClassProgress "compsoul-gallery-progress" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za czasową zmianę slajdu
galleryClassItem "compsoul-gallery-item" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość poszczególnego zdjęcia
galleryClassImage "compsoul-gallery-image" string (tekst) Nazwa klasy CSS elementu reprezentującego poszczególne zdjęcie
galleryClassComment "compsoul-gallery-comment" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość poszczególnego komentarza
galleryClassZoom "compsoul-gallery-zoom" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za funkcje powiększania zdjęcia
galleryClassFullScreen "compsoul-gallery-full-screen" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość powiększonego zdjęcia
thumbnailsClassContainer "thumbnails-container" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość listy miniatur
thumbnailsClassContent "thumbnails-content" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość listy miniatur
thumbnailsClassToggle "thumbnails-toggle" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za funkcje wyświetlania listy miniatur
thumbnailsClassShow "thumbnails-show" string (tekst) Nazwa klasy CSS elementu odpowiedzialnego za funkcje wyświetlania listy miniatur
thumbnailsClassImage "thumbnails-image" string (tekst) Nazwa klasy CSS elementu reprezentującego zawartość pojedynczej miniatury
classActive "compsoul-active" string (tekst) Nazwa klasy CSS odpowiedzialna za aktywację poszczególnych elementów
classInactive "compsoul-inactive" string (tekst) Nazwa klasy CSS odpowiedzialna za dezaktywację poszczególnych elementów
classNext "compsoul-next" string (tekst) Nazwa klasy CSS odpowiedzialna za animacje
classPrev "compsoul-prev" string (tekst) Nazwa klasy CSS odpowiedzialna za animacje
classFade "compsoul-fade" string (tekst) Nazwa klasy CSS odpowiedzialna za animacje
classPast "compsoul-past" string (tekst) Nazwa klasy CSS odpowiedzialna za animacje
classReady "compsoul-ready" string (tekst) Nazwa klasy CSS odpowiedzialna za proces renderingu
classResize "compsoul-resize" string (tekst) Nazwa klasy CSS odpowiedzialna za RWD
classLoader "compsoul-loader" string (tekst) Nazwa klasy CSS odpowiedzialna za proces renderingu
classLoading "compsoul-loading" string (tekst) Nazwa klasy CSS odpowiedzialna za proces renderingu
classLoaded "compsoul-loaded" string (tekst) Nazwa klasy CSS odpowiedzialna za proces renderingu
classError "compsoul-error" string (tekst) Nazwa klasy CSS odpowiedzialna za proces renderingu
classZoom "compsoul-zoom" string (tekst) Nazwa klasy CSS odpowiedzialna za funkcje powiększania zdjęcia
classZoomOut "compsoul-zoom-out" string (tekst) Nazwa klasy CSS odpowiedzialna za funkcje powiększania zdjęcia
classOverflow "compsoul-overflow" string (tekst) Nazwa klasy CSS odpowiedzialna za ukrycie paska przewijania strony
classDirectionNext "compsoul-direction-next" string (tekst) Nazwa klasy CSS odpowiedzialna za kierunek animacji
classDirectionPrev "compsoul-direction-prev" string (tekst) Nazwa klasy CSS odpowiedzialna za kierunek animacji
classPlay "compsoul-play" string (tekst) Nazwa klasy CSS odpowiedzialna za pokaz slajdów
classHidden "compsoul-hidden" string (tekst) Nazwa klasy CSS odpowiedzialna za ukrywanie elementów
classUnset "compsoul-unset" string (tekst) Nazwa klasy CSS odpowiedzialna za animacje galerii
classDrag "compsoul-drag" string (tekst) Nazwa klasy CSS odpowiedzialna za interakcje
classDisorderly "compsoul-disorderly" string (tekst) Nazwa klasy CSS odpowiedzialna za animacje galerii
classLogo "compsoul-logo" string (tekst) Nazwa klasy CSS elementu reprezentującego logotyp firmy Compsoul

Dziękuję za przeczytanie

Jeżeli spodobał Ci się mój wpis, zachęcam do obserwowania mojego profilu w serwisie facebook. Dodatkowo będzie mi bardzo miło jeżeli zechcesz podzielić się swoimi uwagami w komentarzach i zostawisz łapkę w górę. Jeżeli pilnie potrzebujesz pomocy lub chcesz o coś zapytać, skorzystaj z formularza kontaktowego lub napisz na daniel@compsoul.pl. Jeżeli Twoja sprawa jest naprawdę pilna, możesz zadzwonić na numer: +48 732 846 416