首页 / OpenLayers / API 文档

Attribution

先看结论

版权控件。汇总当前可见图层数据源上的版权文字，在右下角集中展示。

最后验证 2026-11-03 · OpenLayers 10.3.1 · 更新 2026-10-27 · 引用本文

new ol.control.Attribution(options)

构造参数

参数	说明
`className`	控件类名，默认 `'ol-attribution'`
`collapsible`	是否允许折叠，默认 true
`collapsed`	初始是否折叠，默认 true
`tipLabel`	按钮提示文字，默认 `'Attributions'`
`target`	控件挂载的容器元素或 id

常用方法

方法	返回	说明
`getCollapsed()`	boolean	取折叠状态
`setCollapsed(collapsed)`	void	展开或收起版权文字
`getCollapsible()`	boolean	取是否允许折叠
`setCollapsible(flag)`	void	设置是否允许折叠
`setMap(map)`	void	挂载到地图，通常由 `addControl` 调用
`getElement()`	Element	取控件根元素

var osm = new ol.layer.Tile({
  source: new ol.source.OSM({
    attributions: '© OpenStreetMap contributors'
  })
});

var wms = new ol.layer.Image({
  source: new ol.source.ImageWMS({
    url: 'https://example.com/geoserver/wms',
    params: { LAYERS: 'demo:landuse' },
    attributions: '数据来源：市规划院'
  }),
  visible: false
});

var attribution = new ol.control.Attribution({ collapsed: false });
map.addControl(attribution);

注意事项

版权文字来自各数据源的 attributions 选项，控件本身不产生内容，只负责汇总与展示。
只有可见图层参与汇总，切换图层可见性后控件内容会自动变化。
collapsed 为 true 时默认收起，版权信息仍需可访问，收起状态会保留展开按钮。
自定义 target 后控件脱离默认控件容器，缩放、旋转等按钮不会跟随移动。

引用本文

经纬志（2026）。《Attribution》。https://www.jingweizhi.com/openlayers/api/attribution.html（访问日期 2026-11-03）。