Vos résultats de recherche

    range

    « Référence du DOM

    Introduction

    L'objet Range (gamme) représente un fragment de document qui peut contenir des nœuds et des parties de nœuds texte dans un document donné.

    Une gamme peut être crée en utilisant la méthode createRange de l'objet document. Les objets range peuvent également être récupérés en utilisant la méthode getRangeAt de l'objet selection.

    Propriétés

    collapsed
    Renvoie un booléen indiquant si le point de départ et le point final de la gamme sont confondus.
    commonAncestorContainer
    Renvoie le nœud le plus profond qui contient à la fois les nœuds startContainer et endContainer.
    endContainer
    Renvoie le nœud dans lequel la gamme se termine.
    endOffset
    Renvoie un nombre représentant l'endroit où la gamme se termine dans endContainer.
    startContainer
    Renvoie le nœud dans lequel la gamme débute.
    startOffset
    Renvoie un nombre représentant l'endroit où la gamme débute dans startContainer.

    Méthodes

    Méthodes de positionnement

    Ces méthodes permettent de définir le début et la fin d'une gamme.

    setStart
    Définit le point de départ d'une gamme.
    setEnd
    Définit le point final d'une gamme.
    setStartBefore
    Définit le point de départ d'une gamme relativement à un autre nœud.
    setStartAfter
    Définit le point de départ d'une gamme relativement à un autre nœud.
    setEndBefore
    Définit le point final d'une gamme relativement à un autre nœud.
    setEndAfter
    Définit le point final d'une gamme relativement à un autre nœud.
    selectNode
    Le contenu de la gamme devient le nœud et son contenu.
    selectNodeContents
    le contenu de la gamme devient le contenu du nœud.
    collapse
    Replie la gamme sur l'un de ses points frontières.

    Méthodes de modification

    Ces méthodes recupèrent les nœuds d'une gamme et modifient le contenu d'une gamme.

    cloneContents
    Renvoie un fragment de document où sont copiés les nœuds d'une gamme.
    deleteContents
    Supprime du document le contenu d'une gamme.
    extractContents
    Déplace le contenu d'une gamme, de l'arbre du document vers un fragment de document.
    insertNode
    Insère un nœud au début d'une gamme.
    surroundContents
    Déplace le contenu d'une gamme dans un nouveau nœud.

    Autres méthodes

    compareBoundaryPoints
    Compare les points frontières de deux gammes.
    cloneRange
    Renvoie un objet Range avec des points frontières identiques à ceux de la gamme clonée.
    detach
    Supprime la gamme afin d'améliorer la performance.
    toString
    Renvoie le texte de la gamme.

    Les méthodes Gecko

    Cette section décrit les méthodes de range qui sont particulières à Mozilla et ne font pas partie des spécifications DOM W3C.

    compareNode
    Renvoie une constante qui indique si le nœud est avant, après, dans ou englobe la gamme.
    comparePoint
    Renvoie -1, 0, ou 1, indiquant si le point se trouve avant, après, ou dans la gamme.
    createContextualFragment
    Renvoie un fragment de document créé à partir d'un morceau de code donné.
    intersectsNode
    Renvoie un booléen indiquant si un nœud donné a une intersection avec la gamme.
    isPointInRange
    Renvoie un booléen indiquant si le point donné est dans la gamme.

    Liens Interwikis


    Étiquettes et contributeurs liés au document

    Étiquettes :
    Contributeurs ayant participé à cette page : VincentN, Learning, Fredchat, BenoitL, Mgjbot
    Dernière mise à jour par : Mgjbot,