Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

inset(): prostokątny kształt podstawowy

Określ prostokąt odsunięty od krawędzi, opcjonalnie z zaokrągleniami, do przycinania lub opływania.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

clip-path: inset(10px 20px round 4px);

inset() definiuje kształt podstawowy przez odsunięcie do środka od prostokąta odniesienia. Od jednej do czterech wartości rozwija się w kolejności góra, prawo, dół, lewo, tak jak w margin. Opcjonalna część round podaje promienie narożników. Procenty odnoszą się do właściwego wymiaru prostokąta. Gdy przeciwległe odsunięcia przekraczają ten wymiar, specyfikacja zmniejsza je proporcjonalnie zamiast tworzyć ujemny prostokąt.

Działanie zależy od właściwości używającej kształtu. W clip-path kształt przycina rysowanie i ogranicza trafienia poza widocznym obszarem, lecz nie zmniejsza rozmiaru elementu w układzie. W shape-outside określa sposób opływania elementu pływającego przez treść. Samo shape-outside nie wykonuje wizualnego przycięcia charakterystycznego dla clip-path.

Przykład przycina element o wymiarach 100 na 80 pikseli za pomocą inset(10px 20px round 4px). Sprawdzenie punktu wewnętrznego trafia w element, a punktu w odciętym pasie już nie. Zmierzony rozmiar układu nadal wynosi 100 na 80 pikseli. Pozwala to odróżnić przycinanie od zmiany szerokości, wysokości, odstępów czy przepływu dokumentu.

Przykłady

const element=document.createElement('div');element.id='clip-example';
element.style.cssText='position:fixed;left:0;top:0;width:100px;height:80px;background:blue;clip-path:inset(10px 20px round 4px)';
document.body.append(element);
const hit=(x,y)=>document.elementFromPoint(x,y)===element;
console.log('inside='+hit(50,40)+'; clipped='+hit(5,40)+'; layout='+element.getBoundingClientRect().width+'x'+element.getBoundingClientRect().height+'; clip='+getComputedStyle(element).clipPath);

Wynik

inside=true; clipped=false; layout=100x80; clip=inset(10px 20px round 4px)

Punkt wewnętrzny daje true, a odcięty false. Prostokąt elementu zachowuje przy tym pierwotne wymiary.

Źródła