如何在Python Eel中设置窗口最小尺寸？解决窗口过度缩小异常

I totally get this frustrating issue—when you drag a fullscreen Eel window down to resize it, it collapses to a tiny vertical line (or disappears entirely) but stays active. The fix is straightforward: you just need to explicitly set a minimum window size for your Eel app, which restricts how small the window can get.

Here are the two main ways to do this:

1. Set Minimum Size When Initializing the Window #

When you call eel.start(), you can pass the min_size parameter alongside your initial window size. This sets the minimum width and height right from the start, preventing the window from shrinking beyond those values.

Example code:

import eel

# Initialize Eel with your web assets folder
eel.init('web')

# Launch the window with initial size and minimum size constraints
eel.start(
    'index.html',
    size=(800, 600),  # Starting window dimensions
    min_size=(400, 300),  # Lock minimum width to 400px, height to 300px
    fullscreen=False  # Set to True if you want default fullscreen; min_size still applies when resizing
)

2. Dynamically Set Minimum Size After Window Launch #

If you need to adjust the minimum size while the app is running (e.g., based on user input or app state), you can use Eel's built-in set_min_size method. This works both from Python and JavaScript.

From Python: #

def update_min_window_size():
    # Set new minimum dimensions (500px wide, 400px tall)
    eel.set_min_size(500, 400)()  # The trailing () is needed to execute the async Eel function

From JavaScript (if you want to trigger this from the frontend): #

// Call this in your HTML/JS file whenever you need to update the minimum size
eel.set_min_size(500, 400);

Why This Works #

Eel is built on top of Electron's BrowserWindow under the hood. The min_size parameter maps directly to Electron's minWidth and minHeight configuration options, which enforce hard limits on how small the window can be resized. This stops the window from collapsing to an unreadable size when dragging from fullscreen.

A quick extra tip: If your app starts in fullscreen mode, the min_size will still take effect as soon as the user begins resizing the window—no extra setup needed.

内容的提问来源于stack exchange，提问作者Albert Francisco