Kbd

En pocas palabras

Dibuja teclas del teclado para que la gente aprenda el atajo: Ctrl + S.

Dibuja un atajo escrito como texto ("ctrl-shift-p", acordes como "cmd-k cmd-s") como teclas. En macOS usa símbolos (⌘⇧P) y palabras en el resto; pyzed.ui.base.KEY_STYLE fuerza "symbols" o "words". ui.format_keys devuelve las etiquetas si quieres dibujarlas tú.

ui.kbd · Categoría: Visualización · Referencia completa →

Vista previa

Código

pz.column([
    ui.kbd("ctrl-shift-p"),
    ui.kbd("ctrl-k ctrl-s"),
    pz.row([ui.kbd("escape", size="xs"), ui.kbd("enter", size="xs"), ui.kbd("tab", size="xs")], spacing=8),
], spacing=12, align="center")

Cuándo usarlo

• En menús, tooltips, paletas y pantallas de ayuda, para enseñar atajos.
• Muchos componentes ya aceptan keys= y lo dibujan por ti (botón, entrada de menú, tooltip).

Uso

import pyzed as pz
from pyzed import ui

pz.column([
    ui.kbd("ctrl-shift-p"),
    ui.kbd("ctrl-k ctrl-s"),
    pz.row([ui.kbd("escape", size="xs"), ui.kbd("enter", size="xs"), ui.kbd("tab", size="xs")], spacing=8),
], spacing=12, align="center")

Variantes

Sobre estas capturas

Cada captura la graba pyzed mismo, fuera de pantalla a 2x, en One Dark o One Light según el tema de este sitio, y recortada al componente para que se vea a su tamaño real. El puntero pasa por encima, pulsa o escribe en él; un componente que no reacciona al puntero recorre algunos temas. Con movimiento reducido ves el primer fotograma. Abre Código bajo una captura para ver el fragmento que la dibuja; los nombres libres como on_save son tus propios callbacks.

Teclas

Escribe los atajos como "ctrl-s"; en macOS ctrl pasa a ⌃ y cmd a ⌘ solo.

Una tecla

Código

ui.kbd("enter")

Combinación

Código

ui.kbd("ctrl-shift-p")

Acorde

Código

ui.kbd("ctrl-k ctrl-s")

Teclas especiales

Código

pz.row([ui.kbd("escape"), ui.kbd("tab"), ui.kbd("backspace"), ui.kbd("up")], spacing=6)

Tamaño

size="xs"

Código

ui.kbd("ctrl-p", size="xs")

size="sm"

Código

ui.kbd("ctrl-p", size="sm")

Eventos

Kbd no tiene eventos propios: muestra lo que le das. Como todo widget, también tiene los 18 eventos comunes (click, double_click, right_click, mouse_enter, drag, key_down, resize…), que se conectan con .on(...): mira Eventos y Eventos de cada componente.

Propiedades y API

ui.kbd

kbd(keys, *, size='sm', theme=None)

Dibuja un atajo como teclas: "ctrl-shift-p", "cmd-k cmd-s". En macOS usa símbolos (⌘⇧P) y en el resto palabras.

Propiedad	Por defecto	Descripción
keys	obligatorio	El atajo.
size	"sm"	"xs" o "sm".
theme	None	Tema a usar en lugar del actual (pyzed.theme.current()).

Referencia completa →

ui.format_keys

format_keys(keys)

Separa un atajo en etiquetas por acorde: format_keys("ctrl-shift-p") == [["Ctrl", "Shift", "P"]]. El estilo se controla con pyzed.ui.base.KEY_STYLE ("auto", "symbols" o "words").

Propiedad	Por defecto	Descripción
keys	obligatorio	El atajo.

Referencia completa →

ui.keys_text

keys_text(keys)

Un atajo como texto plano para una etiqueta o una línea de estado: keys_text("ctrl-shift-p") == "Ctrl+Shift+P" ("⌃⇧P" con los símbolos de macOS), los acordes separados por un espacio. Los tooltips, botones y menús toman keys= y dibujan las teclas, así que no escribas las teclas en su texto.

Propiedad	Por defecto	Descripción
keys	obligatorio	El atajo.

Referencia completa →

Relacionados

Pista de atajoUna pista discreta tipo “Abrir archivo Ctrl P”.

AtajosUna lista de atajos agrupada y con búsqueda.

TooltipUna pista que aparece al pasar el ratón, con su atajo opcional.