arcgis-html-css

ArcGIS HTML 和 CSS

ArcGIS Online 会清理编写的标记。即使浏览器支持有效的 HTML 和 CSS，保存时它们仍可能被移除或更改，而且两个受支持的编辑器并不共用同一套兼容性规范。开始编写前，请先选择受限标记配置。

先确定配置

如果目标不明确，请先询问。切勿猜测：

• Hub 文本卡片 — ArcGIS Online Hub 文本卡片中的 HTML 源代码编辑器。请阅读 references/hub-text-card.md。
• Map Viewer 弹出窗口 — ArcGIS Online Map Viewer 弹出窗口中文本内容的 HTML/CSS 编辑器。请阅读 references/map-viewer-popup.md。

不要将这些配置用于 ArcGIS Enterprise Sites、Experience Builder、嵌入内容、iframe、独立网页或 ArcGIS Maps SDK for JavaScript 应用程序。

弹出窗口 Arcade 属于单独的编写环境。如果请求的输出是弹出窗口 HTML/CSS，请勿生成或组合 Arcade。

生成片段

返回可直接粘贴到所选编辑器中的标记。不要输出 <html>、<head>、外部样式表、构建工具、JavaScript 或独立应用程序。

对于新内容：

1. 确认内容、链接、图像、字段占位符和视觉意图。
2. 仅使用所选配置允许的元素、属性、URL 协议和内联 CSS。
3. 优先使用简单的语义化 HTML。仅在 Hub 中，如果受支持的 Calcite 组件是最清晰、兼容且易于访问的解决方案，则使用该组件。
4. 确保布局在较窄的弹出窗口宽度和移动设备上的 Hub 宽度下仍然易用。

对于修复或转换：

1. 找出清理器或渲染器会拒绝或更改的内容。
2. 优先保留有意义的内容、链接、图像、层级结构和字段占位符，而非视觉保真度。
3. 用最接近且兼容的替代方案替换不受支持的构造。
4. 切勿悄悄删除内容。在片段后列出重要的视觉或行为方面的妥协。
5. 如果请求需要不受支持的脚本或交互功能，请明确说明。

将无障碍性作为完成条件

• 在配置支持的情况下使用语义化结构。
• 保持标题顺序符合逻辑。
• 为图像提供有意义的替代文本，纯装饰性图像除外。
• 使用有意义的链接文本。
• 不要仅通过颜色传达含义。
• 选择颜色时检查文本和交互状态的对比度。
• 避免使用会在较窄宽度下造成裁切或溢出的固定尺寸。

除非修复明确的无障碍问题会实质性改变请求的内容，否则应予以修复；如果会造成这种改变，请说明冲突。

按比例验证

对于简单片段，请根据所选配置参考资料验证每个元素、属性、URL 协议和内联 CSS 属性。检查无障碍性以及窄屏下的显示效果。

对于参考资料未明确说明的复杂布局或行为，如果可以访问实时编辑器，请在其中验证：粘贴、保存、重新打开、检查已保存的标记，并在窄屏和宽屏下测试渲染结果。准确标注结果为 通过允许列表验证 或 通过实时编辑器验证；未经测试，切勿声称 ArcGIS 原样保留了标记。

以 Esri 官方文档为准。带日期的观察结果可用于填补文档空白，但须标明这是观察结果，而非保证。如果这两类来源都未支持某个构造，请采用保守的替代方案。

完成条件

已明确配置，输出为可直接粘贴的片段，每个构造均受该配置支持，无障碍检查通过，已披露妥协，并已说明验证级别。