RUBY 元素 | ruby 對象

指明要放置在文本串之上或內嵌的注解或發(fā)音指南。

成員表

下面的表格列出了 ruby 對象引出的成員。請單擊左側的標簽來選擇你想要查看的成員類型。

標簽屬性/屬性

標簽屬性	屬性	描述
ACCESSKEY	accessKey	設置或獲取對象的快捷鍵。
ATOMICSELECTION		指定元素及其內容是否可以一不可見單位統(tǒng)一選擇。
	canHaveHTML	獲取表明對象是否可以包含豐富的 HTML 標簽的值。
CLASS	className	設置或獲取對象的類。
CONTENTEDITABLE	contentEditable	設置或獲取表明用戶是否可編輯對象內容的字符串。
DIR	dir	設置或獲取對象的閱讀順序。
DISABLED	disabled	設置或獲取控件的狀態(tài)。
HIDEFOCUS	hideFocus	設置或獲取表明對象是否顯式標明焦點的值。
ID	id	獲取標識對象的字符串。
	innerHTML	設置或獲取位于對象起始和結束標簽內的 HTML。
	innerText	設置或獲取位于對象起始和結束標簽內的文本。
	isContentEditable	獲取表明用戶是否可編輯對象內容的值。
	isDisabled	獲取表明用戶是否可與該對象交互的值。
	isMultiLine	獲取表明對象的內容是包含一行還是多行的值。
LANG	lang	設置或獲取要使用的語言。
LANGUAGE	language	設置或獲取當前腳本編寫用的語言。
NAME	name	設置或獲取對象的名稱。
	offsetHeight	獲取對象相對于版面或由父坐標 offsetParent 屬性指定的父坐標的高度。
	offsetLeft	獲取對象相對于版面或由 offsetParent 屬性指定的父坐標的計算左側位置。
	offsetParent	獲取定義對象 offsetTop 和 offsetLeft 屬性的容器對象的引用。
	offsetTop	獲取對象相對于版面或由 offsetTop 屬性指定的父坐標的計算頂端位置。
	offsetWidth	獲取對象相對于版面或由父坐標 offsetParent 屬性指定的父坐標的寬度。
	outerHTML	設置或獲取對象及其內容的 HTML 形式。
	outerText	設置或獲取對象的文本。
	parentElement	獲取對象層次中的父對象。
	readyState	獲取對象的當前狀態(tài)。
	scopeName	獲取為該元素定義的命名空間。
STYLE		為該設置元素設置內嵌樣式。
TABINDEX	tabIndex	設置或獲取定義對象的 Tab 順序的索引。
	tagName	獲取對象的標簽名稱。
	tagUrn	設置或獲取在命名空間聲明中指定的統(tǒng)一資源名稱(URN)。
TITLE	title	設置或獲取對象的咨詢信息(工具提示)。
UNSELECTABLE		指定該元素不可被選中。

行為

行為	描述
clientCaps	提供關于 Internet Explorer 支持的特性的信息，以及提供即用即裝的方法。
download	下載文件并在下載完成后通知一個指定的回調函數(shù)。
homePage	包含關于用戶主頁的信息。

集合

集合	描述
behaviorUrns	返回標識附加到該元素行為的統(tǒng)一資源名稱(URN)字符串的集合。
children	獲取作為對象直接后代的 DHTML 對象的集合。
filters	獲取應用于對象的濾鏡集合。

事件

事件	描述
onactivate	當對象設置為活動元素時觸發(fā)。
onafterupdate	當成功更新數(shù)據(jù)源對象中的關聯(lián)對象后在數(shù)據(jù)綁定對象上觸發(fā)。
onbeforeactivate	對象要被設置為當前元素前立即觸發(fā)。
onbeforecut	當選中區(qū)從文檔中刪除之前在源對象觸發(fā)。
onbeforedeactivate	在 activeElement 從當前對象變?yōu)楦肝臋n其它對象之前立即觸發(fā)。
onbeforeeditfocus	在包含于可編輯元素內的對象進入用戶界面激活狀態(tài)前或可編輯容器變成控件選中區(qū)前觸發(fā)。
onbeforepaste	在選中區(qū)從系統(tǒng)剪貼板粘貼到文檔前在目標對象上觸發(fā)。
onbeforeupdate	當成功更新數(shù)據(jù)源對象中的關聯(lián)對象前在數(shù)據(jù)綁定對象上觸發(fā)。
onblur	在對象失去輸入焦點時觸發(fā)。
onclick	在用戶用鼠標左鍵單擊對象時觸發(fā)。
oncontextmenu	在用戶使用鼠標右鍵單擊客戶區(qū)打開上下文菜單時觸發(fā)。
oncontrolselect	當用戶將要對該對象制作一個控件選中區(qū)時觸發(fā)。
oncut	當對象或選中區(qū)從文檔中刪除并添加到系統(tǒng)剪貼板上時在源元素上觸發(fā)。
ondblclick	當用戶雙擊對象時觸發(fā)。
ondeactivate	當 activeElement 從當前對象變?yōu)楦肝臋n其它對象時觸發(fā)。
ondragstart	當用戶開始拖曳文本選中區(qū)或選中對象時在源對象上觸發(fā)。
onerrorupdate	更新數(shù)據(jù)源對象中的關聯(lián)數(shù)據(jù)出錯時在數(shù)據(jù)綁定對象上觸發(fā)。
onfilterchange	當可視濾鏡更改狀態(tài)或完成轉換時觸發(fā)。
onfocus	當對象獲得焦點時觸發(fā)。
onfocusin	當元素將要被設置為焦點之前觸發(fā)。
onfocusout	在移動焦點到其它元素之后立即觸發(fā)于當前擁有焦點的元素上觸發(fā)。
onhelp	當用戶在瀏覽器為當前窗口時按 F1 鍵時觸發(fā)。
onkeydown	當用戶按下鍵盤按鍵時觸發(fā)。
onkeypress	當用戶按下字面鍵時觸發(fā)。
onkeyup	當用戶釋放鍵盤按鍵時觸發(fā)。
onmousedown	當用戶用任何鼠標按鈕單擊對象時觸發(fā)。
onmouseenter	當用戶將鼠標指針移動到對象內時觸發(fā)。
onmouseleave	當用戶將鼠標指針移出對象邊界時觸發(fā)。
onmousemove	當用戶將鼠標劃過對象時觸發(fā)。
onmouseout	當用戶將鼠標指針移出對象邊界時觸發(fā)。
onmouseover	當用戶將鼠標指針移動到對象內時觸發(fā)。
onmouseup	當用戶在鼠標位于對象之上時釋放鼠標按鈕時觸發(fā)。
onmousewheel	當鼠標滾輪按鈕旋轉時觸發(fā)。
onmove	當對象移動時觸發(fā)。
onmoveend	當對象停止移動時觸發(fā)。
onmovestart	當對象開始移動時觸發(fā)。
onpaste	當用戶粘貼數(shù)據(jù)以便從系統(tǒng)剪貼板向文檔傳送數(shù)據(jù)時在目標對象上觸發(fā)。
onreadystatechange	當對象狀態(tài)變更時觸發(fā)。
onresizeend	當用戶更改完控件選中區(qū)中對象的尺寸時觸發(fā)。
onresizestart	當用戶開始更改控件選中區(qū)中對象的尺寸時觸發(fā)。
onselectstart	對象將要被選中時觸發(fā)。

濾鏡

濾鏡屬性	描述
Alpha	調整對象內容的不透明度。
AlphaImageLoader	在對象的邊界和對象背景到內容之間顯示圖像，可選剪裁或縮放圖像大小。當裝入便攜網(wǎng)絡圖像(PNG)時，從 0 到 100% 的 透明度都是支持的。
Barn	以開門或關門的運動方式顯示對象的新內容。
BasicImage	調整對象內容的顏色處理、圖像旋轉或不透明度。
BlendTrans	以漸隱原始內容的形式顯示對象的新內容。
Blinds	以打開或關閉盲點的運動方式顯示對象的新內容。
Blur	模糊對象的內容以便使其看起來失去焦點。
CheckerBoard	以揭開覆蓋在原始內容上的棋盤的形式顯示對象的新內容。
Chroma	將對象內容的指定顏色顯示為透明。
Compositor	以新舊內容邏輯顏色組合的形式顯示對象的新內容。每個版本的顏色和 alpha 值都會被計算用來決定輸出圖像的最終顏色。
DropShadow	創(chuàng)建對象內容的實體陰影，偏移量位于指定方向。這將使得內容看起來是浮動的因此會產(chǎn)生陰影。
Emboss	使用灰度值對對象以浮雕紋理顯示。
Engrave	使用灰度值對對象以雕刻紋理顯示。
Fade	以漸隱原始內容的形式顯示對象的新內容。
FlipH	以沿水平方向翻轉的形式顯示對象內容。
FlipV	以沿垂直方向翻轉的形式顯示對象內容。
Glow	在對象邊緣外側添加光暈以便使其看起來像發(fā)光的樣子。
Gradient	在對象的背景和內容之間顯示一個漸變色彩的表面。
GradientWipe	以在原有內容上覆蓋漸變帶的形式顯示對象的新內容。
Gray	以灰度顯示對象內容。
ICMFilter	根據(jù)圖像顏色管理(ICM)配置文件轉換對象的彩色內容。這將允許指定內容的顯示效果得以改善，或者在打印機或監(jiān)視器等硬件設備上模擬顯示。
Inset	以對角線方向顯示對象的新內容。
Invert	反轉對象內容的色調、飽和度和亮度。
Iris	以彩虹效果顯示對象的新內容，這與照相機光圈打開相似。
Light	在對象的內容上創(chuàng)建燈光效果。
MaskFilter	將對象內容的透明像素顯示為彩色遮罩，將非透明像素顯示為透明。
Matrix	使用矩陣變換縮放、旋轉或顯現(xiàn)對象的內容。
MotionBlur	以運動模糊的效果顯示對象內容。
Pixelate	將對象的內容顯示為彩色方塊，其顏色取決于該方塊所替代區(qū)域的平均顏色值。此濾鏡顯示可用于切換。
RadialWipe	以輻射狀擦除的形式顯現(xiàn)對象的新內容。
RandomBars	以隨機像素線爆炸的形式顯現(xiàn)對象的新內容。
RandomDissolve	以隨機像素爆炸的形式顯現(xiàn)對象的新內容。
Redirect	目前還不支持。
RevealTrans	使用 24 種預先定義的切換效果顯現(xiàn)對象的新內容。
Shadow	創(chuàng)建對象內容的實體陰影，偏移量位于指定方向。這將創(chuàng)建陰影效果。
Slide	以圖像滑行的形式顯現(xiàn)對象的新內容。
Spiral	以螺旋運動的形式顯現(xiàn)對象的新內容。
Stretch	以拉伸覆蓋原始內容的形式顯現(xiàn)對象的新內容。有一個選項類似立方體從一個表面轉到另外一個表面。
Strips	以條形覆蓋的形式顯現(xiàn)對象的原始內容，好像有一把鋸將原始內容鋸開。
Wave	在對象的內容上執(zhí)行垂直方向的正弦波扭曲。
Wheel	以旋轉運動的形式顯現(xiàn)對象的新內容，好像輪子滾過原始內容。
Xray	更改對象內容的顏色深度將其以黑白顯示。
Zigzag	在對象上將對象的新內容進行來回移動以便覆蓋原始內容。

方法

方法	描述
addBehavior	給元素附加一個行為。
blur	使元素失去焦點并觸發(fā) onblur 事件。
componentFromPoint	通過特定事件返回對象在指定坐標下的位置。
fireEvent	觸發(fā)對象的指定事件。
focus	使得元素得到焦點并執(zhí)行由 onfocus 事件指定的代碼。
getAttributeNode	獲取由 attribute.name 屬性引用的 attribute 對象。
getExpression	獲取給定屬性的表達式。
normalize	合并鄰接 TextNode 對象以便生成一個常規(guī)的文檔對象模型。
removeAttributeNode	從對象中刪除刪除 attribute 對象。
removeBehavior	分離元素的行為。
removeExpression	從指定屬性中刪除表達式。
setActive	設置對象為當前對象而不將對象置為焦點。
setAttributeNode	設置 attribute 對象為對象的一部分。
setExpression	設置指定對象的表達式。

樣式

樣式標簽屬性	樣式屬性	描述
ACCELERATOR	accelerator	設置或獲取表明對象是否包含快捷鍵的字符串。
background-position-x	backgroundPositionX	設置或獲取 backgroundPosition 屬性的 x 坐標。
background-position-y	backgroundPositionY	設置或獲取 backgroundPosition 屬性的 y 坐標。
behavior	behavior	設置或獲取 DHTML 行為的位置。
clip	clip	設置或獲取定位對象的哪個部分可見。
cursor	cursor	設置或獲取當鼠標指針指向對象時所使用的鼠標指針。
direction	direction	設置或獲取對象的閱讀順序。
display	display	設置或獲取對象是否要渲染。
filter	filter	設置或獲取應用于對象的濾鏡或濾鏡集合。
height	height	設置或獲取對象的高度。
layout-flow	layoutFlow	設置或獲取對象內容的方向和繞排方向。
layout-grid	layoutGrid	設置或獲取指定文本字符版面的組合文檔格線屬性。
layout-grid-mode	layoutGridMode	設置或獲取文本布局網(wǎng)格是否使用二維。
overflow	overflow	設置或獲取表明當內容超出對象高度或寬度時如何管理對象內容的值。
overflow-x	overflowX	設置或獲取當內容超出對象寬度時如何管理對象內容。
overflow-y	overflowY	設置或獲取當內容超出對象高度時如何管理對象內容。
padding	padding	設置或獲取要在對象和其邊距或若存在的邊框的話就是對象和其邊框之間要插入的全部空間。
padding-bottom	paddingBottom	設置或獲取要在對象下邊框和內容之間插入的空間總量。
padding-left	paddingLeft	設置或獲取要在對象左邊框和內容之間插入的空間總量。
padding-right	paddingRight	設置或獲取要在對象右邊框和內容之間插入的空間總量。
padding-top	paddingTop	設置或獲取對象上邊框和內容之間插入的空間總量。
	pixelBottom	設置或獲取對象的下方位置。
	pixelHeight	設置或獲取對象的高度。
	pixelLeft	設置或獲取對象的左側位置。
	pixelRight	設置或獲取對象的右側位置。
	pixelTop	設置或獲取對象的上方位置。
	pixelWidth	設置或獲取對象的寬度。
	posBottom	設置或獲取以 bottom 標簽屬性指定的單位的對象下方位置。
	posHeight	設置或獲取以 height 標簽屬性指定的單位的對象高度。
position	position	設置或獲取對象所使用的定位方式。
	posLeft	設置或獲取以 left 標簽屬性指定的單位的對象左側位置。
	posRight	設置或獲取以 right 標簽屬性指定的單位的對象右側位置。
	posTop	設置或獲取以 top 標簽屬性指定的單位的對象上方位置。
	posWidth	設置或獲取以 width 標簽屬性指定的單位的對象寬度。
ruby-align	rubyAlign	設置或獲取由 rt 對象指定的注音文本的位置。
ruby-overhang	rubyOverhang	設置或獲取由 rt 對象指定的注音文本的位置。
ruby-position	rubyPosition	設置或獲取由 rt 對象指定的注音文本的位置。
float	styleFloat	設置或獲取文本要繞排到對象的哪一側。
text-autospace	textAutospace	設置或獲取自動留空和文本的窄空間寬度調整。
text-overflow	textOverflow	設置或獲取表明是否顯示省略號以表明文本溢出的值。
text-underline-position	textUnderlinePosition	設置或獲取對象的 textDecoration 屬性中設置的下劃線的位置。
unicode-bidi	unicodeBidi	設置或獲取關于雙向法則的嵌入級別。
width	width	設置或獲取對象的寬度。
word-wrap	wordWrap	設置或獲取當內容超過其容器邊界時是否斷詞。
writing-mode	writingMode	設置或獲取對象內容的方向和繞排。
zoom	zoom	設置或獲取對象的放大比例。

注釋

注音文本就是一串文本的注解或發(fā)音指南。由 ruby 給出的文本就是基準文本。

RUBY 元素內唯一合法的對象就是 RT 元素。不包含在注音文本對象 RT 內的文本將被認為是基準文本的一部分。

此元素在 Microsoft^® Internet Explorer 5.0 的 HTML 和腳本中可用。

此元素是內嵌元素。

此元素需要關閉標簽。

示例

下面的例子使用了 RUBY 元素指定了第一串文本為基準文本，使用了 RT 元素指定了第二串文本為注音文本。

<RUBY>
基準文本
<RT>注音文本
</RUBY>

此特性需要 Microsoft^® Internet Explorer 5 或以后版本。請單擊下面的圖標安裝最新版本。然后重新裝入此頁再查看示例。

標準信息

此對象是對 HTML 建議附加的一部分。

參看

rt