CSS2Properties

Eine Menge von CSS-Attributen und ihren Werten

---

Eigenschaften

String cssText

Die Textdarstellung eines Sets von Stilattributen und ihren Werten. Der Text wird wie in einem CSS-Stylesheet formatiert, ohne den Elementselektor und die geschwungenen Klammern, die die Attribute und Werte umgeben. Wenn Sie diese Eigenschaft auf einen unzulässigen Wert setzen, wird eine DOMException mit dem code SYNTAX_ERR ausgelöst. Ist das CSS2Properties-Objekt schreibgeschützt und Sie versuchen die Eigenschaft zu setzen, so wird eine DOMException mit einem code von NO_MODIFICATION_ALLOWED_ERR ausgelöst.

Zusätzlich zur cssText-Eigenschaft hat ein CSS2Properties-Objekt auch eine Eigenschaft für jedes CSS-Attribut, das vom Browser unterstützt wird. Diese Eigenschaftsnamen sind eng an die CSS-Attributnamen angelehnt. Geringfügige Abweichungen dienen nur zur Vermeidung von Syntaxfehlern in JavaScript. Attribute, die aus mehreren Wörtern bestehen und Bindestriche enthalten (z.B. »font-family«), werden in JavaScript ohne Bindestriche geschrieben, und jedes Wort hinter dem ersten beginnt mit einem Großbuchstaben: fontFamily. Da auch das Attribut »float« mit dem reservierten Wort float in Konflikt steht, wird es als Eigenschaft cssFloat übersetzt.

Die CSS2Properties-Eigenschaftsnamen, die den jeweiligen von der CSS2-Spezifikation definierten Attributen entsprechen, werden in der nachfolgenden Tabelle aufgeführt. Beachten Sie jedoch, dass manche Browser nicht alle CSS-Attribute unterstützen und möglicherweise nicht alle aufgeführten Eigenschaften implementieren. Da die Eigenschaften direkt den CSS-Attributen entsprechen, werden sie hier nicht einzeln dokumentiert. Angaben zur Bedeutung und zu den zulässigen Werten einzelner Eigenschaften entnehmen Sie bitte einer CSS-Referenz, wie z.B. CSS - Das umfassende Handbuch von Eric A. Meyer (O'Reilly Verlag). Alle Eigenschaften sind Strings. Das Setzen einer beliebigen dieser Eigenschaften kann die gleichen Exceptions auslösen wie das Setzen der cssText-Eigenschaft:

azimuth	background	backgroundAttachment	backgroundColor
backgroundImage	backgroundPosition	backgroundRepeat	border
borderBottom	borderBottomColor	borderBottomStyle	borderBottomWidth
borderCollapse	borderColor	borderLeft	borderLeftColor
borderLeftStyle	borderLeftWidth	borderRight	borderRightColor
borderRightStyle	borderRightWidth	borderSpacing	borderStyle
borderTop	borderTopColor	borderTopStyle	borderTopWidth
borderWidth	bottom	captionSide	clear
clip	color	content	counterIncrement
counterReset	cssFloat	cue	cueAfter
cueBefore	cursor	direction	display
elevation	emptyCells	font	fontFamily
fontSize	fontSizeAdjust	fontStretch	fontStyle
fontVariant	fontWeight	height	left
letterSpacing	lineHeight	listStyle	listStyleImage
listStylePosition	listStyleType	margin	marginBottom
marginLeft	marginRight	marginTop	markerOffset
marks	maxHeight	maxWidth	minHeight
minWidth	orphans	outline	outlineColor
outlineStyle	outlineWidth	overflow	padding
paddingBottom	paddingLeft	paddingRight	paddingTop
page	pageBreakAfter	pageBreakBefore	pageBreakInside
pause	pauseAfter	pauseBefore	pitch
pitchRange	playDuring	position	quotes
richness	right	size	speak
speakHeader	speakNumeral	speakPunctuation	speechRate
stress	tableLayout	textAlign	textDecoration
textIndent	textShadow	textTransform	top
unicodeBidi	verticalAlign	visibility	voiceFamily
volume	whiteSpace	widows	width
wordSpacing	zIndex

Beschreibung

Das Interface CSS2Properties stellt ein Set von CSS-Stilattributen und ihren Werten dar. Es definiert für jedes von der CSS2-Spezifikation definierte CSS-Attribut eine JavaScript-Eigenschaft. Die style-Eigenschaft eines HTMLElements und die style-Eigenschaft eines CSSRule-Objekts sind les- und schreibbare CSS2Properties-Objekte. Der Rückgabewert von Window.getComputedStyle( ) ist aber ein CSS2Properties-Objekt, dessen Eigenschaften schreibgeschützt sind.

Siehe auch

CSSRule, HTMLElement, Window.getComputedStyle( ); Kapitel 16