cvs commit: jakarta-velocity/docs vtl-reference-guide.html

Thu, 19 Oct 2000 09:51:19 -0700 

jvanzyl     00/10/19 09:54:17

  Modified:    docs     vtl-reference-guide.html
  Log:
  - updated VTL Ref guide
  
  Revision  Changes    Path
  1.2       +40 -0     jakarta-velocity/docs/vtl-reference-guide.html
  
  Index: vtl-reference-guide.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/vtl-reference-guide.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- vtl-reference-guide.html  2000/10/19 16:38:40     1.1
  +++ vtl-reference-guide.html  2000/10/19 16:54:16     1.2
  @@ -167,12 +167,52 @@
       to text in your templates.
   </P>
   
  +<P align="justify">
  +    <B>Quiet Reference Notation</B>
  +    <BR>
  +    Velocity's normal behavior upon encountering a
  +    reference that is undefined is to output the image
  +    of the reference. For example, say you have have
  +    the following VTL as part of an HTML for you
  +    want to produce:
  +</P>
   
  +<P align="justify">
  +    <DIV align="center"><TABLE border="0" cellpadding="0" cellspacing="4"><TR><TD 
bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#023264" 
height="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" 
width="1"></TD><TD bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD 
bgcolor="#023264" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff"><PRE>
  +    &lt;input type=&quot;text&quot; name=&quot;email&quot; 
value=&quot;$email&quot;/&gt;
  +    </PRE></TD><TD bgcolor="#023264" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD 
bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#023264" 
height="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" 
width="1"></TD><TD bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
  +</P>
  +
  +<P align="justify">
  +    Now when the form initially loads the variable
  +    reference $email has no value, but you don't
  +    want the text field to have a value of &quot;$email&quot;
  +    it should be blank. To circumvent Velocity's
  +    normal behavior you use the quiet reference
  +    notation: so instead of using $email in the
  +    VTL you would use $!email. So the above example
  +    would look like the following:
  +</P>    
  +
  +<P align="justify">
  +    <DIV align="center"><TABLE border="0" cellpadding="0" cellspacing="4"><TR><TD 
bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#023264" 
height="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" 
width="1"></TD><TD bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD 
bgcolor="#023264" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff"><PRE>
  +    &lt;input type=&quot;text&quot; name=&quot;email&quot; 
value=&quot;$!email&quot;/&gt;
  +    </PRE></TD><TD bgcolor="#023264" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD 
bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#023264" 
height="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" 
width="1"></TD><TD bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
  +</P>
  +
  +<P align="justify">
  +    Now when the form is initially loaded, while
  +    $email has no value yet, an empty string will
  +    be output instead of &quot;$email&quot;.
  +</P>
  +
   </FONT></TD></TR></TABLE></DIV><BR>
   
   <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="0" 
width="98%"><TR><TD bgcolor="#023264" width="100%"><FONT color="#ffffff" 
face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="5" hspace="0" 
src="resources/void.gif" vspace="0" 
width="5"><B>Directives</B></FONT></TD></TR><TR><TD><IMG border="0" height="5" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE><TABLE 
border="0" cellpadding="0" cellspacing="0" width="98%"><TR><TD><FONT color="#000000" 
face="arial,helvetica,sanserif">
   </FONT></TD></TR></TABLE></DIV><BR>
   
  +<DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="0" 
width="98%"><TR><TD bgcolor="#023264" width="100%"><FONT color="#ffffff" 
face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="5" hspace="0" 
src="resources/void.gif" vspace="0" 
width="5"><B>Macros</B></FONT></TD></TR><TR><TD><IMG border="0" height="5" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE><TABLE border="0" 
cellpadding="0" cellspacing="0" width="98%"><TR><TD><FONT color="#000000" 
face="arial,helvetica,sanserif">
  +</FONT></TD></TR></TABLE></DIV><BR>
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>

Reply via email to