SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT 💖

okay bestie so this is one of those pages from the SDL3 functions manual, and it's lowkey niche but highkey useful if you're doing Emscripten stuff. let's get into it 🦋

✨ NAME ✨

SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT — override the binding element for keyboard inputs for Emscripten builds. yes, the whole vibe of this hint is "where do the keyboard events even go??" and you get to decide 💅

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT "SDL_EMSCRIPTEN_KEYBOARD_ELEMENT"

like, that's the whole thing. one include, one define, and you're off 🎀

✨ DESCRIPTION ✨

first thing's first, bestie: this hint only applies to the emscripten platform. so if you're not building for the web, this is not your moment, no cap 🙈

the variable can be one of these iconic options:

  • "#window" — the javascript window object 🌈
  • "#document" — the javascript document object 📄
  • "#screen" — the javascript window.screen object 🖥️
  • "#canvas" — the WebGL canvas element 🎨
  • "#none" — Don't bind anything at all. literally nothing. the keyboard events get to be free 💀
  • any other string without a leading # sign — applies to the element on the page with that ID. so if you've got a div with an id, you just pass the id, no #, and it's that element's problem now 🫶
⚠️ girlypop, listen: this hint should be set before creating a window. set it early or it's not gonna do the thing, fr fr.

✨ AVAILABILITY ✨

this hint is available since SDL 3.2.0 ⭐ so if you're on something older, sorry bestie, you're out of luck 😭

and that's the page!! sending you off with love from the Simple Directmedia Layer girlies, SDL 3.4.18 era, and yes this page is filed under SDL_HINT_EMSC...BOARD_ELEMENT(3) because the title got truncated and honestly? iconic. go forth and bind your keyboard elements, main character 👑✨

📦 where this page comes from