Widgets : Différence entre versions
(→Hello world !) |
|||
| Ligne 1 : | Ligne 1 : | ||
[[Catégorie:Documentation des librairies]] | [[Catégorie:Documentation des librairies]] | ||
| − | Cette librairie | + | 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... |
{{Fonctionnalité|path=Widgets|addon=widgets|version=0.1.9}} | {{Fonctionnalité|path=Widgets|addon=widgets|version=0.1.9}} | ||
| + | === 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 | + | 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"> | <source lang="ini"> | ||
| Ligne 31 : | Ligne 31 : | ||
</source> | </source> | ||
| + | ==== Utilisation de la librairie ==== | ||
| − | == | + | <source lang="php"> |
| + | $W = bab_functionality::get('Widgets'); | ||
| − | |||
| + | </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 | // Ici on récupère l'objet Func_Widgets qui servira notamment à créer tous les widgets et layouts | ||
$W = bab_functionality::get('Widgets', false); | $W = bab_functionality::get('Widgets', false); | ||
| Ligne 45 : | Ligne 53 : | ||
$page = $W->BabPage(); | $page = $W->BabPage(); | ||
| − | // On associe à la page une mise en page (layout) verticale : les | + | // 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()); | $page->setLayout($W->VBoxLayout()); | ||
| − | // Création d' | + | // Création d'un simple texte (Label) |
$helloLabel = $W->Label('Hello world !'); | $helloLabel = $W->Label('Hello world !'); | ||
| − | // On ajoute ce | + | // On ajoute ce texte à la page. |
$page->addItem($helloLabel); | $page->addItem($helloLabel); | ||
// C'est fini, on affiche la page. | // C'est fini, on affiche la page. | ||
$page->displayHtml(); | $page->displayHtml(); | ||
| − | |||
| − | |||
</source> | </source> | ||
Version du 19 juin 2009 à 09:23
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...
|
Sommaire
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
<source lang="php"> $W = bab_functionality::get('Widgets');
</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', false);
// 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>
