Pytań typu range (zakres) można używać do wprowadzania liczb całkowitych lub dziesiętnych z określonego zakresu. Służy do tego suwak umożliwiający wybór wartości z zakresu zdefiniowanego przez autora ankiety.
Domyślnie pytanie typu range (zakres) udostępnia suwak z wartościami od 1 do 10 i akceptuje wartości będące dowolnymi liczbami całkowitymi z podanego zakresu. Działa to tak samo jak w przypadku wyglądu distress w pytaniach typu integer (liczba całkowita). Nowy zakres można zdefiniować, ustawiając parametry danego pytania.
Parametry suwaka zakresu
Pytania typu range (zakres) akceptują trzy różne parametry, które należy wprowadzić w kolumnie parameters (parametry) arkusza survey (ankieta) w formularzu XLSForm. Jest to inna kolumna niż bind::esri:parameters i w przypadku starszych ankiet może być konieczne dodanie jej ręcznie.
W pytaniach typu range (zakres) można skonfigurować trzy następujące parametry: start, end i step. Parametr start definiuje liczbę wyświetlaną po lewej stronie suwaka zakresu, a parametr end — liczbę wyświetlaną po prawej stronie. Parametr step definiuje liczby między poszczególnymi punktami suwaka. Na przykład następujące parametry powodują utworzenie pytania typu range (zakres), które akceptuje co trzecią liczbę całkowitą z zakresu od 0 do 15:
start=0 end=15 step=3
Można ustawić wartość parametru start, która jest wyższa niż wartość parametru end. W takim przypadku kolejne wartości są coraz mniejsze, a nie coraz większe. Jeśli dowolny z tych parametrów nie jest skonfigurowany, przyjmuje się domyślnie wartość 1 dla parametru start, 10 dla parametru end i 1 dla parametru step.
Notatka:
Pole utworzone w warstwie obiektowej dla pytania typu range (zakres) może być różne w zależności od skonfigurowanych parametrów. Jeśli wszystkie trzy parametry będą liczbami całkowitymi, utworzone pole będzie zawierać liczbę całkowitą. Jeśli jednak dowolny z parametrów będzie skonfigurowany na wartość dziesiętną, pole będzie zawierać liczbę dziesiętną.
Wygląd
W przypadku skonfigurowania kolumny appearance na no-ticks pytanie typu range (zakres) jest wyświetlane bez linii wskazujących pozycje suwaka zakresu ani wartości minimalnej i maksymalnej. Nie wpływa to na działanie pytania, tylko na sposób jego wyświetlania.
Opcje stylu
Kolory pytań typu range (zakres) można dostosować w kolumnie body::esri:style.
Pytanie typu range (zakres) akceptuje trzy parametry stylu: startColor, endColor i color. Parametr startColor definiuje kolor wyświetlany po lewej stronie suwaka zakresu, a parametr endColor — kolor wyświetlany po prawej stronie. Jeśli wartości te nie zostaną skonfigurowane, w obu przypadkach przyjmuje się domyślnie kolor biały. Jeśli są to różne wartości, między nimi stosowany jest gradient. Parametr color definiuje kolor używany do wypełnienia miejsca między lewą stroną suwaka i wartością bieżącą. Jeśli nie zostanie określony, domyślnie przyjmowane jest wypełnienie przezroczyste.
Kolory można określać przy użyciu standardowych nazw kolorów HTML lub szesnastkowych kodów kolorów, na przykład startColor=Orange endColor=White color=#FF6347.
Pytania typu range (zakres) na podstawie istniejących warstw obiektowych
Notatka:
W tej sekcji opisano funkcje, które są dostępna tylko w aplikacji Survey123 Connect. Te funkcje nie są dostępne w aplikacji Survey123 Studio.
Jeśli nowa ankieta jest tworzona na podstawie istniejącej warstwy obiektowej, w której używana jest domena zakresowa, pytanie typu range (zakres) jest tworzone automatycznie przy użyciu minimalnej i maksymalnej wartości domeny w parametrach odpowiednio start i end. Parametr step jest skonfigurowany na wartość 1, którą autor ankiety może w razie potrzeby zmienić. Wyrażenie w kolumnie constraint (ograniczenie) jest automatycznie wypełniane na podstawie minimalnej i maksymalnej wartości domeny zakresowej i udostępniana jest również wartość domyślna constraint_message (komunikat ograniczeń). Ograniczenia te są nadmiarowe, chyba że autor ręcznie zaktualizuje typ pytania na integer (liczba całkowita) lub decimal (liczba dziesiętna).