Actions

Vraagtype - Korte vrije tekst

From LimeSurvey Manual

This page is a translated version of the page Question type - Short free text and the translation is 100% complete.

Other languages:
English • ‎español • ‎Nederlands • ‎slovenščina

Contents

Korte beschrijving

Met dit vraagtype lees je een regel tekstinvoer.

S ST.jpg


"'Let op: IN een MySQL-database kan het maximum aantal tekens onbeperkt zijn. Op Postgres en MSSQL is het maximum aantal tekens dat kan worden ingevoerd 255."'

Hoofd instellingen

Verplicht (mandatory)

Beschrijving

Met deze optie kun je instellen dat alle onderdelen van de vraag beantwoordt moeten worden. Als je een vraag hebt met subvragen en je wilt niet alle onderdelen verplicht maken, gebruik dan het min_answers vraagattribuut

Geldige waarden

  • Ja
  • Nee (standaard)


Als de kaartservice van Google is ingeschakeld, en de vraag is verplicht, dan moet de deelnemer de rode punt verplaatsen of de coördinaten invoeren. De deelnemer mag niet uitgaan van de standaardpositie. Het wordt aanbevolen dat in de vraag aan te geven.


Validatie (met reguliere expressies) (preg_validation)

Beschrijving

Met deze optie kun je een reguliere expressie specificeren waarmee je alle delen van een vraag kunt controleren.

Als volgens de validatie een vraag of subvraag niet goed is, dan wordt de achtergrond van het tekst invoerveld veranderd in rood (Nieuw in 1.92 ), je ziet als ontwerper dan gemakkelijk de fouten.

Geldige waarden

  • elke geldige reguliere expressie

Voorbeeld

  • Hier staan meerdere voorbeelden



Standaardwaarde (defaults)

Beschrijving

Hiermee kun je de standaardwaarde instellen voor enkele lijst, meerkeuze en tekst vraagtypes (Nieuw in 1.92 ).


Geldige waarden

  • Bij enkele keuze vragen: Je kunt met dropdown veld(en) de verlangde standaard kiezen.
  • Bij meerkeuzevragen: Je kunt met een checkbox de verlangde standaard kiezen (aanvinken of niet aanvinken).
  • Bij tekst vragen (Nieuw in 1.92 ): Je kunt in een tekstveld een waarde of een expressie invullen. Bij een expressie moet je omringende accolades gebruiken.

Voorbeeld

  • Bij een niet anonieme enquête staat de leeftijd van de respondent op het moment van de aanmaken van de token tabel in {TOKEN:ATTRIBUTE_1}. Je wilt nu een vraag alvast invullen met deze waarde en aan de respondent vragen om de leeftijd indien nodig te corrigeren. In het invoerveld voor de standaardwaarde geef je dan op {TOKEN:ATTRIBUTE_1}

Wees voorzichtig met de standaardwaarde bij een verborgen vraag

  • Als u een verborgen vraag heeft met een standaardwaarde dan wordt deze standaardwaarde alleen gezet als de gebruiker bij de stap met deze vraag komt. Dat betekent dat als de hele groep verborgen is er geen standaardwaarde is, of als u vraag per vraag toont er geen standaardwaarde is.
  • Voor een verborgen vraag is er een alternatieve oplossing mogelijk met Expressiebeheer met de assignment operator.



Relevantie vergelijking

Notice.png
Tip: De functie is beschikbaar vanaf versie 1.92


Beschrijving

Bij alle vragen kun je een relevantie vergelijk specificeren. Dit vervangt de condities, het ondersteunt veel meer complexe logica.

Syntax markering in kleur

Wanneer je de relevantie vergelijking opslaat, dan wordt het geëvalueerd en met kleur gemarkeerd. De fouten worden met een kleur aangegeven waardoor je de fouten gemakkelijker ziet,

Geldige waarden

De vergelijking gebruikt de syntax die beschreven is in de Expressie Beheer, zonder de omringende accolades.

Voorbeelden

Voorbeelden van het met kleur markeren, oftewel syntax highligting.


Speciale instellingen

Antwoord voorvoegsel (prefix)

Beschrijving

Een tekst die voor het tekstinvoerveld getoond wordt. De prefix wordt links van de invoer getoond.

Op het kleine scherm : prefix getoond boven de invoer. Als u het links wilt hebben staan (Nieuw in 3.0.0 ) : voeg suffix-prefix-force klasse toe aan de vraag.

Voorbeeld

Als je voor dit attribuut de waarde "$" invult, dan wordt er een dollar teken getoond direct voor het invoerveld.



Antwoord achtervoegsel (suffix)

Beschrijving

Een tekst die wordt toegevoegd aan het eind van een tekst. De prefix wordt weergegeven rechts van het invoerveld.

Op het kleine scherm : prefix wordt getoond onder de invoer. Als u wilt rechts wilt hebben staan (Nieuw in 3.0.0 ) : voeg dan het suffix-prefix-force class toe aan de vraag.

Voorbeeld

Als je voor dit attribuut de waarde "%" invult, dan wordt er een percentage teken getoond direct na het invoerveld.



Toon rijen (display_rows)

Beschrijving

Hiermee kun je het aantal rijen aangeven. Als er meerdere rijen worden ingevoerd, dan wordt er een scrollbar getoond. Voor het vraagtype "Lange vrije tekst" (standaard:5) en het vraagtype "Extra lange vrije tekst" (standaard:30)

Geldige waarden

  • Een positief getal groter dan 0



Breedte invoerveld (text_input_width)

Notice.png
Tip: Wijziging na versie 2.50.0


Beschrijving

Dit attribuut bepaald de breedte van het tekstinvoerveld, het beperkt niet het aantal tekens dat kan worden ingevoerd.

Voorbeeld

Als u wilt dat het invoergedeelte de gehele pagina gebruikt en onder de subvraag : vul 100% in.


Text input size (input_size) (New in 3.0.0 )

Notice.png
Hint: This features is available starting in version 3.0.0


Description

Set the size or cols of input:text or textarea. The limesurvey package force the input to be diplay with width:auto. Then the input seems lesser wide, nerar the number of character of this attribute.


De vraag altijd verbergen (hidden)

Beschrijving

Als je met een URL een vraag al ingevuld toont, dan kun je er met deze instelling ook voor zorgen dat de vraag helemaal niet getoond wordt aan de deelnemer. Deze instelling gaat voor wat met condities is ingesteld, de vraag wordt helemaal niet opgenomen op de pagina. Als je een vraag alleen wilt verbergen (bijvoorbeeld om even snel een waarde op te slaan) gebruik dan in de vraag broncode embedded JavaScript.

Notice.png
Tip: De vraag wordt niet getoond in HTML, het kan worden ingesteld met een vergelijking of enquête URL, maar niet met JavaScript

Beschikbare opties

  • Ja
  • Nee (standaard)



Maximum karakters (maximum_chars)

Beschrijving

Met dit attribuut kun je het maximum aantal karakters instellen dat ingevoerd kan worden.

Geldige waarden

  • een geheel getal, minimaal 1



Willekeurig indelen groep (random_group)

Notice.png
Tip: De functie is beschikbaar vanaf versie 1.92
Important.png
Attentie : De volgorde wordt niet vatgelegd. Je kunt de respondent dus niet de optie geven om later verder te gaan met invullen. Deze beperking zal in een volgende versie worden opgelost.

Beschrijving

Plaats vragen in een groep waarbinnen de vragen in een willekeurige volgorde getoond worden.

Geldige waarden

Geef een tekst op (bijvoorbeeld: 'groep1'). Alle vragen die deze tekst hebben krijgen een willekeurige plaats.



Gebruik mapping service (location_mapservice)

Je kunt hier kiezen uit een korte vrije tekst of een kaart.

Als je een kaart wilt gebruiken, laat defaultRows dan leeg!. Anders wordt de kaart verwijderd en kunnen er fouten optreden.

Als de kaartservice van Google is ingeschakeld, en de vraag is verplicht, dan moet de deelnemer de rode punt verplaatsen of de coördinaten invoeren. De deelnemer mag niet uitgaan van de standaardpositie. Het wordt aanbevolen dat in de vraag aan te geven.



IP als standaard locatie (location_nodefaultfromip)

Moet de standaardpositie op de kaart worden bepaald op basis van het IP adres van de deelnemer (Ja/Nee)?

Je moet om dit te laten werken eerst de IP Info DB API Key instellen.



Land opslaan (location_country)

Moet het land worden opgeslagen bij de enquête resultaten (Ja/Nee)?



Plaats opslaan (location_city)

Moet de plaats worden opgeslagen bij de enquête resultaten (Ja/Nee)?



Staat opslaan (location_city)

Moet de staat worden opgeslagen bij de enquête resultaten (Ja/Nee)?



Postcode opslaan (location_postal)

Moet de postcode worden opgeslagen bij de enquête resultaten (Ja/Nee)?



Standaard positie (location_defaultcoordinates)

Je kunt ook de begin coördinaten instellen. De rode punt wordt dan in het midden weergegeven.

Voorbeeld: 52.1605 9.8438



Inzoom niveau (location_mapzoom)

Je kunt een inzoom niveau instellen. Minimaal=0, Maximaal=11.

Voorbeeld

Deze afbeelding toont een kaart van 500x300 met een inzoom niveau van 5:

Map zoom level.png



Kaart breedte (location_mapwidth)

Breedte van de kaart in pixels (standaard: 500)



Kaart hoogte (location_mapheight)

Hoogte van de kaart in pixels (standaard: 300)



Uitsluitend getallen (numbers_only)

Beschrijving

Als je deze optie aanzet, dan kan de deelnemer alleen getallen invoeren in het tekstvelden.

Bij het vraagtype vergelijking betekent dit dat het resultaat alleen een getal is, dus geen tekst. Hierdoor heb je een garantie dat de berekeningen/conversies goed verlopen in een latere vergelijking (decimaalteken).

Gedrag per vraagtype

  1. Standaard: Als er iets wordt ingevoerd wat geen getal is, dan wordt het gewist.
  2. Array(teksten): Als je dit op "Nee" zit, dan zijn de instellingen "Totalen tonen voor" en "Toon eindtotaal" niet meer van toepassing, de totalen worden niet getoond.
  3. Vergelijking: Als je deze optie op "Ja" zet wordt het resultaat dus geconverteerd naar een numerieke waarde. Als de waarde wel gevuld is, maar niet numeriek is, dan wordt de vergelijking NaN en als lege string opgeslagen in de antwoordentabel.

Beschikbare opties

  • Ja
  • Nee (standaard)



Forceer nieuwe pagina (page_break)

Beschrijving

Dit attribuut is alleen actief als je een enquête gaat afdrukken. Je kunt een nieuwe pagina forceren voor de vraag. (In de Opera browser is dit niet nodig, die handelt dit zelf af.)

Beschikbare opties

  • Ja
  • Nee (standaard)



De volgende vraagtypes ondersteunen timers:

Tijdslimiet (time_limit)

Beschrijving

Als je dit attribuut gebruikt dan krijg je een teller die terug telt nadat de vraag/pagina geladen is. Bij het aflopen wordt of de vraag verplaatst naar de volgende pagina of wordt het een alleen-lezen vraag.

De attributen van de timer werken het beste bij de instelling van de enquête "Vraag voor vraag" tonen. Je kunt het ook gebruiken bij "Groep voor groep", maar dan kan de enquête gebroken worden bij verplichte vragen.

Geldige waarden

  • Elk positief geheel getal

Voorbeeld

Zet het op 240 om 4 minuten terug te tellen (240 seconden)



Tijdslimiet actie (time_limit_action)

Beschrijving

Bepaald welke actie er ondernomen wordt bij het verlopen van de tijdslimiet. Standaard is het "Waarschuwen en doorgaan", dit betekent dat er een waarschuwing wordt gegeven dat de tijdslimiet is verlopen, de vraag wordt opgeslagen en er wordt automatisch op de knop "Volgende >>" gedrukt. De andere keuzes zijn:

  • "Doorgaan zonder waarschuwen", dus geen waarschuwing tonen maar doen alsof er op de vervolg-knop gedrukt is.
  • "Alleen uitschakelen", de deelnemer kan de vraag niet meer invullen, maar er wordt niet automatisch op de vervolg-knop gedrukt.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.

Beschikbare opties

  • Waarschuwen en doorgaan (standaard)
  • Doorgaan zonder waarschuwen
  • Alleen uitschakelen

NB. Als de vragen per groep worden getoond: De "doorgaan" actie wordt vervangen door "uitschakelen". De timer heeft dan geen effecten op de andere vragen op dezelfde pagina.



Tijdslimiet uitschakelen volgende (time_limit_disable_next)

Beschrijving

Hiermee kun je de knop volgende uitschakelen als de tijdslimiet nog niet verlopen is. Normaal zal een deelnemer ongeacht een tijdslimiet op vervolg willen klikken om door te gaan naar de volgende vraag. Als je hier voor "Ja" kiest, dan wordt de knop grijs weergegeven en is pas na het verlopen van de tijd weer beschikbaar.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.

Beschikbare opties

  • Ja = De vervolg-knop is uitgeschakeld totdat de tijdslimiet is afgelopen.
  • Nee (standaard)



Tijdslimiet uitschakelen vorige (time_limit_disable_prev)

Beschrijving

Hiermee kun je de knop vorige uitschakelen als de tijdslimiet nog niet verlopen is. Normaal zal een deelnemer ongeacht een tijdslimiet op vorige willen klikken om terug te gaan naar de vorige vraag. Als je hier voor "Ja" kiest, dan wordt de knop grijs weergegeven en is pas na het verlopen van de tijd weer beschikbaar.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.

Beschikbare opties

  • Ja = De vorige-knop is uitgeschakeld totdat de tijdslimiet is afgelopen.
  • Nee (standaard)



Tijdslimiet boodschap (time_limit_countdown_message)

Beschrijving

De boodschap die getoond wordt tijdens het aflopen van de klok. Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.



Tijdslimiet CSS stijl klok (time_limit_timer_style)

Beschrijving

Je kunt hier je eigen CSS opgeven voor de klok. Standaard is: 'width: 150px; margin-left: auto; margin-right: auto; border: 1px solid #111; text-align: center; background-color: #EEE; margin-bottom: 5px; font-size: 8pt;'

Als je dit gebruikt dan overschrijf je de standaard CSS van een timer, dus weet wat je doet.Je kunt de standaard kopiëren in dit veld en toevoegen 'display: none;'

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.

.



Tijdslimiet voor verlopen tijd boodschap (time_limit_message_delay)

Beschrijving

Dit attribuut bepaald hoeveel seconden voordat de tijdslimiet verstrijkt, de time_limit_message getoond wordt. Standaard is dit 1 seconde.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.

Voorbeeld

time_limit_message_delay: 5 = de boodschap wordt 5 seconden van te voren getoond.



Tijdslimiet verlopen boodschap (time_limit_message)

Beschrijving

Dit is de tekst die getoond wordt aan de deelnemer bij het verlopen van de tijdslimiet. Standaard: "Uw tijd om deze vraag te beantwoorden is verlopen.". De tekst wordt niet getoond als je dat bij de actie hebt opgegeven. Je kunt de tekst opmaken met CSS met het attribuut time_limit_message_style.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is.

Voorbeeld

time_limit_message: Uw tijd om deze vraag te beantwoorden is verlopen.



Tijdslimiet CSS stijl boodschap (time_limit_timer_style)

Beschrijving

Als je dit gebruikt dan overschrijf je de standaard CSS van een timer boodschap. Standaard is: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1002; text-align: center; overflow: auto'

Als je dit gebruikt dan overschrijf je de standaard CSS van een timer, dus weet wat je doet. Het wordt aanbevolen om de z-index waarde opnieuw te gebruiken, of dat minstens de z-index waarde hoger is dan die gebruikt wordt voor het time_limit_warning_message_style attribuut (die is standaard 1001).

Voorbeeld

Wijzigen in:

top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: black; color: white; z-index: 1010; text-align: center; overflow: auto



Tijdslimiet waarschuwing klok (time_limit_warning)

Beschrijving

Aantal seconden voordat de tijdslimiet verloopt, dat de time_limit_warning_message getoond moet worden. Als je hier een waarde invult, dan schakel je tijdslimiet waarschuwing in.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is. Je kunt twee waarschuwingen instellen, er zijn namelijk twee instellingen.

Voorbeeld

Als je hier '20' invult, dan wordt de time limit warning message 20 seconden voordat de limiet verstrijkt, getoond.



Tijdslimiet tijd van waarschuwen (time_limit_warning_display_time)

Beschrijving

Bepaald hoelang de waarschuwing getoond wordt. Standaard is dit tot de tijd verstreken is. Als je een waarde grote dan 0 invult, dan is dat het aantal seconden dat de waarschuwing getoond wordt.

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is. Je kunt twee tijden instellen, er zijn namelijk twee waarschuwingen mogelijk.

Voorbeeld

time_limit_warning_display_time: 10 = De waarschuwing wordt 10 seconden lang getoond.



Tijdslimiet waarschuwing (time_limit_warning)

Beschrijving

De tekst van de waarschuwing die getoond wordt een aantal seconden voordat de tijd verstrijkt. Standaard : "Uw tijd om deze vraag te beantwoorden is bijna verlopen. U heeft {TIME} over.". Hierbij wordt {TIME} vervangen door een tekst als "30 seconden", of "1 minuut, 5 seconden". Dit alleen als de time_limit_warning ingevuld is.

.

Voorbeeld

Attentie: Over {TIME} is uw tijd om de vraag te beantwoorden verstreken.



Tijdslimiet CSS stijl waarschuwing (time_limit_warning_style)

Beschrijving

Als je dit gebruikt dan overschrijf je de standaard CSS van een timer waarschuwing. Standaard is: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1001; text-align: center; overflow: auto'

Als je dit gebruikt dan overschrijf je de standaard CSS van de waarschuwing, dus weet wat je doet. Het wordt aanbevolen om de z-index waarde opnieuw te gebruiken, of dat minstens de z-index waarde lager is dan die gebruikt wordt voor het time_limit_message_style attribuut (die is standaard 1002).

Deze instelling is alleen van toepassing als de algemene tijdslimiet instelling geactiveerd is. Je kunt twee stijlen instellen, er zijn namelijk twee waarschuwingen mogelijk.

Voorbeeld

top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: gray; color: white; z-index: 1001; text-align: center; overflow: auto



Vraag validatie vergelijking (em_validation_q)

Notice.png
Tip: De functie is beschikbaar vanaf versie 1.92


Beschrijving

Deze vergelijking wordt gebruikt om de hele vraag te valideren. Als de invoer van een vraag niet voldoet, dan wordt de em_validation_q_tip getoond met de .em_q_fn_validation CSS style om de fout te markeren. Deze is standaard verborgen (hidden), zie template.css.

Het belangrijkste verschil van deze optie en die bij subvragen, is dat hier een foutboodschap kan worden getoond. Bij subvragen worden fouten aangegeven met de achtergrondkleur.

Geldige waarden

  • Een vergelijking die de syntax gebruikt die beschreven is in de Expressie Beheer, zonder de omringende accolades.
  • Een vergelijking, die de Expressie Beheer syntax gebruikt, zonder de omringende accolades.

Voorbeeld

  • Je wilt demografische informatie verzamelen van gebruikers met een meerdere korte teksten vraag, en je wilt valideren dat de gebruiker een goed e-mailadres en telefoonnummer invult.

Voorbeeld met ongeldige gegevens:

Validation-invalid-both.jpg

Voorbeeld met geldige gegevens:

Validation-invalid-phone.jpg

Hoe moet je de vraag wijzigen om de informatie in te voeren:

Validation-gui.jpg

En hier een stukje van het "Enquête logica bestand" waarmee je de nauwkeurigheid van je expressie kunt controleren en of er syntax fouten zijn:

Validation-logic.jpg

Zoals je kunt zien controleert de validatie vergelijking dat zowel het e-mailadres als het telefoonnummer of leeg of voldoen aan een reguliere expressie filter.

De validatie tip is de tekst die getoond moet worden als het telefoonnummer of het e-mailadres ongeldig zijn.

Notice.png
Tip: LET OP, LimeSuvey gebruikt de Perl syntax voor reguliere expressies, ze moeten dus beginnen en eindigen met een / (slash)!




Vraag validatie vergelijking tip (em_validation_q_tip)

Notice.png
Tip: De functie is beschikbaar vanaf versie 1.92


Beschrijving

Als je em_validation_q gebruikt, dan is dit de optionele boodschap die als 'tip' getoond wordt.

Geldige waarden

  • elke tekst

Voorbeeld

  • Het voorbeeld staat bij de Vraag validatie. Je kunt daar zien hoe er met maatwerk kan worden aangegeven wat er als tip wordt getoond als er een fout wordt gemaakt door de gebruiker.



Subvraag validatie vergelijking (em_validation_sq)

Notice.png
Tip: De functie is beschikbaar vanaf versie 1.92


Beschrijving

Deze vergelijking wordt gebruikt om elke subvraag afzonderlijk te valideren. Als de invoer van een subvraag niet voldoet, dan wordt de achtergrondkleur roze (gebruik van de .em_sq_fn_validation CSS style) om de fout te markeren. Dit is een aanvulling op de normale reguliere expressie validatie.

Geldige waarden

De vergelijking gebruikt de syntax die beschreven is in de Expressie Beheer, zonder de omringende accolades.

Voorbeelden

Stel je hebt een vraag met meerdere korte teksten en je wilt e-mailadressen verzamelen. Je zou een reguliere expressie kunnen gebruiken om de syntax te valideren, maar dat betekent dan niet dat de domeinnaam bestaat. Je kunt een functie toevoegen aan Expressie beheer met de naam validateEmail() die de DNS lookup service gebruikt om het bestaan van het domein te controleren.

Nog een voorbeeld, je wilt alleen veelvouden van 3 toestaan, de vergelijking wordt dan:

(this / 3) == floor(this/3)

De gereserveerde variabele this wordt automatisch vervangen door een referentie naar het actieve invoerveld.



Subvraag validatie tip (em_validation_sq_tip)

Notice.png
Tip: De functie is beschikbaar vanaf versie 1.92


Beschrijving

Als je em_validation_sq gebruikt, dan is dit de optionele boodschap die als 'tip' getoond wordt.

Geldige waarden

  • elke tekst

Voorbeeld

  • In het voorbeeld met het valideren van e-mailadressen, kan de tip zijn : "Het e-mailadres dat u opgaf is ongeldig. Probeert u het nog eens."