Principes de base.

Il y a deux grandes parties, dans PLUIE :

• la création d'une fiche (d'un écran)
• l'utilisation d'une fiche.

Création d'une fiche

Groupes

Avec PLUIE, on ne pose pas directement des boutons ou des champs. Il doivent toujours être contenus dans un groupe (et un groupe peut contenir  d'autres groupes).

Objets utilisables

Pour l'instant, les seuls objets définis sont :

• groupe
• saut de lignes(s)
• label (texte)
• image
• champ
• textarea  (champ multi-lignes)
• tableau  (en lecture seule)
• bouton
• marquee  (texte défilant)

Propriétés génériques

• ID ; l'identifiant est obligatoire. Comme l'identifiant est aussi utilisable en tant que propriété, et afin de maintenir une compatibilité maximale, il est conseillé d'utiliser uniquement des lettres ou chiffres, sans accents, sans diacritiques, et de préférence en majuscules

 Méthodes :

• close() ; ferme l'objet, et tous les objets contenus, en appelant, pour chacun regen(). Retourne le code-source HTML de l'ensemble.
• walk() ; retourne une liste de (objet, type), pour l'objet et tous les objets contenus.
• walkd() ; retourne un dictionnaire {ID: objet}, pour l'objet et tous les objets contenus.
• regen() ; retourne le code -source HTML recalculé, pour l'objet courant.

Propriétés des groupes (type "group")

• x ; position horizontale en points. Facultatif
• y ; position verticale en points. Facultatif
• larg ; largeur du groupe en points. Facultatif. 400 par défaut.
• haut ; hauteur du groupe en points. Facultatif. Variable par défaut.
• klass ; nom du style CSS. "cad0" par défaut.
• sens ; méthode d'alignement des objets contenus dans le groupes. "H" horizontal ; "V" vertical. "V" par défaut.
• align ; alignement du groupe. "left", "right" ou "center".  "center" par défaut.  Ce paramètre est contrecarré par la propriété x
• content ; contenu HTML "source" de l'objet

Propriétés de gbr (type "gbr") ; sauts de ligne.

• nb ; nombre de sauts de lignes (<br> en HTML).
• klass ; nom du style CSS. "" par défaut.

Utilisation

Evènements

Les évènements gérés sont les suivants : 

• "clic" ; clic sur un bouton de la souris
• "focus" ; arrivée dans un objet
• "blur" ; lorsque le curseur quitte un objet
• "key" ; appuie sur une touche du clavier
• "changevalue" ; se déclenche, si, lors du "blur" d'un champ, le contenu a changé, depuis le "focus". Cet évènement précède
• toujours un "blur".
• "break" ; c'est un pseudo-évènement, retourné par PLUIE, lorsqu'il n'arrive plus à joindre la fiche.
  

On dispose de plusieurs informations complémentaires, pour aider à gérer les évènements :

• .type ; type de l'évènement ("clic", "focus", "blur", "key", "changevalue","break")
• .kbskey ; peut contenir "shift", "ctrl" ou "alt", si une de ces touches spéciales était enfoncée au moment de l'évènement
• .cible ; ID de l'objet cible de l'évènement
• .kbuffer ; code (ASCII) de la touche du clavier
• .mousebutton ; bouton de la souris enfoncé au moment de l'évènement (1 gauche, 2 droit)