currentStyle 对象

代表了在全局样式表、内嵌样式和 HTML 标签属性中指定的对象格式和样式。

成员表

下面的表格列出了 currentStyle 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。

属性

SHOW: 属性 方法 样式 属性 描述 blockDirection 获取表明块元素内容的绕排方向的值，是由左至右，还是由右至左。 clipBottom 获取对象剪裁区域的底边坐标。 clipLeft 获取对象剪裁区域的左边坐标。 clipRight 获取对象剪裁区域的右边坐标。 clipTop 获取对象剪裁区域的顶边坐标。 onOffBehavior 获取表明指定的 Microsoft® DirectAnimation® 行为是否正在运行的对象。

属性

方法

方法	描述
getAttribute	获取指定标签属性的值。
getExpression	获取给定属性的表达式。
setAttribute	设置指定标签属性的值。
setExpression	设置指定对象的表达式。

样式

样式标签属性	样式属性	描述
ACCELERATOR	accelerator	获取表明对象是否包含快捷键的字符串。
background-attachment	backgroundAttachment	设置或获取背景图像如何附加到文档内的对象中。
background-color	backgroundColor	设置或获取对象内容后的颜色。
background-image	backgroundImage	设置或获取对象的背景图像。
background-position-x	backgroundPositionX	设置或获取 backgroundPosition 属性的 x 坐标。
background-position-y	backgroundPositionY	设置或获取 backgroundPosition 属性的 y 坐标。
background-repeat	backgroundRepeat	设置或获取对象的 backgroundImage 属性如何平铺。
behavior	behavior	设置或获取 DHTML 行为的位置。
border-bottom-color	borderBottomColor	设置或获取对象下边框的颜色。
border-bottom-style	borderBottomStyle	设置或获取对象下边框的样式。
border-bottom-width	borderBottomWidth	设置或获取对象下边框的宽度。
border-collapse	borderCollapse	设置或获取表明表格行和单元格边框是组合为单一边框还是像标准 HTML 那样分离。
border-color	borderColor	设置或获取对象的边框颜色。
border-left-color	borderLeftColor	设置或获取对象左边框的颜色。
border-left-style	borderLeftStyle	设置或获取对象左边框的样式。
border-left-width	borderLeftWidth	设置或获取对象左边框的宽度。
border-right-color	borderRightColor	设置或获取对象右边框的颜色。
border-right-style	borderRightStyle	设置或获取对象右边框的样式。
border-right-width	borderRightWidth	设置或获取对象右边框的宽度。
border-style	borderStyle	设置或获取对象上下左右边框的样式。
border-top-color	borderTopColor	设置或获取对象上边框的颜色。
border-top-style	borderTopStyle	设置或获取对象上边框的样式。
border-top-width	borderTopWidth	设置或获取对象上边框的宽度。
border-width	borderWidth	设置或获取对象上下左右边框的宽度。
bottom	bottom	设置或获取对象相对于文档层次中下个定位对象的底部的位置。
clear	clear	设置或获取对象是否允许在其左侧、右侧或两边放置浮动对象，以防下段文本显示在浮动对象上。
color	color	设置或获取对象文本的颜色。
cursor	cursor	设置或获取当鼠标指针指向对象时所使用的鼠标指针。
direction	direction	设置或获取对象的阅读顺序。
display	display	设置或获取对象是否要渲染。
font-family	fontFamily	设置或获取对象文本所使用的字体名称。
font-size	fontSize	设置或获取对象文本使用的字体大小。
font-style	fontStyle	设置或获取对象的字体样式，如斜体、常规或倾斜。
font-variant	fontVariant	设置或获取对象文本是否以小型大写字母显示。
font-weight	fontWeight	设置或获取对象的字体宽度。
	hasLayout	获取表明对象是否有布局的值。
height	height	设置或获取对象的高度。
ime-mode	imeMode	获取输入方法编辑器(IME)的状态。
layout-flow	layoutFlow	设置或获取对象内容的方向和绕排方向。
layout-grid-char	layoutGridChar	设置或获取用于渲染元素文本内容的字符网格大小。
layout-grid-line	layoutGridLine	设置或获取用于渲染元素文本内容的网格线值。
layout-grid-mode	layoutGridMode	设置或获取文本布局网格是否使用二维。
layout-grid-type	layoutGridType	设置或获取用于渲染元素文本内容的网格类型。
left	left	设置或获取对象相对于文档层次中下个定位对象的左边界的位置。
letter-spacing	letterSpacing	设置或获取对象的字符间附加空间的总和。
line-break	lineBreak	设置或获取日本文本的换行规则。
line-height	lineHeight	设置或获取对象两行间的距离。
list-style-image	listStyleImage	获取要为对象应用的列表项目符号的图像。
list-style-position	listStylePosition	获取相对于对象内容如何绘制项目符号。
list-style-type	listStyleType	获取对象预定义的项目符号类型。
margin	margin	设置或获取对象的上下左右边距。
margin-bottom	marginBottom	设置或获取对象的下边距宽度。
margin-left	marginLeft	设置或获取对象的左边距宽度。
margin-right	marginRight	设置或获取对象的右边距宽度。
margin-top	marginTop	设置或获取对象的上边距宽度。
min-height	minHeight	设置或获取元素的最小高度。
overflow	overflow	设置或获取表明当内容超出对象高度或宽度时如何管理对象内容的值。
overflow-x	overflowX	设置或获取当内容超出对象宽度时如何管理对象内容。
overflow-y	overflowY	设置或获取当内容超出对象高度时如何管理对象内容。
padding	padding	设置或获取要在对象和其边距或若存在的边框的话就是对象和其边框之间要插入的全部空间。
padding-bottom	paddingBottom	设置或获取要在对象下边框和内容之间插入的空间总量。
padding-left	paddingLeft	设置或获取要在对象左边框和内容之间插入的空间总量。
padding-right	paddingRight	设置或获取要在对象右边框和内容之间插入的空间总量。
padding-top	paddingTop	设置或获取对象上边框和内容之间插入的空间总量。
page-break-after	pageBreakAfter	设置或获取表明对象后发生换页的字符串。
page-break-before	pageBreakBefore	设置或获取表明对象前发生换页的字符串。
position	position	设置或获取对象所使用的定位方式。
right	right	设置或获取对象相对于文档层次中下个已定位的对象的右边界的位置。
ruby-align	rubyAlign	获取由 RT 对象指定的注音文本的位置。
ruby-overhang	rubyOverhang	获取由 RT 对象指定的注音文本的位置。
ruby-position	rubyPosition	获取由 RT 对象指定的注音文本的位置。
scrollbar-3dlight-color	scrollbar3dLightColor	设置或获取滚动条上滚动按钮和滚动滑块的左上颜色。
scrollbar-arrow-color	scrollbarArrowColor	设置或获取滚动箭头标识的颜色。
scrollbar-base-color	scrollbarBaseColor	设置或获取滚动条的主要颜色，其中包含滚动按钮和滚动滑块。
scrollbar-darkshadow-color	scrollbarDarkShadowColor	设置或获取滚动条上滑槽的颜色。
scrollbar-face-color	scrollbarFaceColor	设置或获取滚动条和滚动条的滚动箭头的颜色。
scrollbar-highlight-color	scrollbarHighlightColor	设置或获取滚动框和滚动条滚动箭头的左上边缘颜色。
scrollbar-shadow-color	scrollbarShadowColor	设置或获取滚动框和滚动条滚动箭头的右下边缘颜色。
scrollbar-track-color	scrollbarTrackColor	设置或获取滚动条轨迹元素的颜色。
float	styleFloat	设置或获取文本要绕排到对象的哪一侧。
table-layout	tableLayout	获取表明表格布局是否固定的字符串。
text-align	textAlign	设置或获取对象中的文本是左对齐、右对齐、居中对齐还是两端对齐。
text-align-last	textAlignLast	设置或获取如何排列对象的最后一行或仅有的一行。
text-autospace	textAutospace	设置或获取自动留空和文本的窄空间宽度调整。
text-decoration	textDecoration	设置或获取对象中的文本是否有闪烁、删除线、上划线或下划线的样式。
text-indent	textIndent	设置或获取对象中文本的缩进。
text-justify	textJustify	设置或获取对象内的文本所使用的对齐类型。
text-kashida-space	textKashidaSpace	设置或获取对象内文本对齐行时所使用空白扩展的 kashida 扩展的倍率。
text-overflow	textOverflow	设置或获取表明是否显示省略号以表明文本溢出的值。
text-transform	textTransform	设置或获取对象中文本的渲染方式。
text-underline-position	textUnderlinePosition	设置或获取对象的 textDecoration 属性中设置的下划线的位置。
top	top	设置或获取对象相对于文档层次中下个定位对象的上边界的位置。
unicode-bidi	unicodeBidi	设置或获取关于双向法则的嵌入级别。
vertical-align	verticalAlign	设置或获取对象的垂直排列。
visibility	visibility	设置或获取对象的内容是否显示。
white-space	whiteSpace	设置或获取对象中是否自动换行。
width	width	设置或获取对象的宽度。
word-break	wordBreak	设置或获取单词内的换行行为，特别是对象中出现多语言的情况。
word-spacing	wordSpacing	设置或获取对象中单词间的附加空间总量。
word-wrap	wordWrap	设置或获取当内容超过其容器边界时是否断词。
writing-mode	writingMode	设置或获取对象内容的方向和绕排。
z-index	zIndex	设置或获取定位对象的堆叠次序。
zoom	zoom	设置或获取对象的放大比例。

注释

currentStyle 对象返回了元素上的样式表，但是 style 对象只返回通过 STYLE 标签属性应用到元素的内嵌样式。因此，通过 currentStyle 对象获取的样式值可能与通过 style 对象获取的样式值不同。例如，如果段落的 color 属性值通过链接或嵌入样式表设置为红色( red )，而不是内嵌的话，对象.currentStyle.color 将返回正确的颜色，而对象 style.color 不能返回值。但是，如果用户指定了 <P STYLE="color:'red'">，currentStyle 和 STYLE 对象都将返回值 red。

currentStyle 对象反映了样式表中的样式优先顺序。在 HTML 中此顺序为：

1. 内嵌样式
2. 样式表规则
3. HTML 标签属性
4. HTML 标签的内部定义

 

从而，currentStyle 对象将为 bold 标签返回 fontWeight 值 normal，若在样式表中为此标签指定了 normal。

currentStyle 返回反映页面所应用的样式设置的值，但可能并不反映获取值时渲染所采用的值。例如，样式值设置为 "color:red; display:none" 的对象，将返回 currentStyle.color 为 red，尽管该对象并不在页面上渲染。也就是说，currentStyle 对象并不受渲染与否的绑定。在下面示例区的第三个例子演示了此行为。禁用的样式表也不影响 currentStyle 值。

返回值的单位与设置对象时的单位相同。例如，若对象的颜色是以内嵌 STYLE="color:'green'" 的格式设置的，那么 object.currentStyle.color 将返回 green 而不是 #00FF00 (与绿色相等的红绿蓝十六进制值)。但是，当 currentStyle 对象返回对象值的时候出现在作者所设置的对象值中的大写和多余的空白将被去掉。

currentStyle 对象支持用户自定义的样式规则属性。请参看示例区的第二个例子。

currentStyle 对象是异步的。这意味着样式不可能被设置后马上就能查询，而是返回旧值。因此，对于含有 addImport 这样方法的想要获得所期待的 currentStyle 行为的脚本，该脚本需要包含一个调用方法的函数和一个检查 currentStyle 的函数。对于需要在页面装载的时候检查当前属性的脚本，脚本必须等到 body 元素装入且页面被选然后，否则 currentStyle 的值可能不反映所显示的情况。

此对象在 Microsoft^® Internet Explorer 5 的脚本中可用。

示例

下面的例子使用 currentStyle 对象将文本颜色设置为棕色。如果你单击着色区域并且背景颜色与文本颜色相同，checkColor 函数就会更改背景颜色，以方便阅读文本。否则，该函数不做任何操作。

这个例子仅当主体和文本颜色同时使用颜色名称或 RGB 十六进制值时可用，混合使用时无效。

SHOWExample

<SCRIPT>
function checkColor(oObj)
{
if (oObj.currentStyle.backgroundColor == 'brown')
{
oObj.style.backgroundColor = 'white';
}
else
:
}
</SCRIPT>
</HEAD>
:
<P STYLE="background-color: 'brown'"
onclick="checkColor(this)">

Show Me

这个例子使用 currentStyle 对象获取创建于样式规则的用户自定义属性。alert 返回值 myvalue。

SHOWExample

<STYLE>
P { myproperty:myvalue }
</STYLE>
<BODY>
<P ID=oPrgrph>
:
<SCRIPT>
alert(oPrgrph.currentStyle.myproperty)
</SCRIPT>

Show Me

这个例子由 currentStyle 对象返回的 td 对象宽度是其层叠宽度值而不是屏幕上渲染的宽度值。