home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / widget_output.xml < prev    next >
Encoding:
Extensible Markup Language  |  2004-07-12  |  2.4 KB  |  63 lines
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--
  3.   Copyright 1999-2004 The Apache Software Foundation
  4.  
  5.   Licensed under the Apache License, Version 2.0 (the "License");
  6.   you may not use this file except in compliance with the License.
  7.   You may obtain a copy of the License at
  8.  
  9.       http://www.apache.org/licenses/LICENSE-2.0
  10.  
  11.   Unless required by applicable law or agreed to in writing, software
  12.   distributed under the License is distributed on an "AS IS" BASIS,
  13.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.   See the License for the specific language governing permissions and
  15.   limitations under the License.
  16. -->
  17. <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "document-v10.dtd">
  18.  
  19. <document>
  20.   <header>
  21.     <title>Cocoon Forms: output widget</title>
  22.     <authors>
  23.       <person name="The Apache Cocoon Team" email="dev@cocoon.apache.org"/>
  24.     </authors>
  25.   </header>
  26.   <body>
  27.     <s1 title="Concept">
  28.       <p>An fd:output widget is similar to a field widget, but its value
  29.       is not editable. The value of an output widget must be set programmatically
  30.       (or through binding). An output widget does not read its value from
  31.       the request, so is most useful in the case where the form is stored
  32.       accross requests (automatically the case when using flowscript). An
  33.       output widget does not perform any validation, it is always considered
  34.       to be valid.</p>
  35.  
  36.       <note>It is likely that we'll add a generalized 'readonly' capability
  37.       to all widgets. When we do that, fd:output will become obsolete and
  38.       can be replaced by a 'readonly' field wiget. In the meantime you can
  39.       safely use fd:output since this change won't have much impact.</note>
  40.  
  41.       <p><strong>Possible alternative:</strong> On each widget you can
  42.       also store additional information
  43.       (i.e. arbitrary Java objects) in attributes. See the Java API
  44.       of the Widget interface, methods setAttribute and getAttribute.
  45.       You can then retrieve these attributes using the JXTemplate generator.</p>
  46.     </s1>
  47.  
  48.     <s1 title="Configuration">
  49.       <source><![CDATA[<fd:output id="...">
  50.   <fd:label>...</fd:label>
  51.   <fd:help>...</fd:help>
  52.   <fd:hint>...</fd:hint>
  53.   <fd:datatype base="...">
  54.      [...]
  55.   </fd:datatype>
  56. </fd:output>]]></source>
  57.  
  58.       <p>See <link href="widget_field.html">field widget</link> for a description
  59.       of the configuration elements.</p>
  60.     </s1>
  61.   </body>
  62. </document>
  63.