cocos_add_button
Add interactive button components to Cocos Creator scenes with configurable visual transitions and click event bindings for user interface functionality.
Instructions
Attach cc.Button. transition: 0=NONE, 1=COLOR, 2=SCALE, 3=SPRITE.
color_preset (e.g. "primary", "secondary", "danger")
sets normal_color from the project's UI theme AND auto-derives
matching hover / pressed / disabled shades — pass explicit RGBA
args only when you want to override those derived values.
click_events: list of dicts from cocos_make_click_event(). Each binds a button press to a script method. Example: evt = cocos_make_click_event(scene, gm_node, 'GameManager', 'onRestart') cocos_add_button(scene, btn_node, click_events=[evt])
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene_path | Yes | ||
| node_id | Yes | ||
| transition | No | ||
| zoom_scale | No | ||
| click_events | No | ||
| normal_color_r | No | ||
| normal_color_g | No | ||
| normal_color_b | No | ||
| normal_color_a | No | ||
| hover_color_r | No | ||
| hover_color_g | No | ||
| hover_color_b | No | ||
| hover_color_a | No | ||
| pressed_color_r | No | ||
| pressed_color_g | No | ||
| pressed_color_b | No | ||
| pressed_color_a | No | ||
| disabled_color_r | No | ||
| disabled_color_g | No | ||
| disabled_color_b | No | ||
| disabled_color_a | No | ||
| color_preset | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |