Widgets Personalizados 1.20.4

Aprende a crear widgets personalizados para tus pantallas o menús.

WARNING

This page is written for version 1.20.4. Documentation for older versions may be incomplete.

Los widgets son esencialmente componentes renderizados que pueden ser agregados a una pantalla, y que pueden ser usados por el jugador mediante varios eventos como un click del mouse, presionar una tecla, y más.

Crear un Widget

Hay varias maneras de crear una clase widget, como extender AbstractWidget (Widget Clickeable). Esta clase provee varias utilidades, como por ejemplo para manejar el ancho, la altura, la posición, y para manejar eventos - implementa las interfaces Renderable (Dibujable), GuiEventListener (Elemento), NarrationSupplier (Narrable), y NarratableEntry (Seleccionable):

• Renderable - para renderizar - Requerido para registrar el widget a la pantalla mediante el método addRenderableWidget.
• GuiEventListener - para eventos - Requerido para manejar eventos como clicks del mouse, cuando se presiona una tecla, y más.
• NarrationSupplier - para accesibilidad - Requerido para que tu widget sea accesible a lectores de pantalla y otras herramientas de accesibilidad.
• Seleccionable - para selecciones - Requerido si quieres que tu widget sea seleccionable usando la tecla Tab - esto también ayuda en accesibilidad.

No lines matched.

Agregar el Widget a La Pantalla

Como todos los widgets, necesitarás agregarlo a la pantalla mediante el método addRenderableWidget, el cual es proveído por la clase Screen. Asegúrate de hacerlo en el método init.

No lines matched.

Eventos de Widget

Puedes manejar eventos como clicks del mouse, cuando se presiona una tecla, anulando el método mouseClicked (duranteMouseClickeado), afterMouseAction (duranteMouseSoltado), keyPressed (duranteTeclaPresionada), y otros métodos.

Por ejemplo, puedes hacer que el widget cambie color cuando el mouse está flotando encima del widget usando el método isHovering() proveído por la clase AbstractWidget:

No lines matched.