使用 CSS 自定义

ArcGIS Instant Apps 支持自定义级联样式表 (CSS),从而可以对 web 应用程序外观进行定制更改,这些更改可以在现有配置设置中不可用。 可以修改 Web 应用程序外观的不同方面,例如文本大小和焦点指示器颜色。

警告:

尽管可以自定义 CSS,建议使用 Instant Apps 中提供的所有可用配置,以自定义 Web 应用程序的外观。 更改现有元素时,并非所有 CSS 类都适用。

ArcGIS Instant Apps 模板基于 Calcite Design System 构建,后者提供了一组设计指导原则以及可重用组件,用于创建直观且一致的界面。 可通过覆盖 Calcite 变量自定义应用程序样式以更改应用程序的外观。

使用 CSS 自定义选项

在配置完 Web 应用程序后,可以开始使用 CSS 对其进行自定义。

注:

某些模板不支持自定义 CSS。 有关如何重启 IBM Cognos 服务的详细信息,应用程序工具矩阵 (PDF)查看哪些模板支持自定义 CSS。

要使用 CSS 自定义选项,请完成以下步骤:

  1. 在侧面板中,禁用精简模式,当显示确认提示时,单击继续
  2. 单击搜索设置,然后搜索自定义 CSS

    随即显示主题和布局设置。

  3. 自定义 CSS 部分中单击编辑

    随即显示自定义 CSS 窗口。

  4. 提供 CSS 类以覆盖应用程序的不同元素。
  5. 单击关闭应用自定义 CSS。

    现在会显示您的更改。

  6. 如果您对自定义满意,单击发布以部署自定义应用程序。
警告:

如果源模板的 Instant Apps 更新可能会影响应用程序的自定义 CSS,请在每个产品发布后测试应用程序。

CSS 类

以下部分概述了 CSS 类的示例,这些类可用于将唯一样式和格式应用于应用程序。

自定义字体大小

可以写入用于更改文本的字体大小的 CSS 类。

在以下 CSS 覆盖规则中,可以在 Sidebar Instant Apps 模板中自定义 Sidebar 标题的字体大小:

h3.esri-widget__heading {
  font-size: var(--calcite-font-size-0);
}

标头文本现在以 0 字体大小显示,即大小为 1 rem 或 16 个像素。

自定义焦点指示器颜色

可以写入 CSS 类以更改应用程序中交互式元素的焦点指示器颜色。这将显示为选定元素周围的轮廓。

箭头指向焦点指示器的显示位置。

要更改焦点指示器颜色,可以使用以下 CSS 类:

.calcite-mode-dark{
--calcite-color-focus:#FFFF00;
}

此类在选中后会将交互式元素的焦点颜色更改为十六进制值 #FFFF00,即显示为黄色。

自定义焦点指示器颜色可以提高与 Web 应用程序的主题颜色的对比度,对于具有视觉障碍的用户,这可以提高可访问性。