jQuery.print是一个用于打印页面特定部分的插件,下载地址为https://github.com/DoersGuild/jQuery.print
用法
导入jQuery后将其包含在HTML中,如:
<script type="text/JavaScript" src="path/to/jquery.print.js"></script>
调用打印方法的方式:
$("#myElementId").print(/*options*/);
或:
$.print("#myElementId" /*, options*/);
你可以在调用打印方法时传入一些参数:
$("#myElementId").print({
globalStyles: true,//是否应包含父文档中的样式
mediaPrint: false,//是否包含media='print'的链接标签。会被globalStyles选项覆盖,默认为false
stylesheet: null,//要包括的外部样式表的URL
noPrintSelector: ".no-print",//要从打印中排除的项目的选择器
iframe: true,//是否从iframe打印而不是弹出窗口;可以将jQuery-selector现有iframe作为值
append: null,//在选定内容之前(前置)或之后(追加)添加自定义HTML
prepend: null,//在选定内容之前(前置)或之后(追加)添加自定义HTML
manuallyCopyFormValues: true,//是否应将用户更新的表单输入值复制到打印的标记上
deferred: $.Deferred(),//一旦调用print函数就解析的jQuery.Deferred对象。可用于设置回调
timeout: 750,//在创建新窗口iframe之前更改等待内容等加载内容的最大时间量,如果新窗口iframe的load事件尚未触发,则作为后备
title: null,//更改打印的标题
doctype: '<!doctype html>'//将doctype添加到打印的文档框架中
});
以下为各个参数的详细用法:
globalStyles
默认:true
可接受的值:布尔值
功能:是否应包含父文档中的样式
stylesheet
默认:null
可接受的值:URL字符串
功能:要包括的外部样式表的URL
noPrintSelector
默认:".no-print"
可接受的值:任何有效jQuery-selector
功能:要从打印中排除的项目的选择器
iframe
默认值:true,如果传递no-vaild iframe选择器,则创建隐藏的iframe
可接受的值:任何有效jQuery-selector或布尔值
功能:是否从iframe打印而不是弹出窗口;可以将jQuery-selector现有iframe作为值
append/prepend
默认:null
可接受的值:任何有效jQuery-selector或HTML文本
功能:在选定内容之前(前置)或之后(追加)添加自定义HTML
manuallyCopyFormValues
默认:true
可接受的值:布尔值
功能:是否应将用户更新的表单输入值复制到打印的标记上(这可以通过手动迭代每个表单元素来完成)
deferred
默认:$.Deferred()
可接受的值:任何有效的jQuery.Deferred对象
功能:一旦调用print函数就解析的jQuery.Deferred对象。可用于设置回调
timeout
默认:750
可接受的值:以毫秒为单位的时间setTimeout
功能:在创建新窗口iframe之前更改等待内容等加载内容的最大时间量,如果新窗口iframe的load事件尚未触发,则作为后备
title
默认值:null,使用主页标题
可接受的值:任何单行字符串
功能:更改打印的标题
doctype
默认:<!doctype html>'
Acceptable-Values:任何有效的doctype字符串
功能:将doctype添加到打印的文档框架中