Skip to content

ContentForge/FormConstructor

Repository files navigation

logo by @tolimag

License: MIT Version

Introduction

Library is designed to simplify the creation and handling of forms. It has a few key advantages over other form libraries:

  • Forms are processed using a lambda, which is passed when the form itself is created, and not by catching events.
  • For each button we can set a lambda function in SimpleForm.
  • In SimpleForm we get a button object as a response, where we can get its text and index.
  • In CustomForm we can mark elements with an identifier to conveniently get this element in its handler. We can get element by id and its index.
  • Easy async handling.

Examples

SimpleForm

SimpleForm form = new SimpleForm("Sample title");

SimpleFormHandler handler = (p, button) -> {
    p.sendMessage("Your selected button is " + button.getName());
    p.sendMessage("Its index - " + button.index);
};

form.setContent("This is a text")
    .addContent("\nThis is addition :3")
    .add(new Button("Test button", handler))
    .add(new Button("Same button but with image", Button.Icon.texture("textures/items/diamond"), handler));

//We can set handler for null result
form.setOnCloseHandler(p -> {
    p.sendMessage("Why you closed this form? :c");
});

form.send(player);

ModalForm

ModalForm form = new ModalForm("Test modal form");

form.setContent("Is OneKN gay?") //local meme in RuNukkitDev
    .setPositiveButton("Yes")
    .setNegativeButton("Sure");

form.setResponse((p, result) -> {
    p.sendMessage(result? "I knew it!" : "Quite right :D");
});

form.send(player);

CustomForm

CustomForm form = new CustomForm("Sample custom form");

List<SelectableElement> elements = Arrays.asList(
    new SelectableElement("Option 1"),
    new SelectableElement("Option 2 but with value", 42),
    new SelectableElement("Option 3")
);

form.add(new Label("This is a test"))
    .add("Easy way to add a label")
    .add("my-text", new Input("A sample input"))
    .add("my-toggle", new Toggle("Toggle?", true))
    .add("my-dd", new Dropdown("Dropdown",  elements))
    .add(new Dropdown("Dropdown with default value", elements, 1))
    .add("my-ss", new StepSlider("Step slider", elements, 2));

form.setHandler((p, response) -> {
    //We can get by id and index
    p.sendMessage(response.getInput("my-text").getValue());
    p.sendMessage(response.getInput(1).getValue()); //It's bad practice. Do not use indexes
    p.sendMessage(response.getToggle("my-toggle").getValue());
    
    SelectableElement el = response.getDropdown("my-dd").getValue();
    p.sendMessage(el.getText());
    if(el.getValue() != null) p.sendMessage(el.getValue(Integer.class));
    
    el = response.getStepSlider("my-ss").getValue();
    p.sendMessage(el.getText());
});

form.send(player);

Async handling

Also you can use method form.sendAsync(player) for using async form handling.