Text, TextNode | NN 6 IE 5 DOM 1 | |||||||
Un objet Text est fréquemment appelé par ce manuel un « noeud de texte ». Microsoft appelle cet objet un objet TextNode. Cet objet représente l´objet enfant contenant les caractères entre les balises de début et de fin d´un élément. L´objet Text existe dans le modèle du DOM W3C DOM abstrait gr ce à une chaîne d´héritage entre lui et l´objet Node fondamental (de Node à CharacterData à Text). L´héritage de l´objet Node dote automatiquement l´objet Text d´une longue liste de propriétés et méthodes décrites parmi les éléments partagés au début de ce chapitre (les propriétés comprennent: attributes, childNodes, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling; les méthodes sont: appendChild(), cloneNode(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeChild(), replaceChild()). Le long de cette chaîne d´héritage, l´objet Text gagne des propriétés et méthodes supplémentaires (décrites ci-dessous) qui permettent de manipuler le contenu du noeud dans le cadre des concepts imposés par le modèle DOM W3C officiel. Comme le DOM est indépendant du langage de création de scripts, vous trouvez des propriétés et des méthodes qui peuvent être manipulées plus facilement ou plus efficacement par le traitement des chaînes JavaScript (reportez-vous au chapitre 12). N´hésitez pas à utiliser ces techniques dans un environnement JavaScript côté client du navigateur. |
||||||||
Les scripts ne font référence au noeud Text (ou à l´objet TextNode IE) que par le biais de références qui repèrent le noeud dans l´arborescence de documents (comme le premier enfant d´un noeud élément particulier) ou tel qu´il est renvoyé par la méthode document.createTextNode(). |
||||||||
Référence de modèle d'objet | ||||||||
elementReference.childReference textNodeReference.siblingReference |
||||||||
Propriétés spécifiques à l´objet | ||||||||
|
||||||||
Méthodes spécifiques à l´objet | ||||||||
|
||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||
Aucune. |
data | NN 6 IE 5 DOM 1 |
Lecture/écriture | |
Contient la chaîne de caractères dans le noeud de texte. Cette valeur est la même que celle de la propriété nodeValue et il n´y a pas de raison de préférer une propriété à l´autre, sauf peut-être pour les préférences syntaxiques de langue simple pour la lecture du code. |
|
Exemple | |
document.getElementById("myP").firstSibling.data = "Some new text."; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Une chaîne vide. |
length | NN 6 IE 5 DOM 1 |
Lecture seule | |
Fournit un nombre de caractères dans le noeud de texte. |
|
Exemple | |
var howMany = document.getElementById("myP").firstSibling.length; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
0 |
appendData() | NN 6 IE 5(Mac)/6(Win) DOM 1 |
appendData("newText") | |
Ajoute des caractères (transmis comme paramètre sous forme de chaîne) à la fin du noeud de texte courant. Le contenu est composé de caractères bruts, donc si vous voulez ajouter une phrase à un noeud de texte, ce sont vos scripts qui doivent se charger de l´espacement dans les phrases. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
deleteData() | NN 6 IE 5(Mac)/6(Win) DOM 1 |
deleteData(startOffset, count) | |
Supprime des caractères du noeud de texte actuel en commençant par le caractère à la position (base zéro) indiquée par startOffset et pour une longueur de count caractères dans la direction du texte normal dans la langue actuelle. Si la longueur spécifiée pour la suppression est supérieure à la longueur des données, tous les caractères jusqu´à la fin du noeud de texte sont supprimés, sans qu´une exception soit générée. Remarque: Netscape 6 inclut l´espace blanc du code source pour son comptage des deux paramètres. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
insertData() | NN 6 IE 5(Mac)/6(Win) DOM 1 |
insertData(startOffset, "newText") | |
Insère le texte à une position de caractère à base zéro dans le noeud de texte. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
replaceData() | NN 6 IE 5(Mac)/6(Win) DOM 1 |
replaceData(startOffset, count, "newText") | |
Remplace le texte dans le noeud de texte courant avec le nouveau texte. Le contenu original à supprimer est indiqué par la position de début à base zéro et le nombre de caractères. La chaîne transmise comme troisième paramètre est placée dans l´espace libéré par le texte supprimé. Un bogue dans IE 5 pour Mac coupe le nouveau texte à la même longueur que le texte supprimé. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Aucune. |
splitText() | NN 6 IE 5(Mac)/6(Win) DOM 1 |
splitText(offset) | |
Divise le noeud de texte courant en deux noeuds de texte frères; sinon, il ne touche pas au texte. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Référence au deuxième noeud de texte. |
substringData() | NN 6 IE 5(Mac)/6(Win) DOM 1 |
substringData(startOffset, count) | |
Renvoie une copie du segment indiqué du contenu du noeud de texte. La section à copier est indiquée par la position de début à base zéro et le nombre de caractères. |
|
Paramètres | |
|
|
Valeur renvoyée | |
Chaîne. |
accessKey | NN s.o. IE 4 DOM 1 |
Lecture/écriture | |
Une seule touche de caractère qui active un élément (dans certains navigateurs) ou active un contrôle de formulaire ou une action de lien. Le navigateur et le système d'exploitation déterminent si l'utilisateur doit appuyer sur une touche de modification (par exemple Ctrl, Alt ou Commande) en même temps que sur la touche d'accès pour activer le lien. Dans IE 5 pour Windows et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Alt et celle-ci est insensible à la casse. Dans IE 5 pour Macintosh et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Ctrl. |
|
Bien que répertorié ici comme attribut largement partagé, ce n'est pas toujours le cas dans toutes les implémentations. Netscape 6 (par le biais du DOM W3C) reconnaît cette propriété pour les éléments suivants uniquement: a , area , button , input , label , legend et textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , object , select , span , table et td (mais supprime label et legend ). IE 5 ajoute tout autre élément affichable, mais attention: à l'exception de l'élément input et d'autres éléments ayant trait aux formulaires, vous devez aussi affecter un attribut tabindex ou une propriété tabIndex à l'élément dans IE 5 et versions ultérieures (même s'il ne s'agit que d'une valeur de zéro pour tous) pour permettre à la combinaison de touches d'accélération d'activer l'élément. A partir de Netscape 7, Netscape ne modifie pas le comportement de l'interface utilisateur si un script modifie la valeur de la propriété. |
|
Exemple | |
document.links[3].accessKey = "n"; |
|
Valeur | |
Caractère unique du clavier alphanumérique (y compris les signes de ponctuation). |
|
Par défaut | |
Une chaîne vide. |
focus() | NN 2 IE 3 DOM 1 |
Donne l´activation à partir de l´objet courant, moment auquel l´événement onfocus de l´objet se déclenche. Remarque: La plage d´éléments capables d´activation et de fondu (l´événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l´attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode focus() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . |
|
Pour activer une zone de texte et présélectionner tout le texte de la zone, utilisez la séquence des méthodes focus() et select() sur l´élément. Si cette séquence doit se produire après un changement de fenêtre (par exemple, après la fermeture d´une boîte de dialogue d´alerte), placez les méthodes dans une fonction indépendante et invoquez cette méthode par le biais de la méthode setTimeout() après la méthode alert() de la boîte de dialogue. Cela permet à IE pour Windows d´exécuter les instructions dans l´ordre correct. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Aucune. |
disabled | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Détermine si l'élément est disponible pour une action interactive de l'utilisateur. S´il est défini sur la valeur true , l'utilisateur ne peut pas activer ni modifier cet élément, qui apparaît généralement en grisé sur cette page. Cette propriété est disponible pour tous les objets éléments dans IE 5.5 pour Windows et versions ultérieures. Pour IE 4 et IE 5, elle ne s´applique qu´aux contrôles de formulaire, alors que Netscape 6 et versions ultérieures reconnaissent cette propriété pour les contrôles de formulaire et l´objet élément style . La paire désactivée nom / valeur d´un contrôle de formulaire n´est pas transmise avec le formulaire. |
|
Exemple | |
document.getElementById("myButton").disabled = true; |
|
Valeur | |
Valeur booléenne: true | false . |
|
Par défaut | |
false |
recordNumber | NN s.o. IE 4 DOM s.o. |
Lecture seule | |
Utilisée avec la fonction de liaison de données IE, renvoie un nombre entier représentant l'enregistrement dans le jeu de données ayant généré l'élément (par exemple un élément dont le contenu provient d'une liaison de données). Vous pouvez utiliser les valeurs de cette propriété pour extraire un enregistrement donné d'un ensemble d'enregistrements Active Data Objects (ADO) (voir la propriété recordset ). Bien que cette propriété soit définie pour tous les objets éléments de Microsoft Internet Explorer, les autres propriétés associées à la liaison de données appartiennent à un sous-ensemble d´éléments. |
|
Exemple | |
<script for="tableTemplate" event="onclick"> myDataCollection.recordset.absoluteposition = this.recordNumber; ... </script> |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
null |
tabIndex | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Nombre indiquant la position de cet élément dans l'ordre de tabulation des éléments pouvant être activés dans le document. L'ordre de tabulation suit un ensemble de règles très strictes. Les éléments dont les valeurs affectées aux propriétés tabIndex diffèrent de zéro sont les premiers activés lorsqu'un utilisateur commence à tabuler dans une page. Le premier élément activé est celui dont l'attribut tabIndex a la valeur la plus faible, et ainsi de suite, dans l'ordre croissant, quel que soit l'emplacement physique des éléments sur la page ou dans le document. Si deux éléments ont un attribut tabIndex de valeur identique, c'est celui qui apparaît le premier dans le document qui est activé d'abord. Viennent ensuite les éléments qui ne prennent pas en charge la propriété tabIndex ou dont la valeur est zéro. Ces éléments sont activés dans l'ordre où ils apparaissent dans le document. |
|
Le DOM W3C et Netscape 6 limitent la propriété tabIndex aux objets éléments suivants: a , area , button , input , object , select , textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , span , table , et td . IE 5 ajoute tout autre élément affichable. Une valeur négative dans IE (uniquement) supprime un élément de la séquence de tabulation. |
|
Les liens et les ancres ne sont pas activables à l'aide de la touche de tabulation dans la version Macintosh de Microsoft Internet Explorer 4 et la propriété tabIndex des objets éléments a est donc ignorée dans cette version. |
|
Exemple | |
document.getElementById("link3").tabIndex = 6; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
0 |
blur() | NN 2 IE 3 DOM 1 |
Supprime l´activation de l´objet courant, moment auquel l´événement onblur de l´objet se déclenche. Remarque: La plage d´éléments capables d´activation et de fondu (l´événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l´attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode blur() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . L´affectation de l´attribut onfocus="this.blur();" à un élément input texte, par exemple, est une façon grossière mais efficace en matière de compatibilité ascendante de désactiver un champ pour les navigateurs ne fournissant pas de véritable désactivation d´éléments. |
|
Utilisez les méthodes blur() et focus() avec modération sur la même page. Vous pouvez déclencher des boucles d´activation et de fondu infinies par accident si des boîtes de dialogue d´alerte sont impliquées à un moment ou à un autre. De plus, sachez que lorsque vous invoquez la méthode blur() sur un objet, un autre objet (peut-être l´objet window ) reçoit un événement onfocus . |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Aucune. |