====== Checkbox =====
A checkbox is probably the simplest Field Type in existence, yet it is still quite useful.  Basically, a checkbox allows users to answer "yes" or "no" to a simple question.


===== How to Create =====
  - Click the {{:presentation-layer:field-plus.png|}} to add a field in your [[Form|form]].
  - Choose "New Field"
  - Select the table you wish to add the field to. Most of the time, this will be the current [[Table|table]] you are on, called the current [[Context|context]].
  - Select a field name and click "Choose Type".
  - Choose "Checkbox" from the list of field types.
  - You can continue adding fields or click the "Select" button to finish adding.

===== Features =====
Field features can be edited by clicking on the orange field icon {{:checkbox.png|}} when the [[Presentation Layer|presentation layer]] is displayed. 

==== Field Label ====
  * [[Field Setting - Field Label|Field Label]]
  * [[Field Setting - Display Alternate Label]] (affects this form only)

==== Grid Appearance ====

  * [[Field Setting - Column Span|Column Span]]
  * [[Field Setting - Row Span|Row Span]]


==== Tooltip ====
  * [[Field Setting - Tooltip|Tooltip]]
  * [[Field Setting - Descriptive Text|Descriptive Text]]
  * [[Field Setting - Display Alternate Descriptive Text|Display Alternate Descriptive Text]] (affects this form only)

==== Block Association ====
  * [[Field Setting - Temporary Block Association|Temporary Block Association]]
  * [[Field Setting - Global Block Association|Global Block Association]]

==== Connected Fields ====
  * [[Field Setting - Connected Fields|Connected Fields]]
  * [[Field Setting - Other Field When Checked|Other Field When Checked]]
  * [[Field Setting - Other Field When Unchecked|Other Field When Unchecked]]

==== Default Value ====
  * [[Field Setting - Default Value|Default Value]]
 
==== Validation ====
   * [[Field Setting - Required|Required]]
 
==== Audit History ====
  * [[Field Setting - Audit This Field|Audit This Field]] 
  * [[Field Setting - Show Audit History|Show Audit History]]
==== View Only ====
  * [[Field Setting - View Only|View Only]]

===== Field parts =====
  
  
===== Output formats =====
The checkbox has five output formats.

  * Full Field - This format returns nothing when the checkbox is unchecked, and returns CHECKED when the checkbox is checked.
  * Checked - This format returns NOT CHECKED when the checkbox is unchecked, and returns CHECKED when the checkbox is checked.
  * Field Label - This format returns nothing when the checkbox is unchecked, and returns the checkbox's Field label when the checkbox is checked.
  * With Sub-Fields - This format returns " - " followed by the "Full Field" output format for its "Other Field When Unchecked" when the checkbox is unchecked, and returns "CHECKED - " followed by the "Full Field" output format for its "Other Field When Checked" when the checkbox is checked.
  * Sub-Fields Only - This format returns the "Full Field" output format for its "Other Field When Unchecked" when the checkbox is unchecked, and returns the "Full Field" output format for its "Other Field When Checked" when the checkbox is checked.

===== Filters =====
The checkbox field can be filtered using the [[Query Builder - Filter#Checkbox-type filters|checkbox-type filters]].