Praca z plikami SVG

Po skonfigurowaniu wyglądu pytań typu select one (wybierz jedną) lub select multiple (wybierz wiele) na wartość image-map (mapa obrazu), pytania te będą wyświetlane jako obrazy, a możliwe do wybrania regiony obrazów będą możliwościami wyboru. Ten wygląd wymaga, aby w folderze multimediów ankiety znajdował się plik SVG. Należy także podać listę wyboru z wartościami nazw zgodnymi z identyfikatorami ścieżek regionów pliku SVG. W kolumnie media::image skoroszytu ankiety należy wprowadzić dokładną nazwę pliku obrazu (wraz z rozszerzeniem .svg).

Wygląd image-map (mapa obrazów) dla pytania typu select one (wybierz jedną)
Notatka:

Wygląd image-map (mapa obrazu) nie jest obsługiwany w aplikacji internetowej Survey123.

Scalable Vector Graphics (SVG) to język zgodny ze standardem XML służący do obsługi grafik wektorowych 2D. Własny obraz SVG można utworzyć w edytorze grafik wektorowych lub w edytorze tekstu. Istnieje także wiele witryn oferujących bezpłatne pliki SVG, a także narzędzi umożliwiających przekształcanie obrazów rastrowych w pliki w formacie SVG. Plik SVG może zawierać jeden lub większą liczbę obrazów rastrowych w tle.

Plik SVG można modyfikować w edytorze tekstu. W poniższym przykładzie prezentowany jest prosty plik SVG z kierunkami kompasu. Zanotuj identyfikatory ścieżek poszczególnych regionów.

<svg
  xmlns="http://www.w3.org/2000/svg"
  height="180"
  width="180">
  <g style="fill:#A9A9A9">
    <path id="North" d="M 75,75 90,0 105,75 Z"/>
    <path id="South" d="m 75,105 15,75 15,-75 Z"/>
    <path id="West" d="M 75,75 0,90 75,105 Z"/>
    <path id="East" d="m 105,75 75,15 -75,15 Z"/>
  </g>
</svg>

Wymagania minimalne dotyczące plików SVG

Poniżej znajdują się wymagania minimalne dotyczące plików SVG, które mogą być używane z wyglądem image-map (mapa obrazu) w aplikacji Survey123:

  • Musi zawierać co najmniej jeden element <path> o wartości id. Innych elementów, takich jak <rect>, <ellipse>, <circle>, <image> i <text> nie można używać do wybierania możliwości wyboru. Elementu <path> nie można używać do wybierania możliwości wyboru, jeśli nie ma wartości id.
  • Nie może zawierać pustych grup. Grupy są otoczone znacznikami <g> i </g>. Jeśli plik SVG zawiera co najmniej jedną pustą grupę, nie będzie można wybrać żadnego regionu obrazu.
  • Może zawierać tylko jedną grupę na każdym poziomie zagnieżdżenia. Plik SVG może mieć wiele zagnieżdżonych poziomów. Jeśli jednak poziom zawiera więcej niż jedną grupę, nie będzie można wybierać żadnych elementów <path>.
  • Musi mieć zdefiniowaną wysokość i szerokość (okno widoku). Jeśli plik SVG nie ma okna widoku, możliwe do wybrania regiony mogą być przesunięte względem obrazu bazowego.
  • Może zawierać opcjonalny atrybut viewBox, jeśli jest on zgodny z oknem widoku. Jeśli atrybut viewBox różni się od wartości wysokości i szerokości, możliwe do wybrania regiony będą przesunięte względem obrazu bazowego.