w3c.css.properties.css1.CssWidthMob Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cssvalidator Show documentation
Backend for the W3C CSS Validation Service
There is a newer version: 1.0.8
//
// $Id$
// From Philippe Le Hegaret ([email protected])
//
// (c) COPYRIGHT MIT and INRIA, 1997.
// Please first read the full copyright statement in file COPYRIGHT.html
package org.w3c.css.properties.css1;

import org.w3c.css.parser.CssStyle;
import org.w3c.css.properties.css.CssProperty;
import org.w3c.css.util.ApplContext;
import org.w3c.css.util.InvalidParamException;
import org.w3c.css.values.CssExpression;
import org.w3c.css.values.CssIdent;
import org.w3c.css.values.CssLength;
import org.w3c.css.values.CssNumber;
import org.w3c.css.values.CssValue;

/**
 * 
 *    'width'
 * 
 * 
 * Value: <length> | <percentage> | auto 

 * Initial: auto

 * Applies to: block-level and replaced elements

 * Inherited: no

 * Percentage values: refer to parent element's width

 * 

 * This property can be applied to text elements, but it is most useful with
 * replaced elements such as images. The width is to be enforced by scaling
 * the image if necessary. When scaling, the aspect ratio of the image is preserved
 * if the 'height' property is 'auto'.
 * 

 * Example:
 * 
 * IMG.icon { width: 100px }
 * 
 * 
 * If the 'width' and 'height' of a replaced element are both 'auto', these
 * properties will be set to the intrinsic dimensions of the element.
 * 
 * Negative values are not allowed.
 *
 * @version $Revision$
 */
public class CssWidthMob extends CssProperty {

    CssValue value;

    private static CssIdent auto = new CssIdent("auto");

    /**
     * Create a new CssWidthMob
     */
    public CssWidthMob() {
        value = auto;
    }

    /**
     * Create a new CssWidthMob
     *
     * @param expression The expression for this property
     * @throws InvalidParamException Values are incorrect
     */
    public CssWidthMob(ApplContext ac, CssExpression expression, boolean check)
            throws InvalidParamException {

        if (check && expression.getCount() > 1) {
            throw new InvalidParamException("unrecognize", ac);
        }

        CssValue val = expression.getValue();

        setByUser();

        if (val.equals(inherit)) {
            value = inherit;
        } else if (val instanceof CssLength) {
            float f = ((Float) val.get()).floatValue();
            if (f < 0) {
                throw new InvalidParamException("negative-value",
                        val.toString(), ac);
            }
            value = val;
        } else if (val.equals(auto)) {
            value = auto;
        } else if (val instanceof CssNumber) {
            value = ((CssNumber) val).getLength();
        } else {
            throw new InvalidParamException("value", val,
                    getPropertyName(), ac);
        }

        expression.next();
    }

    public CssWidthMob(ApplContext ac, CssExpression expression)
            throws InvalidParamException {
        this(ac, expression, false);
    }

    /**
     * Returns the value of this property.
     */
    public Object get() {
        return value;
    }

    /**
     * Returns the name of this property.
     */
    public String getPropertyName() {
        return "width";
    }

    /**
     * Returns true if this property is "softly" inherited
     * e.g. his value equals inherit
     */
    public boolean isSoftlyInherited() {
        return value == inherit;
    }

    /**
     * Returns a string representation of the object.
     */
    public String toString() {
        return value.toString();
    }


    /**
     * Add this property to the CssStyle.
     *
     * @param style The CssStyle
     */
    public void addToStyle(ApplContext ac, CssStyle style) {
        Css1Style style0 = (Css1Style) style;
        if (style0.cssWidthMob != null)
            style0.addRedefinitionWarning(ac, this);
        style0.cssWidthMob = this;
    }

    /**
     * Get this property in the style.
     *
     * @param style   The style where the property is
     * @param resolve if true, resolve the style to find this property
     */
    public CssProperty getPropertyInStyle(CssStyle style, boolean resolve) {
        if (resolve) {
            return ((Css1Style) style).getWidthMob();
        } else {
            return ((Css1Style) style).cssWidthMob;
        }
    }

    /**
     * Compares two properties for equality.
     *
     * @param value The other property.
     */
    public boolean equals(CssProperty property) {
        return (property instanceof CssWidthMob && value.equals(((CssWidthMob) property).value));
    }

    /**
     * Is the value of this property is a default value.
     * It is used by all macro for the function print
     */
    public boolean isDefault() {
        return value == auto;
    }

}
w3c.css.properties.css1.CssWidthMob Maven / Gradle / Ivy

* 'width' *
