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`:
Currently Noteable supports 5 form cell types:
- Checkbox
- Dropdown
- Datetime
- Text input
- Slider
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:
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 listThe 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
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_modelUsing 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)!