Tags

Most tags in MXHX represent instances of Haxe classes, and the properties of those objects that should be set.

The following examples will show how to use this Haxe class in MXHX.

// src/com/example/Widget.hx
package com.example;

class Widget {
  public var name:String;
  public var price:Float;
  public var inStock:Bool;

  public function new() {}
}

To use this class in MXHX, you must first declare a namespace. We can add a package namespace for the com.example package.

xmlns:example="com.example.*"

To create an instance without setting any properties, you may add the tag like this:

<example:Widget/>

The prefix of the tag anme is the same as the prefix in the namespace declaration. In this case, example. The rest of the tag's name is the name of the Haxe class.

Tip: To use a Haxe class in MXHX, it's constructor function signature must have zero parameters, or if there are any parameters, they must all be optional.

It's possible to set properties of basic types using XML attributes. We can set the name string value, the price float value, and the inStock boolean values, like this:

<example:Widget name="Cog" price="6.99" inStock="true"/>

Alternatively, properties may be set using child tags. Property names used as child tags must include the same namespace as their parent.

<example:Widget>
  <example:name>Cog</example:name>
  <example:price>6.99</example:price>
  <example:inStock>6.99</example:inStock>
</example:Widget>

It is possible to set properties with a combination of attributes and child tags as well:

<local:Widget name="Cog" inStock="true">
  <local:price>6.99</local:price>
</local:Widget>