G Suite Business customers can preview App Maker. Ask your domain admin to apply for early access.

Data Widgets

Use form and table widgets to display and edit your app's data. These two widgets are actually collections of other widgets that App Maker assembles based on your preferences. They provide a quick, easy way to input, edit, or display model data.

Drag a form or table to the canvas to open a creation wizard which guides you through widget options. The wizard is only available when you first create a form or table, and it doesn't update with subsequent model changes. You can manually edit the form or table, but it's often easier to delete and re-create the widget after you modify models or fields.

Forms and tables are a great starting point for a simple app, and a good way to learn about App Maker's features.

Form Widget Form

Use forms to let users edit and view your app's data. There are two types of forms:

  • Edit forms let users create, read, update, and delete items in your app's datasource. Edit forms make every field editable by default, but you can set fields to read-only in the wizard.
  • Insert forms let users create new items in a data model. They can't edit existing data.

Usage

Drag a form widget onto the page and let the wizard guide you through its creation. Use the Property Editor to configure the Form's options.

Common workflows

  • Provide an interface for your app's users to view and edit data.
  • Use the wizard to specify which fields in a model are visible in the form and which are writeable by users.

Styling

Use the theme picker in the Action Bar to control how the form looks.

Additional information

Because a form is a collection of other widgets, you can't use the Widget API to interact with a form. However, you can use scripts to manipulate the individual widgets that make up a form.

Examples

The Vendor Ratings has several examples of complex Forms.

Table Widget Table

Use the table widget to arrange items from a datasource into a list. A table presents data as rows and columns: rows are records, and columns are fields. An app user can use a table to:

  • View multiple records at the same time, with controls for navigating between pages of data.
  • Edit data in fields in records that you've defined to be editable.
  • Sort records based on the values of fields.
  • Delete records.

Table cells are read-only by default, but you can change that on a per-field basis.

Usage

Drag a table widget onto the page and let the wizard guide you through its creation. Use the Property Editor to configure the table's options.

Common workflows

  • Provide an interface for your app's users to view and edit data.
  • Use the wizard to specify which fields in a model are visible in the table and which are writeable by users.
  • Use the wizard to add pagination controls, make columns sortable, or give users the option to delete rows.

Styling

Use the theme picker in the Action Bar to control how the Table looks.

Additional information

Because a table is a collection of other widgets, you can't use the Widget API to interact with a table. However, you can use scripts to manipulate the individual widgets that make up a table.

Examples

The Travel Approval template shows an example of a Table with a customizable number of rows per page. Many other samples and templates use tables.