Events
/
Yield-events
A regular event handler will send a StateUpdate
when it has finished running. This works fine for basic event, but sometimes we need more complex logic. To update the UI multiple times in an event handler, we can yield
when we want to send an update.
To do so, we can use the Python keyword yield
. For every yield inside the function, a StateUpdate
will be sent to the frontend with the changes up to this point in the execution of the event handler.
This example below shows how to yield 100 updates to the UI.
0
class MultiUpdateState(rx.State):
count: int = 0
def timed_update(self):
for i in range(100):
self.count += 1
yield
def multi_update():
return rx.vstack(
rx.text(MultiUpdateState.count),
rx.button(
"Start", on_click=MultiUpdateState.timed_update
),
)
Here is another example of yielding multiple updates with a loading icon.
import asyncio
class ProgressExampleState(rx.State):
count: int = 0
show_progress: bool = False
async def increment(self):
self.show_progress = True
yield
# Think really hard.
await asyncio.sleep(0.5)
self.count += 1
self.show_progress = False
def progress_example():
return rx.button(
ProgressExampleState.count,
on_click=ProgressExampleState.increment,
loading=ProgressExampleState.show_progress,
)
Events can also yield other events. This is useful when you want to chain events together. To do this, you can yield the event handler function itself.
import asyncio
class YieldEventsState(rx.State):
count: int = 0
show_progress: bool = False
async def add_five(self):
self.show_progress = True
yield
# Think really hard.
await asyncio.sleep(1)
self.count += 5
self.show_progress = False
async def increment(self):
yield YieldEventsState.add_five
yield YieldEventsState.add_five
yield YieldEventsState.add_five
def multiple_yield_example():
return rx.button(
YieldEventsState.count,
on_click=YieldEventsState.increment,
loading=YieldEventsState.show_progress,
)
Did you find this useful?