<info>

New To Version 2.0:This is a child tag - available for most controls. It is used primarily for providing the user with additional or help information related to a particular control. When it encounters this child tag, XMod will create a link and content area for your information. Into that content area, XMod will place the text you place between the <info> </info> tags.

 

If the client's machine has Javascript enabled, they can click the link to show/hide your information. If you anticipate your users will not have Javascript, you can still use the <info> tag as a static information area. Just set the opentext and closetext attributes to empty values ("") and make sure you specify "false" for the "visible" attribute.

 

ATTRIBUTES <info>:

caption
deprecated

This is the text that will appear in the link the user clicks to show/hide the information. Typically, the value may be something like "Help" or "More Info..."  To prevent the link from being rendered, do not specify the caption attribute.

class
deprecated

Name of the CSS Class used to style the section (a <div> tag) containing the information. (Optional) [String value]

linkclass
deprecated

Name of the CSS Class used to style the link used to show/hide the information panel.  (Optional) [String value]

visibility
deprecated

Determines the initial state of the information panel. Valid values are:

  • visible: information panel is shown initially
  • hidden: information panel is not shown initially

visible

Determines the initial state of the content between the toggle tag. If "true" then the information will be visible initially and the first click of the link will hide it. If "false" then the information will be hidden initially and the first click of the link will show it.

New to Version 5.1

display

Determines how the toggle button/link will be displayed. Valid values are:

 

  • button - the tag will render as a standard HTML button
  • linkbutton - the tag will render as a hyperlink
  • imagebutton - the tag will render as the image, specified in openimageurl or closeimageurl depending on the current toggle state.

 

The default value is linkbutton

New to Version 5.1

layout

Determines how the toggle's content will render when it is open. Valid values are:

 

  • block - the tag's contents will render on a line by itself (like <p> tags do in HTML)
  • inline - the tag's contents will render inline, allowing other elements to be on the same line

 

The default value is block.

New to Version 5.1

opentext

This is the text that will be displayed in the hyperlink (for linkbuttons), on the button face (for buttons) or as the alt. text (for image buttons) when the toggle's content is hidden - i.e. when clicking the button will "open" the panel.

New to Version 5.1

closetext

This is the text that will be displayed in the hyperlink (for linkbuttons), on the button face (for buttons) or as the alt. text (for image buttons when the toggle's content is being displayed - i.e. when clicking the button will "close" the panel.

New to Version 5.1

openimageurl

Only valid if display is "imagebutton". This is a url to an image file to display when the toggle's content is hidden - i.e. when clicking the image will "open" the panel containing the content.

New to Version 5.1

closeimageurl

Only valid if display is "imagebutton". This is a url to an image file to display when the toggle's content is visible - i.e. when clicking the image will "close" the panel containing the content.

New to Version 5.1

imagealign

A value determining how the image will be aligned relative to nearby elements in the page. It is ignored unless display is imagebutton. Valid values are:

 

  • absbottom - the lower edge of the image is aligned with the lower edge of the largest element on the same line
  • absmiddle - the middle of the image is aligned with the middle of the largest element on the same line
  • baseline - the lower edge of the image is aligned with the lower edge of the first line of text
  • bottom - the lower edge of the image is aligned with the lower edge of the first line of text
  • left - the image is aligned on the left edge with the text wrapping on the right
  • middle - the middle of the image is aligned with the lower edge of the first line of text
  • right - the image is aligned on the right edge with text wrapping on the left
  • texttop - the upper edge of the image is aligned with the upper edge of the highest text on the same line
  • top - the upper edge of the image is aligned with the upper edge of the highest element on the same line

     

If this attribute is not set, the default alignment, as determined by the surrounding elements and page will be applied

New to Version 5.1

panelstyle

CSS style values that will be applied to the panel containing the toggle's content.

New to Version 5.1

togglestyle

CSS style values that will be applied to the button/hyperlink/image (depending on the value of display.

New to Version 5.1

EXAMPLE

Example of Dynamic Display (requires Javascript on client)

<input ref="txtQuantity" class="NormalTextBox" required="true" width="50px">

  <label>Quantity: </label>

  <default>1</default>

  <validate type="numeric" message="You must enter a number for Quantity" class="NormalRed"/>

  <info opentext="More Info..." closetext="Less Info..." visible="false" display="button">Enter the number of items you wish to purchase</info>

</input>

 

Example of Static Display (no Javascript required)

This example also shows how you can embed some HTML into your <info> tag.
<input ref="txtPassword" class="NormalTextBox" required="true" width="50px" password="true">

  <label>Quantity: </label>

  <info visible="true" opentext="" closetext=""><div style="border: 1px solid black;">Enter the password you received in the email we sent you</div></info>

</input>