WOGenericElement
Synopsis
WOGenericElement { elementName = aConstantString; [omitTags=YES|NO;] [elementID=identifier;] [otherTagString=aString;] [formValue=singleValue;] [formValues=arrayOfValues;] [invokeAction=aMethod;]... };
Description
WOGenericElement supports development of reusable components that closely model the behavior of common HTML elements. For example, you can now use WOGenericElement to implement your own image (IMG) element as a reusable component. WOGenericElement has attributes that support the takeValues... and invokeAction... phases of the component-action request/response loop.
elementName
Name of the HTML tag. This name (for example "HR") will be used to generate the element's tag (<HR>). elementName can either be a constant ora variable, such as a key path. You can also set the value of this attribute to nil or null, which effectively shuts off this element (that is, WebObjects doesn't generate HTML tags for this element). Alternatively, you can use the omitTags attribute to achieve the same effect.
omitTags
A boolean specifying whether the element's tag should be displayed. The default value is NO. If this flag is YES, the entire element is not rendered.
elementID
Allows access to the element's element ID. This is a read-only attribute.
otherTagString
Enables any string to be part of the opening tag. This permits standalone attributes such as "checked" or "selected" to be part of a tag.
formValue
Enables implementation of input-type elements (for example, WOTextField). Bind these attributes to a variable that can contain the component's input value. During the takeValues... phase, if the element ID of the current generic element matches an element ID of a form value in the request, the form value is pushed into the component using this attribute. The formValue attribute corresponds to WORequest's formValueForKey: while the formValues atribute corresponds to WORequest's formValuesForKey: method; in other words, formValue pushes a single attribute while formValues pushes an array of attributes.
formValues
invokeAction
Enables implementation of action elements (for example, WOHyperlink). During the invokeAction... phase, if the element ID of the current generic element matches the sender ID of the URL, the method bound to this attribute is evaluated. Just as with any action method, it must return an object that conforms to the WOActionResults protocol, such as WOComponent or WOResponse.
Copyright © 1998, Apple Computer, Inc. All rights reserved.