org.apache.tapestry5.corelib.components

## Class Any

- java.lang.Object
- - org.apache.tapestry5.corelib.components.Any

- All Implemented Interfaces:
    ClientElement

      @SupportsInformalParameters
      public class Any
      extends Object
      implements ClientElement

  Turns any arbitrary (X)HTML element into a component. The element's start and end tags are rendered, including any informal parameters and possibly an id attribute. The id is provided by `JavaScriptSupport.allocateClientId(String)` (so it will be unique on the client side) and is available after the component renders using `getClientId()`. The Any component has no template of its own but does render its body, if any.

  Some common uses are:

  - Applying a mixin to an ordinary HTML element. For example, the following turns an img element into a component that, via the `RenderNotification` mixin, triggers event notifications when it enters the BeginRender and EndRender phases:

        <img t:type="any" t:mixins="renderNotification">

    And the following renders a td element with the `NotEmpty` mixin to ensure that a non-breaking space (&nbsp;) is rendered if the td element would otherwise be empty:

        <td t:type="any" t:mixins="NotEmpty">

  - Providing a dynamically-generated client ID for an HTML element in a component rendered in a loop or zone (or more than once in a page), for use from JavaScript. (The component class will typically use `InjectComponent` to get the component, then call `getClientId()` to retrieve the ID.)

        <table t:type="any" id="clientId">

    As an alternative to calling getClientId, you can use the `RenderClientId` mixin to force the id attribute to appear in the HTML:

        <table t:type="any" t:mixins="RenderClientId">

  - Dynamically outputting a different HTML element depending on the string value of a property. For example, the following renders an element identified by the "element" property in the corresponding component class:

        <t:any element="prop:element" ... >

  - As the base component for a new custom component, especially convenient when the new component should support informal parameters or needs a dynamically generated client ID:

        public class MyComponent extends Any { ... }

  Component Parameters
  Name | Type | Flags | Default | Default Prefix
  --- | --- | --- | --- | ---
  clientId | String |  | prop:componentResources.id | literal
  The desired client id, which defaults to the component's id.
  element | String |  |  | literal
  The name of the element to be rendered, typically one of the standard (X)HTML elements, "div", "span", "a", etc., although practically any string will be accepted. The default comes from the template, or is "div" if the template does not specify an element.

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `Any()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `String` | `getClientId()` Returns the client id.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### Any

          public Any()

  - ### Method Detail

    - #### getClientId

          public String getClientId()

      Returns the client id. This has side effects: this first time this is called (after the Any component renders its start tag), a unique id is allocated (based on, and typically the same as, the clientId parameter, which defaults to the component's id). The rendered element is updated, with its id attribute set to the unique client id, which is then returned.
      Specified by:
        `getClientId` in interface `ClientElement`
      Returns:
        unique client id for this component

${project.version} - Copyright © 2003-2014 The Apache Software Foundation.