OOUI/PHP examples/fr

Si vous utilisez OOUI :


 * dans une extension MediaWiki, voir.
 * dans un projet PHP indépendant, exécutez.

Un ensemble plus large de la plupart des exemples de widgets PHP est disponible dans le dépôt de code source. Quand vous clonez le dépôt et / ou que vous l'installez en utilisant composer, consultez aussi.



Configurer la bibliothèque
Avant d'afficher un quelconque widget OOUI, vous devez configurer la bibliothèque en appelant les fonctions suivantes :

Il faut aussi charger le CSS :



Créer un bouton
Pour créer un bouton, utilisez la classe. Le premier argument du constructeur pour un bouton (et le seul) est sa configuration.

Avant que le bouton ne soit converti en HTML et émis, le libellé, la cible et href peuvent être modifiés en utilisant les méthodes  et.

Le bouton est maintenant créé avec le texte « Still click me! » mais il n'est pas encore visible par l'utilisateur, car il doit d'abord être converti en HTML et affiché (echo) dans le document :



Ajouter des comportements JavaScript
En initialisant la propriété, vous êtes certain qu'en cliquant sur le bouton vous chargerez une nouvelle page PHP. Mais si vous souhaitez utiliser la technique d'avancement progressif pour ajouter au bouton des comportements JavaScript côté client, vous pouvez infuser l'objet côté client avec la méthode JavaScript OO.ui.infuse. Vous devez initialiser la propriété  lors de la configuration du widget :

Ensuite il faut charger le JavaScript côté client pour enrichir ce widget :



Utilisation sécurisée
Pour les types supplémentaires de sécurité, vous pouvez utiliser la méthode  du type spécifique de widget que vous souhaitez. Ce qui donne :

Ceci va produire une exception à l'exécution si PHP et JavaScript ne sont pas compatibles pour le type de widget de (depuis mai 2015 cela n'est pas encore implémenté, mais le sera à l'avenir).