Skip to main content
CYPEX Documentation
    Support
    v2.0.0 Latest stable release View changelog ->
    1. CYPEX — PostgreSQL Application Platform
    2. /
    3. Element Dictionary
    4. /
    5. Various
    6. /
    7. Form Button
    Various Referencegenerated

    Form Button

    Submit or reset a form

    Technical id
    default_form_button
    Translation keys
    label

    The submit or reset control of a form. It knows which form it belongs to, so it does not need an action configured.

    When to use

    • The primary Save on a form, or a Reset that returns every field to its loaded value.

    Examples

    • Save and Reset at the foot of an edit form.

    Avoid

    • Using it for anything other than submitting or resetting its form — an Action Button runs arbitrary actions.
    • Adding a second submit button to the same form; two ways to save the same record invites double submission.

    Use instead

    • Action Button — Use instead when the button must do more than submit — navigate, reload a table, or call a connector after saving.

    Editor properties

    Configure these in the Application Designer property panel. Group headings mirror the editor where possible. Data Source is where the element gets its rows or field binding (a view/query, a connector operation, or a parent form field). References appear only for view-backed sources and map foreign-key ID columns to readable labels from another view.

    Data SourcerequiredSettings group
    Where this element loads its data (view, query, connector, or element).
    Default: none
    TyperequiredOne of: submit, reset
    Discriminator selecting which configuration variant applies.
    Choices
    • submit
    • reset
    Default: none

    Inside dataSource: (dataSource)

    Element IDrequiredNumber or Text
    Another element on the page whose data backs this field.
    Default: none

    Sizing

    • No size of its own: dropped at the platform default of 1 × 1 grid cells and resized on the page.

    Values you can read in expressions

    Other parts of your app can read live values from this element in custom expressions:

    elements.myFormButton.<property>

    disabled boolean True while the control is locked and cannot be edited. elements.myFormButton.disabled

    When True while the form cannot be submitted. Read it to keep a nearby hint in step with the button state.

    To use one of these, open the property you want to drive on the other element, switch it to expression mode in the Expression Editor, and enter:

    1

    elements.myFormButton.disabled

    Replace myFormButton with this element’s unique id. Select the element in Application Designer and copy the id chip at the top of the right-hand property panel.

    Where you can place it

    Drag this element into one of these containers:

    Placement notes

    • Form — Belongs to the Form it sits in; the Form’s success actions run after a successful submit.
    1
2
3
4
5
6
7
8

    {
  "config": {
    "type": "submit",
    "dataSource": {
      "elementId": "myElement"
    }
  }
}