CSS 앵커 배치 API 소개

CSS Anchor Positioning API를 사용하면 앵커라고 하는 다른 요소와 관련하여 기본적으로 요소의 위치를 지정할 수 있으므로 웹 개발의 판도를 바꿀 수 있습니다. 이 API는 메뉴 및 하위 메뉴, 도움말, 선택, 라벨, 카드, 설정 대화상자와 같은 많은 인터페이스 기능의 복잡한 레이아웃 요구사항을 간소화합니다. 브라우저에 내장된 앵커 위치 기능을 사용하면 서드 파티 라이브러리에 의존하지 않고도 계층화된 사용자 인터페이스를 빌드할 수 있어 창의적인 가능성의 세계를 열 수 있습니다.

앵커 포지셔닝은 Chrome 125부터 사용할 수 있습니다.

브라우저 지원

  • Chrome: 125 <ph type="x-smartling-placeholder">
  • Edge: 125. <ph type="x-smartling-placeholder">
  • Firefox: 지원되지 않음 <ph type="x-smartling-placeholder">
  • Safari: 지원되지 않음 <ph type="x-smartling-placeholder">

소스

핵심 개념: 앵커 및 배치된 요소

이 API의 핵심은 앵커위치된 요소 간의 관계입니다. 앵커는 anchor-name 속성을 사용하여 참조 지점으로 지정된 요소입니다. 위치가 지정된 요소는 position-anchor 속성을 사용하거나 위치 지정 로직에서 명시적으로 anchor-name를 사용하여 앵커를 기준으로 배치되는 요소입니다.

<ph type="x-smartling-placeholder">
</ph>
요소 및 위치가 지정된 요소를 고정합니다.

앵커 설정하기

앵커를 만드는 방법은 간단합니다. 선택한 요소에 앵커 이름 속성을 적용하고 고유 식별자를 할당합니다. 이 고유 식별자는 CSS 변수처럼 앞에 이중 대시를 추가해야 합니다.

.anchor-button {
    anchor-name: --anchor-el;
}

앵커 이름이 할당되면 .anchor-button가 앵커 역할을 하며 다른 요소의 배치를 안내할 준비가 된 것입니다. 다음 두 가지 방법 중 하나로 이 앵커를 다른 요소에 연결할 수 있습니다.

암시적 앵커

앵커를 다른 요소에 연결하는 첫 번째 방법은 다음 코드 예에서와 같이 암시적 앵커를 사용하는 것입니다. position-anchor 속성은 앵커에 연결하려는 요소에 추가되며 앵커의 이름 (이 경우 --anchor-el)을 값으로 포함합니다.

.positioned-notice {
    position-anchor: --anchor-el;
}

암시적 앵커 관계를 사용하면 첫 번째 인수에 앵커 이름을 명시적으로 지정하지 않고도 anchor() 함수를 사용하여 요소의 위치를 지정할 수 있습니다.

.positioned-notice {
    position-anchor: --anchor-el;
    top: anchor(bottom);
}

명시적 앵커

또는 앵커 함수에서 직접 앵커 이름을 사용할 수 있습니다 (예: top: anchor(--anchor-el bottom). 이를 명시적 앵커라고 하며 여러 요소에 고정하려는 경우 편리할 수 있습니다 (아래 예 참고).

.positioned-notice {
    top: anchor(--anchor-el bottom);
}

앵커를 기준으로 요소 배치

<ph type="x-smartling-placeholder">
</ph>
물리적 속성이 있는 앵커 위치 다이어그램

앵커 포지셔닝은 CSS 절대 배치를 기반으로 빌드됩니다. 위치 값을 사용하려면 position: absolute를 배치된 요소에 추가해야 합니다. 그런 다음 anchor() 함수를 사용하여 위치 값을 적용합니다. 예를 들어 앵커 요소의 왼쪽 상단에 앵커 요소를 배치하려면 다음 배치를 사용합니다.

.positioned-notice {
    position-anchor: --anchor-el;
    /* absolutely position the positioned element */
    position: absolute;
    /* position the right of the positioned element at the right edge of the anchor */
    right: anchor(right);
    /* position the bottom of the positioned element at the top edge of the anchor */
    bottom: anchor(top);
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder"></ph>
배치된 요소의 가장자리 배치 다이어그램

이제 다음과 같이 한 요소가 다른 요소에 고정됩니다.

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
기본 앵커의 데모

데모 스크린샷

이러한 값에 논리적 배치를 사용하기 위해 등가는 다음과 같습니다.

  • top = inset-block-start
  • left= inset-inline-start
  • bottom = inset-block-end
  • right= inset-inline-end

anchor-center를 사용하여 위치가 지정된 요소의 중심에 배치

앵커를 기준으로 앵커가 위치한 요소의 중심을 더 쉽게 맞출 수 있도록 justify-self, align-self, justify-items, align-items 속성과 함께 사용할 수 있는 anchor-center이라는 새 값이 있습니다.

이 예에서는 justify-self: anchor-center를 사용하여 위치가 지정된 요소를 앵커 위에 중앙에 배치하여 이전 요소를 수정합니다.

.positioned-notice {
  position: absolute;
  /*  Anchor reference  */
  position-anchor: --anchor-el;
  /*  Position bottom of positioned elem at top of anchor  */
  bottom: anchor(top);
  /*  Center justification to the anchor */
  justify-self: anchor-center;
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
justify-center를 사용하여 중앙에 정렬된 앵커 데모

데모 스크린샷

여러 앵커

요소는 두 개 이상의 앵커에 테더링할 수 있습니다. 즉, 둘 이상의 앵커를 기준으로 배치되는 위치 값을 설정해야 할 수도 있습니다. anchor() 함수를 사용하고 첫 번째 인수에서 참조하는 앵커를 명시적으로 지정하면 됩니다. 다음 예에서는 위치가 지정된 요소의 왼쪽 상단이 한 앵커의 오른쪽 하단에 고정되고 배치된 요소의 오른쪽 하단이 두 번째 앵커의 왼쪽 상단에 고정됩니다.

.anchored {
  position: absolute;
  top: anchor(--one bottom);
  left: anchor(--one right);
  right: anchor(--two left);
  bottom: anchor(--two top);
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
여러 앵커를 보여주는 데모

데모 스크린샷

inset-area 위치

절대 위치에서의 기본 방향 위치 지정 외에도 인셋 영역이라는 새로운 레이아웃 메커니즘이 앵커링 API에 포함되어 있습니다.

인셋 영역을 사용하면 앵커가 배치된 요소를 각각의 앵커를 기준으로 쉽게 배치할 수 있으며 중앙에 앵커 요소가 있는 9셀 그리드에서 작동합니다.

9셀 그리드에 표시된 다양한 인셋 영역 위치 지정 옵션

절대 위치 대신 인셋 영역을 사용하려면 실제 값 또는 논리 값과 함께 inset-area 속성을 사용합니다. 예를 들면 다음과 같습니다.

  • 상단 중앙: inset-area: top 또는 inset-area: block-start
  • 왼쪽 중앙: inset-area: left 또는 inset-area: inline-start
  • 중앙 하단: inset-area: bottom 또는 inset-area: block-end
  • 오른쪽 중앙: inset-area: right 또는 inset-area: inline-end
를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
여러 앵커를 보여주는 데모

데모 스크린샷

이러한 위치에 대해 자세히 알아보려면 다음 도구를 확인하세요.

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
인셋 영역 위치를 위한 앵커 도구입니다.

anchor-size()로 요소 크기 조정

앵커 위치 지정 API의 일부이기도 한 anchor-size() 함수는 앵커 크기 (너비, 높이, 인라인 및 블록 크기)에 따라 앵커 위치 요소의 크기를 조절하거나 위치를 지정하는 데 사용할 수 있습니다.

다음 CSS는 높이에 이를 사용하는 예를 보여줍니다. calc() 함수 내에서 anchor-size(height)를 사용하여 도움말의 최대 높이를 앵커 높이의 두 배로 설정합니다.

.positioned-notice {
  position-anchor: --question-mark;

  /*  set max height of the tooltip to 2x height of the anchor  */
  max-height: calc(anchor-size(height) * 2);
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
anchor-size 데모

데모 스크린샷

팝오버 및 대화상자와 같은 최상위 레이어 요소와 함께 앵커 사용

앵커 배치는 popover와 같은 최상위 레이어 요소와 함께 사용하면 매우 효과적입니다. 및 <dialog>. 이러한 요소는 DOM 하위 트리의 나머지 부분과 별도의 레이어에 배치되지만, 앵커 위치 지정을 사용하면 요소를 다시 테더링하고 상단 레이어에 없는 요소와 함께 스크롤할 수 있습니다. 이는 계층화된 인터페이스에 있어 엄청난 이점입니다.

다음 예에서는 버튼을 사용하여 도움말 팝오버 모음이 열립니다. 버튼은 앵커이고 도움말은 위치가 지정된 요소입니다. 다른 앵커 요소와 마찬가지로 배치된 요소의 스타일을 지정할 수 있습니다. 이 특정 예에서 anchor-nameposition-anchor는 버튼 및 도움말의 인라인 스타일입니다. 각 앵커에는 고유한 앵커 이름이 필요하므로 동적 콘텐츠를 생성할 때 인라인을 사용하는 것이 가장 쉽습니다.

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
popover와 함께 앵커를 사용하는 데모

데모 스크린샷

@position-try로 앵커 위치 조정

초기 앵커 위치를 설정한 후 앵커가 포함 블록의 가장자리에 도달하면 위치를 조정할 수 있습니다. 대체 앵커 위치를 만들려면 position-try-options 속성과 함께 @position-try 지시어를 사용하면 됩니다.

다음 예에서는 하위 메뉴가 메뉴 오른쪽에 표시됩니다. 메뉴 및 하위 메뉴는 앵커 위치 지정 API를 팝오버 속성과 함께 사용하면 좋습니다. 이러한 메뉴는 트리거 버튼에 고정되는 경향이 있기 때문입니다.

이 하위 메뉴의 경우 가로 공간이 충분하지 않으면 대신 메뉴 아래로 이동할 수 있습니다. 이렇게 하려면 먼저 초기 위치를 설정합니다.

#submenu {
  position: absolute;
  position-anchor: --submenu;

  /* initial position */
  margin-left: var(--padding);
  inset-area: right span-bottom;
}

그런 다음 @position-try를 사용하여 대체 앵커 위치를 설정합니다.

/* alternate position */
@position-try --bottom {
  margin: var(--padding) 0 0 var(--padding);
  inset-area: bottom;
}

마지막으로 두 기기를 position-try-options와 연결합니다. 종합하면 다음과 같습니다.

#submenu {
  position: absolute;
  position-anchor: --submenu;
  /* initial position */
  margin-left: var(--padding);
  inset-area: right span-bottom;
  */ connect with position-try options */
  position-try-options: --bottom;
}

/* alternate position */
@position-try --bottom {
  margin: var(--padding) 0 0 var(--padding);
  inset-area: bottom;
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
popover와 함께 앵커를 사용하는 데모

앵커 위치 자동 플립 키워드

위에서 아래로 또는 왼쪽에서 오른쪽으로(또는 둘 다) 뒤집는 등의 기본적인 조정이 있다면 맞춤 @position-try 선언을 만드는 단계를 건너뛰고 내장된 브라우저 지원 플립 키워드(예: flip-block, flip-inline)를 사용할 수도 있습니다. 맞춤 @position-try 선언의 표준으로 작동하며 서로 조합하여 사용할 수 있습니다.

position-try-options: flip-block, flip-inline, flip-block flip-inline;

플립 키워드는 앵커 코드를 크게 단순화할 수 있습니다. 몇 줄이면 다른 위치로 완전한 기능의 앵커를 만들 수 있습니다.

#my-tooltip {
  position-anchor: --question-mark;
  inset-area: top;
  position-try-options: flip-block;
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
position-try-options: flip-block로 자동 뒤집기 사용

서브 스크롤러의 앵커용 position-visibility

페이지의 하위 스크롤 내에 요소를 고정하고 싶은 경우가 있습니다. 이러한 경우에는 position-visibility를 사용하여 앵커의 공개 상태를 제어할 수 있습니다. 앵커는 언제 화면에 유지되나요? 언제 사라지나요? 이 기능을 사용하여 이러한 옵션을 관리할 수 있습니다. 앵커가 시야를 벗어날 때까지 위치가 지정된 요소가 뷰에 계속 표시되도록 하려면 position-visibility: anchors-visible를 사용합니다.

#tooltip {
  position: fixed;
  position-anchor: --anchor-top-anchor;
  position-visibility: anchors-visible;
  bottom: anchor(top);
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
position-visibility: anchors-visible 데모

또는 position-visibility: no-overflow를 사용하여 앵커가 컨테이너를 오버플로하지 않도록 합니다.

#tooltip {
  position: absolute;
  position-anchor: --anchor-top-anchor;
  position-visibility: no-overflow;
  bottom: anchor(top);
}
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다.
position-visibility: no-overflow 데모

특성 감지 및 폴리필링

현재 브라우저 지원이 제한되어 있으므로 주의해서 이 API를 사용하는 것이 좋습니다. 먼저 @supports 기능 쿼리를 사용하여 CSS에서 직접 지원을 확인할 수 있습니다. 이렇게 하는 방법은 앵커 스타일을 다음과 같이 래핑하는 것입니다.

@supports (anchor-name: --myanchor) {

  /* Anchor styles here */

}

또한 Firefox 54, Chrome 51, Edge 79, Safari 10에서 작동하는 Oddbird의 CSS 앵커 포지셔닝 폴리필로 앵커 위치 지정 기능을 폴리필할 수 있습니다. 이 폴리필은 대부분의 기본 앵커 위치 기능을 지원하지만, 현재 구현이 완전하지 않고 오래된 구문을 포함하고 있습니다. unpkg 링크를 사용하거나 패키지 관리자에서 직접 가져올 수 있습니다.

접근성 관련 참고사항

앵커 위치 지정 API를 사용하면 요소를 다른 요소에 대해 상대적으로 배치할 수 있지만 본질적으로 요소 간에 의미 있는 의미 있는 관계를 만들지는 않습니다. 앵커 요소와 위치가 지정된 요소 간에 실제로 의미론적 관계가 있는 경우(예: 위치가 지정된 요소가 앵커 텍스트에 관한 사이드바 주석인 경우) 이를 위한 한 가지 방법은 aria-details를 사용하여 앵커 요소에서 위치가 지정된 요소를 가리키는 것입니다. 스크린 리더 소프트웨어는 아직 ARIA 세부정보를 처리하는 방법을 학습하는 중이지만 지원이 개선되고 있습니다.

<div class="anchor" aria-details="sidebar-comment">Main content</div>
<div class="positioned" id="sidebar-comment">Sidebar content</div>
.anchor {
  anchor-name: --anchor;
}

.positioned {
  position: fixed;
  position-anchor: --anchor;
}

앵커 위치 지정을 popover 속성이나 <dialog> 요소와 함께 사용하는 경우 브라우저에서 적절한 접근성을 위해 포커스 탐색 수정을 처리하므로 DOM 순서의 팝오버나 대화상자를 포함하지 않아도 됩니다. 사양에서 접근성에 관한 메모를 자세히 읽어 보세요.

결론

이는 완전히 새로운 기능으로, 여러분이 이 기능으로 무엇을 빌드할지 정말 기대됩니다. 지금까지 차트, 연결선, 각주, 시각적 교차 참조의 동적 라벨 등 커뮤니티에서 매우 유용한 사용 사례를 살펴보았습니다. 앵커 포지셔닝을 실험하는 동안 의견을 듣고 싶습니다. 버그를 발견하면 알려주세요.

추가 자료