currentStyle

HTML (DHTML)

COMMENT 元素 | comment 对象 CUSTOM 元素 | custom 对象 DHTML 对象

currentStyle 对象


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

成员表

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

属性

属性描述
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-heightMicrosoft® Internet Explorer 6 新增 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-overflowMicrosoft® Internet Explorer 6 新增 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'">,currentStyleSTYLE 对象都将返回值 red

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

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

从而,currentStyle 对象将为 bold 标签返回 fontWeightnormal,若在样式表中为此标签指定了 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 十六进制值时可用,混合使用时无效。

<SCRIPT>
function checkColor(oObj)
{
if (oObj.currentStyle.backgroundColor == 'brown')
{
oObj.style.backgroundColor = 'white';
}
else
:
}
</SCRIPT>
</HEAD>
:
<P STYLE="background-color: 'brown'"
onclick="checkColor(this)">
此特性需要 Microsoft® Internet Explorer 5.0 或以后版本。请单击下面的图标安装最新版本。然后重新装入此页再查看示例。

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

<STYLE>
P { myproperty:myvalue }
</STYLE>
<BODY>
<P ID=oPrgrph>
:
<SCRIPT>
alert(oPrgrph.currentStyle.myproperty)
</SCRIPT>
此特性需要 Microsoft® Internet Explorer 5.0 或以后版本。请单击下面的图标安装最新版本。然后重新装入此页再查看示例。

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

<BODY ID=oBdy>
:
<TABLE BORDER>
<TR><TD WIDTH=1100 ID=oTblD>text</TD></TR>
</TABLE>
:
<SCRIPT>
alert("TD 对象 currentStyle.width 为 " +
oTblD.currentStyle.width + ".\n" +
"窗口的宽度为 " + oBdy.clientWidth +
"px.\n屏幕的宽度为 " + screen.width + "px." )
</SCRIPT>
此特性需要 Microsoft® Internet Explorer 5.0 或以后版本。请单击下面的图标安装最新版本。然后重新装入此页再查看示例。

标准信息

没有应用于此对象的公共标准。

应用到

a, acronym, address, applet, b, bdo, big, blockQuote, body, br, button, caption, center, cite, code, col, colGroup, custom, dd, del, dfn, dir, div, dl, dt, em, embed, fieldSet, font, form, hn, html, i, img, input type=button, input type=checkbox, input type=file, input type=image, input type=password, input type=radio, input type=reset, input type=submit, input type=text, ins, isIndex, kbd, label, legend, li, listing, marquee, menu, noBr, object, ol, option, p, plainText, pre, q, s, samp, select, small, span, strike, strong, sub, sup, table, tBody, td, textArea, tFoot, th, tHead, tr, tt, u, ul, var, wbr, xmp

参看

style