> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/budowanie-aplikacji/aplikacja-biznesowa/elementy-aplikacji-artefakty/grafiki-aplikacji.md).

# Grafiki aplikacji

{% hint style="info" %}
Dostępność funkcjonalności zależy od licencji i konfiguracji wdrożenia i może nie być dostępna we wszystkich wdrożeniach.
{% endhint %}

Grafika aplikacji to element aplikacji (artefakt), który przechowuje plik graficzny - np. logo, ikonę albo ilustrację - używany w formularzach tej aplikacji. Grafiki dodaje się w Eximee Designer w zakładce **Grafiki** aplikacji. Każda grafika dostaje stały adres względny, który wpisuje się w formularzu, np. w komponencie [Obraz - Image](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/4-tresci/obraz-image.md).

Grafiki należą do aplikacji i są przenoszone razem z nią: eksport aplikacji je zawiera, a import aplikacji publikuje je na środowisku docelowym. Nie ma potrzeby dostarczania grafik osobną paczką ani ręcznego wgrywania plików przez administratora.

## Adres grafiki

Adres względny grafiki ma postać:

```
graphic/{nazwa_aplikacji}/{light|dark}/{nazwa_pliku}
```

Przykład dla aplikacji `demo` i pliku `logo.svg`:

```
graphic/demo/light/logo.svg
graphic/demo/dark/logo.svg
```

* Adres jest taki sam na każdym środowisku (DEV, TEST, PROD), więc po migracji aplikacji nie trzeba go zmieniać w formularzach.
* Adresu nie można zmienić po dodaniu grafiki. Aby użyć innej nazwy, należy dodać grafikę ponownie pod nową nazwą.
* [Nowa wersja grafiki](#dodawanie-nowej-wersji-grafiki) zachowuje dotychczasowy adres, więc formularze nie wymagają zmian.

### Warianty light i dark

Każda grafika ma dwa warianty:

* **light** - wymagany,
* **dark** - opcjonalny, np. wersja logo na ciemne tło.

Jeśli wariant dark nie zostanie dodany, pod adresem `dark` jest publikowany plik light. Dzięki temu oba adresy zawsze zwracają grafikę.

Wariant wybiera się, wpisując w formularzu odpowiedni adres (`light` albo `dark`).

## Wymagania dla pliku

| Wymaganie                           | Wartość                                                                            |
| ----------------------------------- | ---------------------------------------------------------------------------------- |
| Obsługiwane formaty                 | PNG, JPG (JPEG), WebP, SVG                                                         |
| Format wariantów light i dark       | ten sam dla obu wariantów, np. oba pliki JPG                                       |
| Maksymalny rozmiar jednego wariantu | 5 MB                                                                               |
| Dozwolone znaki w nazwie            | litery bez polskich znaków, cyfry, kropka (`.`), podkreślenie (`_`), myślnik (`-`) |

Zawartość pliku musi odpowiadać jego formatowi - np. plik z rozszerzeniem `.png`, który w rzeczywistości jest plikiem JPG, zostanie odrzucony.

## Przeglądanie grafik

1. Należy przejść do modułu **Aplikacje** i otworzyć aplikację.
2. Należy kliknąć zakładkę **Grafiki**.

Jeśli aplikacja nie ma zakładki **Grafiki**, grafiki aplikacji nie są włączone na tym środowisku. Należy skontaktować się z administratorem.

Zakładka **Grafiki aplikacji** pokazuje grafiki jako kafelki. Każdy kafelek zawiera:

* miniaturę wariantu light,
* oznaczenia **Light** albo **Light** i **Dark** - drugie oznaczenie pojawia się tylko wtedy, gdy grafika ma osobny plik dark,
* nazwę pliku,
* format, wymiary i rozmiar,
* datę modyfikacji,
* adres wariantu light.

Aby skopiować adres wariantu light, należy kliknąć ikonę **Kopiuj ścieżkę** na kafelku.

Aby znaleźć grafikę, należy wpisać fragment nazwy pliku w polu **Szukaj...**.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-3797c4f7295c713bb050cd9796777edc7edc2d79%2Fgrafiki-aplikacji-01-lista-grafik.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 1.</strong> Zakładka "Grafiki" aplikacji</em></p></figcaption></figure>

## Dodawanie grafiki

1. W zakładce **Grafiki** należy kliknąć **Dodaj grafikę**.
2. W karcie **Wariant light** należy kliknąć **Wybierz lub przeciągnij plik** i wskazać plik albo przeciągnąć go na pole.
3. (Opcjonalnie) W karcie **Wariant dark** można dodać plik dla ciemnego tła. Plik dark musi mieć ten sam format co plik light.
4. Należy sprawdzić pole **Nazwa w URL**. Domyślnie zawiera nazwę pliku light - można ją zmienić, np. na `logo.svg`.
5. Należy sprawdzić podgląd adresów w polach **Ścieżka light** i **Ścieżka dark**.
6. Należy kliknąć **Opublikuj**.

Przycisk **Opublikuj** jest aktywny dopiero wtedy, gdy plik light jest dodany, a lista kontrolna w oknie nie zawiera błędów (format, rozmiar, nazwa). Jeśli pliki light i dark mają różne formaty, np. light PNG i dark JPG, przy pozycji **Format obsługiwany** pojawia się błąd.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-6111bc3c4e57cbc12eb3f96c5d8699d868fa4ffc%2Fgrafiki-aplikacji-02-dodaj-grafike.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Okno "Dodaj grafikę" z wariantami light i dark</em></p></figcaption></figure>

Po dodaniu grafika jest od razu opublikowana i dostępna pod swoim adresem. Dodanie grafiki podnosi wersję aplikacji, tak samo jak dodanie formularza czy procesu.

{% hint style="info" %}
Nazwa grafiki musi być unikalna w aplikacji. Ta sama nazwa pliku może wystąpić w różnych aplikacjach, bo adres zawiera nazwę aplikacji.
{% endhint %}

## Szczegóły grafiki

Aby otworzyć szczegóły, należy kliknąć nazwę pliku na kafelku. Strona szczegółów zawiera:

* status grafiki: **Aktywny** (grafika jest opublikowana) albo **Nieaktywny**,
* kartę **Podgląd** - przełącznik **Light**/**Dark**, wybór tła podglądu (**Przezroczyste**, **Jasne**, **Ciemne**), powiększanie od 25% do 400% i tryb **Pełny ekran**,
* kartę **Informacje** - aplikację, nazwę pliku, format, wymiary, rozmiar, limit rozmiaru, najnowszą wersję, autora i datę modyfikacji,
* pole **Adres względny** - adres wybranego wariantu z przyciskiem **Kopiuj adres**.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-2ca166d0d622c7308f3a23a3c2477da416ffe03a%2Fgrafiki-aplikacji-03-szczegoly-light.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 3.</strong> Szczegóły grafiki - wariant light</em></p></figcaption></figure>

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-c815e372ea3b86c84801dd96649455c1aabe79d2%2Fgrafiki-aplikacji-04-szczegoly-dark.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 4.</strong> Szczegóły grafiki - wariant dark na ciemnym tle</em></p></figcaption></figure>

Jeśli grafika nie ma wariantu dark, po wybraniu **Dark** podgląd pokazuje plik light z informacją, że wariant dark używa pliku light.

## Dodawanie nowej wersji grafiki

Nowa wersja podmienia pliki grafiki bez zmiany jej nazwy i adresu. Pozwala to np. zaktualizować logo we wszystkich formularzach, które go używają, bez edytowania tych formularzy.

1. Należy otworzyć szczegóły grafiki.
2. Należy kliknąć **Dodaj nową wersję**. Otworzy się okno **Edytuj grafikę** z bieżącymi plikami light i dark.
3. W karcie **Wariant light** należy kliknąć **Zmień plik** i wskazać nowy plik albo przeciągnąć go na pole.
4. (Opcjonalnie) W karcie **Wariant dark** można:
   * dodać albo zmienić plik dark,
   * kliknąć **Usuń plik** - od tej pory pod adresem `dark` będzie publikowany plik light.
5. Należy kliknąć **Opublikuj**.

Przykład: grafika `logo.jpg` w aplikacji `demo` ma najnowszą wersję 1.0. Po podmianie pliku light na nowy plik JPG i kliknięciu **Opublikuj** szczegóły grafiki pokazują nowy podgląd, wymiary i rozmiar oraz **Najnowsza wersja: 1.1**. Adres `graphic/demo/light/logo.jpg` się nie zmienia.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-99bd2f6c203b93d34ca94ec5125bb36ce9422845%2Fgrafiki-aplikacji-06-nowa-wersja.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 5.</strong> Okno "Edytuj grafikę" po kliknięciu "Dodaj nową wersję"</em></p></figcaption></figure>

W oknie **Edytuj grafikę**:

* pola **Nazwa w URL**, **Ścieżka light** i **Ścieżka dark** są zablokowane,
* **Obsługiwane formaty** pokazują tylko format bieżącej grafiki - np. dla grafiki JPG można wgrać wyłącznie pliki JPG; plik w innym formacie oznacza błąd przy pozycji **Format obsługiwany**,
* obowiązuje limit rozmiaru 5 MB dla każdego wariantu,
* przycisk **Opublikuj** jest aktywny dopiero po zmianie któregoś pliku i tylko wtedy, gdy lista kontrolna nie zawiera błędów.

Po opublikowaniu:

* poprzednie pliki grafiki są zastępowane nowymi - historia wersji nie jest dostępna i nie można przywrócić poprzedniej wersji,
* najnowsza wersja grafiki rośnie o 1 w części po kropce, np. z 1.0 na 1.1,
* wersja aplikacji się nie zmienia - aplikacja od razu korzysta z nowej wersji grafiki,
* podgląd w szczegółach grafiki i miniatura na liście grafik odświeżają się od razu.

{% hint style="info" %}
Formularz może jeszcze przez około 5 minut wyświetlać poprzednią wersję grafiki, ponieważ przeglądarka przechowuje ją w pamięci podręcznej.
{% endhint %}

{% hint style="warning" %}
Jeśli grafika została dodana z plikami light i dark w różnych formatach, przy dodawaniu nowej wersji należy podmienić plik dark na plik w formacie light albo usunąć wariant dark.
{% endhint %}

## Użycie grafiki w formularzu

Grafikę wstawia się w formularzu przez jej adres względny - w komponencie **Obraz** albo w treści. Adres można skopiować w szczegółach grafiki z pola **Adres względny**, np. `graphic/demo/light/logo.svg`.

### W komponencie Obraz

1. Należy otworzyć formularz aplikacji i dodać komponent **Obraz** (Image).
2. W polu **Link do obrazka** należy wkleić adres grafiki.
3. W sekcji **WCAG** należy ustawić **Prezentację** i uzupełnić tekst alternatywny zgodnie z [opisem komponentu](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/4-tresci/obraz-image.md).

### W treści (TextContent)

W treści grafikę wstawia się tak jak każdy inny obrazek - podając jej adres względny. Przykład w składni [Wiki Markup](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/4-tresci/tresc-textcontent/tresc-przy-pomocy-wiki-markup.md#obrazki) z tekstem alternatywnym:

```
{img:alt=Logo Demo}graphic/demo/light/logo.svg{img}
```

Ten sam obrazek w HTML:

```html
<img src="graphic/demo/light/logo.svg" alt="Logo Demo">
```

## Usuwanie grafiki

1. Należy otworzyć szczegóły grafiki.
2. Należy kliknąć **Usuń**.

Grafika znika z listy, a wersja aplikacji zostaje podniesiona. Od tej chwili adresy light i dark grafiki zwracają błąd 404, a jej nazwę można użyć ponownie.

Bezpośrednio po usunięciu pojawia się komunikat z przyciskiem **Przywróć**, który cofa usunięcie. Przywrócenie nie jest możliwe, jeśli w międzyczasie dodano grafikę o tej samej nazwie.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-f0366fda94e8e9420c1813f29d1a7dc6afbc694d%2Fgrafiki-aplikacji-05-usunieto-przywroc.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 6.</strong> Komunikat po usunięciu grafiki z przyciskiem "Przywróć"</em></p></figcaption></figure>

{% hint style="warning" %}
Przed usunięciem grafiki należy sprawdzić, czy formularze jej nie używają. Formularz, który odwołuje się do usuniętej grafiki, nie wyświetli jej.
{% endhint %}

## Przenoszenie grafik między środowiskami

Grafiki są przenoszone razem z aplikacją - nie ma osobnego eksportu grafik.

* **Eksport aplikacji** (**Wydaj**) - jeśli aplikacja ma grafiki, zamiast pliku `.artifact` powstaje plik `.zip` z definicją aplikacji i plikami grafik. Więcej: [Eksport/import aplikacji](https://docs.eximee.com/budowanie-aplikacji/aplikacja-biznesowa/zarzadzanie-aplikacja/eksport-import-aplikacji.md).
* **Import aplikacji** (**Importuj aplikację**) - należy wskazać plik `.zip`. Grafiki z paczki zostaną zapisane i opublikowane na środowisku docelowym.
* **Moduł Środowiska** - migracja i eksport aplikacji przenoszą także jej grafiki. Więcej: [Moduł Środowiska](https://docs.eximee.com/eksploatacja-aplikacji/designer/srodowiska.md).

Do paczki trafia opublikowana wersja każdej grafiki aplikacji, w obu wariantach.

## Powiązane tematy

* [Eksport/import aplikacji](https://docs.eximee.com/budowanie-aplikacji/aplikacja-biznesowa/zarzadzanie-aplikacja/eksport-import-aplikacji.md)
* [Moduł Środowiska](https://docs.eximee.com/eksploatacja-aplikacji/designer/srodowiska.md)
* [Obraz - Image](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/4-tresci/obraz-image.md)
* [Konwencje nazewnicze elementów aplikacji](https://docs.eximee.com/budowanie-aplikacji/aplikacja-biznesowa/elementy-aplikacji-artefakty/konwencje-nazewnicze-elementow-aplikacji.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eximee.com/budowanie-aplikacji/aplikacja-biznesowa/elementy-aplikacji-artefakty/grafiki-aplikacji.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
