Search
K

Form Cells

Form Cells are currently an experimental feature and we will be adding more capability over time. Please contact us with any feedback you have when using this feature to help us make it better!
Form cells are an easy way to get inputs from users that can be later used as variables within a notebook.
To get started with form cells create a new cell and change it’s type to `Form`:

Form Cell Types

Currently Noteable supports 5 form cell types:
  • Checkbox
  • Dropdown
  • Datetime
  • Text input
  • Slider

Configuring Form Cells

Form cells can be configured by entering the edit state of the cell, where you’ll see a side-by-side configuration panel and a preview:
Form cell types Dropdown and Checkboxes allow users to provide the options to be displayed:
The form cell type slider allows users to change the Min, Max, and Step:

Retrieving the value of a form cell in Python

The values imputed into a form cell are automatically assigned to a python variable. Form cell types Dropdown, Datetime, Text Input and Slider all return a string, whereas form cell type Checkbox returns a list
The variable name can be modified at any point within the configuration section of the form cell, or from within the display area at the lower right corner of the cell

To interact with the form cell model

With an active kernel session, Form Cells can directly interact with the Python kernel.
When a Form Cell is created, Noteable assigns a variable as the "value variable", which will automatically create a "model variable" if we want to programmatically interact with the value or settings.
For example if the variable is called new_slider, the model variable would be called new_slider_model
Using the model variable, we can programmatically change the value of a form cell, which will update a few things:
  • the model's property within the Python kernel
  • the value variable (new_slider)
  • the form cell UI
Programmatically updating the value variable (new_slider) will not update the form cell or any of the associated variables/properties within the Python kernel - this all has to be done against the model variable (new_slider_model)!
To see how to interact with the model variable within a notebook please look at this example.