| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/fr/docs/Web/API/Element/classList | [Back] [Original] |
Get to know MDN better
Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.
Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.
La proprit en lecture seule classList de l'interface Element contient une collection dynamique (DOMTokenList) reprsentant l'attribut class de l'lment. Cela peut ensuite tre utilis pour manipuler la liste des classes.
L'utilisation de classList est une alternative pratique l'accs la liste des classes d'un lment sous forme de chane de caractres dlimite par des espaces avec element.className.
Un objet DOMTokenList reprsentant le contenu de l'attribut class de l'lment. Si l'attribut class n'est pas dfini ou est vide, il retourne un DOMTokenList vide, c'est--dire un DOMTokenList avec la proprit length gale 0.
Bien que la proprit classList elle-mme soit en lecture seule dans le sens o vous ne pouvez pas remplacer l'objet DOMTokenList, vous pouvez toujours affecter directement la proprit classList, ce qui quivaut affecter sa proprit value. Vous pouvez galement modifier l'objet DOMTokenList en utilisant les mthodes add(), remove(), replace() et toggle().
const div = document.createElement("div");
div.className = "toto";
// notre point de dpart : <div class="toto"></div>
console.log(div.outerHTML);
// utiliser l'API classList pour supprimer et ajouter des classes
div.classList.remove("toto");
div.classList.add("autreClasse");
// <div class="autreClasse"></div>
console.log(div.outerHTML);
// si "visible" est dfini, le supprimer, sinon, l'ajouter
div.classList.toggle("visible");
// ajouter/supprimer "visible", en fonction d'un test conditionnel, pour i infrieur 10
div.classList.toggle("visible", i < 10);
// false
console.log(div.classList.contains("toto"));
// ajouter ou supprimer plusieurs classes
div.classList.add("toto", "tata", "truc");
div.classList.remove("toto", "tata", "truc");
// ajouter ou supprimer plusieurs classes en utilisant la syntaxe de propagation
const cls = ["toto", "tata"];
div.classList.add(...cls);
div.classList.remove(...cls);
// remplacer la classe "toto" par la classe "tata"
div.classList.replace("toto", "tata");
| Spcification |
|---|
| DOM # ref-for-dom-element-classlist |
Element.classNameDOMTokenListCette page a t modifie le 29 juil. 2026 par les contributeurices du MDN.
ElementactiveViewTransitionariaActiveDescendantElementariaAtomicariaAutoCompleteariaBrailleLabelariaBrailleRoleDescriptionariaBusyariaCheckedariaColCountariaColIndexariaColIndexTextariaColSpanariaControlsElementsariaCurrentariaDescribedByElementsariaDescriptionariaDetailsElementsariaDisabledariaErrorMessageElementsariaExpandedariaFlowToElementsariaHasPopupariaHiddenariaInvalidariaKeyShortcutsariaLabelariaLabelledByElementsariaLevelariaLiveariaModalariaMultiLineariaMultiSelectableariaOrientationariaOwnsElementsariaPlaceholderariaPosInSetariaPressedariaReadOnlyariaRelevantariaRequiredariaRoleDescriptionariaRowCountariaRowIndexariaRowIndexTextariaRowSpanariaSelectedariaSetSizeariaSortariaValueMaxariaValueMinariaValueNowariaValueTextassignedSlotattributeschildElementCountchildrenclassListclassNameclientHeightclientLeftclientTopclientWidthcurrentCSSZoomcustomElementRegistryelementTimingfirstElementChildidinnerHTMLlastElementChildlocalNamenamespaceURInextElementSiblingouterHTMLpartprefixpreviousElementSiblingrolescrollHeightscrollLeftscrollLeftMaxscrollTopscrollTopMaxscrollWidthshadowRootslottagNameafter()animate()append()ariaNotify()attachShadow()before()checkVisibility()closest()computedStyleMap()getAnimations()getAttribute()getAttributeNames()getAttributeNode()getAttributeNodeNS()getAttributeNS()getBoundingClientRect()getClientRects()getElementsByClassName()getElementsByTagName()getElementsByTagNameNS()getHTML()hasAttribute()hasAttributeNS()hasAttributes()hasPointerCapture()insertAdjacentElement()insertAdjacentHTML()insertAdjacentText()matches()moveBefore()prepend()pseudo()querySelector()querySelectorAll()releasePointerCapture()remove()removeAttribute()removeAttributeNode()removeAttributeNS()replaceChildren()replaceWith()requestFullscreen()requestPointerLock()scroll()scrollBy()scrollIntoView()scrollIntoViewIfNeeded()scrollTo()setAttribute()setAttributeNode()setAttributeNodeNS()setAttributeNS()setCapture()setHTML()setHTMLUnsafe()setPointerCapture()startViewTransition()toggleAttribute()afterscriptexecuteanimationcancelanimationendanimationiterationanimationstartauxclickbeforeinputbeforematchbeforescriptexecutebeforexrselectblurclickcompositionendcompositionstartcompositionupdatecontentvisibilityautostatechangecontextmenucopycutdblclickDOMActivateDOMMouseScrollfocusfocusinfocusoutfullscreenchangefullscreenerrorgesturechangegestureendgesturestartgotpointercaptureinputkeydownkeypresskeyuplostpointercapturemousedownmouseentermouseleavemousemovemouseoutmouseovermouseupmousewheelMozMousePixelScrollpastepointercancelpointerdownpointerenterpointerleavepointermovepointeroutpointeroverpointerrawupdatepointerupscrollscrollendscrollsnapchangescrollsnapchangingsecuritypolicyviolationtouchcanceltouchendtouchmovetouchstarttransitioncanceltransitionendtransitionruntransitionstartwebkitmouseforcechangedwebkitmouseforcedownwebkitmouseforceupwebkitmouseforcewillbeginwheelAbortControllerAbortSignalAbstractRangeAttrCDATASectionCharacterDataCommentCustomEventDOMErrorDOMExceptionDOMImplementationDOMParserDOMTokenListDocumentDocumentFragmentDocumentTypeEventEventTargetHTMLCollectionMutationObserverMutationRecordNamedNodeMapNodeNodeIteratorNodeListProcessingInstructionQuotaExceededErrorRangeShadowRootStaticRangeTextTreeWalkerXMLDocumentXPathEvaluatorXPathExpressionXPathResultXSLTProcessorCertaines parties de ce contenu sont protges par le droit d'auteur 19982026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.
| Web Proxy Viewer | New URL | Original Page |