useSetCellCallback

The useSetCellCallback primitive returns a parameterized callback that can be used to set the value of a single Cell in a Store.

useSetCellCallback<Parameter>(
  tableId: MaybeAccessor<string> | GetId<Parameter>,
  rowId: MaybeAccessor<string> | GetId<Parameter>,
  cellId: MaybeAccessor<string> | GetId<Parameter>,
  getCell: (parameter: Parameter, store: Store) => Cell | MapCell,
  storeOrStoreId?: MaybeAccessor<undefined | StoreOrStoreId>,
  then?: (store: Store, cell: Cell | MapCell) => void,
): ParameterizedCallback<Parameter>

This primitive is useful, for example, when creating an event handler that will mutate the data in the Store. In this case, the parameter will likely be the event, so that you can use data from it as part of the mutation.

The fourth parameter is a function which will produce the Cell object that will then be used to update the Store in the callback.

For convenience, you can optionally provide a then function which will be called just after the Store has been updated. This is a useful place to call the addCheckpoint method, for example, if you wish to add the mutation to your application's undo stack.

import {createRoot} from 'solid-js';
import {createStore} from 'tinybase';
import {useCell, useSetCellCallback} from 'tinybase/ui-solid';

createRoot((dispose) => {
  const store = createStore().setCell('pets', 'fido', 'sold', false);
  const sold = useCell('pets', 'fido', 'sold', store);
  const sell = useSetCellCallback(
    'pets',
    'fido',
    'sold',
    () => true,
    store,
  );
  sell();
  console.log(sold());
  // -> true
  dispose();
});