FM BetterForms
BF Editorfmbetterforms.com
master
master
  • Introduction
  • 🏆Features
  • Getting Started
    • Welcome to FM BetterForms!
    • System Overview
    • Quick Tour of the BetterForms IDE
    • Phase 1: Setting Up Your Foundation
      • 1.1 Configure FileMaker Server
      • 1.2 Install BetterForms Helper File
      • 1.3 Add Your Server to BetterForms (IDE)
    • Phase 2: Building Your First Application
      • 2.1 Create an App (Site) in the IDE
      • 2.2 Create Your First Page (Intro to Page Builder)
      • 2.3 Understanding & Managing Environments (IDE)
      • 2.4 Adding Elements to Your Page
      • 2.5 Understanding Validation
      • 2.6 Adding Actions to Your Page
      • 2.7 Creating Your First List View
      • 2.8 Understanding Page Data Flow
      • 2.9 Creating Your First Hook
      • 2.10 Working with Data Tables (Coming Soon)
    • Phase 3: Understanding Core BetterForms Concepts
      • 3.1 Introduction to Hooks (and where to find them in the IDE)
      • 3.2 Running Your First Hook (Practical Example)
      • 3.3 Introduction to Actions & Action Scripts (IDE Context)
      • 3.4 Understanding the Data Model (and Page Data Model UI)
    • Phase 4: Common Customizations & Expanding Your App
      • 4.1 Adding & Configuring Buttons (Page Builder)
      • 4.2 Implementing Page Navigation (Actions & Site Navigation UI)
      • 4.3 Displaying Data in Tables (Page Builder & Element Config)
      • 4.4 Basic App Styling (Site Styling UI)
    • Phase 5: Mastering the BetterForms Environment & Advancing Your Skills
      • 5.1 Understanding & Managing Environments (In-Depth)
      • 5.2 Deep Dive: Page Configuration & Settings
        • Navigating the Page Builder Interface
        • Working with Page-Level Action Scripts
        • Configuring the Page Data Model
        • Page Integration Settings Explained
        • Managing Page Info & Other Settings
      • 5.3 Working with Global Scripts
      • 5.4 Managing App (Site) Settings & Navigation
      • 5.5 Exploring Further: What to Learn Next
    • Support & Resources
      • Getting Help
      • Learning JSON
  • Reference
    • Site Settings
      • Navigation
      • App Model
      • DOM Header Insertions
      • Global Named Actions
      • Site Structure
      • Slots / Code Injection
    • Page Settings
      • Data Model
      • Card / Window Modals
      • Validation
        • Custom Validators
      • Misc Page Settings
    • Page Elements
      • Copy of Site Structure
      • BetterForms Elements
        • Checkbox
        • Checklist
        • Cleave.js Input Masking
        • DateTime Picker
        • Google Address Autocomplete
        • Image Display Element
        • Input
        • Masked Input
        • Range Slider (noUiSlider)
        • Radios
        • Select
        • Advanced Select (selectEx)
        • TextArea
      • Common
        • Input
        • Button
        • Data Table
        • HTML
      • Grouping Elements
        • Tabs
        • Panel
        • accordion
        • accordion2
        • listrows
      • Uploading Files
        • dropzone
        • dropzone to S3
        • uploadCare
        • 🏗️Uppy File Upload Widget Integration with AWS S3
      • Misc Elements
        • Plain Text / Code Editor
        • signature
        • fullCalendar
        • rangeSlider
      • Payment Gateways
        • Authorize.net
        • PayPal
        • Stripe
      • Adding Custom Page Elements
    • Actions Processor
      • Named Actions (Action Scripts)
      • Actions
        • runUtilityHook
        • path
        • debounce
        • throttle
        • showAlert
        • showModal / hideModal
        • function
        • clipboard
        • cookie
        • setFocus
        • scrollTo
        • wait
        • emit
        • validate
        • channelJoinAnon
        • channelLeaveAnon
        • messageSend
        • messageSendAnonChannel
        • consoleError
        • showStripeCheckout
      • Authentication Actions
    • Script Hooks
      • Globals Variables
        • $$BF_Model
        • $$BF_App
        • $$BF_State
      • Keeping Keys Private
      • Reducing Payload Size
      • API Callback Endpoint
      • Common Hooks
      • Scoped Hooks
    • Users & Authentication
      • Managing User Accounts
      • Custom Login Pages
      • OAuth
    • Advanced Configuration
      • Custom Domains
    • BF Utility Functions
      • Example Usage
        • BF.i18n()
    • BF Error Codes
    • Messaging
      • Adding users to channels
      • Removing users from channels
      • Sending messages
      • Get connected users
      • Get active channels
    • Practices for File Downloads
    • BF Streaming Proxy
    • Updating the Helper File
    • Connection Trouble Shooting Guide
    • Software Testing Overview
    • JavaScript Libraries
    • FM BetterForms - Quality Assurance
    • Rollbacks and Version Control
    • BF Server Proxy
    • Setting up Auth0
    • Create an S3 Bucket on AWS
    • ApexCharts - Getting started
    • BF Enterprise Documentation
    • BetterForms Error Pages API
    • BF Streaming API
    • Creating a PWA
  • Usage Tips
    • Troubleshooting
      • Debugging
      • Frozen Actions Queue
      • Vue Variables
    • JavaScript Tips
      • Calling Named Actions from HTML Vue Events
      • Calculations
    • Hacking a Webpage
    • System Overview
    • Forms Processor
      • Form Types
      • HTML & VueJS
      • Styling and Design
    • Customizing and Styling
      • Custom CSS
      • Custom Components
        • Components Editor
        • Component Best Practices
      • Page Pre-loaders
      • Favicon
    • Design Patterns and Best Practices
      • Working with environments
      • Handling Data
      • Saving Data
      • Data Optimization
      • Business Logic
      • UI / UX
      • Debugging
      • Script Engine Optimization
    • Getting Started
    • Installation
  • Security
    • Authentication
    • Security White Paper
    • Firewalls
    • Technology Stack
  • Compatibility
Powered by GitBook
On this page
  • Client-Side Validation
  • Triggering Validation
  • Validator Types
  • Custom Validators
  • Example: Custom Validator
  • Server-Side Validation
  • Validation Settings
  • Next Steps

Was this helpful?

  1. Getting Started
  2. Phase 2: Building Your First Application

2.5 Understanding Validation

Validation is a crucial part of ensuring data integrity in your BetterForms application. This guide will help you understand how to implement and manage validation in your pages.

Client-Side Validation

Client-side validation is controlled by the validator key in all page elements. This validation happens immediately in the browser, providing instant feedback to users.

Triggering Validation

Validation does not run automatically. You must trigger client validation with the validate action. This action can be added to buttons or other elements to validate the form when needed. Automatic validation can be controlled with the validations settings from the Page Settings tab withing the page editor.

Validator Types

The validator key can be set to the following types:

  • number: Checks that the value is numeric and within the fields min & max range, if defined.

  • integer: Checks that the value is a valid JavaScript Number and an integer.

  • double: Checks that the value is a valid number.

  • string: Checks that the value is a string and its length is within the fields min & max range, if defined.

  • array: Checks that the value is an array and its length is within the fields min & max range, if defined.

  • date: Checks that the value is a valid JavaScript Date and between the fields min and max dates, if defined.

  • regexp: Checks that the value matches the regex defined in the fields schema.pattern.

  • email: Checks that the value is a plausible looking email address.

  • url: Checks that the value is a plausible looking http url.

  • creditCard: Checks that the value is a valid credit card number.

  • alpha: Checks that the value is a letter.

  • alphaNumeric: Checks that the value is a letter or a number.

Custom Validators

You can define your own JavaScript custom validation calculation that will fire the same as the regular validators. By selecting the validator type to calc and adding a calculation and error message, you can have excellent control over validation.

Example: Custom Validator

Here's an example of how to define a custom validator:

{
  "inputType": "text",
  "label": "Some Password",
  "model": "password1",
  "placeholder": "",
  "styleClasses": "w-80",
  "type": "input",
  "required": true,
  "validator": "string"
},
{
  "inputType": "text",
  "label": "Another Password",
  "model": "password2",
  "placeholder": "",
  "styleClasses": "w-80",
  "type": "input",
  "required": true,
  "validator": "calc",
  "validator_calc": "model.password1 == model.password2",
  "errorMsg": "The passwords do not match"
}

Server-Side Validation

While client-side validation is useful for providing immediate feedback, sensitive data should also be validated in your FileMaker scripts before committing to the database. This ensures that data integrity is maintained even if client-side validation is bypassed.

Validation Settings

The Page Settings tab allows you to manage validation settings for your page:

  • Validate After Loaded: Triggers validation routines as soon as the page is loaded. This should be enabled if any fields on the page have validators.

  • Validate After Changed: Triggers validation routines as soon as a field is changed. This should also be enabled if fields have validators to ensure data integrity.

Next Steps

You now have a basic understanding of how to implement and manage validation in your BetterForms application. As you build out your first application, you'll become more familiar with these components and how to use them effectively.

Previous2.4 Adding Elements to Your PageNext2.6 Adding Actions to Your Page

Last updated 2 days ago

Was this helpful?

Explore the to see the wide variety of available elements and their specific configuration options.

BetterForms Elements reference