The core library of the HaxeUI framework -
Clone or download
Latest commit 9515ebb Sep 18, 2018

README.md

Build Status Code Climate Issue Count Support this project on Patreon

haxeui-core

haxeui-core is a users universal entry point into the HaxeUI framework and allows for the same user interface code (either with markup or via haxe source code) to be used to build a user interface on various platforms using various HaxeUI backends. Below is a general overview of how haxeui-core and the various HaxeUI backends fit together. You can watch a presentation (given at WWX2016) about HaxeUI to get more of an understanding here.

Installation

Eventually all these libs will become haxelibs, however, currently in their alpha form they do not even contain a haxelib.json file (for dependencies, etc) and therefore can only be used by downloading the source and using the haxelib dev command or by directly using the git versions using the haxelib git command (recommended). Eg:

haxelib git haxeui-core https://github.com/haxeui/haxeui-core
haxelib dev haxeui-openfl path/to/expanded/source/archive

Backends

In general, using a HaxeUI backend is as simple as just including haxeui-core and the backend library into your application, for example:

-lib haxeui-core
-lib haxeui-openfl

Currently, HaxeUI supports the following backends. Please refer to each backend for specific instructions on how to set-up and initialise the host framework (if required).

Backend Library Dependencies Platforms Native Components CI
haxeui-openfl OpenFL / Lime Build Status
haxeui-kha Kha Build Status
haxeui-html5 none Build Status
haxeui-pixijs PixiJS Build Status
haxeui-nme NME Build Status
haxeui-hxwidgets hxWidgets / wxWidgets Build Status

Usage

Assuming that haxeui-core and the backend library have been included in your application, initialising the toolkit and using it should be relatively straight forward:

Toolkit.init();

The init function can take an optional Dynamic argument that allows certain options to be passed to the host framework. Please refer to each specific backend on how to use these.

Once the toolkit has been initialised components can be added in one of two ways:

Adding components using Haxe code

Using HaxeUI components in haxe code is simple and easy:

import haxe.ui.components.Button;
import haxe.ui.containers.VBox;
import haxe.ui.core.Screen;

var main = new VBox();

var button1 = new Button();
button1.text = "Button 1";
main.addComponent(button1);

var button2 = new Button();
button2.text = "Button 2";
main.addComponent(button2);

Screen.instance.addComponent(main);

Note: Screen was used here as a universal way to add items to the application, this is not required however, if you are using a single framework and are not interested in the cross-framework capabilities of HaxeUI, then you can use something more specific to the target framework (eg: Lib.current.stage.addChild(main)).

Adding components from markup

It is also possible for HaxeUI to take a user interface definition from a markup language (like XML) and use that to build code similar to above:

var main = ComponentMacros.buildComponent("assets/ui/demo/main.xml");
Screen.instance.addComponent(main);

If your xml isn't available at compile time you can use Toolkit.componentFromString:

var main = Toolkit.componentFromString('<vbox><button text="Button" /></vbox>', "xml");
Screen.instance.addComponent(main);

Additional resources

  • haxeui-api - The HaxeUI api docs.
  • haxeui-guides - Set of guides to working with HaxeUI and backends.
  • haxeui-demo - Demo application written using HaxeUI.
  • haxeui-templates - Set of templates for IDEs to allow quick project creation.
  • haxeui-bdd - A behaviour driven development engine written specifically for HaxeUI (uses haxe-bdd which is a gherkin/cucumber inspired project).
  • WWX2016 presentation - A presentation given at WWX2016 regarding HaxeUI.