| |||||||
FRAMES NO FRAMES |
this tag renders a dabase-datadriven LABEL, which is a passive element (it can't be changed bythe user) - it is predestinated for use with read-only data (i.e. primary keys you don't wantthe user to change, etc) so far it is equivalent to DbLabelTag. But this tag may have a body containing any kind ofEmbeddedData - tag! this feature was put into a seperate class for performance reasons (we do not want the overheadof pushing and poping the jsp writer to and off the stack) The dataLabel tag contains an EmbeddedData tag (TableData, QueryData, or StaticData) The fieldName (defined in dataLabel) is used as a lookup for an element in the embeddedData collection. Example: <!We have an ID, we want to display the Description -look it up in the Priorities table --> <db:dataLabel fieldName="ID_Priority"> <db:queryData name="aQuery" query="SELECT ID_Priority, Description from Priorities"/> </db:dataLabel>
Tag Information | |
Tag Class | org.dbforms.taglib.DbDataContainerLabelTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | ||||
Name | Required | Request-time | Type | Description |
fieldName | true | true | java.lang.String | name of the field this tag references to |
strict | false | true | java.lang.String | if strict is true, value is set to empty string if it's not found in the embedded data. otherwise it's set to the formatted field value. default is false, so that it act's like before. |
maxlength | false | true | java.lang.String | Allows a developer to limit the amount of characters displayed on screen. If the label to display exceeds the limit, trim and display '...' Example: <db:dataLabel fieldName="ABC" maxlength="10"> </db:dataLabel> |
nullFieldValue | false | true | java.lang.String | If the value (retrieved from the database) is null, allow the user to replace the text to display by a custom value. May be used in conjunction with dbForm's I18N support. |
styleClass | false | true | java.lang.String | CSS stylesheet class to be applied. This is done adding a SPAN element that contains the text. |
title | false | true | java.lang.String | this defines the "title" attribute for the HTML4 tag. |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |