OOUI/Eléments

From mediawiki.org
This page is a translated version of the page OOUI/Elements and the translation is 100% complete.

Les éléments (OO.ui.Element) sont les composants les plus basiques de la bibliothèque OOUI[1]; un élément est un objet qui représente un rendu dans le DOM[2] — cela peut être par exemple un bouton, une icône, ou tout ce qui est visible par l'utilisateur. A l'opposé des widgets, les éléments à plat n'ont habituellement aucun événement connecté et ne peuvent pas interagir.

Tout élément OOUI possède une propriété $element qui est une sélection jQuery du rendu de ses contenus. Notez que OOUI utilise le préfixe $ pour les noms de toutes les variables et les propriétés qui font référence aux sélections jQuery de éléments du DOM. La propriété $element est très utile; elle est utilisée par exemple pour créer des widgets OOUI et les attacher au DOM.

Exemple

// créer un élément objet <div></div> avec le texte "Sample Text" et la classe CSS 'sample'.
var e = new OO.ui.Element( {
	text: 'Sample Text',
	classes: [ 'sample' ]
} );

// ajouter l'élément au DOM.
$( 'body' ).append( e.$element );

Le HTML résultant a l'aspect suivant :

<body>
	<div class="sample">Sample Text</div>
</body>

Eléments

Références

  1. OOUI (Object-Oriented User Interface)
  2. DOM (Document Object Model)