Using the keyboard
What it is
You can move between an app's buttons, text fields and lists with the keyboard alone. Where the keyboard points now gets a blue outline (the "focus ring"). It is like keeping a finger on the line you are reading — Tab moves the finger to the next control, Space or Enter presses it.
Try it now: open any app (Files, say) and press Tab a few times. The blue outline moves from button to button.
How to use it
- **
Tab**: the next button, field or list in the front window. After the last one it starts again at the first. - **
Shift+Tab**: backwards, to the previous one. - **
SpaceorEnter**: press the outlined button, check box or tab (the same as clicking its middle). - Arrows: in a group of tabs ("Day · Week · Month")
←→, in a sidebar↑↓choose the neighbour. When a list has the outline, the arrows move inside the list. - On a text field the caret lands at its end; just type. If you were in the middle of composing Korean,
Tabfinishes the syllable first, then moves. - **
Esc**: hides the outline. Small windows (New Folder, Rename) close withEsc. - Inside a small window (sheet): in New Folder or Rename,
Tabgoes field → Cancel → the OK button. With Cancel outlined,Entercancels. - A mouse click moves the keyboard's place there too; the outline shows again at the next
Tab. - Coming back from another window, the app still points where it pointed last.
- In apps where
Tabis part of the work — Terminal, Notepad, Documents, Sheet, Paint, Virtual Machines, a remote screen —Tabdoes what that app does with it.
How it works
- Every time an app draws a button, field or list, NanumOS's shared toolkit (the kit) notes in a table "something you can press is here". The app does nothing extra — using the shared controls is enough.
Tabpicks the next entry of that table, in the order the controls were drawn, and draws the blue outline over the app's picture.Space/Entersend the app exactly what a mouse click at the control's middle would. So a keyboard press and a mouse click always do the same thing.- Each app remembers its own place, so switching windows does not lose it.
Why it is built this way: when every app makes its own keyboard moves, some work and some do not (a check of 53 apps found Tab changing nothing in 35). In one place, the toolkit, every app moves the same way — like one access card for every door instead of a different key per building.
See for yourself: open Contacts, press Tab until the "+" is outlined, then Space — a new contact card opens.
- Registration:
kit_button,kit_field,kit_check,kit_switch,kit_slider,kit_tabs,kit_sidebar_row,kit_tool,kit_keyandkit_list_drawcallkit_focusable(rect, kind, flags)while drawing. Apps with hand-drawn buttons (Music, Radio, Photos, Calendar) call it themselves. The table lives ingui_am->kf(not the kernel BSS), relative to the window's body, so moving the window keeps it. - Order: drawing order. A tab group or a sidebar is one stop (it lands on the chosen one); rows inside a list are not stops of their own.
- Keys:
app_keyingui.coffers them tokit_focus_keyfirst. An open sheet (kd_*) or menu goes first. Apps that keepTab: the list inkit_focus_own_tab. - The ring:
COL_ACCENToutside, the text-field halo colour inside, 3 logical pixels (KU, crisp on HiDPI), drawn only in the band around the control so it never covers it. - Log:
GUI kfocus <app> <index> x y w h <kind>(b button, f field, c check, t tab, r row, l list, s slider); inside a sheetGUI kfocus dialog <0 field|1 list|2+ button> <label>. - Tests:
tests/gui_kfocus.py; every app:tools/app_qa/run.py --rows g-ux-tab,g-ux-stab.
NanumOS 0.1.8349 · 2026-11-16