m.redraw
Redraws the view for the currently active module. Use m.module()
to activate a module.
This method is called internally by Mithril's auto-redrawing system and is only documented for completeness; usually you should avoid calling it manually unless you explicitly want a multi-pass redraw cycle. One case where m.redraw
may be useful is to force a manual redraw after background requests (see the background
option in m.request
.
A multi-pass redraw cycle is usually only useful if you need non-trivial UI metrics measurements. A multi-pass cycle may span multiple browser repaints and therefore could cause flash of unbehaviored content (FOUC) and performance degradation.
By default, if you're using either m.route
or m.module
, m.redraw()
is called automatically by Mithril's auto-redrawing system once the controller finishes executing.
m.redraw
is also called automatically on event handlers defined in virtual elements.
If there are pending m.request
calls in either a controller constructor or event handler, the auto-redrawing system waits for all the AJAX requests to complete before calling m.redraw
.
This method may also be called manually from within a controller if more granular updates to the view are needed, however doing so is generally not recommended, as it may degrade performance. Model classes should never call this method.
If you are developing an asynchronous model-level service and finding that Mithril is not redrawing the view after your code runs, you should use m.startComputation
and m.endComputation
to integrate with Mithril's auto-redrawing system instead.
Signature
void redraw()