ui.scheduler
Scheduler
Events on a grid of hours, placed to the minute: a timetable, a room's bookings, a team's week. Overlaps sit side by side.A teacher's week
Each event is a dict: id, title, start, end, and an optional subtitle and colour. all_day events become one bar across their days.26
27
28
29
30
School trip
8:00
9:00
10:00
11:00
12:00
13:00
14:00
15:00
PhysicsRoom 209
ChemistryLab
PhysicsRoom 209
Team meetingHall
ChemistryLab
Office hoursLibrary
PhysicsRoom 209
def at(day: int, hour: str, minutes: int) -> tuple[dt.datetime, dt.datetime]:
start = dt.datetime.combine(MONDAY + dt.timedelta(days=day), dt.time.fromisoformat(hour))
return start, start + dt.timedelta(minutes=minutes)
def timetable() -> list[dict]:
rows = [
(0, "08:05", 55, "Physics", "Room 209", "violet"),
(0, "09:00", 55, "Chemistry", "Lab", "green"),
(1, "08:15", 55, "Physics", "Room 209", "violet"),
(1, "10:15", 90, "Team meeting", "Hall", "slate"),
(2, "09:00", 55, "Chemistry", "Lab", "green"),
(2, "09:30", 55, "Office hours", "Library", "amber"),
(3, "13:45", 55, "Physics", "Room 209", "violet"),
]
events = []
for day, hour, minutes, title, place, color in rows:
start, end = at(day, hour, minutes)
events.append({"id": f"{day}-{hour}", "title": title, "subtitle": place,
"color": color, "start": start, "end": end})
events.append({"id": "trip", "title": "School trip", "color": "sky", "all_day": True,
"start": MONDAY + dt.timedelta(days=3),
"end": MONDAY + dt.timedelta(days=5)})
return events
def week() -> None:
ui.scheduler(events=timetable(), date=MONDAY, hours=(8, 15))
Cards drawn your way
Write the loop: each ui.scheduler_item says when, its children say what the card shows. The scheduler places them.26
27
28
29
30
8:00
9:00
10:00
11:00
12:00
Physics
Chemistry
Physics
Team meeting
Chemistry
Office hours
def at(day: int, hour: str, minutes: int) -> tuple[dt.datetime, dt.datetime]:
start = dt.datetime.combine(MONDAY + dt.timedelta(days=day), dt.time.fromisoformat(hour))
return start, start + dt.timedelta(minutes=minutes)
def timetable() -> list[dict]:
rows = [
(0, "08:05", 55, "Physics", "Room 209", "violet"),
(0, "09:00", 55, "Chemistry", "Lab", "green"),
(1, "08:15", 55, "Physics", "Room 209", "violet"),
(1, "10:15", 90, "Team meeting", "Hall", "slate"),
(2, "09:00", 55, "Chemistry", "Lab", "green"),
(2, "09:30", 55, "Office hours", "Library", "amber"),
(3, "13:45", 55, "Physics", "Room 209", "violet"),
]
events = []
for day, hour, minutes, title, place, color in rows:
start, end = at(day, hour, minutes)
events.append({"id": f"{day}-{hour}", "title": title, "subtitle": place,
"color": color, "start": start, "end": end})
events.append({"id": "trip", "title": "School trip", "color": "sky", "all_day": True,
"start": MONDAY + dt.timedelta(days=3),
"end": MONDAY + dt.timedelta(days=5)})
return events
def custom_cards() -> None:
with ui.scheduler(date=MONDAY, hours=(8, 12)):
for event in timetable():
if event.get("all_day"):
continue
with ui.scheduler_item(key=event["id"], title=event["title"],
start=event["start"], end=event["end"],
color=event["color"]), ui.vstack(gap="xs"):
ui.text(event["title"], weight="bold", size="sm")
with ui.hstack(gap="xs", align="center"):
ui.icon("map-pin", size="xs")
ui.text(event["subtitle"], size="xs")
One day
view="day" shows a single column — the view for a phone.28
8:00
9:00
10:00
11:00
12:00
ChemistryLab
Office hoursLibrary
def at(day: int, hour: str, minutes: int) -> tuple[dt.datetime, dt.datetime]:
start = dt.datetime.combine(MONDAY + dt.timedelta(days=day), dt.time.fromisoformat(hour))
return start, start + dt.timedelta(minutes=minutes)
def timetable() -> list[dict]:
rows = [
(0, "08:05", 55, "Physics", "Room 209", "violet"),
(0, "09:00", 55, "Chemistry", "Lab", "green"),
(1, "08:15", 55, "Physics", "Room 209", "violet"),
(1, "10:15", 90, "Team meeting", "Hall", "slate"),
(2, "09:00", 55, "Chemistry", "Lab", "green"),
(2, "09:30", 55, "Office hours", "Library", "amber"),
(3, "13:45", 55, "Physics", "Room 209", "violet"),
]
events = []
for day, hour, minutes, title, place, color in rows:
start, end = at(day, hour, minutes)
events.append({"id": f"{day}-{hour}", "title": title, "subtitle": place,
"color": color, "start": start, "end": end})
events.append({"id": "trip", "title": "School trip", "color": "sky", "all_day": True,
"start": MONDAY + dt.timedelta(days=3),
"end": MONDAY + dt.timedelta(days=5)})
return events
def day() -> None:
ui.scheduler(events=timetable(), date=MONDAY + dt.timedelta(days=2),
view="day", hours=(8, 12))