Praca z plikami SVG

Notatka:

W tej sekcji opisano funkcje, które są dostępne tylko w aplikacji Survey123 Connect i aplikacji terenowej Survey123. Funkcje te nie są dostępne w aplikacji Survey123 Studio ani Survey123 Mobile.

Notatka:

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

Skonfigurowanie kolumny appearance (wygląd) pytań typu select one (wybierz jedną) lub select multiple (wybierz wiele) na wartość image-map (mapa obrazu) powoduje, że 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ą)

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.