Type de champ de formulaire pour URL
From Joomla! Documentation
Ce champ est essentiellement un champ texte avec un type URL. Si une url complète (avec le schéma et nom de domaine tel que : http://exemple.com) est renseignée et utilise l'idn (qui utilise des caractères non ascii comme ê ou Ψ) l'URL sera alors traduite en punycode avant l'enregistrement. Ceci permet de garantir que l'URL fonctionne comme prévu, indépendamment de l'environnement. Si vous voulez afficher les données de champ en idn, vous devriez appliquer la méthode de conversion :
JStringPunycode::urlToUTF8($this->contact->webpage).
- type (obligatoire) doit être "url".
- name (nom) (obligatoire) est le nom unique du champ.
- label (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
- size (dimension) (facultatif) est la largeur de la zone de texte en nombre de caractères. Si non renseigné, la largeur sera alors déterminée par le navigateur lui-même. La valeur de cette dimension ne limite pas le nombre de caractères qui peuvent être saisis.
- maxlength (facultatif) nombre maximum de caractères pouvant être saisis.
- default (par défaut) (facultatif) est la valeur par défaut.
- description (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
- class (classe) (facultatif) est le nom de classe CSS pour le champ de formulaire HTML. Si non défini, 'text_area' sera la valeur par défaut.
- readonly (lecture seule) (facultatif) le champ ne pourra pas être modifié et héritera automatiquement la valeur par défaut.
- disabled (désactivé) (facultatif) le champ ne peut pas être modifié et héritera automatiquement la valeur par défaut - ne sera pas transmise.
- required (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
- filter (filtre) (facultatif) autorise le système à sauvegarder certaines balises html ou des données brutes.
- validate (facultatif) vérifie le format de l'url.
- relative (facultatif) mis à true pour les URLs relatives
- hint (factultatif) le texte affiché dans l'emplacement html, habituellement un indicateur de couleur plus claire affiché à l'intérieur d'un champ blanc
Exemple de définition de champ XML :
<field name="mytextvalue" type="url" default="http://www.example.com" label="Enter a URL" description="" size="10" />À la fois une règle URL et un filtre d'entrée d'URL peuvent vous aider à vérifier que des données valides aient été saisies dans ce champ de formulaire.