JQuery : Différence entre versions

De OviWiki
Aller à : navigation, rechercher
 
(9 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
[[Catégorie:Documentation des librairies]]
 
 
{{Fonctionnalité|path=jquery|addon=[[JQuery]]|version=1.3.3.1}}
 
 
==Introduction==
 
 
 
La librairie partagée JQuery partage sous la forme d'une [[API des fonctionnalités|fonctionnalité]] le framework Javascript [http://jquery.com JQuery].
 
La librairie partagée JQuery partage sous la forme d'une [[API des fonctionnalités|fonctionnalité]] le framework Javascript [http://jquery.com JQuery].
  
 +
Le module JQuery est disponible sur CVS : [http://213.215.40.194/cgi-bin/cvsweb.cgi/libraries/jquery/ libraries/jquery]
  
 +
{{Fonctionnalité|path=jquery|addon=jquery|version=1.3.1.1}}
  
== setSourceFile ==
 
  
Définir la source en indiquant le chemin complet vers un fichier.
+
==includeCore==
  
<source lang="php">
+
Cette méthode inclut le fichier javascript principal de JQuery dans l'en-tête de la page.
  
 +
<source lang="php">
 +
$jquery = bab_functionality::get('jquery');
 +
if ($jquery !== false) {
 +
    $jquery->includeCore();
 +
}
 
</source>
 
</source>
  
  
 +
==includeUi==
 +
 +
Cette méthode inclut les fichiers javascript principaux de JQuery UI (user interface) dans l'en-tête de la page.<br />
 +
Il est nécessaire d'appeler la méthode includeCore auparavant.<br />
 +
JQuery UI inclut ces fonctions : ui.core, ui.draggable, ui.droppable, ui.selectable, ui.resizable, ui.sortable, ui.dialog, ui.slider, ui.tabs, ui.datepicker, ui.accordion.
 +
 +
<source lang="php">
 +
$jquery = bab_functionality::get('jquery');
 +
if ($jquery !== false) {
 +
    $jquery->includeCore();
 +
    $jquery->includeUi();
 +
}
 +
</source>
  
 
==Exemples d'utilisations==
 
==Exemples d'utilisations==
  
 
Si la librairie est un pré-requis obligatoire à l'utilisation de votre module, ajoutez ces lignes dans le fichier addonini.php du module :<br />
 
Si la librairie est un pré-requis obligatoire à l'utilisation de votre module, ajoutez ces lignes dans le fichier addonini.php du module :<br />
<pre>
+
<source lang="ini">
 
[functionalities]
 
[functionalities]
 
jquery="Available"
 
jquery="Available"
</pre>
+
</source>
  
  
Ligne 54 : Ligne 67 :
  
 
function monmodule_onPageRefreshed() {
 
function monmodule_onPageRefreshed() {
    if ('theme_axinnov' === $GLOBALS['babSkin']) {
+
    $jquery = bab_functionality::get('jquery');
        $jquery = bab_functionality::get('jquery');
+
    if ($jquery !== false) {
        if ($jquery !== false) {
+
        $jquery->includeCore();
            $jquery->includeCore();
+
    }
        }
+
    }
+
 
}
 
}
 
</source>
 
</source>

Version actuelle en date du 26 mai 2009 à 07:57

La librairie partagée JQuery partage sous la forme d'une fonctionnalité le framework Javascript JQuery.

Le module JQuery est disponible sur CVS : libraries/jquery

Le chemin complet de la fonctionnalité
jquery
Documentation du parent
Pas de parent
Module
jquery
version du module
1.3.1.1


getDescription

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

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

$description = $instance->getDescription();


includeCore

Cette méthode inclut le fichier javascript principal de JQuery dans l'en-tête de la page.

<source lang="php"> $jquery = bab_functionality::get('jquery'); if ($jquery !== false) {

   $jquery->includeCore();

} </source>


includeUi

Cette méthode inclut les fichiers javascript principaux de JQuery UI (user interface) dans l'en-tête de la page.
Il est nécessaire d'appeler la méthode includeCore auparavant.
JQuery UI inclut ces fonctions : ui.core, ui.draggable, ui.droppable, ui.selectable, ui.resizable, ui.sortable, ui.dialog, ui.slider, ui.tabs, ui.datepicker, ui.accordion.

<source lang="php"> $jquery = bab_functionality::get('jquery'); if ($jquery !== false) {

   $jquery->includeCore();
   $jquery->includeUi();

} </source>

Exemples d'utilisations

Si la librairie est un pré-requis obligatoire à l'utilisation de votre module, ajoutez ces lignes dans le fichier addonini.php du module :
<source lang="ini"> [functionalities] jquery="Available" </source>


Pour charger le fichier javascript principal de JQuery dans une page de votre module, prenez exemple sur ce code PHP :
<source lang="php"> /* Appel de la fonctionnalité jQuery */ $jquery = bab_functionality::get('jquery'); if ($jquery !== false) {

   $jquery->includeCore();

} </source>

Si dans votre module, vous désirez charger la librairie dans toutes les pages, vous pouvez utiliser l'API des évènements et ainsi prendre exemple sur ce code PHP à inclure dans le fichier init.php du module :
<source lang="php"> function monmodule_upgrade($version_base,$version_ini) {

   global $babBody;
   
   bab_addEventListener('bab_eventPageRefreshed', 'monmodule_onPageRefreshed', 'addons/monmodule/init.php', 'theme_axinnov');
   return true;

}

function monmodule_onDeleteAddon() {

    bab_removeEventListener('bab_eventPageRefreshed', 'monmodule_onPageRefreshed', 'addons/monmodule/init.php');
    return true;

}

function monmodule_onPageRefreshed() {

    $jquery = bab_functionality::get('jquery');
    if ($jquery !== false) {
        $jquery->includeCore();
    }

} </source>