emilk / emilk/egui

On macOS, the builtin 2-Set Korean IME's hanja candidate window cannot be opened with `Option+Return`

Open
#7,974 1 comment 0 reactions 0 assignees View on GitHub
bug
Dominant language
Rust
Stars
30.6k
Forks
2.1k
Avg merge
1d 9h
Merged PRs (30d)
72

Description

**Describe the bug**

On macOS, while using the builtin 2-Set Korean IME, the user normally can open the hanja candidate window with Option+Return.
The section “Convert Hangul to Hanja” of [this User Guide by Apple](https://support.apple.com/en-am/guide/korean-input-method/welcome/mac) illustrates this.

On 0.33.3 and [current main], this key combination does not work.

It doesn't seem that Apple provides an option to change the keybinding for it, so I can't tell whether this bug is related to this specific key combination or not.

**To Reproduce**
Steps to reproduce the behavior:
1. run the demo App.
2. open the TextEdit demo.
3. Switch to the builtin 2-Set Korean IME and type `gks` in the TextEdit. (You may need to type something else first with the Korean IME due to [this winit bug](https://github.com/rust-windowing/winit/issues/3095))
4. hit Option+Return.
5. Instead of the hanja candidate window being opened, a new line is entered.

**Expected behavior**
The hanja candidate window should be opened at the 5th step of the reproduction above.

**Screenshots**

Working example on macOS (within TextEdit.app)

![Image](https://github.com/user-attachments/assets/71977d1c-bffd-452f-a16c-fb1f383fe615)

Broken behavior in egui on macOS

![Image](https://github.com/user-attachments/assets/fc786e1b-0364-49c8-89e7-dfd66bebef2c)

On Windows, the builtin Korean IME uses the Ctrl key for the same thing, and it works

![Image](https://github.com/user-attachments/assets/82ab87ab-3cac-4e5b-be60-74d119275b37)

On Linux, the Korean Hangul IME for both IBus and Fcitx5 supports using customizable keybindings (with F9 being one of the default) to open the hanja candidate window, and that works in egui just like Windows.
(I could open the hanja candidate window with Ctrl yesterday, but I can't do that anymore for no reason. This is unlikely related to egui, since every program is affected.)

**Desktop (please complete the following information):**
- OS: macOS 15.7.3
- Native (eframe)
- Version 0.33.3 and [current main]

[current main]: https://github.com/emilk/egui/commit/14afefa2521d1baaf4fd02105eec2d3727a7ac36

Contributor guide

Open the contributing guide

Research direction

Start by running the demo App, opening the TextEdit demo, and reproducing the issue with macOS's builtin 2-Set Korean IME and Option+Return. Trace the macOS keyboard and text-input handling involved in the TextEdit demo. Done means Option+Return opens the hanja candidate window instead of inserting a new line, while the existing Windows and Linux behavior remains intact.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
desktop
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.