Pull to refresh

HTML и SVG: создаём интерактивную карту

Reading time 8 min
Views 233K
Давайте создадим интерактивную карту. Чего-нибудь. Что значит интерактивную? Ну, она должна взаимодействовать с пользователем и с данными на веб-странице, на которой она расположена. Думаю, этого достаточно, чтобы считать её интерактивной.

Что же, и возьмём мы SVG. Почему? Да потому что с ним легко работать человеку, знакомому с HTML. SVG — это векторный формат, основанный на XML. То есть у SVG-рисунка есть своя DOM, к различным элементам можно применять CSS-правила и управлять старым добрым JavaScript'ом.

Что же, начнём?

Самые нетерпеливые, могут сразу посмотреть демо, но я предлагаю читать обо всём по порядку.

Готовим карту


Для начала нам нужна суть. То бишь сама карта. В случае, если гугл не помогает, то её можно нарисовать и самому, даром что в Inkscape это сделать не трудно.

Я же, к примеру, возьму карту одной круглой страны (исходник на Wikimedia Commons)

Поскольку, по моему замыслу, у областей карты не должно быть различного окраса, то вначале я вырезаю из интересующих меня тегов <path> стили fill и stroke, зато взамен даю этим элементам нужные мне class и id. Например, class=«area» для регионов и class=«city» для городов.

Далее, в секции <defs> изображения помещаем до боли знакомое:
<style type="text/css">
  .area {
    stroke: black;
    stroke-width: 2px;
    fill: #E9FFE9;
  }
  .city {
    stroke: black;
    stroke-width: 2px;
    fill: red;
  }
</style>

Вот и обещанный мною CSS в действии. В принципе, этого уже достаточно. Diff.

Результат:


Вставляем SVG в HTML


Достаточно подробно этот процесс был освещён в хабратопике К вопросу о кроссбраузерном использовании SVG.

Мы же будем использовать HTML5 и воспользуемся самым простым, гуманным и стандартным способом:
<object data="map.svg" type="image/svg+xml" id="imap" width="500" height="420"></object>

Все браузеры, поддерживающие SVG, его корректно «скушают» и покажут. И даже дадут нам с ним поработать. При одном условии: если веб-сервер отдаст его с MIME-типом image/svg+xml. Другой MIME-тип может очень смутить Google Chrome (но не Оперу, которая из тега твёрдо знает, что идёт за SVG и на провокации не поддаётся).

Второй правильный метод — вставка SVG-кода прямо в HTML. Великолепно с точки зрения скриптинга, но поддержка браузерами пока похуже. Кстати, заметьте, что SVG, вставленный в «либеральный» HTML, всё-таки остаётся «суровым» XML'ем. Так что кавычки и закрывающие теги обязательны.

Подводные грабли

Но не всё так просто. Сразу можно заметить, что браузеры упорно не хотят масштабировать нашу карту, а если она не влезает, то показывают полосы прокрутки, вот так:

Чтобы заставить браузеры работать с SVG так, как мы ожидаем, следует убрать в SVG-файле из тега <svg> атрибуты width и height (или задать им значения в 100%), а вставить специально предназначенный для браузеров атрибут viewBox со значениями координат левого верхнего и правого нижнего углов изображения:
viewBox="0 0 493 416"
Diff.

После этого ситуация значительно улучшается, но другую граблю нам подкладывает Google Chrome: он упорно стремится смасштабировать картинку по высоте до высоты элемента <object>, а не увеличить высоту <object> согласно ширине тега и пропорциям изображения, как ведут себя остальные браузеры.

Жаль. Придётся привлечь JavaScript и подогнать высоту элемента вручную.
var viewBox = svgdom.rootElement.getAttribute("viewBox").split(" ");
var aspectRatio = viewBox[2] / viewBox[3];
svgobject.height = parseInt(svgobject.offsetWidth / aspectRatio);
Diff.

Результат:


Взаимодействуем с SVG


Чтобы нам взаимодействовать с SVG, вписаннным прямо в HTML, ничего не нужно — он уже часть DOM веб-страницы.

Получить доступ к SVG, вставленным через <object> чуть сложнее:
jQuery(window).load(function () { // Нам нужно дождаться, пока вся графика (и наша карта тоже) загрузится, поэтому используем window.onload,
  var svgobject = document.getElementById('svgmap'); // Находим тег <object>
  if ('contentDocument' in svgobject) {              // У нас действительно там что-то есть?
    var svgdom = jQuery(svgobject.contentDocument);  // Получаем доступ к объектной модели SVG-файла
    // Теперь делаем свою работу, например:
    jQuery("#figure1", svgdom).attr("fill", "red");  // Находим тег с id="figure1" в SVG DOM и заливаем его красным
  }	
});

Да, jQuery работает с SVG, но только частично. Например, я заметил, что не работают функции addClass и removeClass, а так же поиск по классам (jQuery(".class")). Приходится извращаться.

Заметьте, что я использую событие window.onload, так как нам необходимо дождаться полной загрузки страницы, вместе со всеми связанными элементами (в числе которых и наша карта). Однако и тут Google Chrome спешит подложить нам свинью: в том случае, если скрипт с window.onload находится в html-коде до тега <object>, то код в обработчике выполняется ДО того, как карта на самом деле загрузится. Поэтому тег <script> необходимо разместить после нашей карты. Sad but true.

Интерактивность первая: выделяем районы на карте щелчком по чекбоксу на странице.

Для этого взаимодействия нам понадобятся чекбоксы в каждой строке таблицы с районами, а так же совпадающие или схожие id у строк таблицы и районов на карте.

Здесь мы будем при щелчке по флажку ставить или убирать класс selected у соответствующей области на карте, а так уже у самой строки. Это несложно:
$("#areas input[type=checkbox]").change(function() {
  var row = $(this).parent().parent();
  var id = row.attr("id");
  if (this.checked) {
    row.addClass("selected");
    $("#"+id, svgdom).myAddClass("selected");
  } else {
    row.removeClass("selected");
    $("#"+id, svgdom).myRemoveClass("selected");
  }
});

Соответственно, нужно добавить и стилевые определения для данного класса. Предоставляю вам это сделать самостоятельно, согласно своих вкусов и предпочтений. Diff.


Интерактивность вторая: вскрываем/показываем названия на карте щелчком по чекбоксу на странице.

Это взаимодействие делается ещё проще. Вставляем на страницу <input type="checkbox" id="titleswitch"> и немножко яваскрипта, который добавляет/удаляет всем связанным с названиями элементам на карте класс hidden {visibility: hidden;}:
$("#titleswitch").change(function () {
  var elements = $(svgdom.getElementsByClassName("areatitle"))
    .add($(svgdom.getElementsByClassName("citytitle")))
    .add($(svgdom.getElementsByClassName("titlebox")))
    .add($(svgdom.getElementsByClassName("titleline")));
  if (this.checked) {
    elements.myAddClass("hidden");
  } else {
    elements.myRemoveClass("hidden");
  }
});

Вот так.


Интерактивность третья: подсвечиваем районы на карте при наведении на строку таблицы (и наоборот)

Для этого необходимо повешать обработчики события onhover как на таблицу:
// Подсвечиваем регион на карте при наведении мыши на соотв. строку таблицы.
$("#areas tr").hover(
  function () {
    var id = $(this).attr("id");
    $("#"+id, svgdom).myAddClass("highlight");
  }, 
  function () {
    var id = $(this).attr("id");
    $("#"+id, svgdom).myRemoveClass("highlight");
  }
);  

…так и на районы на карте:
// Подсвечиваем строку в таблице при наведении мыши на соотв. регион на карте
$(svgdom.getElementsByClassName("area")).hover(
  function () {
    var id = $(this).attr("id");
    $("#areas #"+id).addClass("highlight");
  }, 
  function () {
    var id = $(this).attr("id");
    $("#areas #"+id).removeClass("highlight");
  }
);

Для того, чтобы мы это видели, добавим соответствующие CSS-правила в страницу:
tr.highlight, tr:hover, tr:nth-child(even):hover {
  background: lightyellow;
}
…и в SVG-карту:
.highlight, .area:hover {
  fill: lightyellow;
  stroke: black;
}

При наведении мышкой на строку таблицы (или на район на карте) на соответствующий район на карте (на строку таблицы) вешается нужный для подсвечивания класс. Чтобы приведённый выше код работал, необходимо, чтобы у районов на карте и строк таблицы были совпадающие (или схожие) id. Diff.


Интерактивность четвёртая: Отображаем данные со страницы на карте

Ну что же, банальное присваивание классов, наверное, уже наскучило. Пускай карта нам показывает на себе какие-нибудь данные.

Перво-наперво: данные. Добавим к нашей табличке пару столбцов, например «Люди» и «Деньги». Внимание: Данные взяты от балды и никакого отношения к реальному Аместрису не имеют. А так же радиокнопки, по которым будем переключать, какие данные показывать.

Во-вторых, нам нужно место на карте, где будут отображаться данные. Добавим на карту пять блоков <text> (по одному на каждый регион, соотнеся их id с регионами) и соответствующие стили в <defs>:
<text
   class="areavals"
   x="190.29787"
   y="246.35461"
   id="text3186"></text>


Ну и JavaScript-код, который будет брать данные из ячеек таблицы и помещать в блоки текста:
$("input[name=tabledata]").change(function () {
  var descnum = $(this).parent().prevAll().length+1;
  $("#areas tbody tr").each(function() {
    var id = $(this).attr("id").substring(4);
    var value = $(this).children(":nth-child("+descnum+")").text();
    $("#text"+id, svgdom).text(value);
  });
});

И по переключению радиокнопок карта будет показывать нужные цифры. Вуаля!


Интерактивность пятая: всплывающие подсказки

Возможно, это уже и лишнее, но пусть будет. Для ровного счёта.

Для данного взаимодействия возьмём плагин jQuery.tooltip и привяжем его к областям на карте. Текст для подсказок будем брать, конечно же, из таблицы:
$(svgdom.getElementsByClassName("area")).tooltip({
  bodyHandler: function() {
    var id     = $(this).attr("id");
    var area   = $("#areas #"+id+" td:nth-child(2)").text();
    var result = $("<p>").append($("<strong>").text(area));
    $("#areas #"+id+" td:nth-child(2)").nextAll().each(function(){
      var pos = $(this).prevAll().length+1;
      var title = $("#areas thead th:nth-child("+pos+")").text();
      var value = $(this).text();
      result.append($("<p>").text(title + ": " + value));
    });
    return result;
  }
});


Diff.

И так далее…

Разумеется, этим возможности взаимодействия с SVG не ограничиваются. Вы можете делать всё. Перетасовывать DOM, менять страницу и SVG по AJAX-запросам и многое, многое другое. Дерзайте.

Результат




Оставшиеся подводные камни

Из известных проблем пока что можно отметить, что Google Chrome не выводит на печать SVG-картинки. Это или его баг или баг WebKit в целом.

Обратная совместимость


Почти все современные браузеры поддерживают SVG: IE 9+, Opera 8+, Firefox 3+ (в Firefox 1.5+ частичная поддержка), Chrome всех версий, Safari 3.2+ (более полный список)

Но увы и ах, светлое будущее целиком всё никак не наступит и задумываться о поддержке старых браузеров всё же приходится.

Стандартный и самый простой путь, если SVG — это просто картинка: вставляем замещающее содержимое (отрендеренную в PNG картинку и абзац текста) внутрь тега <object>.
<object data="map.svg" type="image/svg+xml" id="imap" width="600" height="500">
  <img src="map.png" alt="Неинтерактивная карта" width="600" height="500">
  <p>К сожалению, вы используете устаревшую версию браузера, который не поддерживает интерактивную карту.</p>
</object>

Если в браузере поддержки SVG нет, будет показана PNG-картинка и текст, уведомляющий пользователей, что их браузер устарел. Никакого интерактива. Впрочем, он, может быть, не очень-то и нужен. Правда, есть один минус — как я заметил, современные браузеры упорно скачивают себе замещающую png-картинку, несмотря на то, что они её всё равно не отобразят.

Желающие могут воспользоваться детектированием поддержки SVG с помощью Modernizr и наворотить на яваскрипте что-нибудь посложнее.

В более сложных случаях вам могут помочь многочисленные решения на Flash, VML или Canvas (или на всех вместе). Список можно посмотреть здесь: HTML5 Crossbrowser Polyfills, но те решения, которые я опробовал, мне, к сожалению, не помогли. Возможно потому, что тот SVG c CSS'ом, что я набросал на коленке — оказался им не по зубам.

Конвертирование SVG в PNG

В сети есть много мест, где можно конвертнуть SVG-картинку во что-нибудь другое. Я же предложу воспользоваться командой rsvg-convert из пакета librsvg2-bin. Примерно вот так:
cat map.svg | rsvg-convert > map.png

Впрочем, она может преобразовывать и в другие форматы, а так же увеличивать/уменьшать картинку, смотрите --help.
Для массовых преобразований можно сочинить команду посложнее или посмотреть примеры в форумной ветке, где я эту команду и нашёл.

Вместо заключения


Ну вот и всё. При ближайшем рассмотрении это не так уж и сложно, а главное — всё близко и знакомо веб-разработчику. Смотрите, о чём я написал выше в виде демо-страницы, раздирайте исходный код из репозитория, если есть предложения и улучшения — высказывайте в комментариях или присылайте в репозиторий в виде пулл реквестов. Приятной вам работы с современными веб-технологиями!
Tags:
Hubs:
If this publication inspired you and you want to support the author, do not hesitate to click on the button
+76
Comments 19
Comments Comments 19

Articles