Widgets : Différence entre versions

Version du 19 juin 2009 à 10:55

Cette librairie facilite la création des interfaces en proposant des objets associés à chaque élément connu d'une page Web : champ de formulaire, tableau, lien avec puce, popup calendrier de sélection d'un jour...

getDescription

Méthode commune à toutes les librairies pour obtenir la description de l'objet partagé.

$instance = bab_functionality::get('Widgets');

$description = $instance->getDescription();

Initialisation

Fichier addonini.php

Pour accéder aux widgets dans un module d'Ovidentia, il est nécessaire d'installer la librairie Widgets et le module jQuery.

De manière a éviter tout problème ces pré-requis devront être signalés dans le fichier addonini.php du module en y ajoutant quelques lignes :

<source lang="ini">

<?php/*

[general] name="my_addon" . . .

[addons] widgets="0.2.0"

[functionalities] jquery="Available"

• /?>

</source>

Utilisation de la librairie

Pour utiliser la librairie dans un code PHP, il est nécessaire d'utiliser la fonction bab_functionality(). Il est conseillé d'inclure les styles utiles à quelques widgets :

<source lang="php"> $W = bab_functionality::get('Widgets'); $W->includeCss(); </source>

Les pages

<source lang="php"> $page = $W->BabPage('widgets_demo'); $page->setLayout($W->VBoxLayout()); </source>

Exemples

Hello world !

Commençons par un exemple simple qui se contentera d'afficher le texte "Hello world !" sur une page. L'exemple contient un certain nombre d'opérations qui seront nécessaires pour toutes les pages utilisant les widgets.

<source lang="php"> // Ici on récupère l'objet Func_Widgets qui servira notamment à créer tous les widgets et layouts $W = bab_functionality::get('Widgets');

// On crée une page, qui sera le container principal. $page = $W->BabPage();

// On associe à la page une mise en page (layout) verticale : les éléments qu'on y ajoutera seront disposés les uns sous les autres. $page->setLayout($W->VBoxLayout());

// Création d'un simple texte (Label) $helloLabel = $W->Label('Hello world !');

// On ajoute ce texte à la page. $page->addItem($helloLabel);

// C'est fini, on affiche la page. $page->displayHtml(); </source>