Element (class)

L'objet Element permet l'accès à des méthodes que l'on peut qualifier encore une fois de 'raccourci' (ndr : exception faite de méthodes comme 'Element.toggle()' par exemple).
Ces méthodes accélèrent l'écriture code et permettre de rendre un code lisible qui n'utilise pas l'ensemble des accès DOM pour faire le traitement ce qui est le cas si l'on code Javascript sans Prototype.js (ndr : en quelquesorte, merci Proto ;-) )

Le tableau présenté ci après reprend les méthodes attachés à Element afin d'en donner un aperçu global et la structure d'utilisation :

Méthode	Type	Arguments	Détails
addClassName (element,className)	instance	element : objet DOM ou id DOM className : nom de la class CSS à ajouter	Permet d'ajouter une classe CSS à un champ précisé.
classNames (element)	instance	element : objet DOM ou id DOM	Retourne une variable Element.ClassNames (ndr : objet), qui contient les classes CSS associées au champ précisé.
cleanWhitespace (element)	instance	element : objet DOM ou id DOM	Permet de retirer tous les espaces blancs de la node texte de l'élément précisé.
empty (element)	instance	element : objet DOM ou id DOM	Retourne un Boolean (ndr : valeur booléenne) qui détermine si le champ est vide (ndr : ou ne contient que des espace blancs).
getDimensions (element)	instance	element : objet DOM ou id DOM	Retourne les dimensions d'un élément précisé. La variable retournée est un objet à deux propriétés, 'width' et 'height'.
getHeight (element)	instance	element : objet DOM ou id DOM	Retourne la valeur de l'attribut CSS 'offsetHeight' de l'élément précisé.
getStyle (element, cssProperty)	instance	element : objet DOM ou id DOM cssProperty : nom d'une propriété CSS (ndr : 'width', 'position', etc...)	Retourne la valeur de la propriété CSS précisée pour l'élément précisé.
hasClassName (element,className)	instance	element : objet DOM ou id DOM className : nom de classe CSS à vérifier	La méthode retourne 'true' si le nom de classe précisé est bien associé à l'élément précisé.
hide (elem_0, [ elem_1 ], [ elem_2] , ...)	instance	elem : nom de ou des élément(s) à cacher	Permet de cacher le ou les élément(s) précisé(s) en valorisant à '' la propriété CSS display de l'élément précisé.
makeClipping (element)	instance	element : objet DOM ou id DOM	Permet de valoriser la propriété CSS 'overflow' de l'élément précisé à 'hidden'.
makePositionned (element)	instance	element : objet DOM ou id DOM	Permet de valoriser la propriété CSS 'position' de l'élément précisé à 'relative'.
remove (element)	instance	element : objet DOM ou id DOM	Permet de supprimer définitivement un élément précisé de la page ou document en cours.
removeClassName (element,className)	instance	element : objet DOM ou id DOM className : nom d'une classe CSS à retirer	Permet de supprimer une classe CSS précisée de la liste des classes CSS associées d'un élément précisé.
scrollTo (element)	instance	element : objet DOM ou id DOM	Permet de faire "scroller" la page vers un élément précisé.
setStyle (element,cssPropertyHash)	element : objet DOM ou id DOM cssPropertyHash : objet Hash avec les styles à appliquer.	Permet d'appliquer des styles CSS synthétisés au sein d'un objet Hash, sur un élément précisé.
show (elem_0 , [ elem_1 ] , [ elem_2 ] , ...)	instance	elem : objet(s) DOM ou id(s) DOM	Permet de valoriser la propriété CSS 'display' de ou des élément(s) précisé(s) à ''. Cela a pour effet de rendre le ou les élément(s) visible(s).
toggle (elem_0 , [ elem_1 ] , [ elem_2 ] , ... )	instance	elem : objet(s) DOM ou id(s) DOM	Méthode permettant de cacher ou montrer un ou des élément(s) précisé(s). Si l'élément est caché alors il devient visible. Inversement si l'élément est visible, il devient caché.
undoClipping (element)	instance	element : objet DOM ou id DOM	(ndr : à mettre à jour, 04/01/2007)
undoPositioned (element)	instance	element : objet DOM ou id DOM	(ndr : à mettre à jour, 04/01/2007)
update (element, html)	instance	element : objet DOM ou id DOM	Cette méthode permet de remplacer le 'innerHTML' d'un élement précisé avec la valeur html transmise. Il est important de noter que si du code Javascript est trouvé dans la chaîne HTML transmise, celui ci sera exécuté et ne sera pas recopié en tant que chaîne de caractères dans la zone.
visible (element)	instance	element : objet DOM ou id DOM	Retourne une valeur booléenne (ndr :de type Boolean), qui selon la valeur de la propriété CSS 'display' de l'élément précisé vaut 'true' (ndr : 'inline','block', etc.. renverront 'true') ou 'false' (ndr : 'none').

: 03/01/2007 23:25:31 | : Element, javascriptClass, DOM, manipulation, prototype.js, prototype, javascript, xhtml, xml, css, styles,

Aucun commentaire enregistré