인라인 확대/축소 뷰어 사용자 지정

마지막 업데이트: 2025년 8월 15일
  • 주제:

작성 대상:

  • 개발자
  • 사용자

모든 시각적 사용자 지정 및 대부분의 비헤이비어 사용자 지정은 사용자 지정 CSS를 만들어 수행합니다.

제안된 워크플로는 적절한 뷰어에 대한 기본 CSS 파일을 가져와서 다른 위치에 복사하고, 사용자 지정하고, style= 명령에서 사용자 지정된 파일의 위치를 지정하는 것입니다.

기본 CSS 파일은 다음 위치에서 찾을 수 있습니다.

<s7_viewers_root>/html5/InlineZoomViewer.css

사용자 지정 CSS 파일은 기본 클래스 선언과 동일한 클래스 선언을 포함해야 합니다. 클래스 선언을 생략하면 뷰어가 사용자 인터페이스 요소에 기본 스타일을 제공하지 않으므로 제대로 작동하지 않습니다.

또한 인라인 확대/축소 기능에 필요하므로 기본 뷰어 CSS에서 다음 CSS 선언을 유지하는 것이 중요합니다.

.s7flyoutviewer .s7flyoutzoomview .s7flyoutzoom {
 width: 100%;
 height: 100%;
 left: 0;
 top: 0;
 border: none;
 z-index:999;
}

사용자 지정 CSS 규칙을 제공하는 또 다른 방법은 웹 페이지에서 직접 또는 연결된 외부 CSS 규칙 중 하나에 포함된 스타일을 사용하는 것입니다.

사용자 지정 CSS를 만들 때는 뷰어가 해당 컨테이너 DOM 요소에 .s7flyoutviewer 클래스를 할당하는 것을 잊지 마십시오. style= 명령을 사용하여 전달된 외부 CSS 파일을 사용하는 경우 CSS 규칙의 하위 항목 선택기에서 .s7flyoutviewer 클래스를 상위 클래스로 사용합니다. 웹 페이지에서 임베드된 스타일을 수행하는 경우 다음과 같이 이 선택기에 컨테이너 DOM 요소의 ID도 부여합니다.

#<containerId>.s7flyoutviewer

응답형 디자인 CSS 구축

사용자의 장치 또는 특정 웹 페이지 레이아웃에 따라 컨텐츠를 다르게 표시하도록 다양한 장치와 CSS의 포함 크기를 타깃팅할 수 있습니다. 이 기능에는 다양한 웹 페이지 레이아웃, 사용자 인터페이스 요소 크기 및 아트워크 해상도가 포함되지만 이에 국한되지 않습니다.

뷰어는 반응형 디자인 CSS를 만드는 두 가지 방법인 CSS 마커 및 표준 CSS 미디어 쿼리를 지원합니다. 이러한 메서드는 독립적으로 사용하거나 함께 사용할 수 있습니다.

CSS 마커

응답형 디자인 CSS를 만드는 데 도움이 되도록 뷰어는 최상위 뷰어 컨테이너 요소에 동적으로 할당되는 특수 CSS 클래스인 CSS 마커를 지원합니다. 할당은 런타임 뷰어 크기와 현재 장치에서 사용되는 입력 유형을 기반으로 합니다.

CSS 마커의 첫 번째 그룹에는 .s7size_large, .s7size_medium 및 .s7size_small 클래스가 포함됩니다. 뷰어 컨테이너의 런타임 영역을 기반으로 적용됩니다. 즉, 뷰어 영역이 일반 데스크톱 모니터 .s7size_large의 크기보다 크거나 같은 경우 사용됩니다. 영역이 일반 태블릿 장치 .s7size_medium에 가까운 경우 할당됩니다. 휴대폰 화면과 유사한 영역에 대해 .s7size_small이(가) 설정되어 있습니다. 이러한 CSS 마커의 주요 목적은 다양한 화면과 뷰어 크기에 대해 다양한 사용자 인터페이스 레이아웃을 만드는 것입니다.

CSS 표식의 두 번째 그룹은 .s7mouseinput 및 .s7touchinput을(를) 포함합니다. 현재 장치에 터치 입력 기능이 있는 경우 마커 .s7touchinput이(가) 설정됩니다. 그렇지 않으면 .s7mouseinput이(가) 사용됩니다. 이러한 마커는 일반적으로 터치 입력에 더 큰 요소가 필요하기 때문에 다양한 입력 유형에 대해 다양한 화면 크기를 갖는 사용자 인터페이스 입력 요소를 만들기 위한 것입니다. 장치에 마우스 입력 및 터치 기능이 모두 있는 경우 .s7touchinput이(가) 설정되고 뷰어가 터치 지원 사용자 인터페이스를 렌더링합니다.

다음 샘플 CSS는 마우스 입력이 있는 시스템의 경우 확대 단추 크기를 28 x 28픽셀로 설정하고 터치 디바이스의 경우 56 x 56픽셀로 설정합니다. 또한 뷰어 크기가 작아지는 경우 버튼을 완전히 숨깁니다.

.s7flyoutviewer.s7mouseinput .s7swatches .s7thumb {
 width: 28px;
 height: 28px;
}
.s7flyoutviewer.s7touchinput .s7swatches .s7thumb {
 width: 56px;
 height: 56px;
}
.s7flyoutviewer.s7size_small .s7swatches {
 visibility: hidden;
}

픽셀 밀도가 다른 장치를 타깃팅하려면 CSS 미디어 쿼리를 사용하십시오. 다음 미디어 쿼리 블록에는 고밀도 화면에만 해당하는 CSS가 포함되어 있습니다.

@media screen and (-webkit-min-device-pixel-ratio: 1.5)
{
}

CSS 마커를 사용하는 것은 반응형 디자인 CSS를 구축하는 가장 유연한 방법입니다. 장치 화면 크기뿐만 아니라 실제 뷰어 크기도 타깃팅할 수 있습니다. 이는 반응형 디자인 웹 페이지 레이아웃에 유용할 수 있습니다.

CSS 미디어 쿼리

장치 감지는 순수 CSS 미디어 쿼리를 사용하여 수행할 수도 있습니다. 지정된 미디어 쿼리 블록 내에 포함된 모든 내용은 해당 장치에서 실행될 때만 적용됩니다.

Mobile Viewer에 적용되는 경우 CSS에 정의된 4개의 CSS 미디어 쿼리를 다음 순서로 사용하십시오.

  1. 모든 터치 장치에 대한 규칙만 포함합니다.

    @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px),
only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px)
{
}

  2. 고해상도 화면이 있는 태블릿에 대한 규칙만 포함합니다.

    @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px) and (-webkit-min-device-pixel-ratio:1.5),
only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px) and (-webkit-min-device-pixel-ratio:1.5)
{
}

  3. 모든 휴대폰에 대한 규칙만 포함합니다.

    @media only screen and (max-device-width:9in) and (max-device-height:9in)
{
}

  4. 고해상도 화면이 있는 휴대폰에 대한 규칙만 포함합니다.

    @media only screen and (max-device-width:9in) and (max-device-height:9in) and (-webkit-min-device-pixel-ratio: 1.5),
  only screen and (device-width:720px) and (device-height:1280px) and (-webkit-device-pixel-ratio: 2),
  only screen and (device-width:1280px) and (device-height:720px) and (-webkit-device-pixel-ratio: 2)
{
}

미디어 쿼리 접근 방식을 사용하면 다음과 같이 디바이스 감지로 CSS를 구성해야 합니다.

  • 먼저, 바탕 화면별 섹션은 바탕 화면별 속성이거나 모든 화면에 공통되는 모든 속성을 정의합니다.
  • 두 번째로, 4개의 미디어 쿼리는 위에 정의된 순서대로 실행되며 해당 디바이스 유형에 맞는 CSS 규칙을 제공합니다.

각 미디어 쿼리에서 전체 뷰어 CSS를 복제할 필요가 없습니다. 지정된 장치에 특정한 속성만 미디어 쿼리 내에 다시 정의됩니다.

CSS 스프라이트

대부분의 뷰어 사용자 인터페이스 요소는 비트맵 아트웍을 사용하여 스타일이 지정되며 둘 이상의 고유한 시각적 상태를 갖습니다. 좋은 예는 일반적으로 "up", "over" 및 "down"의 세 가지 이상 다른 상태를 갖는 단추입니다. 각 상태에는 고유한 비트맵 아트워크가 할당되어야 합니다.

스타일링에 대한 클래식 접근 방식을 사용하면 CSS에는 사용자 인터페이스 요소의 각 상태에 대해 서버의 개별 이미지 파일에 대한 별도의 참조가 있습니다. 다음은 스크롤 단추 스타일을 지정하는 샘플 CSS입니다.

.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="up"]{
background-image:url(images/v2/ScrollLeftButton_up.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="over"]{
background-image:url(images/v2/ScrollLeftButton_over.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="down"]{
background-image:url(images/v2/ScrollLeftButton_down.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="disabled"]{
background-image:url(images/v2/ScrollLeftButton_disabled.png);
}

이 접근 방식의 단점은 요소가 와 처음 상호 작용할 때 최종 사용자가 깜박이거나 지연된 사용자 인터페이스 응답을 경험한다는 것입니다. 이 작업은 새 요소 상태에 대한 이미지 아트워크가 아직 다운로드되지 않았기 때문에 발생합니다. 또한 이 방법은 서버에 대한 HTTP 호출 수가 증가하므로 성능에 약간 부정적인 영향을 줄 수 있습니다.

CSS 스프라이트는 모든 요소 상태에 대한 이미지 아트워크가 "스프라이트"라는 단일 PNG 파일로 결합되는 다른 방법입니다. 이러한 "스프라이트"는 지정된 요소에 대한 모든 시각적 상태를 차례로 배치합니다. 스프라이트를 사용하여 사용자 인터페이스 요소의 스타일을 지정할 때 CSS의 모든 다른 상태에 대해 동일한 스프라이트 이미지가 참조됩니다. 또한 background-position 속성은 각 상태에 대해 "스프라이트" 이미지의 어떤 부분을 사용할지 지정하는 데 사용됩니다. 적절한 방법으로 "스프라이트" 이미지를 구조화할 수 있습니다. 뷰어는 일반적으로 세로로 스택되어 있습니다. 다음은 위에서 동일한 스크롤 단추를 스타일링하는 "스프라이트" 기반 예입니다.

.s7flyoutviewer .s7scrollleftbutton[state]  {
    background-image: url(images/v2/ScrollLeftButton_light_sprite.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="up"]{
background-position: -56px -504px;
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="over"]{
background-position: -0px -504px;
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="down"]{
background-position: -56px -448px;
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="disabled"]{
background-position: -0px -448px;
}