The ice:dataExporter component can be used to export the data contents of an ice:dataTable component into a variety of formats.
The following three formats are supported by the component:
Attributes |
Name | Required | Request-time | Type | Description |
binding | false | false | java.lang.String | The value binding expression linking this component to a property in a backing bean |
clickToCreateFileText | false | false | java.lang.String | Note: This is deprecated as of 1.8.1. Specifying a value for this attribute will have no effect. |
for | false | false | java.lang.String | ID of the dataTable that this dataExporter component will export data from. |
id | false | false | java.lang.String | The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
ignorePagination | false | false | java.lang.String | This is false by default. If true the dataExporter will ignore the "first" and "rows" properties on the associated dataTable. |
image | false | false | java.lang.String | The URL of an image that will be rendered instead of the 'label' attribute text which the user can click on to initiate a data export download. When this attribute is specified, the 'label' text will be used for the 'title' and 'alt' text on the image element. |
includeColumns | false | false | java.lang.String | This attribute lets you define the order and number of columns that needs to be added to the generated output. It takes comma separated column indexes. Note that index starts with 0.
If there are 6 columns in the table and you want to add only 1st, 4th and 6th column to the generated output: <ice:dataExporter includeColumns="0,3,5"... > The column order of the above example can be changed a well: <ice:dataExporter includeColumns="5,0,3"... > By default all columns will be included to the output, and in the default order. |
label | false | false | java.lang.String | The value of this attribute will be rendered to download the generated file. If it has not been defined then the file name will be rendered instead. If the image property has been specified, then the label will be used to render alt and title attributes on the HTML markup. |
outputTypeHandler | false | false | java.lang.String | Custom output handler can be define using this attribute. The custom handler must be a type of com.icesoft.faces.component.dataexporter.OutputTypeHandler |
popupBlockerLabel | false | false | java.lang.String | When used in a browser with a popup blocker enabled downloading the exported file will require two clicks instead of a single click. In this case the value of this attribute will be used to update the label for the dataExporter to reflect that the user must click the link/button/image again to complete the download process.. |
renderLabelAsButton | false | false | java.lang.String | This is false by default. If true the label text will be the label of a rendered button, instead of an anchor link. |
rendered | false | false | java.lang.String | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. |
style | false | false | java.lang.String | CSS style(s) to be applied when this component is rendered. |
styleClass | false | false | java.lang.String | Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. Default value is iceDatExp |
type | false | false | java.lang.String | It can have one of the following value: Note: If the custom handler has been defined using the outputTypeHandler attribute then it will take precedence over this attribute. Exporting to PDF requires the presence of the iText jar in your application, which can be downloaded from itextpdf.com |