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_booleanfield.xml < prev    next >
Encoding:
Extensible Markup Language  |  2004-07-12  |  2.1 KB  |  58 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: booleanfield 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:booleanfield is a field that has a value of
  29.       true or false. Usually is rendered as a checkbox.</p>
  30.  
  31.       <p>It is different from a <link href="widget_field.html">field widget</link>
  32.       with a <code>boolean</code> datatype because an HTML checkbox submits
  33.       no request parameter if the checkbox is unchecked. If you would render
  34.       it instead as a listbox with true and false values, you could also
  35.       use a regular field widget. Since the styling preference might change over
  36.       time, it is however better to use consistently the fd:booleanfield widget.</p>
  37.  
  38.       <p>A booleanfield cannot be marked as "required", because it is
  39.       always required. It is either true or false. If you want tripples
  40.       (true/false/none), use a normal field widget with a selection list.</p>
  41.     </s1>
  42.  
  43.     <s1 title="Configuration">
  44.       <source><![CDATA[<fd:booleanfield id="...">
  45.   <fd:label>...</fd:label>
  46.   <fd:help>...</fd:help>
  47.   <fd:hint>...</fd:hint>
  48.   <fd:on-value-changed>
  49.      [...]
  50.   </fd:on-value-changed>
  51. </fd:booleanfield>]]></source>
  52.  
  53.       <p>See <link href="widget_field.html">field wiget</link> for a description of the
  54.       configuration options.</p>
  55.     </s1>
  56.   </body>
  57. </document>
  58.