Skip to main content

Video control APIs deprecated

note

This guide is accurate as of Flet 0.85.0. Later releases might add new APIs or additional migration paths.

The breaking changes and deprecations index lists the guides created for each release.

Summary​

Flet 0.85.0 deprecated Video.show_controls, Video.playlist_add(), and Video.playlist_remove().

Use Video.controls to configure or hide video controls. Mutate Video.playlist directly with standard list methods.

Context​

Video.controls provides a single configuration point for built-in and custom video controls. It also supports the old hide-controls behavior by setting the value to None.

The playlist is now the source of truth for video items. Mutating the list directly keeps the API aligned with other list-backed Flet controls.

Migration guide​

Hiding controls​

Code before migration:

video = ft.Video(
    playlist=[media],
    show_controls=False,
)

Code after migration:

video = ft.Video(
    playlist=[media],
    controls=None,
)

Updating the playlist​

Code before migration:

video.playlist_add(media)
video.playlist_remove(media_index)

Code after migration:

video.playlist.append(media)
video.playlist.pop(media_index)
video.update()

Call video.update() when the mutation happens after the control has already been added to the page.

Timeline​

  • Deprecated in: 0.85.0
  • Removal in: 0.88.0

References​