• CSS
  • Overflow w CSS - hidden, clip czy auto? Jak wybrać ustawienie

Overflow w CSS - hidden, clip czy auto? Jak wybrać ustawienie

13 października 2026

Napis "CSS Overflow" na tle w kolorze morskim. Tekst opisuje, jak zarządzać elementami, które wychodzą poza swoje granice, czyli jak rozwiązać problem **overflow CSS**.

Panel boczny wystaje poza ekran telefonu, więc kusi, by dopisać overflow: hidden i ukryć problem. To zadziała tylko wtedy, gdy nadmiar ma zniknąć; jeśli użytkownik ma dotrzeć do uciętej treści, potrzebne będzie inne ustawienie.

Dobierz overflow do tego, co ma się stać z nadmiarem treści

  • auto pozwala przewijać zawartość, gdy rzeczywiście nie mieści się w kontenerze.
  • hidden ucina treść bez widocznego paska, ale nadal pozwala przewijać ją programowo.
  • clip ucina treść i nie tworzy przewijalnego kontenera.
  • overflow-x i overflow-y można ustawić osobno, ale wartości obu osi wpływają na siebie.

Najpierw zdecyduj, czy nadmiar ma być widoczny, przewijalny czy ucięty

Właściwość overflow określa, co przeglądarka robi z treścią, która nie mieści się w obszarze elementu. Domyślne visible pozwala jej wystawać poza pudełko, co bywa przydatne przy dekoracjach, ale może zasłonić sąsiednie elementy albo wywołać poziome przewijanie całej strony.

Jeśli zawartość powinna pozostać dostępna, wybierz auto. Gdy ma zostać bezpowrotnie przycięta w widoku, rozważ clip. Różnica między nim a hidden jest mniej oczywista, niż sugerują nazwy.

Wartość Efekt Typowe zastosowanie
visible Treść może wystawać poza element. Elementy ozdobne, które mają nachodzić na otoczenie.
hidden Treść zostaje przycięta, bez pasków przewijania; przewijanie programowe pozostaje możliwe. Maskowanie animowanego elementu lub dekoracji, gdy przewijanie poza krawędź ma być wyłączone dla użytkownika.
clip Treść zostaje przycięta i element nie staje się kontenerem przewijania. Przycinanie nieinteraktywnego detalu, który nie ma być przewijany.
auto Przewijanie pojawia się, gdy zawartość się nie mieści. Długie panele, listy i tabele.
scroll Element jest przewijalny również wtedy, gdy zawartość się mieści. Sytuacje, w których stała obecność paska jest zamierzona.

Dokumentacja MDN dotycząca właściwości overflow podkreśla, że hidden nie oznacza całkowitego braku przewijania: można przesunąć zawartość skryptem, a fokus klawiatury może sprowadzić ukryty element do widoku. Przy treści interaktywnej samo schowanie paska nie rozwiązuje więc problemu dostępności.

Wartości osi X i Y potrafią zmienić się po obliczeniu

Gdy ustawiasz jedną wartość, obowiązuje ona w obu kierunkach. Dwie wartości w skróconym zapisie odpowiadają kolejno osi poziomej i pionowej, na przykład overflow: auto hidden pozwala przewijać poziomo, a przycina pionowo.

Jest jednak haczyk: zestawienie visible z wartością przewijającą nie zawsze zachowuje się dosłownie. Jeśli jedna oś ma auto, scroll albo hidden, to visible na drugiej osi oblicza się jako auto. Dlatego zapis overflow-x: hidden; overflow-y: visible; może dać przewijanie pionowe zamiast swobodnego wystawania treści.

.panel {
  overflow-x: hidden;
  overflow-y: auto;
}

Ten układ przycina nadmiar poziomy, a treść w pionie przewija w razie potrzeby. Zestawienie zasad dla obu osi opisuje także specyfikacja CSS Overflow Module Level 3. Jeśli potrzebujesz swobodnego wystawania elementów w jednym kierunku i przycinania w drugim, sprawdź obliczone wartości w narzędziach deweloperskich, zamiast zakładać, że deklaracje zachowają się niezależnie.

Poziomy pasek przewijania często zaczyna się w elemencie flex

Treść wychodząca poza ekran nie zawsze oznacza, że brakuje jej właściwego overflow. W układzie flex element potomny może nie chcieć się zwężać poniżej minimalnego rozmiaru wynikającego z zawartości. Wtedy pasek poziomy jest skutkiem rozmiaru elementu, a nie braku deklaracji ukrywającej nadmiar.

Rozważmy kartę z długim adresem lub niełamliwym ciągiem znaków. Jeśli karta jest elementem flex i wypycha sąsiadów, ustaw min-width: 0 na elemencie, który ma się skurczyć, a dla długiego tekstu dobierz zawijanie, na przykład overflow-wrap: anywhere. Nie zaczynaj od ukrywania paska na całej stronie, bo przytniesz objaw, a nie usuniesz źródła problemu. Dokumentacja właściwości flex na MDN wskazuje min-width lub min-height jako sposób zmiany minimalnego rozmiaru elementu flex.

Uważam, że w takim przypadku najpierw trzeba znaleźć element, który wypycha układ, a dopiero potem zdecydować, czy jego zawartość ma się zawijać, przewijać czy zostać przycięta. Sama reguła overflow: hidden potrafi zamaskować błąd aż do chwili, gdy znika fragment przycisku albo link.

Wybierz ustawienie po objawie, a nie po wyglądzie paska

Brak widocznego paska nie mówi, czy ukryta treść nadal da się przewinąć. Do szybkiej diagnozy przyda się rozróżnienie między skutkiem, który widzisz, a tym, co ma zrobić użytkownik.

Sytuacja lub objaw Prawdopodobna przyczyna Co zrobić
Cała strona przewija się poziomo na małym ekranie. Szeroki element potomny, długi niełamliwy tekst albo element flex z minimalnym rozmiarem. Znajdź element powodujący nadmiar; ustaw zawijanie tekstu lub min-width: 0 na odpowiednim elemencie flex.
Tekst w panelu jest ucięty, ale użytkownik powinien móc go przeczytać. Przycinanie przez hidden lub clip zamiast przewijania. Ustaw overflow: auto i ogranicz wysokość albo szerokość kontenera.
Ukryty element interaktywny dostaje fokus, ale nie widać go na ekranie. Treść została przycięta, a sposób przewijania nie sprowadza jej do widoku. Nie chowaj obszaru zawierającego kontrolki; zapewnij przewijanie i widoczny fokus.
Przewijanie ma być możliwe, ale pasek nie powinien stale zajmować miejsca. scroll wymusza kontener przewijania także wtedy, gdy nadmiaru nie ma. Użyj auto, które udostępnia przewijanie, gdy zawartość przekracza obszar.

Jeśli problem dotyczy tylko jednego fragmentu, ogranicz regułę do jego kontenera. Globalne overflow-x: hidden na stronie może ukryć elementy wysunięte poza ekran, w tym takie, do których użytkownik powinien mieć dostęp.

Przycinanie i ukrywanie pasków to dwa różne zadania

Popularny skrót myślowy brzmi: „hidden usuwa przewijanie”. Precyzyjniej: usuwa widoczne paski i ucina nadmiar, ale element może nadal być kontenerem przewijania, a zawartość da się przesunąć programowo. clip nie tworzy takiego kontenera, więc pasuje do statycznego przycinania, nie do ukrywania paska przy zachowaniu przewijania.

Jeśli zawartość ma być dostępna, wybierz auto lub scroll, zależnie od tego, czy pasek ma pojawiać się dopiero przy nadmiarze. Jeśli przycinasz dekorację, która nie zawiera linków, pól formularza ani innych elementów interaktywnych, rozważ clip. Przy elementach interaktywnych sprawdź obsługę klawiaturą, bo fokus może trafić na kontrolkę poza widocznym obszarem.

Dobry overflow nie ukrywa problemu użytkownika

Traktuj overflow jak decyzję o dostępie do treści, a nie kosmetyczny sposób na usunięcie paska. Dla dłuższej zawartości zacznij od auto; do przycinania nieinteraktywnych ozdobników użyj clip; po hidden sięgaj wtedy, gdy świadomie akceptujesz jego zachowanie jako kontenera przewijania.

Gdy układ nadal wystaje, sprawdź szerokość potomków, długie ciągi tekstu i minimalny rozmiar elementów flex. Często to tam znajduje się przyczyna, którą samo ukrycie nadmiaru jedynie zasłania.

FAQ - Najczęstsze pytania

hidden przycina treść i nie pokazuje pasków przewijania, ale element nadal może być przewijany programowo, a fokus może sprowadzić ukryty fragment do widoku. clip także przycina treść, lecz nie tworzy przewijalnego kontenera. Dlatego clip pasuje do statycznych, nieinteraktywnych dekoracji, a hidden wymaga sprawdzenia dostępności ukrytej zawartości.

Jeśli druga oś ma wartość auto, scroll albo hidden, wartość visible na pierwszej osi oblicza się jako auto. Zapis overflow-x: hidden; overflow-y: visible; może więc skutkować pionowym przewijaniem zamiast swobodnego wystawania treści. W skrócie dwie wartości odpowiadają kolejno osi poziomej i pionowej, na przykład overflow: auto hidden pozwala przewijać poziomo i przycina pionowo.

Najpierw znajdź element potomny, który wypycha układ, zamiast ukrywać nadmiar globalnym overflow-x: hidden. Na elemencie flex, który ma się skurczyć, ustaw min-width: 0, a przy długich, niełamliwych ciągach rozważ overflow-wrap: anywhere. Dzięki temu usuwasz przyczynę problemu, zamiast ryzykować przycięcie przycisku lub linku.

auto udostępnia przewijanie dopiero wtedy, gdy zawartość nie mieści się w ograniczonym kontenerze, dlatego sprawdza się przy panelach, listach i tabelach. scroll tworzy przewijalny element także wtedy, gdy nadmiaru nie ma, więc pasek może być stale obecny. Jeśli panel zawiera interaktywne elementy, zapewnij możliwość przewijania i sprawdź, czy fokus pozostaje widoczny.
Oceń artykuł

Średnia: 5.0 / 5 · 3 oceny

Tagi

overflow flexbox przewijanie dostępność

Udostępnij artykuł

Komentarze (0)
Dodaj komentarz