Dropdown (GComboBox)

Author: Gu Zhu

1-1

  • Title — Dropdown title. You must first set the Title Widget.
  • Icon — Dropdown icon. You must first set the Icon Widget.
  • Title Color — Color of the title text.
  • Title Font Size — Font size of the title.
  • Items — Titles of each item in the dropdown.
  • Values — Values for each item, used in code logic.
  • Icons — Icons for each item.
  • Popup Direction — Direction the dropdown opens:

    • Auto — Automatically determines direction based on dropdown position. For example, if the dropdown is near the bottom of the stage, it will open upwards to avoid clipping content.
    • Up — Opens upward.
    • Down — Opens downward.
  • Visible Item Count — Limits the number of visible items. Items exceeding this count are scrollable.
  • Selected Controller — See Controller and Dropdown Interaction.

Functional Widgets Binding

These properties bind the dropdown’s functional sub-components. Note: if the dropdown node is part of a prefab instance, these properties are hidden.

  • Dropdown Res — Dropdown resource, which is a prefab. Typically designed as a background + list. The background should adapt to the container’s width and height. The list must be named "list" and usually requires vertical scrolling.
  • Title Widget — Sets the text sprite.
  • Icon Widget — Sets the icon sprite.

Button Controller

The dropdown usually contains a controller named "button", since its behavior is similar to a button. Design it like a button:

  • When the dropdown is clicked and expanded, the "button" controller stays on the "down" page.
  • When the dropdown collapses, the "button" controller returns to "up" or "over" page.
Copyright ©Layabox 2025 all right reserved,powered by LayaAir EngineUpdate: 2025-10-10 18:47:46

results matching ""

    No results matching ""