URL formulierveld type
From Joomla! Documentation
Dit veld is in wezen is een tekstveld voor een url. Indien gevuld met een volledig gekwalificeerde url (met name een schema gevolgd door het domein zoals http://example.com) met gebruik van IDN (die gebruik maakt van niet-ascii-tekens zoals ê of Ψ), dan zal de url in punycode vertaald worden nog voor deze wordt opgeslagen. Dit zorgt er voor dat de url zal werken, ongeacht de omgeving. Als u veldgegevens wilt renderen in IDN dan moet u volgende conversie methode gebruiken:
JStringPunycode::urlToUTF8($this->contact->webpage)
.
- type (verplicht) moet de waarde url bevatten.
- name (verplicht) is de unieke naam van het veld.
- label (verplicht) is de (vertaalbare) beschrijvende titel van het veld.
- size (optioneel) is de breedte van het tekstvak in tekens. Indien weggelaten wordt de breedte bepaald door de browser. Deze waarde beperkt niet het aantal tekens dat ingevoerd kan worden.
- maxlength (optioneel) beperkt het aantal tekens dat ingevoerd kan worden.
- default (optioneel) is de standaard waarde (en is niet vertaalbaar) .
- description (optioneel) is (vertaalbare) tekst die wordt weergegeven als tootip wanneer de gebruiker de muis beweegt over de drop-down box.
- class (optioneel) is een CSS class naam voor het HTML formulierveld. Indien weggelaten wordt de standaard 'text_area'.
- readonly (optioneel) Het veld kan niet veranderd worden en zal automatisch de standaard waarde overnemen
- disabled (optioneel) Het veld kan niet veranderd worden en zal automatisch de standaard waarde overnemen - het zal niet worden verzonden
- required (optioneel) Het veld moet ingevuld zijn voor het verzenden van het formulier.
- filter (optioneel) laat het systeem toe bepaalde HTML-tags of raw data op te slaan.
- validate (optioneel) maakt een validatie
- relative (optioneel) ingesteld op 'true' voor relatieve URL's
- hint (optionel) De tekst die getoond wordt in het html placeholder element, meestal een lichter gekleurde hint, getoond binnen een leeg veld.
Voorbeeld XML-velddefinitie:
<field name="mytextvalue" type="url" default="http://www.example.com" label="Enter a URL" description="" size="10" />
Zowel een url-regel als een url input-filter kan mee verzekeren dat geldige url-gegevens in dit veld worden ingevoerd.