自定义基本缩放查看器 customizing-basic-zoom-viewer

基本缩放查看器的所有可视化自定义和大多数行为自定义均通过创建自定义CSS来完成。

建议的工作流是获取相应查看器的默认CSS文件，将其复制到其他位置，对其进行自定义，然后在style=命令中指定自定义文件的位置。

可以在以下位置找到默认CSS文件：

<s7_viewers_root>/html5/BasicZoomViewer_light.css

查看器提供了两个现成的CSS文件，用于“浅”和“深”颜色方案。 默认使用“浅色”版本，但您可以使用以下标准CSS切换到“深色”版本：

<s7_viewers_root>/html5/BasicZoomViewer_dark.css

自定义CSS文件必须包含与默认文件相同的类声明。 如果忽略类声明，则查看器将无法正常运行，因为它没有为用户界面元素提供内置的默认样式。

提供自定义CSS规则的替代方法是直接在网页或其中一个链接的外部CSS规则中使用嵌入样式。

创建自定义CSS时，请记住，查看器将.s7basiczoomviewer类分配给其容器DOM元素。 如果您使用通过style=命令传递的外部CSS文件，请将.s7basiczoomviewer类用作CSS规则的后代选择器中的父类。 如果您在网页上执行嵌入样式，则还可以使用容器DOM元素的ID限定此选择器，如下所示：

#<containerId>.s7basiczoomviewer

构建响应式设计CSS section-0bb49aca42d242d9b01879d5ba59d33b

可以将不同的设备和嵌入大小定位到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像素。 此外，如果查看器变小，它将完全隐藏按钮：

.s7basiczoomviewer.s7mouseinput .s7zoominbutton {
    width:28px;
    height:28px;
}
.s7basiczoomviewer.s7touchinput .s7zoominbutton {
    width:56px;
    height:56px;
}
.s7basiczoomviewer.s7size_small .s7zoominbutton {
    visibility:hidden;
}

要定位具有不同像素密度的设备，必须使用CSS媒体查询。 以下媒体查询块将包含特定于高密度屏幕的CSS：

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

使用CSS标记是为响应式设计构建CSS的最灵活方式。 原因在于，它不仅允许您定位设备屏幕大小，而且允许您定位实际查看器大小，这对于响应式设计布局非常有用。

您可以使用默认查看器CSS文件作为CSS标记方法示例。

CSS媒体查询

您还可以使用纯CSS媒体查询完成设备感知。 给定媒体查询块中包含的所有内容，仅在相应设备上运行时适用。

当应用于移动设备查看器时，使用四个CSS媒体查询（在CSS中定义），顺序如下：

使用媒体查询方法，您应该使用设备感知来组织CSS，如下所示：

无需在每个媒体查询中复制整个查看器CSS。 只有特定于给定设备的属性才能在媒体查询中重新定义。

CSS脚本 section-9b6d8d601cb441d08214dada7bb4eddc

许多查看器用户界面元素使用位图图进行样式设置，并具有多个不同的可视状态。 一个很好的示例是一个按钮，该按钮通常至少具有三种不同的状态：“up”、“over”和“down”。 每个状态都需要为其指定自己的位图图稿。

使用经典样式设置方法时，对于用户界面元素的每个状态，CSS将对服务器上的单个图像文件进行单独的引用。 以下是缩放按钮样式的CSS示例：

.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='up'] {
background-image:url(images/v2/ZoomInButton_dark_up.png);
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='over'] {
background-image:url(images/v2/ZoomInButton_dark_over.png);
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='down'] {
background-image:url(images/v2/ZoomInButton_dark_down.png);
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='disabled'] {
background-image:url(images/v2/ZoomInButton_dark_disabled.png);
}

此方法的一个缺点是最终用户在首次与元素交互时体验到用户界面响应闪烁或延迟。 发生此操作是因为尚未下载新元素状态的图像图稿。 此外，由于对服务器的HTTP调用数量增加，此方法可能会对性能产生轻微的负面影响。

CSS sprite是一种不同的方法，所有元素状态的图像图稿都合并到称为“sprite”的单个PNG文件中。 此类“sprite”具有给定元素的所有视觉状态，它们彼此相邻。 使用拼写设置用户界面元素的样式时，同一个sprite图像将针对CSS中的所有不同状态引用。 此外，background-position属性用于每个状态，以指定使用“sprite”图像的哪个部分。 您可以以任何适当的方式构建“Sprite”图像。 查看器通常将其垂直栈叠。 下面是基于“sprite”的示例，用于从上面为同一放大按钮设置样式：

.s7basiczoomviewer .s7zoominbutton[state]  {
    background-image: url(images/v2/ZoomInButton_dark_sprite.png);
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='up'] {
background-position: -84px -560px;
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='over'] {
background-position: -56px -560px;
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='down'] {
background-position: -28px -560px;
}
.s7basiczoomviewer.s7mouseinput .s7zoominbutton[state='disabled'] {
background-position: -0px -560px;
}

常规样式注释和建议 section-95855dccbbc444e79970f1aaa3260b7b

常见用户界面元素 section-d6330c9be8c444aa9b2a07886e3dbc2a

以下是适用于基本缩放查看器的用户界面元素参考文档：