Text
Vapaan tekstin vastauksen kysymystyyppi rtSurveyssa
text-kysymystyyppi kerää vapaan tekstin vastauksen — minkä tahansa merkkijonon. Se on joustavin syötetyyppi ja sitä käytetään nimiin, osoitteisiin, kuvauksiin, koodeihin ja kaikkeen, mikä ei sovi spesifisempään tyyppiin.
rtSurvey laajentaa text-tyyppiä myös ajan syöttöwidgeteillä, jotka mahdollistavat tarkan ajanvalintakellon käytön.
XLSForm-perusmäärittely
| type | name | label |
|---|---|---|
| text | respondent_name | Vastaajan koko nimi |
| text | address | Kotiosoite |
Lisätietoja XLSForm-standardin text-tyypistä löytyy XLSForm-spesifikaatiosta.
Käyttötarkoitukset
Tekstikysymyksiä käytetään:
- Nimiin, osoitteisiin, vapaisiin kuvauksiin
- Avoimiin kommentteihin tai palautteeseen
- Koodeihin, tunnuksiin tai viitenumeroihin, jotka eivät sovi integer/decimal-tyypeille
- Aikaarvojen keräämiseen rtSurveyn ajan syöttölaajennuksilla
- Automaattisiin tekstikenttiin (via
search-autocomplete-noedit-v2())
Vakiomuotoiset ulkoasuvaihtoehdot
| Ulkoasu | Kuvaus |
|---|---|
| (ei mitään) | Yksirivisinen tekstisyöte |
multiline | Monirivisinen tekstialue — parhaiten pitkälle vapaamuotoiselle tekstille verkossa |
rtSurveyn ajan syöttölaajennukset
rtSurvey laajentaa text-tyyppiä kellovalitsimella aikaarvojen keräämiseksi. Nämä ulkoasuvaihtoehdot näyttävät kello-ikonin, jota luetteloija voi napauttaa valitakseen tunnit, minuutit, sekunnit tai millisekunnit.
Ulkoasuvariantit
| Ulkoasu | Kuvaus |
|---|---|
inline | Kello-ikoni näytetään kentän vieressä |
inline colors("RRGGBB") | Kello-ikoni mukautetulla heksavärillä |
inline-1line | Kello näytetään kompaktissa yhden rivin muodossa |
inline-1line-RRGGBB | Yhden rivin muoto mukautetulla ikoni-värillä (heksa, ei #) |
inline-1line colors("RRGGBB","RRGGBB") | Yhden rivin muoto kahdella värillä |
inline-onlyresult | Kello-ikoni katoaa valinnan jälkeen; näytetään vain arvo |
inline-onlyresult colors("RRGGBB") | Sama, mukautetulla ikoni-värillä |
Aikamuototokenit
Lisää muotomerkkijono hakasulkeissa ohjaamaan, mitkä aikakomponentit näytetään:
| Muotomerkkijono | Näyttää |
|---|---|
inline-[%H:%M] | Tunnit ja minuutit (24 tunnin muoto) |
inline-[%h:%M] | Tunnit ja minuutit (12 tunnin muoto) |
inline-[%H:%M:%S] | Tunnit, minuutit, sekunnit (24 tunnin muoto) |
inline-[%h:%M:%S] | Tunnit, minuutit, sekunnit (12 tunnin muoto) |
inline-[%H:%M:%3] | Tunnit, minuutit, millisekunnit |
inline-[%M:%S] | Vain minuutit ja sekunnit |
inline-[%M:%3] | Vain minuutit ja millisekunnit |
inline-[%S] | Vain sekunnit |
inline-[%3] | Vain millisekunnit |
inline-[%H] | Vain tunnit (24 tunnin muoto) |
inline-[%h] | Vain tunnit (12 tunnin muoto) |
Esimerkki: Tehtävän keston tallentaminen minuuteissa ja sekunneissa
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | Tehtävän suorittamiseen kulunut aika | inline-[%M:%S] |
Esimerkki: Tapahtuman ajan tallentaminen 24 tunnin muodossa mukautetulla värillä
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | Tapahtuman aika | inline-1line colors("0099FF") |
Tietomuoto
Tekstitiedot tallennetaan ja viedään tavallisena merkkijonona. Aikapohjaisia syötteitä varten inline-kellowidjettillä arvo tallennetaan valitun muotomerkkijonon mukaisessa muodossa (esim. 14:32 muodolle %H:%M).
Rajoitteet ja validointi
Käytä rajoitteita muodon, pituuden tai kuvion pakottamiseen:
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | Koko nimi | string-length(.) >= 2 | Nimen on oltava vähintään 2 merkkiä |
| text | code | Viitenumero | regex(., '^[A-Z]{2}[0-9]{4}$') | Syötä 2 isoa kirjainta ja 4 numeroa |
| text | phone | Puhelinnumero | regex(., '^[0-9]{9,15}$') | Syötä kelvollinen puhelinnumero |
Parhaat käytännöt
- Käytä tarkempia tyyppejä (
integer,decimal,date) aina kun tiedolla on tunnettu rakenne — tämä estää virheelliset merkinnät ja yksinkertaistaa analyysiä. - Lisää
constraintstring-length()- tairegex()-funktiolla koodien tai tunnuksien validointiin. - Käytä
multiline-ulkoasua avoimiin kysymyksiin, joissa vastaajat voivat kirjoittaa useita lauseita. - Ajan keräämistä varten valitse aikamuototokenit, jotka vastaavat analyysisi edellyttämää tarkkuutta — millisekuntien kerääminen, kun tarvitset vain minuutteja, tuhlaa luetteloijan vaivaa.
Alustatuki
Text-kysymystyyppi ja kaikki ajan syötön ulkoasut ovat tuettuja iOS-, Android- ja verkkoalustoilla.
Rajoitukset
- Tekstivastaukset ovat vapaamuotoisia — sisäänrakennettua oikeinkirjoituksen tarkistusta tai sanastorajoitetta ei ole muuten kuin regex-kuvioiden kautta.
- Inline-kellowidjetti on rtSurvey-laajennus eikä se ole osa XLSForm-standardispesifikaatiota.