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 0 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 pytania typu Range (Zakres)
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.
Trzy parametry, które można skonfigurować w pytaniu typu range (zakres) to start (Początek), end (Koniec) i step (Etap). Parametr start (Początek) definiuje liczbę wyświetlaną po lewej stronie suwaka zakresu, a parametr end (Koniec) — liczbę wyświetlaną po prawej stronie. Parametr step (Etap) definiuje liczby między poszczególnymi punktami pytania typu range (zakres). 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ść 0 dla parametru start, 10 dla parametru end lub 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ą.
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
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.
Pytania typu range (zakres) na podstawie istniejących warstw obiektowych
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 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ępniany jest również komunikat 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).