D Le modèle objet de document de MathML

Les sections suivantes décrivent les interfaces définies pou le modèle objet de document de MathML. Cf. le chapitre 8 Le modèle objet de document de MathML pour plus d'informations.

Les liaisons IDL, Java et ECMAScript se trouvent dans l'Annexe E [Les liaisons du modèle objet de document de MathML].

D.1 Les interfaces IDL

D.1.1 Les définitions d'objets diverses

L'interface MathMLDOMImplementation

Étend : DOMImplementation

Cette interface étend l'interface DOMImplementation en ajoutant une méthode pour créer un objet MathMLDocument.

Définition IDL

interface MathMLDOMImplementation: DOMImplementation {
  MathMLDocument createMathMLDocument();
};

Méthodes

createMathMLDocument

Crée un objet MathMLDocument dont l'arbre minimal ne contient qu'un objet MathMLMathElement correspondant à l'élément math de MathML. L'objet MathMLMathElement est vide, sans sous-éléments ni attributs avec d'autres valeurs que celles par défaut ; c'est l'élément racine du document et on y accède via l'attribut documentElement de l'objet MathMLDocument. Remarquez que l'objet MathMLDocument ne devrait être créé que pour un document MathML autonome.

Valeur retournée

MathMLDocument

L'objet MathMLDocument créé.

Cette méthode ne produit aucune exception.

L'interface MathMLDocument

Étend : Document

Cette interface étend l'interface Document pour ajouter un accès aux propriétés du document concernant la navigation. L'attribut documentElement d'un objet MathMLDocument devrait être l'objet MathMLMathElement représentant l'élément de premier niveau math qui est la racine du document.

Définition IDL

interface MathMLDocument: Document {
  readonly attribute DOMString referrer;
  readonly attribute DOMString domain;
  readonly attribute DOMString URI;
};

Attributs

referrer de type DOMString, en lecture seule

L'adresse URI de la page menant à ce document, si disponible. Sa valeur est null si l'utilisateur s'est rendu directement à la page. Si ce n'est pas un document MathML autonome (par exemple, parce qu'il est incorporé dans un document XHTML), on peut la récupérer à partir de l'objet Document du parent, si disponible.

domain de type DOMString, en lecture seule

Le nom de domaine du serveur ayant servi le document, ou la valeur null si on ne peut pas identifier le serveur par son nom de domaine ou s'il n'est pas disponible. Si ce n'est pas un document MathML autonome (par exemple, parce qu'il est incorporé dans un document XHTML), on peut la récupérer à partir de l'objet Document du parent, si disponible.

URI de type DOMString, en lecture seule

L'adresse URI complète de ce document. Sa valeur est null s'il ne s'agit pas d'un document MathML autonome.

L'interface MathMLNodeList

Étend : NodeList

Cette interface est fournie comme une spécialisation de l'interface NodeList. Les objets-enfants Node de NodeList doivent être des objets MathMLElement ou des nœuds Text.

Remarquez que les objets MathMLNodeList sont fréquemment employés dans le DOM comme valeurs d'attributs en lecture seule, en encapsulant, par exemple, divers ensembles de sous-éléments. Lorsqu'ils sont utilisés de cette façon, ces objets sont toujours compris comme étant dynamiques, au sens où les changements apportés au document s'y reflètent immédiatement.

Définition IDL

interface MathMLNodeList: NodeList {
};

D.1.2 Les éléments MathML génériques

L'interface MathMLElement

Étend : Element

Toutes les interfaces des éléments MathML dérivent de cet objet, lequel dérive de l'interface Element du DOM de base.

Définition IDL

interface MathMLElement: Element {
  attribute DOMString className;
  attribute DOMString mathElementStyle;
  attribute DOMString id;
  attribute DOMString xref;
  attribute DOMString href;
  readonly attribute MathMLMathElement ownerMathElement;
};

Attributs

className de type DOMString

L'attribut class de l'élément. Cf. la discussion sur l'attribut class ailleurs dans ce document, et également sa définition HTML.

mathElementStyle de type DOMString

Une chaîne identifiant l'attribut style de l'élément.

id de type DOMString

L'identificateur de l'élément. Cf. la discussion sur l'attribut id ailleurs dans ce document, et également sa définition HTML.

xref de type DOMString

L'attribut xref de l'élément. Cf. la discussion sur l'attribut xref ailleurs dans ce document.

href de type DOMString

L'attribut xlink:href de l'élément. Cf. la discussion sur l'attribut xlink:href ailleurs dans ce document ; cf. également la définition de cet attribut dans la spécification XLink.

ownerMathElement de type MathMLMathElement, en lecture seule

L'objet MathMLMathElement correspondant à l'élément math ancêtre le plus proche de cet élément. Sa valeur devrait être null si c'est un élément de premier niveau math.

L'interface MathMLContainer

C'est une interface abstraite dont les fonctionnalités sont nécessaires aux éléments MathML pouvant contenir arbitrairement beaucoup de sous-éléments. Aucun élément n'est directement pris en charge par cette interface ; toutes les instances sont des instances d'objet MathMLPresentationContainer, ou bien MathMLContentContainer, ou bien MathMLMathElement.

Définition IDL

interface MathMLContainer {
  readonly attribute unsigned long nArguments;
  readonly attribute MathMLNodeList arguments;
  readonly attribute MathMLNodeList declarations;
  MathMLElement getArgument(in unsigned long index);
  MathMLElement setArgument(in MathMLElement newArgument, in unsigned long index);
  MathMLElement insertArgument(in MathMLElement newArgument, in unsigned long index);
  void deleteArgument(in unsigned long index);
  MathMLElement removeArgument(in unsigned long index);
  MathMLDeclareElement getDeclaration(in unsigned long index);
  MathMLDeclareElement setDeclaration(in MathMLDeclareElement newDeclaration, in unsigned long index);
  MathMLDeclareElement insertDeclaration(in MathMLDeclareElement newDeclaration, in unsigned long index);
  MathMLDeclareElement removeDeclaration(in unsigned long index);
  void deleteDeclaration(in unsigned long index);
};

Attributs

nArguments de type unsigned long, en lecture seule

Le nombre de sous-éléments de cet élément dont ils représentent les arguments, à opposer aux éléments qualificatifs ou aux éléments declare. Un objet MathMLContentContainer ne contient donc pas d'éléments représentant des variables liées, des conditions, des séparateurs, des degrés ou des limites supérieures et inférieures (bvar, condition, sep, degree, lowlimit ou uplimit).

arguments de type MathMLNodeList, en lecture seule

Cet attribut accède aux objets-enfants MathMLElement de cet élément dont ce sont les arguments, en tant qu'objet MathMLNodeList. Remarquez que cette liste ne contient aucun objet MathMLElement représentant un élément qualificatif ou un élément declare.

declarations de type MathMLNodeList, en lecture seule

Fournit un accès aux éléments declare, qui sont les sous-éléments de cet élément, dans un objet MathMLNodeList. Tous les objets Node dans cette liste doivent être des objets MathMLDeclareElement.

Méthodes

getArgument

Cette méthode retourne l'argument enfant indexé de cet élément. Il diffère souvent de celui obtenu par Node::childNodes().item(index), puisque les éléments qualificatifs et declare ne sont pas comptés.

Paramètres

unsigned long

index

L'index commençant à un de l'argument à récupérer.

Valeur retournée

MathMLElement

Un objet MathMLElement représentant l'argument de cet élément dont c'est la valeur d'index.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de sous-éléments.

setArgument

Cette méthode fixe le paramètre newArgument comme argument indexé de cet élément. S'il existe déjà un argument avec cet index, l'objet newArgument le remplace. Il diffère souvent du nœud fixé par Node::childNodes().item(index), puisque les éléments qualificatifs et declare ne sont pas comptés.

Paramètres

MathMLElement	newArgument	Un objet MathMLElement représentant l'élément à fixer comme argument indexé de cet élément.
unsigned long	index	L'index de l'argument à attribuer à l'objet newArgument. Le premier argument est numéroté 1. Si la valeur du paramètre index est supérieure d'une unité au nombre actuel d'arguments, un nouvel argument est ajouté à la fin.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouvel argument dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si cet élément n'admet pas de sous-élément du type de l'objet newArgument, ou si c'est un objet MathMLContentContainer et que l'objet newArgument représente un élément qualificatif, ou si l'objet newElement est un objet MathMLDeclareElement.

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure de plus d'une unité au nombre de sous-éléments.

insertArgument

Cette méthode insère l'objet newArgument avant l'argument indexé courant de cet élément. Si la valeur de l'attribut index est 0, ou supérieure d'une unité au nombre courant d'arguments, l'objet newArgument est ajouté comme dernier argument. Il diffère souvent du nœud fixé par Node::childNodes().item(index), puisque les éléments qualificatifs et declare ne sont pas comptés.

Paramètres

MathMLElement	newArgument	Un objet MathMLElement représentant le sous-élément à insérer comme argument de cet élément.
unsigned long	index	L'index commençant à un de la position avant laquelle doit s'insérer l'objet newArgument. Le premier argument est numéroté 1.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouvel argument dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si cet élément n'admet pas d'argument enfant du type de l'objet newArgument, ou pour les objets MathMLContentContainer, si l'objet newArgument représente un élément qualificatif.

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure de plus d'une unité au nombre d'arguments enfants.

deleteArgument

Cette méthode supprime l'argument enfant indexé de cet élément. Remarquez que les sous-éléments qualificatifs ou declare n'interviennent pas dans le compte qui détermine l'index de l'argument.

Paramètres

unsigned long

index

L'index commençant à un de l'argument à supprimer.

Valeur retournée

void

Aucune.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de sous-éléments.

removeArgument

Cette méthode supprime l'argument enfant indexé de cet élément et le retourne à l'appelant. Remarquez que les sous-éléments qualificatifs ou declare n'interviennent pas dans le compte qui détermine l'index de l'argument.

Paramètres

unsigned long

index

L'index commençant à un de l'argument à supprimer.

Valeur retournée

MathMLElement

Un objet MathMLElement représentant l'argument supprimé.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de sous-éléments.

getDeclaration

Cette méthode récupère le sous-élément declare indexé de cet élément.

Paramètres

unsigned long

index

L'index commençant à un dans la liste des sous-éléments declare de cet élément, donnant la position de l'élément declare à récupérer.

Valeur retournée

MathMLDeclareElement

L'objet MathMLDeclareElement représentant le sous-élément declare ayant cet index.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de sous-éléments declare.

setDeclaration

Cette méthode insère un objet newDeclaration comme sous-élément declare avec cet index de cet élément. S'il existe déjà un sous-élément declare dont c'est l'index, l'objet newDeclaration le remplace.

Paramètres

MathMLDeclareElement	newDeclaration	L'objet MathMLDeclareElement à insérer comme sous-élément declare avec cet index.
unsigned long	index	L'index commençant à un dans la liste des sous-éléments declare de cet élément, donnant la position où l'objet newDeclaration doit s'insérer. Si la valeur du paramètre index est supérieure d'une unité au nombre de sous-éléments declare de cet élément, l'objet newDeclaration se place en dernier sous-élément declare.

Valeur retournée

MathMLDeclareElement

L'objet MathMLDeclareElement inséré.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure d'une unité au nombre de sous-éléments declare.

HIERARCHY_REQUEST_ERR : Produite si cet élément n'admet pas de sous-éléments declare.

insertDeclaration

Cette méthode insère un objet newDeclaration avant le sous-élément declare indexé de cet élément. Si la valeur du paramètre index est 0, l'objet newDeclaration se place en dernier sous-élément declare.

Paramètres

MathMLDeclareElement	newDeclaration	L'objet MathMLDeclareElement à insérer comme sous-élément declare avec cet index.
unsigned long	index	L'index commençant à un dans la liste des sous-éléments declare de cet élément, donnant la position où l'objet newDeclaration doit s'insérer. Si la valeur du paramètre index est 0, ou supérieure d'une unité au nombre des sous-éléments declare, l'objet newDeclaration se place en dernier sous-élément declare.

Valeur retournée

MathMLDeclareElement

L'objet MathMLDeclareElement enfant de cet élément représentant newDeclaration dans le DOM.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure de plus d'une unité au nombre de sous-éléments declare.

HIERARCHY_REQUEST_ERR : Produite si cet élément n'admet pas de sous-élément declare.

removeDeclaration

Cette méthode supprime l'objet MathMLDeclareElement représentant le sous-élément declare indexé de cet élément et le retourne à l'appelant. Remarquez que la valeur du paramètre index correspond à la position dans la liste des sous-éléments declare, à opposer à la position dans la liste de tous les objets Node des sous-éléments.

Paramètres

unsigned long

index

L'index commençant à un de l'élément declare à supprimer.

Valeur retournée

MathMLDeclareElement

L'objet MathMLDeclareElement supprimé comme objet Node enfant de cet élément.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de sous-éléments declare.

deleteDeclaration

Cette méthode supprime l'objet MathMLDeclareElement représentant le sous-élément declare indexé de cet élément. Remarquez que la valeur du paramètre index correspond à la position dans la liste des sous-éléments declare, à opposer à la position dans la liste de tous les objets Node des sous-éléments.

Paramètres

unsigned long

index

L'index commençant à un de l'élément declare à supprimer.

Valeur retournée

void

Aucune.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de sous-éléments declare.

L'interface MathMLMathElement

Étend : MathMLElement, MathMLContainer

Cette interface représente l'élément de premier niveau math de MathML.

Elle peut se révéler utile pour interfacer les objets du modèle objet de document codant un document englobant et les éléments du DOM de MathML qui en sont les sous-éléments. On pourrait aussi s'en servir dans quelques cas en remplacement du DOM de MathML pour un objet Document. Par exemple, on pourrait y placer des méthodes de classes d'objets spécifiques de MathML, telles que des méthodes permettant de créer des objets Iterator ou TreeWalker spécifiques de MathML. Toutefois, cette fonctionnalité n'est pas encore définie.

Définition IDL

interface MathMLMathElement: MathMLElement, MathMLContainer {
  attribute DOMString macros;
  attribute DOMString display;
};

Attributs

macros de type DOMString

Représente l'attribut macros de l'élément math. Cf. la section 7.1.2 L'élément de premier niveau math.

display de type DOMString

Représente l'attribut display de l'élément math. Cette valeur est soit "block", soit "inline". Cf. la section 7.1.2 L'élément de premier niveau math.

L'interface MathMLSemanticsElement

Étend : MathMLElement

Cette interface repésente l'élément semantics dans MathML.

Définition IDL

interface MathMLSemanticsElement: MathMLElement {
  attribute MathMLElement body;
  readonly attribute unsigned long nAnnotations;
  MathMLElement getAnnotation(in unsigned long index);
  MathMLElement insertAnnotation(in MathMLElement newAnnotation, in unsigned long index);
  MathMLElement setAnnotation(in MathMLElement newAnnotation, in unsigned long index);
  void deleteAnnotation(in unsigned long index);
  MathMLElement removeAnnotation(in unsigned long index);
};

Attributs

body de type MathMLElement

Cet attribut représente le premier sous-élément de semantics, c.à.d. le sous-élément fournissant le contenu principal représenté par l'élément.

nAnnotations de type unsigned long, en lecture seule

Représente le nombre de sous-éléments annotation ou annotation-xml de l'élément semantics, c.à.d. le nombre de formes de contenu de remplacement de cet élément.

Méthodes

getAnnotation

Cette méthode donne accès à un contenu remplaçant indexé, associé à un élément semantics.

Paramètres

unsigned long

index

L'index commençant à un de l'annotation récupérée.

Valeur retournée

MathMLElement

Les objets MathMLAnnotationElement ou MathMLXMLAnnotationElement représentant le sous-élément annotation (ou annotation-xml) indexé de l'élément semantics. Remarquez que tous les sous-éléments d'un élément semantics, sauf le premier, doivent obligatoirement être de l'un de ces types.

Cette méthode ne produit aucune exception.

insertAnnotation

Cette méthode insère un objet newAnnotation avant le contenu remplaçant indexé courant, associé à un élément semantics. Si la valeur du paramètre index est 0, l'objet newAnnotation se place en dernier sous-élément annotation (ou annotation-xml) de cet élément.

Paramètres

MathMLElement	newAnnotation	Un objet MathMLAnnotationElement (ou MathMLXMLAnnotationElement) représentant le nouvel élément annotation (ou annotation-xml) à insérer.
unsigned long	index	La position dans la liste des sous-éléments annotation (ou annotation-xml) avant laquelle doit s'insérer l'objet newAnnotation. La première annotation est numérotée 1.

Valeur retournée

MathMLElement

L'objet MathMLAnnotationElement (ou MathMLXMLAnnotationElement) enfant de cet élément représentant la nouvelle annotation dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newAnnotation n'est pas un objet MathMLAnnotationElement ou MathMLXMLAnnotationElement.

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre courant de sous-éléments annotation ou annotation-xml de cet élément semantics.

setAnnotation

Cette méthode permet de fixer ou de remplacer le contenu remplaçant ayant cet index, associé à un élément semantics. S'il existe déjà un élément annotation (ou annotation-xml) avec cet index, l'objet newAnnotation le remplace.

Paramètres

MathMLElement	newAnnotation	Un objet MathMLAnnotationElement (ou MathMLXMLAnnotationElement) représentant la nouvelle valeur du sous-élément annotation (ou annotation-xml) indexé de cet élément semantics.
unsigned long	index	La position dans la listes des sous-éléments annotation ou annotation-xml de cet élément semantics où doit se placer l'objet newAnnotation. Le premier élément d'annotation est numéroté 1.

Valeur retournée

MathMLElement

L'objet MathMLAnnotationElement (ou MathMLXMLAnnotationElement) enfant de cet élément représentant la nouvelle annotation dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newAnnotation n'est pas un objet MathMLAnnotationElement ou MathMLXMLAnnotationElement.

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure de plus d'une unité au nombre de sous-éléments annotation ou annotation-xml de cet élément semantics.

deleteAnnotation

Une méthode pratique pour supprimer le contenu remplaçant indexé, associé à cet élément semantics.

Paramètres

unsigned long

index

L'index commençant à un de l'annotation à supprimer.

Valeur retournée

void

Aucune.

Cette méthode ne produit aucune exception.

removeAnnotation

Une méthode pratique pour supprimer le contenu remplaçant indexé, associé à cet élément semantics, et pour le retourner à l'appelant.

Paramètres

unsigned long

index

L'index commençant à un de l'annotation à supprimer.

Valeur retournée

MathMLElement

L'objet MathMLAnnotationElement (ou MathMLXMLAnnotationElement) supprimé.

Cette méthode ne produit aucune exception.

L'interface MathMLAnnotationElement

Étend : MathMLElement

Cette interface représente l'élément annotation de MathML.

Définition IDL

interface MathMLAnnotationElement: MathMLElement {
  attribute DOMString body;
  attribute DOMString encoding;
};

Attributs

body de type DOMString

Fournit un accès au contenu d'un élément annotation.

encoding de type DOMString

Fournit un accès à l'attribut encoding d'un élément annotation.

L'interface MathMLXMLAnnotationElement

Étend : MathMLElement

Cette interface représente l'élément annotation-xml de MathML.

Définition IDL

interface MathMLXMLAnnotationElement: MathMLElement {
  attribute DOMString encoding;
};

Attributs

encoding de type DOMString

Fournit un accès à l'attribut encoding d'un élément xml-annotation.

D.1.3 Les éléments de présentation

L'interface MathMLPresentationElement

Étend : MathMLElement

Cette interface est fournie pour servir de base aux diverses interfaces de présentation de MathML. Elle ne contient pas d'attributs nouveaux ni de méthodes nouvelles pour l'instant ; néanmoins, il est pressenti que la distinction entre les entités de présentation et de contenu MathML devrait apparaître dans la hiérarchie MathMLElement. En particulier, les versions futures du DOM de MathML pourront ajouter des fonctionnalités à cette interface ; elle peut aussi aider les développeurs.

Définition IDL

interface MathMLPresentationElement: MathMLElement {
};

D.1.3.1 Les interfaces des éléments de présentation terminaux

L'interface MathMLGlyphElement

Étend : MathMLPresentationElement

Cette interface gère l'élément mglyph (cf. la section 3.2.9 L'ajout de nouveaux glyphes de caractères à MathML (mglyph)).

Définition IDL

interface MathMLGlyphElement: MathMLPresentationElement {
  attribute DOMString alt;
  attribute DOMString fontfamily;
  attribute unsigned long index;
};

Attributs

alt de type DOMString

Une chaîne donnant un nom de remplacement du caractère. Représente l'attribut alt de l'élément mglyph.

fontfamily de type DOMString

Une chaîne représentant la famille de polices.

index de type unsigned long

Un entier sans signe donnant la position du glyphe dans la police.

L'interface MathMLSpaceElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement de l'élément d'espacement mspacede MathML. Remarquez qu'elle n'est pas dérivée de l'interface MathMLPresentationToken, bien que mspace soit classé comme élément atomique, parce qu'elle ne porte pas les attributs déclarés pour MathMLPresentationToken.

Définition IDL

interface MathMLSpaceElement: MathMLPresentationElement {
  attribute DOMString width;
  attribute DOMString height;
  attribute DOMString depth;
};

Attributs

width de type DOMString

Une chaîne de la forme number h-unit ; représente l'attribut width de l'élément mspace, si défini.

height de type DOMString

Une chaîne de la forme number v-unit ; représente l'attribut height de l'élément mspace, si défini.

depth de type DOMString

Une chaîne de la forme number v-unit ; représente l'attribut depth de l'élément mspace, si défini.

D.1.3.2 Les interfaces des éléments atomiques de présentation

Les interfaces représentant les éléments atomiques de présentation MathML acceptant un contenu sont décrites ici.

L'interface MathMLPresentationToken

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLElement pour inclure un accès aux attributs spécifiques de la présentation de texte. Elle sert de classe de base pour tous les éléments atomiques de présentation MathML. L'accès au corps de l'élément se fait via l'attribut nodeValue hérité de l'interface Node. Les éléments qui exposent seulement les attributs des atomes de présentation principaux sont directement gérés par cet objet. Ces éléments sont les suivants :

mi

élément identificateur

mn

élément numérique

mtext

élément textuel

Définition IDL

interface MathMLPresentationToken: MathMLPresentationElement {
  attribute DOMString mathvariant;
  attribute DOMString mathsize;
  attribute DOMString mathfamily;
  attribute DOMString mathcolor; 
  attribute DOMString mathbackground;
  readonly attribute MathMLNodeList contents;
};

Attributs

mathvariant de type DOMString

L'attribut mathvariant de l'élément, si défini. L'une parmi les valeurs suivantes : "normal", "bold", "italic", "bold-italic", "double-struck", "bold-fraktur", "script", "bold-script", "fraktur", "sans-serif", "bold-sans-serif", "sans-serif-italic", "sans-serif-bold-italic" ou "monospace".

mathsize de type DOMString

L'attribut mathsize de l'élément, si défini. L'une des valeurs "small", "normal" ou "big", ou bien une valeur de la forme number v-unit.

mathfamily de type DOMString

L'attribut mathfamily de l'élément, si défini. Ce devrait être une chaîne de la forme css-fontfamily.

mathcolor de type DOMString

L'attribut mathcolor de l'élément, si défini. L'objet DOMString retourné devrait prendre la forme d'une définition de couleur CSS.

mathbackground de type DOMString

L'attribut mathbackground de l'élément, si défini. L'objet DOMString retourné devrait prendre la forme d'une spécification de couleur CSS.

contents de type MathMLNodeList, en lecture seule

Retourne les sous-éléments de type Node de l'élément. Ils devraient se composer de nœuds Text et, le cas échéant, d'objets MathMLGlyphElement. L'attribut devrait se comporter comme l'attribut de la classe de base Node::childNodes ; toutefois, il est fourni ici pour la clarté du propos.

L'interface MathMLOperatorElement

Étend : MathMLPresentationToken

Cette interface étend l'interface MathMLPresentationToken de l'élément opérateur mo de MathML.

Définition IDL

interface MathMLOperatorElement: MathMLPresentationToken {
  attribute DOMString form;
  attribute DOMString fence;
  attribute DOMString separator;
  attribute DOMString lspace;
  attribute DOMString rspace;
  attribute DOMString stretchy;
  attribute DOMString symmetric;
  attribute DOMString maxsize;
  attribute DOMString minsize;
  attribute DOMString largeop;
  attribute DOMString moveablelimits;
  attribute DOMString movablelimits;
  attribute DOMString accent;
};

Attributs

form de type DOMString

L'attribut form (avec les valeurs "prefix", "infix" ou "postfix") de l'élément mo, si défini.

fence de type DOMString

L'attribut fence (valeurs "true" ou "false") de l'élément mo, si défini.

separator de type DOMString

L'attribut separator (valeurs "true" ou "false") de l'élément mo, si défini.

lspace de type DOMString

L'attribut lspace (espacement à gauche) de l'élément mo, si défini.

rspace de type DOMString

L'attribut rspace (espacement à droite) de l'élément mo, si défini.

stretchy de type DOMString

L'attribut stretchy (valeurs "true" ou "false") de l'élément mo, si défini.

symmetric de type DOMString

L'attribut symmetric (valeurs "true" ou "false") de l'élément mo, si défini.

maxsize de type DOMString

L'attribut maxsize de l'élément mo, si défini

minsize de type DOMString

L'attribut minsize de l'élément mo, si défini.

largeop de type DOMString

L'attribut largeop de l'élément mo, si défini.

moveablelimits movablelimits de type DOMString

L'attribut moveablelimits movablelimits (valeurs "true" ou "false") de l'élément mo, si défini.

accent de type DOMString

L'attribut accent (valeurs "true" ou "false") de l'élément mo, si défini.

L'interface MathMLStringLitElement

Étend : MathMLPresentationToken

Cette interface étend l'interface MathMLPresentationToken de l'élément chaîne littérale ms de MathML.

Définition IDL

interface MathMLStringLitElement: MathMLPresentationToken {
  attribute DOMString lquote;
  attribute DOMString rquote;
};

Attributs

lquote de type DOMString

Une chaîne donnant le délimiteur ouvrant de la chaîne littérale ; représente l'attribut lquote de l'élément ms, si défini.

rquote de type DOMString

Une chaîne donnant le délimiteur fermant de la chaîne littérale ; représente l'attribut rquote de l'élément ms, si défini.

D.1.3.3 Les interfaces des conteneurs de présentation

Les interfaces conçues pour représenter les éléments de présentation MathML susceptibles de contenir un nombre arbitraire d'objets MathMLElement enfants apparaissent sous le titre des éléments conteneurs de présentation (cf. D.1.3.3 dans la table des matières).

L'interface MathMLPresentationContainer

Étend : MathMLPresentationElement, MathMLContainer

Cette interface représente les éléments de présentation MathML pouvant contenir un nombre arbitraire de sous-éléments. Les éléments directement gérés par cette interface comprennent mrow, mphantom et merror. Tous les attributs et méthodes sont dérivés des interfaces de base MathMLPresentationElement et MathMLContainer.

Définition IDL

interface MathMLPresentationContainer: MathMLPresentationElement, MathMLContainer {
};

L'interface MathMLStyleElement

Étend : MathMLPresentationContainer

Cette interface étend l'interface MathMLElement de l'élément de style mstyle de MathML. Quoique l'élément mstyle puisse contenir n'importe quels attributs admissibles sur un élément de présentation MathML, seuls les attributs spécifiques de l'élément mstyle sont inclus dans l'interface suivante. On devrait accéder aux autres attributs en utilisant les méthodes de la classe de base Element, notamment les méthodes Element::getAttribute et Element::setAttribute, ou même l'attribut Node::attributes pour accéder à tous en une seule fois. On évite non seulement la longue liste ci-dessous, mais la plupart des mises en œuvres trouveront probablement cette interface beaucoup plus utile pour un objet MathMLStyleElement.

Définition IDL

interface MathMLStyleElement: MathMLPresentationContainer {
  attribute DOMString scriptlevel;
  attribute DOMString displaystyle;
  attribute DOMString scriptsizemultiplier;
  attribute DOMString scriptminsize;
  attribute DOMString color;
  attribute DOMString background;
};

Attributs

scriptlevel de type DOMString

Une chaîne de la forme +/- unsigned integer ; représente l'attribut scriptlevel de l'élément mstyle, si défini. Cf. également la discussion à propos de cet attribut.

displaystyle de type DOMString

Sa valeur est soit "true", soit "false" ; une chaîne représentant l'attribut displaystyle de l'élément mstyle, si défini. Cf. également la discussion à propos de cet attribut.

scriptsizemultiplier de type DOMString

Une chaîne de la forme number ; représente l'attribut scriptsizemultiplier de l'élément mstyle, si défini. Cf. également la discussion à propos de cet attribut.

scriptminsize de type DOMString

Une chaîne de la forme number v-unit ; représente l'attribut scriptminsize de l'élément mstyle, si défini. Cf. également la discussion à propos de cet attribut.

color de type DOMString

Une chaîne représentant une couleur ; représente l'attribut color de l'élément mstyle, si défini. Cf. également la discussion à propos de cet attribut.

background de type DOMString

Une chaîne représentant une couleur ou valant "transparent" ; représente l'attribut background de l'élément mstyle, si défini. Cf. également la discussion à propos de cet attribut.

L'interface MathMLPaddedElement

Étend : MathMLPresentationContainer

Cette interface étend l'interface MathMLElement de l'élément d'ajustement d'espacement mpadded de MathML.

Définition IDL

interface MathMLPaddedElement: MathMLPresentationContainer {
  attribute DOMString width;
  attribute DOMString lspace;
  attribute DOMString height;
  attribute DOMString depth;
};

Attributs

width de type DOMString

Une chaîne représentant l'attribut width (la largeur totale) de l'élément mpadded, si défini. Cf. également la discussion à propos de cet attribut.

lspace de type DOMString

Une chaîne représentant l'attribut lspace (l'espace supplémentaire à gauche) de l'élément mpadded, si défini. Cf. également la discussion à propos de cet attribut.

height de type DOMString

Une chaîne représentant l'attribut height (la hauteur au-dessus de la ligne de base) de l'élément mpadded, si défini. Cf. également la discussion à propos de cet attribut.

depth de type DOMString

Une chaîne représentant l'attribut depth (la profondeur en-dessous de la ligne de base) de l'élément mpadded, si défini. Cf. également la discussion à propos de cet attribut.

L'interface MathMLFencedElement

Étend : MathMLPresentationContainer

Cette interface étend l'interface MathMLPresentationContainer de l'élément à contenu délimité mfenced de MathML.

Définition IDL

interface MathMLFencedElement: MathMLPresentationContainer {
  attribute DOMString open;
  attribute DOMString close;
  attribute DOMString separators;
};

Attributs

open de type DOMString

Une chaîne représentant le délimiteur ouvrant de l'élément mfenced, si défini ; il s'agit de l'attribut open de l'élément.

close de type DOMString

Une chaîne représentant le délimiteur fermant de l'élément mfenced, si défini ; il s'agit de l'attribut close de l'élément.

separators de type DOMString

Une chaîne représentant n'importe quel caractère de séparation au sein de l'élément mfenced, si défini ; il s'agit de l'attribut separators de l'élément.

L'interface MathMLEncloseElement

Étend : MathMLPresentationContainer

Cette interface gère l'élément menclose (cf. la section 3.3.9 L'inclusion d'une expression dans une notation (menclose).

Définition IDL

interface MathMLEncloseElement: MathMLPresentationContainer {
  attribute DOMString notation;
};

Attributs

notation de type DOMString

Un chaîne donnant le nom de la notation englobant le contenu de l'élément. Représente l'attribut notation de l'élément menclose. Les valeurs admises sont "longdiv", "actuarial" et "radical".

L'interface MathMLActionElement

Étend : MathMLPresentationContainer

Cette interface étend l'interface MathMLPresentationContainer de l'élément d'animation d'expression maction de MathML.

Définition IDL

interface MathMLActionElement: MathMLPresentationContainer {
  attribute DOMString actiontype;
  attribute DOMString selection;
};

Attributs

actiontype de type DOMString

Une chaîne indiquant l'action. Les valeurs possibles sont "toggle", "statusline", "tooltip", "highlight" et "menu".

selection de type DOMString

Une chaîne indiquant un entier qui sélectionne le sujet courant de l'action.

D.1.3.4 Les interfaces des schémas de présentation

L'interface MathMLFractionElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement de l'élément de fraction mfrac de MathML.

Définition IDL

interface MathMLFractionElement: MathMLPresentationElement {
  attribute DOMString linethickness;
  attribute MathMLElement numerator;
  attribute MathMLElement denominator;
};

Attributs

linethickness de type DOMString

Une chaîne représentant l'attribut linethickness de l'élément mfrac, si défini.

numerator de type MathMLElement

Le premier objet MathMLElement enfant de l'objet MathMLFractionElement ; représente le numérateur de la fraction en question.

denominator de type MathMLElement

Le second objet MathMLElement enfant de l'objet MathMLFractionElement ; représente le dénominateur de la fraction en question.

L'interface MathMLRadicalElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement des éléments de radical (mroot) et de racine carrée (msqrt) de MathML.

Définition IDL

interface MathMLRadicalElement: MathMLPresentationElement {
  attribute MathMLElement radicand;
  attribute MathMLElement index;
};

Attributs

radicand de type MathMLElement

Le premier objet MathMLElement enfant de l'objet MathMLRadicalElement ; représente la base du radical en question.

index de type MathMLElement

Le second objet MathMLElement enfant de l'objet MathMLRadicalElement ; représente l'indice du radical en question. Il doit avoir la valeur "null" pour les éléments msqrt.

L'interface MathMLScriptElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement des éléments d'écriture en indice (msub), d'écriture en exposant (msup) et de paire indice-exposant (msubsup) de MathML.

Définition IDL

interface MathMLScriptElement: MathMLPresentationElement {
  attribute DOMString subscriptshift;
  attribute DOMString superscriptshift;
  attribute MathMLElement base;
  attribute MathMLElement subscript;
  attribute MathMLElement superscript;
};

Attributs

subscriptshift de type DOMString

Une chaîne représentant la quantité minimum de glissement vers le bas de la ligne de base de l'indice, si défini ; il s'agit de l'attribut subscriptshift de l'élément. Sa valeur doit être "null" pour un élément msup.

superscriptshift de type DOMString

Une chaîne représentant la quantité minimum de glissement vers le haut de la ligne de base de l'exposant, si défini ; il s'agit de l'attribut superscriptshift de l'élément. Sa valeur doit être "null" pour un élément msub.

base de type MathMLElement

Un objet MathMLElement représentant la base de l'écriture. C'est le premier sous-élément de l'élément.

subscript de type MathMLElement

Un objet MathMLElement représentant l'indice de l'écriture. C'est le second sous-élément d'un élément msub (ou msubsup) ; sa valeur doit être "null" pour un élément msup.

Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Produite lorsque c'est un élément msup.

superscript de type MathMLElement

Un objet MathMLElement représentant l'exposant de l'écriture. C'est le second sous-élément d'un élément msup, ou le troisième d'un élément msubsup ; sa valeur doit être "null" pour un élément msub.

Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Produite lorsque c'est un élément msub.

L'interface MathMLUnderOverElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement des éléments d'écriture dessous (munder), d'écriture dessus (mover) et de paire dessous-dessus (munderover) de MathML.

Définition IDL

interface MathMLUnderOverElement: MathMLPresentationElement {
  attribute DOMString accentunder;
  attribute DOMString accent;
  attribute MathMLElement base;
  attribute MathMLElement underscript;
  attribute MathMLElement overscript;
};

Attributs

accentunder de type DOMString

Sa valeur est soit "true", soit "false", si l'attribut est présent ; une chaîne contrôlant si l'écriture dessous se dessine comme un accent ou comme une limite, si défini ; il s'agit de l'attribut accentunder de l'élément. Sa valeur doit être "null" pour un élément mover.

accent de type DOMString

Sa valeur est soit "true", soit "false", si l'attribut est présent ; une chaîne contrôlant si l'écriture dessus se dessine comme un accent ou comme une limite, si défini ; il s'agit de l'attribut accent de l'élément. Sa valeur doit être "null" pour un élément munder.

base de type MathMLElement

Un objet MathMLElement représentant la base de l'écriture. C'est le premier sous-élément de l'élément.

underscript de type MathMLElement

Un objet MathMLElement représentant l'écriture dessous de l'écriture. C'est le second sous-élément d'un élément munder (ou munderover) ; sa valeur doit être "null" pour un élément mover.

Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Produite lorsque c'est un élément mover.

overscript de type MathMLElement

Un objet MathMLElement représentant l'écriture dessus de l'écriture. C'est le second sous-élément d'un élément mover, ou le troisième d'un élément munderover ; sa valeur doit être "null" pour un élément munder.

Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Produite lorsque c'est un élément munder.

L'interface MathMLMultiScriptsElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement pour les éléments à écritures multiples (dont les préécritures et les tenseurs) mmultiscripts de MathML.

Définition IDL

interface MathMLMultiScriptsElement: MathMLPresentationElement {
  attribute DOMString subscriptshift;
  attribute DOMString superscriptshift;
  attribute MathMLElement base;
  readonly attribute MathMLNodeList prescripts;
  readonly attribute MathMLNodeList scripts;
  readonly attribute unsigned long numprescriptcolumns;
  readonly attribute unsigned long numscriptcolumns;
  MathMLElement getPreSubScript(in unsigned long colIndex);
  MathMLElement getSubScript(in unsigned long colIndex);
  MathMLElement getPreSuperScript(in unsigned long colIndex);
  MathMLElement getSuperScript(in unsigned long colIndex);
  MathMLElement insertPreSubScriptBefore(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement setPreSubScriptAt(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement insertSubScriptBefore(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement setSubScriptAt(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement insertPreSuperScriptBefore(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement setPreSuperScriptAt(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement insertSuperScriptBefore(in unsigned long colIndex, in MathMLElement newScript);
  MathMLElement setSuperScriptAt(in unsigned long colIndex, in MathMLElement newScript);
};

Attributs

subscriptshift de type DOMString

Une chaîne représentant la quantité minimum de glissement vers le bas de la ligne de base des indices, si défini ; il s'agit de l'attribut subscriptshift de l'élément.

superscriptshift de type DOMString

Une chaîne représentant la quantité minimum de glissement vers le haut de la ligne de base des exposants, si défini ; il s'agit de l'attribut superscriptshift de l'élément.

base de type MathMLElement

Un objet MathMLElement représentant la base de l'écriture. C'est le premier sous-élément de l'élément.

prescripts de type MathMLNodeList, en lecture seule

Un objet NodeList représentant les préécritures de l'écriture, lesquelles apparaissent dans l'ordre décrit par l'expression (préécriture préexposant)*. C'est le même ordre que celui de la traversée du contenu de l'objet NodeList retourné par la méthode Node::childNodes(), de l'objet Node suivant l'élément <mprescripts/> (si présent) jusqu'à la fin de la liste.

scripts de type MathMLNodeList, en lecture seule

Un objet MathMLNodeList représentant les écritures de l'écriture, lesquelles apparaissent dans l'ordre décrit par l'expression (écriture exposant)*. C'est le même ordre que celui de la traversée du contenu de l'objet NodeList retourné par la méthode Node::childNodes(), du premier objet Node jusqu'à l'objet Node inclus précédant l'élément <mprescripts/> (si présent.

numprescriptcolumns de type unsigned long, en lecture seule

Le nombre de colonnes d'écritures/indices précédant (à gauche) la base. Il devrait toujours être la moitié de getprescripts().length().

numscriptcolumns de type unsigned long, en lecture seule

Le nombre de colonnes d'écritures/indices suivant (à droite) la base. Il devrait toujours être la moitié de getscripts().length().

Méthodes

getPreSubScript

Une méthode pratique pour récupérer les sous-éléments préindices de l'élément, référencés par un index de colonne.

Paramètres

unsigned long

colIndex

L'index de colonne de la préécriture (où 1 représente la colonne de préécriture la plus à gauche).

Valeur retournée

MathMLElement

Retourne l'objet MathMLElement représentant le préindice dont l'index de colonne correspond à la valeur du paramètre colIndex (à gauche de la base, la colonne la plus à gauche valant 1). Remarquez qu'il peut s'agir de l'objet MathMLElement correspondant à l'élément spécial <none/> pour un préindice manquant (cf. la discussion à propos de l'élément mmultiscripts), ou il peut s'agir de la valeur "null" si la valeur de colIndex dépasse la portée de l'élément.

Cette méthode ne produit aucune exception.

getSubScript

Une méthode pratique pour récupérer les sous-éléments indices de l'élément, référencés par un index de colonne.

Paramètres

unsigned long

colIndex

L'index de colonne d'écriture (où 1 représente la colonne d'écriture la plus à gauche, la première à droite de la base).

Valeur retournée

MathMLElement

Retourne l'objet MathMLElement représentant l'indice dont l'index de colonne correspond à la valeur du paramètre colIndex (à droite de la base). Remarquez qu'il peut s'agir de l'objet MathMLElement correspondant à l'élément spécial <none/> pour un indice manquant (cf. la discussion à propos de l'élément mmultiscripts), ou il peut s'agir de la valeur "null" si la valeur de colIndex dépasse la portée de l'élément.

Cette méthode ne produit aucune exception.

getPreSuperScript

Une méthode pratique pour récupérer les sous-éléments préexposants de l'élément, référencés par un index de colonne.

Paramètres

unsigned long

colIndex

L'index de colonne du préexposant (où 1 représente la colonne de préécriture la plus à gauche).

Valeur retournée

MathMLElement

Retourne l'objet MathMLElement représentant le préexposant dont l'index de colonne correspond à la valeur du paramètre colIndex (à gauche de la base, la colonne la plus à gauche valant 1). Remarquez qu'il peut s'agir de l'objet MathMLElement correspondant à l'élément spécial <none/> pour un préexposant manquant (cf. la discussion à propos de l'élément mmultiscripts), ou il peut s'agir de la valeur "null" si la valeur de colIndex dépasse la portée de l'élément.

Cette méthode ne produit aucune exception.

getSuperScript

Une méthode pratique pour récupérer les sous-éléments exposants de l'élément, référencés par un index de colonne.

Paramètres

unsigned long

colIndex

L'index de colonne de l'exposant (où 1 représente l'écriture la plus à gauche, la première à droite de la base)

Valeur retournée

MathMLElement

Retourne l'objet MathMLElement représentant l'exposant dont l'index de colonne correspond à la valeur du paramètre colIndex (à droite de la base). Remarquez qu'il peut s'agir de l'objet MathMLElement correspondant à l'élément spécial <none/> pour un exposant manquant (cf. la discussion à propos de l'élément mmultiscripts), ou il peut s'agir de la valeur "null" si la valeur de colIndex dépasse la portée de l'élément.

Cette méthode ne produit aucune exception.

insertPreSubScriptBefore

Une méthode pratique pour insérer un préindice avant la position référencée par un index de colonne. Si l'attribut colIndex vaut 0, le nouveau préindice est ajouté comme dernier préindice de l'élément mmultiscripts ; si colIndex vaut 1, un nouveau préindice est ajouté devant celui le plus à gauche. Remarquez que l'insertion d'un nouveau préindice entraîne celle d'un nouveau préexposant vide dans la même colonne.

Paramètres

unsigned long	colIndex	L'index de colonne d'un préindice (où la valeur 1 représente la colonne de préécriture la plus à gauche).
MathMLElement	newScript	Un objet MathMLElement représentant l'élément à insérer en préindice.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet objet MathMLMultiScriptsElement représentant la nouvelle écriture dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un préindice.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure au nombre de préécritures de l'élément.

setPreSubScriptAt

Une méthode pratique pour placer le sous-élément préindice à la position référencée par l'attribut colIndex. S'il existe déjà un préindice à cette position, l'objet newScript le remplace.

Paramètres

unsigned long	colIndex	L'index de colonne du préindice (où la valeur 1 représente la colonne de préécriture la plus à gauche).
MathMLElement	newScript	Un objet MathMLElement représentant le sous-élément préindice de cet élément, à placer dans la colonne avec la valeur de colIndex.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet objet MathMLMultiScriptsElement représentant le nouveau préindice dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un préindice.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure de plus d'une unité au nombre de préécritures de l'élément.

insertSubScriptBefore

Une méthode pratique pour insérer un indice avant la position référencée par un index de colonne. Si l'attribut colIndex vaut 0, le nouvel indice est ajouté en dernier indice de l'élément mmultiscripts ; si colIndex vaut 1, un nouvel indice est ajouté avant celui le plus à gauche. Remarquez que l'insertion d'un indice entraîne celle d'un exposant vide dans la même colonne.

Paramètres

unsigned long	colIndex	L'index de colonne d'un indice, où la valeur 1 représente la colonne d'écriture la plus à gauche (la première à droite de la base).
MathMLElement	newScript	Un objet MathMLElement représentant l'élément à insérer en indice.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet objet MathMLMultiScriptsElement représentant le nouvel indice dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un indice.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure au nombre d'écritures de l'élément.

setSubScriptAt

Une méthode pratique pour placer le sous-élément indice à la position référencée par l'attribut colIndex. S'il existe déjà un indice à cette position, l'objet newScript le remplace.

Paramètres

unsigned long	colIndex	L'index de colonne d'un indice, où la valeur 1 représente la colonne d'écriture la plus à gauche (la première à droite de la base).
MathMLElement	newScript	Un objet MathMLElement représentant le sous-élément indice de cet élément, à placer dans la colonne équivalant à colIndex.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouvel indice dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un indice.

INDEX_SIZE_ERR : Produite si la valeur de colIndex est supérieure de plus d'une unité au nombre d'écritures de l'élément.

insertPreSuperScriptBefore

Une méthode pratique pour insérer un préexposant avant la position référencée par un index de colonne. Si l'attribut colIndex vaut 0, le nouveau préexposant est ajouté comme dernier préexposant de l'élément mmultiscripts ; si colIndex vaut 1, un nouveau préexposant est ajouté avant celui le plus à gauche. Remarquez que l'insertion d'un nouveau préexposant entraîne celle d'un nouveau préindice vide dans la même colonne.

Paramètres

unsigned long	colIndex	L'index de colonne d'un préexposant (où la valeur 1 représente la colonne de préécriture la plus à gauche).
MathMLElement	newScript	Un objet MathMLElement représentant l'élément à insérer en préexposant.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouveau préexposant dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un préexposant.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure au nombre de préécritures de l'élément.

setPreSuperScriptAt

Une méthode pratique pour placer le sous-élément préexposant à la position référencée par l'attribut colIndex. S'il existe déjà un préexposant à cette position, l'objet newScript le remplace.

Paramètres

unsigned long	colIndex	L'index de colonne d'un préexposant (où la valeur 1 représente la colonne de préécriture la plus à gauche).
MathMLElement	newScript	Un objet MathMLElement représentant le sous-élément préexposant de cet élément, à placer dans la colonne équivalant à colIndex.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouveau préexposant dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un préexposant.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure de plus d'une unité au nombre de préécritures de l'élément.

insertSuperScriptBefore

Une méthode pratique pour insérer un exposant avant la position référencée par un index de colonne. Si l'attribut colIndex vaut 0, le nouvel exposant est ajoutée comme dernier indice de l'élément mmultiscripts ; si colIndex vaut 1, un nouvel exposant est ajouté avant celui le plus à gauche. Remarquez que l'insertion d'un nouvel exposant entraîne celle d'un nouvel indice vide dans la même colonne.

Paramètres

unsigned long	colIndex	L'index de colonne d'un exposant, où la valeur 1 représente la colonne d'écriture la plus à gauche (la première à droite de la base).
MathMLElement	newScript	Un objet MathMLElement représentant l'élément à insérer en exposant.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouvel exposant dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un exposant.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure au nombre d'écritures de l'élément.

setSuperScriptAt

Une méthode pratique pour placer le sous-élément exposant à la position référencée par l'attribut colIndex. S'il existe déjà un exposant à cette position, l'objet newScript le remplace.

Paramètres

unsigned long	colIndex	L'index de colonne d'un exposant, où la valeur 1 représente la colonne d'écriture la plus à gauche (la première à droite de la base).
MathMLElement	newScript	Un objet MathMLElement repésentant le sous-élément exposant de cet élément, à placer dans la colonne équivalant à colIndex.

Valeur retournée

MathMLElement

L'objet MathMLElement enfant de cet élément représentant le nouvel exposant dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newScript représente un élément qui ne peut pas être un exposant.

INDEX_SIZE_ERR : Produite si la valeur de l'attribut colIndex est supérieure de plus d'une unité au nombre d'écritures de l'élément.

L'interface MathMLTableElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement de l'élément de tableau ou matrice mtable de MathML.

Définition IDL

interface MathMLTableElement: MathMLPresentationElement {
  attribute DOMString align;
  attribute DOMString rowalign;
  attribute DOMString columnalign;
  attribute DOMString groupalign;
  attribute DOMString alignmentscope;
  attribute DOMString columnwidth;
  attribute DOMString width;
  attribute DOMString rowspacing;
  attribute DOMString columnspacing;
  attribute DOMString rowlines;
  attribute DOMString columnlines;
  attribute DOMString frame;
  attribute DOMString framespacing;
  attribute DOMString equalrows;
  attribute DOMString equalcolumns;
  attribute DOMString displaystyle;
  attribute DOMString side;
  attribute DOMString minlabelspacing;
  readonly attribute MathMLNodeList rows;
  MathMLTableRowElement insertEmptyRow(in long index);
  MathMLLabeledRowElement insertEmptyLabeledRow(in long index);
  MathMLTableRowElement getRow(in unsigned long index);
  MathMLTableRowElement insertRow(in long index, in MathMLTableRowElement newRow);
  MathMLTableRowElement setRow(in long index, in MathMLTableRowElement newRow);
  void deleteRow(in unsigned long index);
  MathMLTableRowElement removeRow(in long index);
};

Attributs

align de type DOMString

Une chaîne représentant l'alignement vertical du tableau au texte adjacent. Les valeurs admises sont : (top | bottom | center | baseline | axis)[rownumber], où rownumber est une valeur comprise entre 1 et n (pour un tableau de n lignes), ou entre -1 et -n.

rowalign de type DOMString

Une chaîne représentant l'alignement des entrées dans chaque ligne, qui se compose d'une séquence de spécificateurs d'alignement séparés par des espaces, chacun d'eux pouvant avoir les valeurs suivantes : "top", "bottom", "center", "baseline" ou "axis".

columnalign de type DOMString

Une chaîne représentant l'alignement des entrées dans chaque colonne, qui se compose d'une séquence de spécificateurs d'alignement séparés par des espaces, chacun d'eux pouvant avoir les valeurs suivantes : "left", "center" ou "right".

groupalign de type DOMString

Une chaîne indiquant comment les groupes d'alignement au sein des cellules de chaque lignes doivent s'aligner avec les éléments correspondants au-dessus ou en-dessous d'eux dans la même colonne. La chaîne se compose d'une séquence de listes de groupes d'alignement entre des accolades. Chaque liste de groupes d'alignement, séparés par des espaces, est une séquence, chacun d'eux pouvant avoir les valeurs suivantes : "left", "right", "center" ou "decimalpoint".

alignmentscope de type DOMString

Une chaîne composée des valeurs "true" ou "false" indiquant, pour chaque colonne, si celle-ci peut servir d'espace d'alignement.

columnwidth de type DOMString

Une chaîne qui se compose d'une séquence de spécificateurs séparés par des espaces, chacun d'eux pouvant avoir l'une des formes suivantes : "auto", number h-unit, namedspace ou "fit". (La forme namedspace prend l'une des valeurs suivantes : "veryverythinmathspace", "verythinmathspace", "thinmathspace", "mediummathspace", "thickmathspace", "verythickmathspace" ou "veryverythickmathspace"). Cela représente l'attribut columnwidth de l'élément.

width de type DOMString

Une chaîne de la forme number h-unit, ou bien la chaîne "auto". Cela représente l'attribut width de l'élément.

rowspacing de type DOMString

Une chaîne qui se compose d'une séquence de spécificateurs séparés par des espaces, de la forme number v-unit, représentant l'espace à ajouter entre les lignes.

columnspacing de type DOMString

Une chaîne qui se compose d'une séquence de spécificateurs séparés par des espaces, de la forme number h-unit, représentant l'espace à ajouter entre les colonnes.

rowlines de type DOMString

Une chaîne indiquant si et, le cas échéant, quels types de lignes il faudrait ajouter entre chaque ligne. La chaîne se compose d'une séquence de spécificateurs séparés par des espaces, chacun d'eux pouvant avoir l'une des valeurs suivantes : "none", "solid" ou "dashed".

columnlines de type DOMString

Une chaîne indiquant si et, le cas échéant, quels types de lignes il faudrait ajouter entre chaque colonne. La chaîne se compose d'une séquence de spécificateurs séparés par des espaces, chacun d'eux pouvant avoir l'une des valeurs suivantes : "none", "solid" ou "dashed".

frame de type DOMString

Une chaîne définissant un cadre autour de la table. Les valeurs permises sont (none | solid | dashed).

framespacing de type DOMString

Une chaîne de la forme number h-unit number v-unit indiquant l'espacement entre le tableau et son cadre.

equalrows de type DOMString

Une chaîne dont la valeur est "true" ou "false".

equalcolumns de type DOMString

Une chaîne dont la valeur est "true" ou "false".

displaystyle de type DOMString

Une chaîne dont la valeur est "true" ou "false".

side de type DOMString

Une chaîne dont la valeur est "left", "right", "leftoverlap" ou "rightoverlap".

minlabelspacing de type DOMString

Une chaîne de la forme number h-unit, indiquant l'espace minimum entre une étiquette et l'entrée adjacente dans la ligne étiquetée.

rows de type MathMLNodeList, en lecture seule

Un objet MathMLNodeList composé d'objets MathMLTableRowElements et MathMLLabeledRowElements, représentant les lignes de la table. C'est un objet dynamique.

Méthodes

insertEmptyRow

Une méthode pratique pour insérer une nouvelle ligne vide (mtr) dans le tableau avant la ligne courante avec cet index. Si la valeur du paramètre index est inférieure à 0, la nouvelle ligne s'insère avant la ligne moins indexée (-index), à compter de la dernière ligne courante ; si la valeur de index est égale au nombre de lignes courant, la nouvelle ligne se place en dernière position.

Paramètres

long

index

La position avant laquelle insérer la nouvelle ligne, où la valeur 0 représente la première ligne. Les nombres négatifs servent à compter à rebours depuis la dernière ligne.

Valeur retournée

MathMLTableRowElement

Retourne l'objet MathMLTableRowElement enfant de cet objet MathMLTableElement représentant le nouvel élément mtr inséré.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de lignes courant, ou inférieure au négatif de ce nombre, de cet élément mtable.

insertEmptyLabeledRow

Une méthode pratique pour insérer une nouvelle ligne vide étiquetée (mlabeledtr) dans la table, avant la ligne indexée courante. Si la valeur du paramètre index est inférieure à 0, la nouvelle ligne s'insère avant la ligne moins indexée (-index), à compter de la dernière ligne courante ; si la valeur de index est égale au nombre de lignes courant, la nouvelle ligne se place en dernière position.

Paramètres

long

index

La position avant laquelle insérer la nouvelle ligne, où la valeur 0 représente la première ligne. Les nombres négatifs servent à compter à rebours depuis la dernière ligne.

Valeur retournée

MathMLLabeledRowElement

Retourne l'objet MathMLLabeledRowElement enfant de cet objet MathMLTableElement représentant l'élément mtr inséré.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de lignes courant, ou inférieure au négatif de ce nombre, de cet élément mtable.

getRow

Une méthode pratique pour récupérer une ligne indexée de la table. Si la valeur du paramètre index est inférieure à 0, la ligne moins indexée (-index) à récupérer à compter du bas du tableau. (Ainsi, par exemple, si la valeur de index est -2, c'est l'avant-dernière ligne qui sera récupérée). Si la valeur de index n'est pas valide (c.à.d. est supérieure ou égale au nombre de lignes, ou inférieure au négatif de ce nombre), un objet MathMLTableRowElement de valeur "null" est retourné.

Paramètres

unsigned long

index

L'index de la ligne à retourner, où la valeur 0 représente la première ligne. Les nombres négatifs servent à compter à rebours depuis la dernière ligne.

Valeur retournée

MathMLTableRowElement

Retourne l'objet MathMLTableRowElement représentant la ligne indexée de la table.

Cette méthode ne produit aucune exception.

insertRow

Une méthode pratique pour insérer la nouvelle ligne mtr (ou ligne étiquetée mlabeledtr) représentée par l'objet newRow dans la table, avant la ligne indexée courante. Si la valeur du paramètre index est égale au nombre de lignes courant, l'objet newRow se place en dernière ligne dans la table. (Ainsi, par exemple, si l'index vaut -2, la nouvelle ligne se place avant l'avant-dernière ligne courante).

Paramètres

long	index	L'index avant lequel insérer l'objet newRow, où la valeur 0 représente la première ligne. Les nombres négatifs servent à compter à rebours depuis la dernière ligne courante.
MathMLTableRowElement	newRow	Un objet MathMLTableRowElement (ou MathMLLabeledRowElement) représentant la ligne à insérer.

Valeur retournée

MathMLTableRowElement

L'objet MathMLTableRowElement (ou MathMLLabeledRowElement) enfant de cet objet MathMLTableElement représentant l'élément mtr inséré.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newRow n'est pas un objet MathMLTableRowElement ou MathMLLabeledRowElement.

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de lignes courant, ou inférieure au négatif de ce nombre, de cet élément mtable.

setRow

Une méthode pour fixer la valeur de la ligne du tableau avec l'index indiqué à l'élément mtr (ou mlabeledtr) représenté par l'objet newRow ; si la valeur du paramètre index est inférieure à 0, l'objet newRow remplace la ligne -index à compter de la dernière ; si elle est supérieure d'une unité au nombre de lignes courant, la nouvelle ligne se place en dernière ligne dans la table.

Paramètres

long	index	L'index de la ligne à attribuer à l'objet newRow, où la valeur 0 représente la première ligne. Les nombres négatifs servent à compter à rebours depuis la dernière ligne.
MathMLTableRowElement	newRow	Un objet MathMLTableRowElement représentant la nouvelle ligne indexée.

Valeur retournée

MathMLTableRowElement

Retourne l'objet MathMLTableRowElement (ou MathMLLabeledRowElement) enfant de cet élément représentant la nouvelle ligne dans le DOM.

Exceptions

DOMException

HIERARCHY_REQUEST_ERR : Produite si l'objet newRow n'est pas un objet MathMLTableRowElement ou MathMLLabeledRowElement.

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure au nombre de lignes courant, ou inférieure au négatif de ce nombre, de cet élément mtable.

deleteRow

Une méthode pratique pour supprimer la ligne du tableau à l'index indiqué. Si la valeur de l'attributs index est inférieure à 0, la ligne moins indexée (-index), à compter du bas de la table, est supprimée. (Ainsi, si la valeur de index est -2, l'avant-dernière ligne est supprimée).

Paramètres

unsigned long

index

L'index de la ligne à supprimer, où la valeur 0 représente la première ligne.

Valeur retournée

void

Aucune.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure ou égale au nombre de lignes courant, ou inférieure au négatif de ce nombre, de cet élément mtable.

removeRow

Une méthode pratique pour supprimer la ligne du tableau à l'index indiqué et la retourner à l'appelant. Si la valeur du paramètre index est inférieure à 0, la ligne indexée, à compter du bas de la table, est retirée. (Ainsi, par exemple, si la valeur de index est -2, l'avant-dernière ligne est retirée).

Paramètres

long

index

L'index de la ligne à supprimer, où la valeur 0 représente la première ligne.

Valeur retournée

MathMLTableRowElement

Un objet MathMLTableRowElement représentant la ligne supprimée.

Exceptions

DOMException

INDEX_SIZE_ERR : Produite si la valeur du paramètre index est supérieure ou égale au nombre de lignes, ou inférieure au négatif de ce nombre, de cet élément mtable.

L'interface MathMLTableRowElement

Étend : MathMLPresentationElement

Cette interface étend l'interface MathMLPresentationElement de l'élément ligne de tableau ou ligne de matrice mtr de MathML.

Définition IDL

interface MathMLTableRowElement: MathMLPresentationElement {
  attribute DOMString rowalign;
  attribute DOMString columnalign;
  attribute DOMString groupalign;
  readonly attribute MathMLNodeList cells;
  MathMLTableCellElement insertEmptyCell(in unsigned long index);
  MathMLTableCellElement insertCell(in MathMLTableCellElement newCell, in unsigned long index);
  MathMLTableCellElement setCell(in MathMLTableCellElement newCell, in unsigned long index);
  void deleteCell(in unsigned long index);
};

Attributs

rowalign de type DOMString

Une chaîne représentant un remplacement de l'alignement des lignes défini dans l'élément co