Reactivity

Since Pluto's reactivity system does not work for variables inside a package (e.g. user_package), but we may need to rerun cells based on their variables (e.g. a cell containing a plot that should update when we collect data from the user with HTML elements), PlutoBoard.jl offers functions to achieve this.

Updating all cells containing matching variables

await updateCellByVariable(variable);

finds all cells containing variable and reruns them.

Note that some_var is not the same as user_package.some_var, so make sure to use variable="user_package.some_var" if you want to rerun cells that use user_package.some_var.

Updating all cells with certain attribute

await updateCellByReactiveVariableAttribute(reactiveVariable);

finds all <div> elements with the class cell-div and attribute rv=reactiveVariable and reruns them.

updateCellByReactiveVariableAttribute("some_number") would rerun following <div>:

<div class="cell-div" cellid="..." rv="some_number" />

But won't rerun not exact matches:

<div class="cell-div" cellid="..." rv="some_number_2" />

The rv attribute is not limited to one Reactive variable, it can also have multiple, like rv="some_number some_number_1 some_number_2" seperated with a space.