xapi.ui.html.api.Html Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of xapi-dev Show documentation

Everything needed to run a comprehensive dev environment. Just type X_ and pick a service from autocomplete; new dev modules will be added as they are built. The only dev service not included in the uber jar is xapi-dev-maven, as it includes all runtime dependencies of maven, adding ~4 seconds to build time, and 6 megabytes to the final output jar size (without xapi-dev-maven, it's ~1MB).

The newest version!

package xapi.ui.html.api;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Html {

  // We should be able to do == checks on this string for defaults,
  String ROOT_ELEMENT = "x-root";

  String document() default ROOT_ELEMENT;

  Css[] css() default {};

  El[] body() default {};

  /**
   * @return Any other class with {@link Html} tags to inherit,
   * or a raw string template to use.
   *
   */
  HtmlTemplate[] templates() default {};

  /**
   * @return the order in which to render children;
   * unspecified means the children will be rendered in the order declared.
   */
  String[] renderOrder() default {};

  /**
   * @return false to treat the template as a static singleton (one and only one instance is used);
   * return true (default) to create a new element on every invocation.
   */
  boolean isDynamic() default true;
}