Module jdk.javadoc

Interface Taglet



  • public interface Taglet
    The interface for a custom taglet supported by doclets such as the standard doclet. Custom taglets are used to handle custom tags in documentation comments.

    A custom taglet must implement this interface, and must have a public default constructor (i.e. a public constructor with no parameters), by which, the doclet will instantiate and register the custom taglet.

    Since:
    9
    • Method Detail

      • getAllowedLocations

        Set<Taglet.Location> getAllowedLocations​()
        Returns the set of locations in which a tag may be used.
        Returns:
        the set of locations in which a tag may be used
      • isInlineTag

        boolean isInlineTag​()
        Indicates whether this taglet is for inline tags or not.
        Returns:
        true if this taglet is for an inline tag, and false otherwise
      • getName

        String getName​()
        Returns the name of the tag.
        Returns:
        the name of this custom tag.
      • init

        default void init​(DocletEnvironment env,
                          Doclet doclet)
        Initializes this taglet with the given doclet environment and doclet.
        API Note:
        The environment may be used to access utility classes for elements and types if needed.
        Implementation Requirements:
        This implementation does nothing.
        Parameters:
        env - the environment in which the doclet and taglet are running
        doclet - the doclet that instantiated this taglet
      • toString

        String toString​(List<? extends DocTree> tags,
                        Element element)
        Returns the string representation of a series of instances of this tag to be included in the generated output. If this taglet is for an inline tag it will be called once per instance of the tag, each time with a singleton list. Otherwise, if this tag is a block tag, it will be called once per comment, with a list of all the instances of the tag in a comment.
        Parameters:
        tags - the list of instances of this tag
        element - the element to which the enclosing comment belongs
        Returns:
        the string representation of the tags to be included in the generated output