gwt.material.design.addins.client.avatar.MaterialAvatar Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gwt-material-addins
Extra Components of GWT Material Framework
There is a newer version: 2.8.3
/*
 * #%L
 * GwtMaterial
 * %%
 * Copyright (C) 2015 - 2017 GwtMaterialDesign
 * %%
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * #L%
 */
package gwt.material.design.addins.client.avatar;

import com.google.gwt.dom.client.Document;
import gwt.material.design.addins.client.MaterialAddins;
import gwt.material.design.addins.client.avatar.js.JsAvatar;
import gwt.material.design.client.MaterialDesignBase;
import gwt.material.design.client.base.AbstractValueWidget;
import gwt.material.design.client.base.JsLoader;

//@formatter:off

/**
 * Generated avatar based on @link(https://jdenticon.com/)
 * provides a unique avatar based on unique name.
 * 
 * 
XML Namespace Declaration
 *  * {@code
 * xmlns:ma='urn:import:gwt.material.design.addins.client'
 * }
 * 
 * 
 * 
UiBinder Usage:
 *  * {@code
 *
 * 
 *
 * }
 * 
 *
 * @author kevzlou7979
 * @see Material Avatar
 * @see Jdenticon 1.3.2
 */
//@formatter:on
public class MaterialAvatar extends AbstractValueWidget implements JsLoader {

    static {
        if (MaterialAddins.isDebug()) {
            MaterialDesignBase.injectDebugJs(MaterialAvatarDebugClientBundle.INSTANCE.jdenticonDebugJs());
            MaterialDesignBase.injectDebugJs(MaterialAvatarDebugClientBundle.INSTANCE.md5DebugJs());
        } else {
            MaterialDesignBase.injectJs(MaterialAvatarClientBundle.INSTANCE.jdenticonJs());
            MaterialDesignBase.injectJs(MaterialAvatarClientBundle.INSTANCE.md5Js());
        }
    }

    private String value;
    public MaterialAvatar() {
        super(Document.get().createCanvasElement());
    }

    public MaterialAvatar(String name) {
        this();
        setValue(name, false);
    }

    @Override
    protected void onLoad() {
        super.onLoad();

        load();
    }

    @Override
    public void load() {
        JsAvatar.jdenticon();
    }

    @Override
    public void unload() {}

    @Override
    public void reload() {
        unload();
        load();
    }

    @Override
    public void reset() {
        super.reset();

        reload();
    }

    /**
     * Replaced by {@link MaterialAvatar#getValue()}
     */
    @Deprecated
    public String getName() {
        return getValue();
    }

    /**
     * Replaced by {@link MaterialAvatar#setValue(Object)}
     * @param name
     */
    @Deprecated
    public void setName(String name) {
        setValue(name, true);
    }

    @Override
    public void setValue(String value, boolean fireEvents) {
        super.setValue(value, fireEvents);
        getElement().setAttribute("data-jdenticon-hash", generateHashCode(value));
    }

    @Override
    public String getValue() {
        return value;
    }

    @Override
    public void setWidth(String width) {
        getElement().setAttribute("width", width);
    }

    @Override
    public void setHeight(String height) {
        getElement().setAttribute("height", height);
    }

    @Override
    public int getWidth() {
        String width = getElement().getAttribute("width");
        return width != null ? Integer.parseInt(width) : 0;
    }

    public int getHeight() {
        String height = getElement().getAttribute("height");
        return height != null ? Integer.parseInt(height) : 0;
    }

    /**
     * Allowing to set the dimension of the Avatar component.
     * @param width - the width dimension of the avatar without any Unit suffix (e.i 100)
     * @param height - the height dimension of the avatar without any Unit suffix (e.i 100)
     */
    public void setDimension(int width, int height) {
        setWidth(String.valueOf(width));
        setHeight(String.valueOf(height));
        reload();
    }

    /**
     * Generate hash code - needed by jdenticon to generate avatar.
     */
    protected String generateHashCode(String value) {
        this.value = value;
        return JsAvatar.md5(value);
    }
}