作为一个Flash版的上传组件，<w:swfUpload>除了提供Ajax方式的无页面刷新上传，还提供了文件多选、文件名过滤、文件大小限制等功能。
表 30.143. 构件信息
| Component Type | org.operamasks.faces.component.widget.UISwfUpload |
| Component Family | org.operamasks.faces.widget.SwfUpload |
| Component Class | org.operamasks.faces.component.widget.UISwfUpload |
| Tag Class | org.operamasks.faces.webapp.widget.UISwfUploadTag |
| Renderer Type | org.operamasks.faces.component.widget.UISwfUpload |
| Renderer Class(AJAX) | org.operamasks.faces.render.widget.ajax.AjaxSwfUploadRenderer |
+java.lang.Object
++javax.faces.component.UIComponent
+++javax.faces.component.UIComponentBase
++++org.operamasks.faces.component.widget.base.UISwfUploadBase
+++++org.operamasks.faces.component.widget.UISwfUpload
表 30.144. 属性
| autoUpload | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否在选择文件结束后自动上传文件，默认为false | ||||
| binding | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | javax.el.ValueExpression(javax.faces.component.UIComponent) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个值表达式，用于把该组件链接到一个ManagedBean的某个属性。 | ||||
| buttonHeight | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 浏览按钮的高度 | ||||
| buttonImage | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 选择文件按钮的图片 | ||||
| buttonText | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 选择文件按钮的文字 | ||||
| buttonTextLeftPadding | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 按钮文字的CSS的padding-left设置 | ||||
| buttonTextStyle | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 按钮文字的CSS风格 | ||||
| buttonTextTopPadding | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 按钮文字的CSS的padding-top设置 | ||||
| buttonWidth | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 浏览按钮的宽度 | ||||
| cancelImage | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 设置取消按钮的图片 | ||||
| customUI | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否自己定制UI，默认为false,如果设置为true将不显示"浏览"按钮下的"上传 | 清除"链接 | ||||
| enableHandCursor | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否启用手形的鼠标(鼠标移动到浏览按钮上显示的形状),默认为true | ||||
| enableQueryString | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否传递用户自定义添加的参数，默认为true | ||||
| fileQueueLimit | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件队列限制 | ||||
| fileSizeLimitMessage | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件过大的错误信息 | ||||
| fileSizeMax | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 允许上传的文件的最大值，比如10MB, 10KB. | ||||
| fileTypes | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 允许上传的文件类型, 多个文件类型以分号隔开，如"*.jpg;*.png;*.gif" | ||||
| fileTypesDescription | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件类型的描述 | ||||
| fileUploadLimit | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件上传总数限制 | ||||
| id | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内，必须是唯一的。 | ||||
| initConfig | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 初始化配置 | ||||
| invalidFileTypeMessage | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件类型错误的提示信息 | ||||
| jsvar | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件的客户端Javascript变量 | ||||
| onalluploadcomplete | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 在队列的所有上传都结束之后执行的JavaScript代码 | ||||
| onclearqueue | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 清除队列时执行的JavaScript代码 | ||||
| ondialogcomplete | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 选择文件对话框结束时执行的JavaScript代码 | ||||
| ondialogstart | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 选择文件对话框打开时执行的JavaScript代码 | ||||
| onfilequeue | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件进入队列时执行的JavaScript代码 | ||||
| onflashready | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 在Flash已被加载完成后触发，此时可安全调用 SwfUpload 的方法 | ||||
| onqueueerror | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件进入队列错误时执行的JavaScript代码 | ||||
| onuploadcomplete | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 每个文件上传结束时执行的JavaScript代码 | ||||
| onuploaderror | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件上传错误时执行的JavaScript代码 | ||||
| onuploadprogress | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 每次更新文件上传进度时执行的JavaScript代码 | ||||
| onuploadstart | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 开始上传时执行的JavaScript代码 | ||||
| onuploadsuccess | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 每个文件上传成功时执行的JavaScript代码 | ||||
| originalButtonTextSetting | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否采用原始的选择文件按钮的设置，默认为false，与 buttonTextStyle 等属性合作使用 | ||||
| queueLimitMessage | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 队列超过设置的最大值的错误信息 | ||||
| rendered | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | boolean(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个标志，指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。 | ||||
| savePath | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件上传后保存到服务器的路径，用于简单上传 | ||||
| showProgress | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否显示进度条，默认为true | ||||
| swfUploadListener | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 处理文件上传的方法 | ||||
| zeroByteFileMessage | 定义类 | org.operamasks.faces.component.widget.UISwfUpload | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 文件只有0比特的错误信息 | ||||