在 canvas 中，TextMetrics 接口表示文本的尺寸，通过 CanvasRenderingContext2D.measureText() 方法创建。

  TextMetrics() 继承层次

Object.prototype 　Function.prototype  　　TextMetrics

构造函数

程序不能直接调用该构造函数，否则将会产生异常。

属性列表 属性说明-- 方法列表 语法说明-- TextMetrics.prototype 继承层次

Object.prototype 　TextMetrics.prototype

属性列表 属性说明width只读,double 类型，使用 CSS 像素计算的内联字符串的宽度。基于当前上下文字体考虑。actualBoundingBoxLeft只读,double 类型，平行于基线，从 CanvasRenderingContext2D.textAlign 属性确定的对齐点到文本矩形边界左侧的距离，使用 CSS 像素计算。actualBoundingBoxRight只读,double 类型，平行于基线，从 CanvasRenderingContext2D.textAlign 属性确定的对齐点到文本矩形边界右侧的距离，使用 CSS 像素计算。fontBoundingBoxAscent只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的所有字体的矩形最高边界顶部的距离，使用 CSS 像素计算。fontBoundingBoxDescent只读,double 类型，根据从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的所有字体的矩形边界顶部的距离，使用 CSS 像素计算。actualBoundingBoxAscent只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的矩形边界顶部的距离，使用 CSS 像素计算。actualBoundingBoxDescent只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到渲染文本的矩形边界底部的距离，使用 CSS 像素计算。emHeightAscent只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框中 em 方块顶部的距离，使用 CSS 像素计算。emHeightDescent只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框中 em 方块底部的距离，使用 CSS 像素计算。hangingBaseline只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 hanging 基线的距离，使用 CSS 像素计算。alphabeticBaseline只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 alphabetic 基线的距离，使用 CSS 像素计算。ideographicBaseline只读,double 类型，从 CanvasRenderingContext2D.textBaseline 属性标明的水平线到线框的 ideographic 基线的距离，使用 CSS 像素计算。 方法列表 语法说明-- TextMetrics实例

Object.prototype 　TextMetrics.prototype 　　TextMetrics 实例

参考

相关页面

Object

外部链接

TextMetrics-MDN

DOM简介

DOM(Document Object Model,文档对象模型)将XML/HTML文档构造成一个层次化的节点树,并提供了一系列的应用程序编程接口,以允许程序或脚本动态的访问和修改文档的内容、结构和样式。

内容结构

DOM由W3C进行了标准化,W3C DOM标准中立于平台和语言,分为以下3个部分：

核心DOM：针对结构化文档的标准模型XML DOM： 针对XML文档的标注模型HTML DOM：针对HTML文档的标准模型 标准化历史

DOM标准化的历史如下:

规范化前版本  由各个浏览器自行实现,这个阶段的DOM经常被称为DHTML(Dynamic HTML,动态HTML)DOM级别1规范  发布于1998年10月1日,专注于HTML和XML文档模型DOM级别2规范  发布于2000年11月13日,对DOM级别1添加了样式表对象模型和事件处理模型DOM级别3规范  从2004年开始陆续发布,对DOM级别2作了系列扩展 核心DOM

核心DOM定义了一个通用性的,以节点为基础的结构化文档模型,DOM文档模型中的所有内容都是节点,整个文档是一个文档根节点。

基本属性

节点的基本属性如下:

nodeType  获取节点的类型。例如 1代表元素节点,2代表属性节点,3代表文本节点,通常这三类节点使用的最为普遍.nodeName  获取节点的名称。如果节点是元素节点，则 nodeName属性返回标签名;如果节点是属性节点，则nodeName属性返回属性的名称;其他节点类型,nodeName属性将返回不同节点类型的不同名称。nodeValue  设置或返回节点的值。如果节点是元素节点或文档节点，nodeValue属性值为null;如果节点是属性节点，nodeValue代表属性的值;如果节点是文本节点，nodeValue代表节点的内容;如果节点是注释节点，nodeValue代表注释的内容 节点类型

核心DOM规范中定义了以下节点类型:

类型说明Type值子节点Document(文档节点)表示整个文档(DOM树的根节点)9Element(max.one) ProcessingInstruction Comment DocumentTypeElement(元素节点)表示标签元素1Text ProcessingInstruction Comment CDATASection EntityReferenceAttribute(属性节点)表示元素的属性2Text EntityReferenceText(文本节点)表示元素或属性中的文本内容3无CDATASection(CDATA区段节点)表示文档中的 CDATA 区段4无DocumentFragment(文档片段节点)表示轻量级的Document 对象11Text ProcessingInstruction Comment CDATASection EntityReferenceComment(注释节点)表示注释8无

其他还有几个，但一般不太用到，在此暂不列出。

节点层次

节点树中的节点彼此拥有层级关系:父节点(parent),子节点(child)和同胞节点(sibling)等。父节点拥有子节点,同级的子节点被称为同胞节点。 另外一部分节点如元素节点拥有属性节点. DOM规范为节点提供了以下诸多属性,以用于获取节点的层次关联信息。

属性说明childNodes获取当前节点的所有子节点(※1)firstChild获取当前节点的第一个子节点(※1)lastChild获取当前节点的最后一个子节点(※1)ownerDocument获取该节点的文档根节点，相当与documentparentNode获取当前节点的父节点previousSibling获取当前节点的前一个同级节点nextSibling获取当前节点的后一个同级节点attributes获取当前元素节点的所有属性节点集合(※2)※1 部分类型的节点如文本节点等没有子节点.※2 仅部分类型的节点如元素节点拥有属性 创建节点 方法说明document.write()这个方法可以把任意字符串插入到文档中document.createElement()创建一个元素节点node.appendChild()将新节点追加到子节点列表的末尾document.createTextNode()创建一个文本节点node.insertBefore()将新节点插入在前面node.replaceChild()将新节点替换旧节点node.cloneNode()复制节点node.removeChild()移除节点 HTML DOM

HTML DOM定义了一个HTML文档的文档对象模型。

HTML文档首先是一个XML文档,为简单起见,XML DOM部分也包含在HTML DOM里一并说明。

HTML文档的主要构成元素是各类HTML标签,HTML文档中的标签对应着元素节点。

元素属性

HTML元素的属性有attribute与property两个概念，这两个通常都被翻译成属性，但含义完全不一样。

attribute是HTML标签属性，设计期在文档中直接记述，运行期可以通过Node的接口方法getAttribute(name)和setAttribute(name,value)进行访问。attribute值只存在文字列类型。而property是JS对象属性，运行期象一般的JS对象访问一样直接元素进行操作。property值拥有各自不同的数据类型。

通常每个attribute都有一个同名的property，property可以看成是attribute的包装器，同时也对attribute值进行必要的类型转换。

HTML: <input id="input1" type="checkbox" checked= "checked"/> <input id="input2" type="checkbox" checked= "true"/> JavaScript: console.log(document.getElementById("input1").getAttribute("checked")); // checked console.log(document.getElementById("input1").checked); // true console.log(document.getElementById("input2").getAttribute("checked"); // true 元素事件 事件阶段(Event Phases)

当一个DOM事件被触发的时候，它并不只是在它的起源对象上触发一次，而是会经历以下三个不同的阶段:

捕获阶段  事件的第一个阶段是捕获阶段。事件从文档的根节点出发，随着DOM树的结构向事件的目标节点流去。途中经过各个层次的DOM节点，并在各节点上触发捕获事件，直到到达事件的目标节点。捕获阶段的主要任务是建立传播路径，在冒泡阶段，事件会通过这个路径回溯到文档跟节点。目标阶段  捕获阶段结束,即当事件到达目标节点后，事件就进入了目标阶段,事件在目标节点上被触发。冒泡阶段  事件在目标元素上触发后，并不在这个元素上终止。它会随着DOM树一层层向上冒泡，直到到达最外层的根节点。 事件处理

TODO:待编辑

事件分类

TODO:待编辑

元素样式

TODO:待编辑

视口

TODO:待编辑

使用FileReader对象，web应用程序可以异步的读取存储在用户计算机上的文件(或者原始数据缓冲)内容，可以使用File对象或者Blob对象来指定所要处理的文件或数据。其中File对象可以是来自用户在一个<input>元素上选择文件后返回的FileList对象，也可以来自拖放操作生成的 DataTransfer对象。

  FileReader() 继承层次

Object.prototype 　Function.prototype  　　EventTarget  　　　FileReader

构造函数 语法 new FileReader(); 参数 length  指定数组缓冲区的大小，以字节为单位返回值 一个实例化的拥有特定字节数的ArrayBuffer对象。它的每一个字节的值都是0。 属性列表 属性说明-- 方法列表 语法说明-- FileReader.prototype 继承层次

Object.prototype  　EventTarget.prototype  　　FileReader.prototype

属性列表

从其父级继承的属性请查阅: EventTarget。

属性说明error只读，在读取文件时发生的错误。readyState表明FileReader对象的当前状态. 值为State constants中的一个. 只读result读取到的文件内容.这个属性只在读取操作完成之后才有效,并且数据的格式取决于读取操作是由哪个方法发起的. 只读. 方法列表

从其父级继承的方法请查阅: EventTarget.

语法说明abort()中止该读取操作.在返回时,readyState属性的值为DONE.readAsArrayBuffer()开始读取指定的Blob对象或File对象中的内容. 当读取操作完成时,readyState属性的值会成为DONE,如果设置了onloadend事件处理程序,则调用之.同时,result属性中将包含一个ArrayBuffer对象以表示所读取文件的内容.readAsBinaryString()开始读取指定的Blob对象或File对象中的内容. 当读取操作完成时,readyState属性的值会成为DONE,如果设置了onloadend事件处理程序,则调用之.同时,result属性中将包含所读取文件的原始二进制数据.readAsDataURL()开始读取指定的Blob对象或File对象中的内容. 当读取操作完成时,readyState属性的值会成为DONE,如果设置了onloadend事件处理程序,则调用之.同时,result属性中将包含一个data: URL格式的字符串以表示所读取文件的内容.readAsText()开始读取指定的Blob对象或File对象中的内容. 当读取操作完成时,readyState属性的值会成为DONE,如果设置了onloadend事件处理程序,则调用之.同时,result属性中将包含一个字符串以表示所读取的文件内容. FileReader实例

Object.prototype  　EventTarget.prototype  　　FileReader.prototype 　　　FileReader 实例

参考

相关链接

ObjectEventTarget

外部链接

FileReader-MDN

Blob 对象是包含有只读原始数据的类文件对象。Blob 对象中的数据并不一定得是JavaScript 中的原生形式。File 接口基于 Blob，继承了 Blob 的功能,并且扩展支持用户计算机上的本地文件。

创建 Blob 对象的方法有几种，可以调用 Blob() 构造函数，还可以使用一个已有Blob对象上的 slice() 方法切出另一个 Blob 对象。想要从用户的文件里获取一个Blob对象，请参考File文档。

  Blob() 继承层次

Object.prototype 　
    Function.prototype 
　　Blob

构造函数

Blob(blobParts[, options])

返回一个新创建的 Blob 对象，其内容由参数中给定的数组串联组成。

语法 var b1 = new new Boolean(value) 参数 value 可选的Boolean对象的初始值.。 属性列表 名称语法説明sizeBlob.sizeBlob 对象中所包含数据的大小（字节）。typeBlob.type一个字符串，表明该Blob对象所包含数据的MIME类型。如果类型未知，则该值为空字符串。 方法列表 名称语法説明sliceBlob.slice([start[, end[, contentType]]])返回一个新的 Blob 对象，包含了源 Blob 对象中指定范围内的数据。 Blob.prototype 属性列表

无相应成员。

方法列表

无相应成员。

Blob实例 继承层次

Object.prototype 　Blob.prototype 　　Blob 实例

Blob构造函数用法举

Blob() 构造函数 允许用其它对象创建一个 Blob 对象。比如，用字符串构建一个 blob：

var debug = {hello: "world"}; var blob = new Blob([JSON.stringify(debug, null, 2)], {type : 'application/json'}); 使用类型数组和 Blob 创建一个 URL var typedArray = GetTheTypedArraySomehow(); // 传入一个合适的MIME类型 var blob = new Blob([typedArray], {type: "application/octet-binary"}); // 会产生一个类似blob:d3958f5c-0777-0845-9dcf-2cb28783acaf 这样的URL字符串 // 你可以像使用一个普通URL那样使用它，比如用在img.src上。 var url = URL.createObjectURL(blob); 从 Blob 中提取数据 var reader = new FileReader(); reader.addEventListener("loadend", function() { // reader.result contains the contents of blob as a typed array }); reader.readAsArrayBuffer(blob);

概述

DOM存储(Storage)API是通过sessionStorage对象和localStorage对象来实现的。通过这些对象，WEB应用程序能够把信息存储到客户端，并再以后需要的时候进行获取。

其中：

sessionStorage 
会话存储，其中的数据在页面会话结束时会被自动清除。页面会话在浏览器打开期间一直保持，并且重新加载或恢复页面仍会保持原来的页面会话。localStorage 
本地存储，其中的数据没有过期时间，在页面会话结束时不会被自动清除。

DOM存储与cookie的相同点：

提供了把数据保存到本地的能力，页面刷新或者关掉浏览器后，数据依然存在。只能存字符串数据。

DOM存储与cookie的不同点：

存储容量大。虽然不同浏览器的标准可能不一样，主流的一般都在5~10M，远超cookie的4k。数据不会自动发送到服务器，与cookie相比，节省带宽，加快响应速度 代码示例浏览器支持检测

通过以下代码可以事先检测浏览器是否支持本API。

if(window.Storage) { //支持此API } else { //不支持此API }

存取数据

使用本地DOM存储

var loSt = window.localStorage; loSt['username'] = 'hudao'; loSt.setItem('jobName', 'wrting'); console.log(loSt.length); //2 console.log(loSt.username + ' job is ' + loSt.jobName); //hudao job is wrting loSt['jobName'] = 'singer'; console.log(loSt.username + ' job is ' +loSt.jobName); //hudao job is singer delete loSt['jobName'];

使用会话DOM存储

sessionStorage.setItem('company', 'Hudao');

上面代码表示访问当前域名的会话DOM存储对象，并使用setItem()访问往里面添加一个数据条目。

//获得填充公司名称的文本输入框 var company = document.getElementByid('company'); //检测是否存在company键值 if(sessionStorage.getItem('company')) { //将文本框中的值设置成sessionStorage中的company键值 company.value = sessionStorage.getItem('company'); } //添加监听文本输入框的change事件 company.addEventListener("change", function(){ //将文本框的值保存到sessionStorage中的company键值 sessionStorage.setItem("company", company.value); }); 捕获存储异常 

不同的浏览器，分配给本地存储的空间是不一样的,该存储的空间是整个子域共享的。

如果当本地存储满了，再进行写数据，将会触发error，因此有时需要捕捉调用setItem()时的错误。

try{ localStorage.setItem('name', 'hudao'); }catch(e){ console.log('It's cant't write!'); } 清空存储

调用clear()方法将会清空整个域的数据，包括和当前页面共享一个存储空间的其他页面。

localStorage.clear(); sessionStorage.clear();

对象可以用来获取某个文件的信息,还可以用来读取这个文件的内容.通常情况下,File对象是来自用户在一个<input>元素上选择文件后返回的FileList对象,也可以是来自由拖放操作生成的 DataTransfer对象.

  File() 继承层次

Object.prototype
　Function.prototype
  　　Blob
  　　　File

构造函数

程序不能直接调用该构造函数，否则将会产生异常。

属性列表 属性说明-- 方法列表 语法说明-- File.prototype 继承层次

Object.prototype  　Blob.prototype  　　File.prototype

属性列表

从其父级继承的属性请查阅: Blob。

属性说明lastModifiedDate只读，jsval类型，当前File对象所引用文件最后修改时间。name只读，当前File对象所引用文件的文件名。size只读，当前File对象所引用文件的文件大小,单位为字节。type只读，当前File对象所引用文件的文件类型(MIME类型)。 方法列表

从其父级继承的方法请查阅: Blob.

语法说明-- File实例

Object.prototype  　Blob.prototype  　　File.prototype 　　　File 实例

参考

相关链接

ObjectBlob

外部链接

File-MDN

概述

drawImage方法将所给图片绘制到canvas。

使用方法 CanvasRenderingContext2D .drawImage(image, dx, dy)； CanvasRenderingContext2D .drawImage(image, dx, dy, dw, dh)； CanvasRenderingContext2D .drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh)； 参数说明 image：图形数据，可以是图像数据也可以是img标签。sx：从图形x轴坐标x处截取sy：从图形y轴坐标y处截取sw: 截取图形的宽sh：截取图形的高dx：从目标canvas的x轴x处绘制dy：从目标canvas的y轴y处绘制dw: 绘制的宽dh：绘制的高 代码示例

在todataurl一节中我们为GridFunny添加了一个toDataURL的方法，将canvas直接转换为图形数据， 本节中的示例，使用这个被转换的数据，并将其重新绘制到另一个canvas中：

// 为GridFunny添加一个clone方法 GridFunny.prototype.clone = function(options, callback) { if (!this._started) this.start(); var self = this, width = 300, height = 300, destGridW = this._canvasRatio("width", options.width || width) * this.pixelX, destGridH = this._canvasRatio("height", options.height || height) * this.pixelY, _opts = this._extendObject({ type: "image/png", opts: {}, width: width, height: height, sx: this.pixelX, sy: this.pixelY, sw: options.gridNum ? options.gridNum * this.pixelX : this.settings.canvasSize.width - this.pixelX * 2, sh: options.gridNum ? options.gridNum * this.pixelY : this.settings.canvasSize.height - this.pixelY * 2, dx: destGridW, dy: destGridH, dw: (options.width || width) - (destGridW * 2), dh: (options.width || width) - (destGridH * 2) }, options || {}); this.toDataURL(_opts.type, _opts.opts, function(canvas, data) { var image = new Image(); image.src = data; image.onload = function() { var _canvas = self._initCanvas(_opts.width, _opts.height), ctx = _canvas.getContext('2d'); ctx.drawImage(image, _opts.sx, _opts.sy, _opts.sw, _opts.sh, _opts.dx, _opts.dy, _opts.dw, _opts.dh) callback(_canvas); }; })； } // 调用 // 剪切三个格子 grid.clone({ gridNum: 3， width: 300, height: 300 }, function(canvas) { grid.settings.container.appendChild(canvas); }); // 全部复制 grid.clone({ width: 300, height: 300 }, function(canvas) { grid.settings.container.appendChild(canvas); });

clone参数：

gridNum：剪切的格子数，没有则为全部width：复制后canvas的宽height：复制和canvas的高(s|d)(x,y,w,h)：默认不传，则根据gridNum自动计算，有传值则根据所传值处理图片

代码的执行效果如下：

获取和设置HTML属性文本 var disabled = nodelib.attr(node,"disabled"); nodelib.attr(node,"disabled",""); 获取和设置DOM对象属性 var disabled = nodelib.prop(node,"disabled"); nodelib.prop(node,"disabled",false); 工具函数列表

uDOMlib所提供的工具函数之中，有一部分与元素属性相关，下面列出部分函数的源代码实现以供参考。

attr

获取或设置元素的attribute（HTML标签属性）值。

attr: function(node,name, value) { if (value === undefined){ if (typeof name === "object"){ for (var attr in name){ this.attr(node,attr,name[atrr]); } return this; } else { return node[name]; } } else { node[name] = value; return this; } } data

获取或设置元素给定名称的数据存储的值。

data: function(node,name, value) { var attrName = 'data-' + name.replace(capitalRE, "-$1").toLowerCase() if (value === undefined){ var data = this.attr(node,attrName,value); return data !== null ? deserializeValue(data) : undefined; } else { return this.attr(node,attrName,value); } } html

获取或设置元素的Html内容。 html()内部使用DOM节点的innerHTML属性，适用于任意HTML元素。

html: function(node,html) { if (html === undefined){ return node.innerHTML; } else { this.empty(node); node.innerHTML = html; //TODO:will be checkd return this; } } prop

获取或设置元素的property（特性）值。 prop()方法返回的是节点作为一个JavaScript对象所拥有的特性（property）值。 与attr()方法不同，prop()返回的值具有其本来的数据类型，如针对<input type=“checkbox”/>元素调用prop(“checked”),其返回值将是Boolean型的true或false。

prop: function(node,name, value) { name = propMap[name] || name; if (value === undefined){ return node[name]; } else { node[name] = value; return this; } } removeAttr removeAttr: function(node,name) { name.split(' ').forEach(function(attr) { setAttribute(node, attr); }); return this; } text

获取或设置元素的文本内容。 .text() 方法不能使用在input元素或scripts元素上。 input 或 textarea 需要使用 .val() 方法获取或设置文本值。得到scripts元素的值，使用.html()方法

text: function(node,text) { if (text === undefined){ return node.textContent; } else { node.textContent = text == null ? '' : '' + text return this; } } val

获取或设置元素的当前值。 val()方法主要适用于表单元素，如input, select 和 textarea。 如果select元素设置了multiple属性，.val()返回一个包含每个选择项值的数组

val: function(node,value) { if (value === undefined){ if (node.multiple) { // select multiple values var selectedOptions = this.find(node,"option").filter(function(){ return this.selected }); return this.pluck(selectedOptions,"value"); } else { return node.value; } } else { node.value = value; return this; } }