Atlaslog
Atlaslog / Examples / OpenLayers / Custom Control
OpenLayers · Runnable Example

Custom Control

Runnable OpenLayers example: Custom Control. Open the live demo, read the complete source, and copy the file into your project. No build step or API key.

Open standalone → Chinese notes All OpenLayers examples
/demos/openlayers-custom-control.htmlLIVE
single HTML file · CDN dependencies onlyinterface may contain Chinese labels

Source

demos/openlayers-custom-control.html
<!--
  示例:自定义控件
  要点:继承 ol.control.Control 包装自有 DOM,getMap 取地图后执行动画
  依赖:OpenLayers 10.3.1 · jsDelivr CDN
-->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta name="robots" content="noindex,follow">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>自定义控件</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ol@10.3.1/ol.css">
<style>
  html,body{height:100%;margin:0}
  body{display:flex;flex-direction:column;overflow:hidden;
       font:13px/1.6 -apple-system,"Segoe UI","PingFang SC",sans-serif}
  .bar{flex:0 0 auto;padding:8px 12px;background:#f6f7f9;border-bottom:1px solid #e3e6ea;
       display:flex;gap:12px;align-items:center;font-size:12px;color:#58606e}
  .bar label{display:flex;gap:5px;align-items:center;cursor:pointer}
  #map{flex:1 1 auto;min-height:0;background:#eef0f3}
  .home-ctl{top:70px;right:.5em}
  .home-ctl button{min-width:52px;height:auto;padding:3px 8px;font-size:12px}
</style>
</head>
<body>
<div class="bar">
  <label><input type="checkbox" id="label"> 按钮文字改为「回中心」</label>
  <span>拖动地图后点击右上角按钮复位</span>
</div>
<div id="map"></div>
<script src="https://cdn.jsdelivr.net/npm/ol@10.3.1/dist/ol.js"></script>
<script>
(function () {
  'use strict';

  if (typeof ol === 'undefined') {
    document.getElementById('map').innerHTML =
      '<div style="padding:20px;color:#b42318">OpenLayers 加载失败,请检查能否访问 cdn.jsdelivr.net</div>';
    return;
  }

  var HOME = ol.proj.fromLonLat([116.3974, 39.9093]);
  var HOME_ZOOM = 13;

  /* 继承内置控件,DOM 与事件都在构造时准备好 */
  class HomeControl extends ol.control.Control {
    constructor() {
      var el = document.createElement('div');
      el.className = 'ol-control home-ctl';

      var button = document.createElement('button');
      button.type = 'button';
      button.textContent = '复位';
      el.appendChild(button);

      super({ element: el });
      this.button_ = button;

      var self = this;
      button.addEventListener('click', function () {
        var map = self.getMap();
        if (!map) {
          return;
        }
        map.getView().animate({
          center: HOME,
          zoom: HOME_ZOOM,
          rotation: 0,
          duration: 600
        });
      });
    }

    setLabel(text) {
      this.button_.textContent = text;
    }
  }

  var homeControl = new HomeControl();

  new ol.Map({
    target: 'map',
    layers: [new ol.layer.Tile({ source: new ol.source.XYZ({url: 'https://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer/tile/{z}/{y}/{x}', attributions: 'Tiles © Esri'}) })],
    view: new ol.View({
      center: HOME,
      zoom: HOME_ZOOM,
      minZoom: 3,
      maxZoom: 18
    }),
    controls: ol.control.defaults.defaults({ attribution: false }).extend([homeControl])
  });

  document.getElementById('label').addEventListener('change', function () {
    homeControl.setLabel(this.checked ? '回中心' : '复位');
  });
})();
</script>
</body>
</html>
Language: the code and this page are in English; the full tutorial and API notes for this example are in Chinese. The demo itself is the authoritative version — it runs exactly as shown.

More OpenLayers examples

OpenLayers · EXAMPLECustom Controls OpenLayers · EXAMPLECustom Hit Detection Renderer OpenLayers · EXAMPLECustom Interactions