makePositioned
makePositioned(element) -> HTMLElement
该方法使你能够方便的创建 CSS 容器块(block),如果 element 的 CSS position 属性初始值为 'static' 或 undefined,它将设置 position 属性为 'relative'。该方法返回元素本身。
为恢复 element 原始的 CSS 位置,请使用 Element.undoPositioned。
样例
考虑一下以下的情形:
<p>lorem […]</p>
<div id="container">
<div id="element" style="position: absolute; top: 20px; left: 20px;"></div>
</div>
让 div#element 的位置 相对 于它的父节点:$('container...
getDimensions
getDimensions(element) -> {height: Number, width: Number}
获取 element 的 width 和 height,并返回一个对象,包括宽高的名值对。
通过内联的样式规则或者 CSS 样式表将元素的显示设置为 none 后,这个方法仍然返回元素本身所具有的尺寸,而不是返回 0。
为避免重复调用这个方法,可以考虑使用一个变量缓存返回的值,就像下面的示例一样。如果只是需要 element 的宽度或者高度,請使用 Element.getWidth 或 Element.getHeight 方法。
注意:所有返回值都仅有数字,单位为像素。
样例
<div id="rectangle" style="font-size: 10px; width: 20em; height: 10em"></div&...
clonePosition [1.6]
clonePosition(element, source[, options]) -> HTMLElement
从 source 中复制参数 options 指定的位置和/或尺寸的相关信息到 element。
注意:该方法根据 CSS containing block 的规则判定元素的位置信息是否相同,调用该方法后,target 和 source 的位置信息按照上述规则严格匹配。
选项
名称
默认值
描述
setLeft
true
克隆 source 的 CSS 属性 left 到 element。
setTop
true
克隆 source ...
undoPositioned(element) -> HTMLElement
设置 element 返回到在元素上应用 Element.makePositioned 方法之前的状态,返回元素本身。
对于 element 内具有绝对定位属性的子元素,调用该方法后,它们定位的基准位置将会更改为 element 最近的 CSS position 属性为 'absolute'、'relative' 或 'fixed' 的那个先代节点。
样例
<p>lorem […]</p>
<div id="container">
<div id="element" style="position: absolute; top: 20px; left: 20px;"></div>
</div>
$('container').makePositioned();
// -> HTMLElement
返回到初始布...
previousSiblings(element) -> [HTMLElement...]
返回 element 的所有前导兄弟节点,结果为一个数组,数组元素已经过 扩展。
如果两个元素有相同的父节点,则认为它们是兄弟节点,因此在样例中,head 和 body 是兄弟节点(它们的父节点都是 html)。前导兄弟节点可简单的看作文档中排在 elemnet 之前的兄弟节点。
返回的数组成员按照元素在页面中的顺序 反序 进行排列(例如:索引 0 表示距 element 最近的前导兄弟节点)。
注意:所有 Prototype 的 DOM 扩展方法均忽略文本节点,仅返回元素节点。
样例
<ul>
<li id="golden-delicious">Golden Delicious</li>
<li id="mutsu&qu...
previous(element[, cssRule][, index = 0]) -> HTMLElement | undefined
返回匹配 cssRule 指定规则的 element 的前一个兄弟节点(如果指定 index 参数,则返回第 index 个)。如果未指定 cssRule 参数,则默认匹配所有前导兄弟节点。 如果没有符合条件的节点,返回 undefined。
Element.previous 方法是 Prototype 最基本的 DOM 遍历工具之一(其余的还有 Element.up、 Element.down 和 Element.next,这些方法体现了 Prototype 良好的编程风格)。它允许基于索引和/或 CSS 规则对元素的前导兄弟节点进行精确选择。 (注意:如果两个元素有相同的父节点,则认为它们是兄弟节点,因此在样例中,head 和 body 是兄弟节...
positionedOffset(element) -> [Number, Number] 或 { left: Number, top: Number }
以 element 的容器块(Containing Block)节点(译注:距离元素最近的 CSS position 属性为 relative 或 absolute 的先代节点)为坐标原点,返回 element 的坐标偏移值(元素的容器块节点可通过 Element#getOffsetParent 方法获取)。
译注:假定返回值为 offset,则 X 轴坐标可通过 offset[0] 获取,也可以通过 offset.left 获取,Y 轴坐标可通过 offset[1] 获取,也可通过 offset.top 获取。
这个方法其实是累加元素及其所有父元素的 offsetLeft 和 offsetTop,直到其中一个元素的 CSS position 属性不等于 static(译注:static...
makePositioned(element) -> HTMLElement
该方法使你能够方便的创建 CSS 容器块(block),如果 element 的 CSS position 属性初始值为 'static' 或 undefined,它将设置 position 属性为 'relative'。该方法返回元素本身。
为恢复 element 原始的 CSS 位置,请使用 Element.undoPositioned。
样例
考虑一下以下的情形:
<p>lorem […]</p>
<div id="container">
<div id="element" style="position: absolute; top: 20px; left: 20px;"></div>
</div>
让 div#element 的位置 相对 于它的父节点:$('container').makePositione...
getDimensions(element) -> {height: Number, width: Number}
获取 element 的 width 和 height,并返回一个对象,包括宽高的名值对。
通过内联的样式规则或者 CSS 样式表将元素的显示设置为 none 后,这个方法仍然返回元素本身所具有的尺寸,而不是返回 0。
为避免重复调用这个方法,可以考虑使用一个变量缓存返回的值,就像下面的示例一样。如果只是需要 element 的宽度或者高度,請使用 Element.getWidth 或 Element.getHeight 方法。
注意:所有返回值都仅有数字,单位为像素。
样例
<div id="rectangle" style="font-size: 10px; width: 20em; height: 10em"></div>
var dimensions ...
clonePosition(element, source[, options]) -> HTMLElement
从 source 中复制参数 options 指定的位置和/或尺寸的相关信息到 element。
注意:该方法根据 CSS containing block 的规则判定元素的位置信息是否相同,调用该方法后,target 和 source 的位置信息按照上述规则严格匹配。
选项
名称
默认值
描述
setLeft
true
克隆 source 的 CSS 属性 left 到 element。
setTop
true
克隆 source 的 CSS 属性 top 到 elem...
new Ajax.PeriodicalUpdater(container, url[, options])周期性地执行一个 AJAX 请求并根据返回的响应文本更新指定容器的内容。它提供了一种“退化(decay)”机制 —— 当相邻两次请求的响应内容无变化时,会自动增加后续请求的时间间隔。
该对象解决了常见的要求进行周期性更新的需求,常被用于各种需要“轮询”机制的场合 (例如在线聊天室或在线邮件客户端)。
基本的思路是按照指定的时间间隔定时运行一个指定的 Ajax.Update,如果 decay 选项(请看下面)被激活,则监视响应的内容,并根据其是否变更来调整请求的时间间隔。
附加选项
Ajax.PeriodicalUpdater 支持所有的公用选项及...
在 Ajax 命名空间中的所有请求对象都共享一系列公共的选项和回调函数。 回调函数在请求生命周期的各个阶段被调用,并且它们具有相同的参数列表。在请求期间,参数所包括的选项被不断的传递到请求中。
公用选项
选项 默认值 描述
asynchronous true 指出 XMLHttpRequest 是否是异步的。因为同步的方式在某种程度上具有一定的不确定性, 通常不是一个好的选择,应尽量避免使用。
contentType 'application/x-www-form-urlencoded' 请求头部的 Content-Type(译注:form 元素的 enctype 属性)设置。可能你想要发送的内容是 XML 格式而不是常规的 URL 编码格式,这时,你就需要重新设置这个选项。
encoding 'UTF-8' 请...
<script src="prototype.js"></script>
<div id="div1" style="font-size:20px;font-weight:bold">
<hr>基线<hr>
</div>
<script>
new Insertion.After("div1", " After");
new Insertion.Bottom("div1", " Bottom");
new Insertion.Top("div1", " Top");
new Insertion.Before("div1", " Before");
</script>...
JavaScript中的Function对象是函数,函数的用途分为3类:
作为普通逻辑代码容器;
作为对象方法;
作为构造函数。
1.作为普通逻辑代码容器
function multiply(x, y){
return x*y;
}
函数multiply封装了两位数的乘法运算公式:
var product = multiply(128,128); // product = 16384
创建函数实例的方式有3种。第一种是声明式,即像声明变量一样,将通过function(){}标识符创建的匿名函数直接赋值给变量,以该变量作为调用时的函数名称:
var multiply = function(x, y){
return x*y;
}
第二种是定义式,即以function关键字后跟函数名称及(){}来直接定义命名函数,前面第一个multiply函数就是通过定义式创建的。...
返回所使用的 Scripting 引擎的生成版本号。
ScriptEngineBuildVersion()
说明
返回值直接依赖于所使用的 Scripting 语言的动态链接库 (DLL) 中包含的版本信息。
示例
下面的例子说明了 ScriptEngineBuildVersion 函数的用法:
function GetScriptEngineInfo(){
var s;
s = ""; // 根据必要的信息创建字符串。
s += ScriptEngine() + " Version ";
s += ScriptEngineMajorVersion() + ".";
s += ScriptEngineMinorVersion() + ".";
s += ScriptEngineBuildVersion();
return(s);
}...
返回所使用的 Scripting 引擎的主要版本号。
ScriptEngineMajorVersion()
说明
返回值直接依赖于所使用的 Scripting 语言的动态链接库 (DLL) 中包含的版本信息。
示例
下面的例子说明了 ScriptEngineMajorVersion 函数的用法:
function GetScriptEngineInfo(){
var s;
s = ""; // 根据必要的信息创建字符串。
s += ScriptEngine() + " Version ";
s += ScriptEngineMajorVersion() + ".";
s += ScriptEngineMinorVersion() + ".";
s += ScriptEngineBuildVersion();
return(s);
}...