> 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/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/nawigacja/odliczanie.md).

# Odliczanie - Progress

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

Komponent odliczania umożliwia wizualną reprezentację postępu.

![](/files/wn2UHklJVz9GSYNr6UUm)

✅ **Kiedy stosować:**

* Musisz zaprezentować czas pozostały na wykonanie kroku lub wskazać czas oczekiwania na akcję systemu.

:x: **Kiedy nie stosować:**

* Akcja nie jest ograniczona czasowo, a chcesz jedynie pokazać postęp przechodzenia wniosku. **Stosuj**: opcja „Widoczność kroków" we zakładce [Właściwości](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/nawigacja/pages/c3b350144a7fce11181d0798fd2f9b47ce0b8604#widoczność-kroków) formularza.

### Właściwości komponentu

| Właściwość Eximee Designer                                | Nazwa atrybutu w Źródle | Opis                                                                                                                                                             |
| --------------------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Etykieta (klucz)**                                      | labelKey                | Klucz ze słownika etykiet, który odpowiada za wyświetlaną nazwę (tytuł) komponentu.                                                                              |
| **Pozycja etykiety**                                      | labelPosition           | Określa położenie opisu względem paska postępu. Wartość `ABOVE_LINE` oznacza wyświetlanie etykiety nad linią paska.                                              |
| **Kierunek** (sekcja **Podstawowe właściwości**)          | directionOfProgress     | Określa kierunek postępu paska. Dostępne opcje: **Od lewej do prawej** (wartość wzrasta) oraz **Od prawej do lewej** (wartość maleje).                           |
| **Tryb wyświetlania** (sekcja **Podstawowe właściwości**) | displayMode             | Określa sposób prezentacji informacji o stanie postępu. Opcje: **Czas** (minuty i sekundy), **Procent** (%) oraz **Brak**. Domyślnie: "Czas (minuty i sekundy)". |
| **Czas maks.** (sekcja **Podstawowe właściwości**)        | duration                | Określa całkowity czas (w sekundach) potrzebny na pełne "ładowanie" paska postępu. Domyślnie: 60.                                                                |
| **Skok \[s]** (sekcja **Podstawowe właściwości**)         | valueUpdateInterval     | Określa interwał czasowy (w sekundach), co jaki następuje wizualna aktualizacja paska. Domyślnie: 1.                                                             |
| **Auto-zapis \[s]** (sekcja **Podstawowe właściwości**)   | valueSaveInterval       | Określa częstotliwość (w sekundach), z jaką komponent zapisuje swoją aktualną wartość na serwerze. Domyślnie: 1.                                                 |

> Więcej informacji o właściwościach komponentu: [Wspólne właściwości komponentów](/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow.md)

<br>

<figure><img src="/files/k1WKEJ9ymDgDUYsNS7xw" alt=""><figcaption><p><em><strong>Ilustracja 1.</strong> Przykładowy wygląd komponentu.</em></p></figcaption></figure>

<figure><img src="/files/I2Yki9FnMsVs6HK2TK54" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Przykładowe właściwości komponentu.</em></p></figcaption></figure>

### Resetowanie komponentu po zmianie strony

Aby komponent resetował swoją wartość po opuszczeniu i ponownym wejściu na stronę:

1. Ustaw w **Warunku widoczności** komponentu:

```
getValue("currentPageMid") == "Page3"
```

Gdzie `Page3` należy zastąpić identyfikatorem biznesowym strony, na której znajduje się komponent.

2. Dodaj nasłuchiwanie na:

```
currentPageMid
```

Takie ustawienie powoduje ponowne wyrenderowanie komponentu po zmianie strony oraz wyzerowanie licznika.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/nawigacja/odliczanie.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.