Package com.vaadin.flow.component.avatar

Class Avatar

  • All Implemented Interfaces:
    AttachNotifier, DetachNotifier, HasElement, HasSize, HasStyle, HasTheme, HasThemeVariant<AvatarVariant>, Serializable
    @Tag("vaadin-avatar")
@NpmPackage(value="@vaadin/polymer-legacy-adapter",version="23.5.4") @NpmPackage(value="@vaadin/avatar",version="23.5.4") @NpmPackage(value="@vaadin/vaadin-avatar",version="23.5.4")
@JsModule("@vaadin/polymer-legacy-adapter/style-modules.js") @JsModule("@vaadin/avatar/src/vaadin-avatar.js")
public class Avatar
extends Component
implements HasStyle, HasSize, HasThemeVariant<AvatarVariant>
    Avatar is a graphical representation of an object or entity, for example a person or an organisation.

    Avatar has three properties: name, abbreviation and image.

    The name is shown on hover in a tooltip. When a name is set, Avatar will auto-generate and display an abbreviation of the specified name. For example, “Allison Torres” becomes “AT”, “John Smith” becomes “JS”, etc.

    The abbreviation can also be set manually. Abbreviations should be kept to a maximum of 2–3 characters.

    Avatar can be used to display images, such as user profile pictures or company logos. Abbreviations are not shown when images are used.

    Note that this component is optimized for use with Collaboration Engine — a simple way to build real-time collaboration into your app — but can also be used standalone as a regular component.

    Author:
    Vaadin Ltd
    See Also:
    Serialized Form

    • Constructor Detail

      • Avatar

        public Avatar()
        Creates a new empty avatar.

        The avatar displays the user icon in the avatar and "Anonymous" in the tooltip unless overridden by setting other properties.

      • Avatar

        public Avatar​(String name)
        Creates a new avatar with the provided name.
        Parameters:
        name - the name for the avatar
        See Also:
        setName(String)

    • Method Detail

      • getI18n

        public Avatar.AvatarI18n getI18n()
        Gets the internationalization object previously set for this component.

        Note: updating the object content that is gotten from this method will not update the lang on the component if not set back using setI18n(AvatarI18n)

        Returns:
        the i18n object. It will be null, If the i18n properties weren't set.

      • setI18n

        public void setI18n​(Avatar.AvatarI18n i18n)
        Sets the internationalization properties for this component.
        Parameters:
        i18n - the internationalized properties, not null

      • getName

        public String getName()
        Gets the name that was set for the avatar.
        Returns:
        the name

      • setName

        public void setName​(String name)
        Sets the name for the avatar.

        The name is displayed in a tooltip on hover.

        Automatically deduced abbreviation is displayed in the avatar if no abbreviation or image is set.

        Parameters:
        name - the name for the avatar

      • getAbbreviation

        public String getAbbreviation()
        Gets the abbreviation that was set for the avatar.
        Returns:
        the abbreviation

      • setAbbreviation

        public void setAbbreviation​(String abbr)
        Sets the abbreviation for the avatar.

        The abbreviation will be displayed in the avatar if no image has been set.

        Parameters:
        abbr - the abbreviation

      • getImage

        public String getImage()
        Gets the image url that was set for the avatar.
        Returns:
        the image url

      • getImageResource

        public AbstractStreamResource getImageResource()
        Gets the image that was set for the avatar.
        Returns:
        the image resource value or null if the resource has not been set

      • setImageResource

        public void setImageResource​(AbstractStreamResource resource)
        Sets the image for the avatar.

        Setting the image as a resource with this method resets the image URL that was set with setImage(String)

        Parameters:
        resource - the resource value or null to remove the resource
        See Also:
        setImage(String)

      • getColorIndex

        public Integer getColorIndex()
        Gets the color index for the avatar.
        Returns:
        the color index or null if the index has not been set

      • setColorIndex

        public void setColorIndex​(Integer colorIndex)
        Sets the color index for the avatar.

        The color index defines which color will be used for the border of the avatar. Color index N applies CSS variable --vaadin-user-color-N to the border.

        Parameters:
        colorIndex - the color index or null to remove the index

      • isTooltipEnabled

        public boolean isTooltipEnabled()
        Gets the enabled state of the avatar tooltip, which is false by default.
        Returns:
        true if the tooltip is shown on hover or focus, false otherwise

      • setTooltipEnabled

        public void setTooltipEnabled​(boolean tooltipEnabled)
        Sets the enabled of the avatar tooltip.
        Parameters:
        tooltipEnabled - true to show the tooltip on hover or focus, false to not show it