dWebSpec Dictionary
CONTEXT: descriptors->element




All Details Standard Only Platform Only
Structured Web info and helpTechnologies
 Home Page
 Product Page
 Download Page
 Feedback
Javascript Tree Menu

Results for:

 element 
Prev  Topic  Next

Input elements, specifically form input elements, are the basis of data entry and display for HTML based application. The core of the activities of most dynamic web platforms is the population of these elements with data for display, whereas extracting data when the form is submitted. Meanwhile there are a host of other activities, involving the conversion of string entry to data types, validations and formatting.

Despite the commonalities of purpose, the ways that these activities are conducted vary widely amongst the platforms. What dWebSpec defines is a common representation of these activities, for which we provide translations to target platforms in this dictionary.

For this, there are the definitions of standard elements, data types, validators, and format masks, which could be used in the specification.

The element descriptor captures for each element, the specifications in terms of validations, formatting, conversions, presentation behavior, as well as other details. Despite its provision of such high levels of details, it also allows a bird?s eye view of such specifications by providing the information in concise form.

 Seam  

The tables below provide the correspondence between the standard elements types and those supplied with the JSF platform a the Seam provided. These are broken into categories: command, input, output, selection, image, message, component.

Element Type Option JSF Equivalent Seam Component Category
button  
ajax
h:commanButton s:button
a4j:commandButton
command
buttonReset   h:commandButton   command
buttonSubmit
immediate
h:commandButton
h:commandButton
  command
caption   h:outputLabel s:label output
checkbox   h:selectBooleanCheckbox   selection
checkboxGroup   h:selectManyCheckbox   selection
file     s:fileUpload input
hidden   h:inputHidden   input
image   h:commandButton with image   image
img   h:graphicImage s:graphicImage image
inputText   h:inputText s:formattedText input
link
link
link

post
ajax
h:outputLink
h:commandLink
s:link
 
a4j:commandLink
command
command command
messages   h:message s:message message
messages   h:messages   message
option   f:selectitem s:enumItem selection
options   f:selectitems s:selectitems selection
outputText  
format
i18n
h:outputText
h:outputFormat
h:outputText
  output
password   h: inputSecret   input
radio       selection
radioGroup   h:selectOneRadio    selection
select   h:selectOneListBox
h:selectOneMenu
h:selectManyListBox
h:selectManyMenu
  selection
textarea   h:inputTextArea   input
aggregator      
component   h:dataTable   component

The element descriptor attributes capture the specifications that are easily translatable to the attributes of JSF component. This is illustrated below. The translation of these attributes could vary for the different element types (input, output, command, and selection). There are more in depth discussions for each of the attributes, which could read by following the links below.

Example of desriptor specification is shown below.

ELEMENT DESCRIPTORS

id

caption

type

value

component-id

conversion-type

validators

formatter

required

visible

enabled

group-id

spec-scope

depositAmount {bundle.depAmt} inputText {invoice.depositAmount} {bb.depositAmount} float TypeValidator $#######.## true true true payment page

The specifiction would be translated to JSF components and attributes. The table below provides some of these translations. For further details follow the link provided for the descriptor attributes.

Element Descriptor Attributes JSF Component Attribute Element Types
id id A
caption h:outputText surrounded by h:outputLabel (Label For in the source content) A
type The element type would determine the JSF component to use for implementation A
component-id binding A
value value IOC
conversion-type converter IO
validators validator I
formatter See conversion-type for the formatting aspect of conversionIO
required required I
visible rendered A
enabled disable (converse) A
spec-scope
group-id

A = all, I = input, O = output, C = commands, S = selections except for options, O = selection Option(s)

The event related attributes could be derived from the event descriptor.

Event Descriptor Attributes. JSF Component Attribute Element Types
handler valueChangeListener I
handler actionListener C
handler action C
call-type (immediate) immediate C
call-type (ajax) see event descr. CIS

Other attributes that could be prescribed for an element involve the Passthrough Attributes, these are very important, since these could be entered during the initial page UI design, and must eventually be reflected in the final implementation.

Prev Next