beeware / beeware/toga

Allow laying out content beyond standard areas of the window

Open
#4,039 47 comments 1 reaction 0 assignees View on GitHub
enhancement not quite right
Dominant language
Python
Stars
5.4k
Forks
827
Avg merge
15h 39m
Merged PRs (30d)
40

Description

### What is the problem or limitation you are having?

On iOS, e.g. the Photos app displays images fullscreen, having content behind the status bar.

There might also occasionally be use-cases where, say we'd like a slightly tinted colored background extending all the way up.

### Describe the solution you'd like

A platform-specific API for extending content and layout beyond the area into the navigation bar and status bar.

An example design could include allowing the users to modify the top_offset of the container, and providing conveniences like exposing the height of the status and navigation bars, helping users decide exactly how much to extend. We could also expose values of these kinds for users to adjust layouts of certain things appropriately. [edit]

### Describe alternatives you've considered

Do nothing

### Additional context

_No response_

Contributor guide

Open the contributing guide

Research direction

Start by surveying Toga's existing window and container layout APIs, then review the iOS-specific handling of the status and navigation bars. Done means defining a platform-specific way to extend content into those areas and expose the relevant bar dimensions or offsets for layout adjustments.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios, python
Domain
mobile
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.