Voir la source de Thème d'icônes

[[Catégorie:Développement de modules]]
[[Catégorie:API Ovidentia]]
[[Catégorie:Icônes]]

== Utilisation d'un thème d'icônes ==

=== Exemple ===

Pour afficher une icône en 16x16px sur la gauche d'un libellé, voilà le code qu'il faut utiliser :

<source lang="xml">

<div class="icon-left-16 icon-left icon-16x16">
  <span class="icon mimetypes-x-office-spreadsheet">Fichier</span>
</div>

</source>

la classe CSS qui détermine le choix de l'icône est '''mimetypes-x-office-spreadsheet''', elle peut être obtenue dans la valeur de la constante <code>Func_Icons::MIMETYPES_OFFICE_SPREADSHEET</code>

=== Les constantes ===

On peut trouver la liste des constantes disponibles dans les thèmes d'icônes dans le fichier ''utilit/icons.php''


== Création d'un nouveau thème d'icônes ==

Un thème d'icônes est une librairie héritée de "Icons" qui est fournie en standard dans la distribution d'Ovidentia depuis la version 7.0.0 ; Les nouveaux thèmes doivent être packagés dans des modules dont le nom est préfixés par "icons_".

Une librairie de thème d'icônes doit proposer les méthodes suivantes :

* <code>getDescription()</code>
* <code>includeCss()</code>
* <code>getCss()</code>


== Choix du thème d'icônes ==

Pour le moment il n'existe pas d'interface dédié au thèmes d'icônes dans Ovidentia, il faut passer par l'interface d'administration des librairies pour choisir un thème d'icônes.

par exemple quand le module [[icons_oxygen]] est installé on peut voir l'arborescence suivante :

* Icons
** Default
** Oxygen

Dans le code php, si on utilise <code>bab_functionality::get('Icons')</code> pour obtenir l'objet, c'est le thème choisi dans l'interface d'administration qui sera utilisé.