tr | NN 6 IE 4 DOM 1
Das tr-Objekt spiegelt das tr-Element wider. Aufgrund einer unvollständigen Implementierung ermöglicht IE 4 für den Macintosh keinen uneingeschränkten Skriptzugriff auf diese Elemente.
HTML-Äquivalent
    <tr>
Objektmodellreferenz
    [window.]document.getElementById("elementID")
    [window.]document.getElementById("tableID").rows[i]
Objektspezifische Eigenschaften
align | bgColor | borderColor | borderColorDark
borderColorLight | cells[ ] | ch | chOff
height | rowIndex | sectionRowIndex | vAlign
Objektspezifische Methoden
deleteCell( ) | insertCell( )
Objektspezifische Ereignisbehandlungsroutineneigenschaften
Keine.

align | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Definiert die horizontale Ausrichtung von Inhalten in allen Zellen einer Zeile.
Beispiel
    document.getElementById("myTR").align = "center";
Wert
Eine der drei folgenden horizontalen Ausrichtungskonstanten: center | left | right.
Standardwert
left

blur( ) | NN 2 IE 3 DOM 1
Entfernt den Fokus vom aktuellen Objekt und löst damit das onblur-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode blur( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen. Die Zuweisung des Attributs onfocus="this.blur( );" zu einem Text-input-Element ist beispielsweise eine simple, aber effektive und rückwärtskompatible Möglichkeit, ein Feld für Browser zu deaktivieren, die keine eigene Funktion zum Deaktivieren von Elementen aufweisen.
Verwenden Sie die Methoden blur( ) und focus( ) vorsichtig in ein- und derselben Seite, da hierbei durch eingeblendete Warndialogfelder versehentlich Blur- und Fokus-Endlosschleifen ausgelöst werden können. Denken Sie außerdem daran, dass der Aufruf der Methode blur( ) eines Objekts bewirkt, dass ein anderes Objekt (möglicherweise das window-Objekt) ein onfocus-Ereignis empfängt.
Parameter
Keine.
Zurückgegebener Wert
Keiner.

bgColor | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Legt die Hintergrundfarbe der Tabellenzellen in der aktuellen Zeile fest. Diese Farbeinstellung wird nicht von der backgroundColor-Eigenschaft des Stylesheets widergespiegelt. Auch wenn für das bgcolor-Attribut oder die bgColor-Eigenschaft ein unverschlüsselter Farbname angegeben wurde, ist der zurückgegebene Wert immer ein hexadezimales Triplett.
Beispiel
    document.getElementById("myTR").bgColor = "yellow";
Wert
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A.
Standardwert
Hängt vom Browser und dem Betriebssystem ab.

borderColor | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Legt die Farbe des Elementrahmens fest. Internet Explorer wendet die Farbe für alle vier Linien an, aus denen der innere Rahmen einer Zelle besteht. Daher gibt es keine Konflikte zwischen den Farben aneinander grenzender Zellen.
Beispiel
    document.getElementById("myTR").borderColor = "salmon";
Wert
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Eine Einstellung ohne Wert wird als "#000000" (Schwarz) interpretiert. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A.
Standardwert
Variiert je nach Betriebssystem.

borderColorDark, borderColorLight | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Der dreidimensionale Effekt der Tabellenrahmen in Internet Explorer wird durch das sorgfältige Positionieren von hellen und dunklen Linien um den Seitenhintergrund oder die Standardfarbe erzeugt. Sie können die für helle und dunkle Linien verwendeten Farben unabhängig steuern, indem Sie den Eigenschaften borderColorDark (linke und obere Seite der Zelle) und borderColorLight (rechte und untere Seite) Werte zuweisen.
In der Regel werden dem Eigenschaftenpaar Komplementärfarben zugewiesen. Es gibt jedoch keine Regel, die besagt, Sie müssen der Eigenschaft borderColorDark eine dunkle Farbe zuweisen. Die Attribute steuern lediglich einen definierten Liniensatz, so dass Sie vorhersagen können, welche Seite eines Rahmens sich mit welchem Attribut ändert.
Beispiel
    document.getElementById("myTR").borderColorDark = "blue";
    document.getElementById("myTR").borderColorLight = "cornflowerblue";
Wert
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Eine Einstellung ohne Wert wird als "#000000" (Schwarz) interpretiert. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A.
Standardwert
Variiert je nach Betriebssystem.

cells[ ] | NN 6 IE 4 DOM 1
| Schreibgeschützt
Gibt eine Sammlung aller td- oder th-Elemente zurück, die in der Tabellenzeile verschachtelt sind. Die Elemente in dieser Sammlung sind in der Quellcodereihenfolge aufgeführt.
Beispiel
    var allRowCells = document.getElementById("myTR").cells;
Wert
Referenz auf ein cells-Sammlungsobjekt.
Standardwert
Array mit der Länge Null.

ch | NN 6 IE 5(Mac)/6(Win) DOM 1
| Lesen/Schreiben
Definiert das Textzeichen, das als Ausrichtungspunkt für die Textzellen der Zeile verwendet wird. Diese Eigenschaft ist normalerweise nur sinnvoll, wenn das align-Attribut auf "char" gesetzt ist. In der Praxis haben diese Eigenschaften weder in IE noch in Navigator irgendwelche Auswirkungen.
Beispiel
    document.getElementById("myTR").ch = ".";
Wert
Aus einem einzelnen Zeichen bestehende Zeichenfolge.
Standardwert
Keiner.

chOff | NN 6 IE 5(Mac)/6(Win) DOM 1
| Lesen/Schreiben
Definiert den Offset-Punkt, an dem das durch das char-Attribut angegebene Zeichen in einer Zelle erscheinen soll. In der Praxis haben diese Eigenschaften weder in IE noch in Navigator irgendwelche Auswirkungen.
Beispiel
    document.getElementById("myTR").chOff = "80%";
Wert
Anzahl der Pixel oder in Prozent angegebene relative Position (innerhalb der Zelle) in Form einer Zeichenfolge.
Standardwert
Keiner.

clientHeight, clientWidth | NN 7 IE 4 DOM nicht zutreffend
| Schreibgeschützt
Geben die Höhe und Breite des Elementinhalts zurück, jedoch mit geringfügigen Abweichungen hinsichtlich der Elementauffüllung bei den verschiedenen Betriebssystemversionen von IE und den verschiedenen von der DOCTYPE-Deklaration gesteuerten Kompatibilitätsmodi. In IE für Macintosh nicht für alle Elementtypen verfügbar. Bei Netscape 7 sind die Werte Null, es sei denn, der Inhalt eines Elements ragt über den sichtbaren Bereich hinaus, in welchem Fall die Werte die Abmessungen des sichtbaren Bereichs (beim Element document.body beispielsweise den Inhaltsbereich des Browserfensters) angeben. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels.
Beispiel
    var midHeight = document.body.clientHeight/2;
Wert
Ein Pixelwert als ganze Zahl.
Standardwert
0

height | NN nicht zutreffend IE 5 DOM nicht zutreffend
| Lesen/Schreiben
Legt die Höhe der Zeile in Pixel oder Prozent fest. Wenn Sie die Höhe einer Zeile dynamisch ändern möchten, sollten Sie anstelle der Eigenschaft height den style.height-Wert des Elements anpassen.
Wert
Anzahl von Pixel oder Prozentwert (innerhalb der Zeile) als Zeichenfolge.
Standardwert
Keiner.

focus( ) | NN 2 IE 3 DOM 1
Übergibt den Fokus an das aktuelle Objekt und löst damit das onfocus-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode focus( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen.
Um einem Textfeld den Fokus zuzuweisen und zugleich den in diesem Feld enthaltenen Text zu markieren, wenden Sie die Methoden focus( ) und select( ) nacheinander auf das Element an. Wenn dies unmittelbar nach einer Veränderung im Fenster geschehen soll (z. B. nachdem ein Wardialogfeld geschlossen wurde), stellen Sie die beiden Methoden in eine separate Funktion und rufen Sie diese im Anschluss an die alert( )-Methode des Dialogfelds über die Methode setTimeout( ) auf. Auf diese Weise können Sie gewährleisten, dass IE/Windows die Anweisungen in der richtigen Reihenfolge ausführt.
Parameter
Keine.
Zurückgegebener Wert
Keiner.

rowIndex | NN 6 IE 4 DOM 1
| Schreibgeschützt
Gibt eine auf Null basierende ganze Zahl zurück, mit der die Position der aktuellen Zeile unter allen anderen tr-Elementen in der gesamten Tabelle angegeben wird. Diese Zählung basiert auf der Quellcodereihenfolge der tr-Elemente.
Beispiel
    var whichRow = document.getElementById("myTR").rowIndex;
Wert
Eine ganze Zahl.
Standardwert
Keiner.

sectionRowIndex | NN 6 IE 4 DOM 1
| Schreibgeschützt
Gibt eine auf Null basierende ganze Zahl zurück, mit der die Position der aktuellen Zeile unter allen anderen tr-Elementen in der Zeilengruppe angegeben wird. Bei einer Zeilengruppe kann es sich um eines der folgenden Elemente handeln: thead, tbody, tfoot. Diese Zählung basiert auf der Quellcodereihenfolge der tr-Elemente.
Beispiel
    var whichRow = document.getElementById("myTR").sectionRowIndex;
Wert
Eine ganze Zahl.
Standardwert
Keiner.

vAlign | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Gibt die vertikale Ausrichtung des Textes innerhalb der Zellen der aktuellen Zeile an.
Beispiel
    document.getElementById("myTR").vAlign = "baseline";
Wert
Von der Groß-/Kleinschreibung unabhängige Konstante (als Zeichenfolge): baseline | bottom | middle | top.
Standardwert
middle

deleteCell( ) | NN 6 IE 4 DOM 1
deleteCell(index) |
Entfernt ein im aktuellen tr-Element verschachteltes td- oder th-Element. Der ganzzahlige Parameter verweist auf den auf Null basierenden Eintrag in der cells-Sammlung der Zeile.
Parameter
Auf Null basierende ganze Zahl, die dem numerierten td-Element in der Quellcodereihenfolge (verschachtelt im aktuellen Element) entspricht.
Zurückgegebener Wert
Keiner.

insertCell( ) | NN 6 IE 4(Win) DOM 1
insertCell(index) |
Fügt ein im aktuellen tr-Element verschachteltes td-Element ein. Der ganzzahlige Parameter verweist auf die auf Null basierende Indexposition in der cells-Sammlung, an der die neue Zelle eingefügt werden soll; in IE können Sie jedoch auch den Kurzschrift-Wert -1 verwenden, um die Zelle an das Ende der Sammlung anzuhängen. Beim Einfügen der Zelle wird ein leeres Element erzeugt, dem Sie mithilfe der verschiedenen Verfahren zur Modifizierung des Dokumentbaums Inhalte hinzufügen. Leider funktioniert das skriptgesteuerte Hinzufügen von Tabellenzeilen und -zellen in IE für den Macintosh (einschließlich Version 5.1) nur sehr fehlerhaft und erzeugt übermäßig große Zeilen und Zellen. Bei nicht verschachtelten Tabellen können Sie anstelle der an sich praktischeren Tabellenabschnitts-Objektmethoden unter Umständen auf die regulären Verfahren zum Erstellen und Einfügen von Nodes in den Dokumentbaum zurückgreifen.
Parameter
Auf Null basierende ganze Zahl, die einer Zeile in der cells-Sammlung entspricht, vor der die neue Zelle eingefügt werden soll.
Zurückgegebener Wert
Referenz auf die neu eingefügte Zelle.

focus( ) | NN 2 IE 3 DOM 1
Übergibt den Fokus an das aktuelle Objekt und löst damit das onfocus-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode focus( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen.
Um einem Textfeld den Fokus zuzuweisen und zugleich den in diesem Feld enthaltenen Text zu markieren, wenden Sie die Methoden focus( ) und select( ) nacheinander auf das Element an. Wenn dies unmittelbar nach einer Veränderung im Fenster geschehen soll (z. B. nachdem ein Wardialogfeld geschlossen wurde), stellen Sie die beiden Methoden in eine separate Funktion und rufen Sie diese im Anschluss an die alert( )-Methode des Dialogfelds über die Methode setTimeout( ) auf. Auf diese Weise können Sie gewährleisten, dass IE/Windows die Anweisungen in der richtigen Reihenfolge ausführt.
Parameter
Keine.
Zurückgegebener Wert
Keiner.