w3c.css.properties.css2.CssBackground Maven / Gradle / Ivy
Show all versions of cssvalidator Show documentation
//
// $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.css2;
import org.w3c.css.parser.CssSelectors;
import org.w3c.css.parser.CssStyle;
import org.w3c.css.properties.css.CssProperty;
import org.w3c.css.properties.css1.Css1Style;
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.CssTypes;
import org.w3c.css.values.CssValue;
import static org.w3c.css.values.CssOperator.SPACE;
/**
*
* 5.3.7 'background'
*
*
* Value: <background-color> || <background-image> ||
* <background-repeat> || <background-attachment> ||
* <background-position>
* Initial: not defined for shorthand properties
* Applies to: all elements
* Inherited: no
* Percentage values: allowed on <background-position>
*
* The 'background' property is a shorthand property for setting the individual
* background properties (i.e., 'background-color', 'background-image',
* 'background-repeat', 'background-attachment' and 'background-position') at
* the same place in the style sheet.
*
* Possible values on the 'background' properties are the set of all possible
* values on the individual properties.
*
* BODY { background: red }
* P { background: url(chess.png) gray 50% repeat fixed }
*
* The 'background' property always sets all the individual background
* properties. In the first rule of the above example, only a value for
* 'background-color' has been given and the other individual properties are
* set to their initial value. In the second rule, all individual properties
* have been specified.
*
* @version $Revision$
* @see org.w3c.css.properties.css.CssBackgroundColor
* @see org.w3c.css.properties.css.CssBackgroundImage
* @see org.w3c.css.properties.css.CssBackgroundRepeat
* @see org.w3c.css.properties.css.CssBackgroundAttachment
* @see org.w3c.css.properties.css.CssBackgroundPosition
*/
public class CssBackground extends org.w3c.css.properties.css.CssBackground {
public CssBackgroundColor color;
public CssBackgroundImage image;
public CssBackgroundRepeat repeat;
public CssBackgroundAttachment attachment;
public CssBackgroundPosition position;
public boolean same;
/**
* Duplicate this property.
*
* @see org.w3c.css.css.CssCascadingOrder#order
*/
public CssProperty duplicate() {
CssBackground cloned = (CssBackground) super.duplicate();
if (cloned != null) {
if (color != null) {
cloned.color = (CssBackgroundColor) color.duplicate();
}
if (image != null) {
cloned.image = (CssBackgroundImage) image.duplicate();
}
if (repeat != null) {
cloned.repeat = (CssBackgroundRepeat) repeat.duplicate();
}
if (attachment != null) {
cloned.attachment = (CssBackgroundAttachment) attachment.duplicate();
}
if (position != null) {
cloned.position = (CssBackgroundPosition) position.duplicate();
}
}
return cloned;
}
/**
* Create a new CssBackground
*/
public CssBackground() {
}
/**
* Set the value of the property
*
* @param expression The expression for this property
* @throws InvalidParamException The expression is incorrect
*/
public CssBackground(ApplContext ac, CssExpression expression,
boolean check) throws InvalidParamException {
CssValue val;
char op = SPACE;
boolean find = true;
CssExpression background_position_expression = null;
// too many values
if (check && expression.getCount() > 6) {
throw new InvalidParamException("unrecognize", ac);
}
setByUser();
boolean manyValues = (expression.getCount() > 1);
while (find) {
val = expression.getValue();
if (val == null) {
break;
}
op = expression.getOperator();
// if there are many values, we can't have inherit as one of them
if (manyValues && val.equals(inherit)) {
throw new InvalidParamException("unrecognize", null, null, ac);
}
switch (val.getType()) {
case CssTypes.CSS_STRING:
if (check) {
throw new InvalidParamException("unrecognize", ac);
}
find = false;
break;
case CssTypes.CSS_URL:
if (getImage() == null) {
setImage(new CssBackgroundImage(ac, expression));
continue;
}
find = false;
break;
case CssTypes.CSS_HASH_IDENT:
case CssTypes.CSS_COLOR:
if (getColor2() == null) {
setColor(new CssBackgroundColor(ac, expression));
continue;
}
find = false;
break;
case CssTypes.CSS_NUMBER:
case CssTypes.CSS_PERCENTAGE:
case CssTypes.CSS_LENGTH:
if (background_position_expression == null) {
background_position_expression = new CssExpression();
}
background_position_expression.addValue(val);
expression.next();
find = true;
break;
case CssTypes.CSS_IDENT:
// the hard part, as ident can be from different subproperties
find = false;
CssIdent identval = (CssIdent) val;
if (inherit.equals(identval) && !manyValues) {
find = true;
same = true;
expression.next();
break;
}
// check background-image ident
if (CssBackgroundImage.checkMatchingIdent(identval)) {
if (getImage() == null) {
setImage(new CssBackgroundImage(ac, expression));
find = true;
}
break;
}
// check background-repeat ident
if (CssBackgroundRepeat.checkMatchingIdent(identval)) {
if (getRepeat() == null) {
setRepeat(new CssBackgroundRepeat(ac, expression));
find = true;
}
break;
}
// check background-attachment ident
if (CssBackgroundAttachment.checkMatchingIdent(identval)) {
if (getAttachment() == null) {
setAttachment(new CssBackgroundAttachment(ac, expression));
find = true;
}
break;
}
// check background-position ident
if (CssBackgroundPosition.checkMatchingIdent(identval)) {
if (background_position_expression == null) {
background_position_expression = new CssExpression();
}
background_position_expression.addValue(val);
expression.next();
find = true;
break;
}
if (getColor2() == null) {
try {
setColor(new CssBackgroundColor(ac, expression));
find = true;
break;
} catch (InvalidParamException e) {
// nothing to do, image will test this value
}
}
default:
if (check) {
throw new InvalidParamException("unrecognize", ac);
}
find = false;
}
if (check && !find) {
throw new InvalidParamException("unrecognize", ac);
}
if (op != SPACE) {
throw new InvalidParamException("operator",
Character.toString(op),
ac);
}
}
if (background_position_expression != null) {
setPosition(new CssBackgroundPosition(ac, background_position_expression, check));
}
}
public CssBackground(ApplContext ac, CssExpression expression)
throws InvalidParamException {
this(ac, expression, false);
}
/**
* @return Returns the attachment.
*/
public CssBackgroundAttachment getAttachment() {
return attachment;
}
/**
* @param attachment The attachment to set.
*/
public void setAttachment(CssBackgroundAttachment attachment) {
this.attachment = attachment;
}
/**
* @return Returns the image.
*/
public CssBackgroundImage getImage() {
return image;
}
/**
* @param image The image to set.
*/
public void setImage(CssBackgroundImage image) {
this.image = image;
}
/**
* @return Returns the repeat.
*/
public CssBackgroundRepeat getRepeat() {
return repeat;
}
/**
* @param repeat The repeat to set.
*/
public void setRepeat(CssBackgroundRepeat repeat) {
this.repeat = repeat;
}
/**
* @return Returns the same.
*/
public boolean isSame() {
return same;
}
/**
* @param same The same to set.
*/
public void setSame(boolean same) {
this.same = same;
}
/**
* Returns the color
*/
public final CssBackgroundColor getColor2() {
return color;
}
/**
* @param color The color to set.
*/
public void setColor(CssBackgroundColor color) {
this.color = color;
}
/**
* @return Returns the position.
*/
public CssBackgroundPosition getPosition() {
return position;
}
/**
* @param position The position to set.
*/
public void setPosition(CssBackgroundPosition position) {
this.position = position;
}
/**
* Returns the value of this property
*/
public Object get() {
return color;
}
/**
* Returns the color
*/
public final CssValue getColor() {
if (color == null) {
return null;
} else {
return color.getColor();
}
}
/**
* Returns a string representation of the object.
*/
public String toString() {
if (same) {
return inherit.toString();
} else {
StringBuilder sb = new StringBuilder();
boolean addspace = false;
if (color != null) {
sb.append(color);
addspace = true;
}
if (image != null) {
if (addspace) {
sb.append(' ');
}
sb.append(image);
addspace = true;
}
if (repeat != null) {
if (addspace) {
sb.append(' ');
}
sb.append(repeat);
addspace = true;
}
if (attachment != null) {
if (addspace) {
sb.append(' ');
}
sb.append(attachment);
addspace = true;
}
if (position != null) {
if (addspace) {
sb.append(' ');
}
sb.append(position);
}
return sb.toString();
}
}
/**
* Set this property to be important.
* Overrides this method for a macro
*/
public void setImportant() {
important = true;
if (color != null) {
color.important = true;
}
if (image != null) {
image.important = true;
}
if (repeat != null) {
repeat.important = true;
}
if (attachment != null) {
attachment.important = true;
}
if (position != null) {
position.important = true;
}
}
/**
* Returns true if this property is important.
* Overrides this method for a macro
*/
public boolean getImportant() {
if (same) {
return important;
}
return ((color == null || color.important) &&
(image == null || image.important) &&
(repeat == null || repeat.important) &&
(attachment == null || attachment.important) &&
(position == null || position.important));
}
/**
* Set the context.
* Overrides this method for a macro
*
* @see org.w3c.css.css.CssCascadingOrder#order
* @see org.w3c.css.css.StyleSheetParser#handleRule
*/
public void setSelectors(CssSelectors selector) {
super.setSelectors(selector);
if (color != null) {
color.setSelectors(selector);
}
if (image != null) {
image.setSelectors(selector);
}
if (repeat != null) {
repeat.setSelectors(selector);
}
if (attachment != null) {
attachment.setSelectors(selector);
}
if (position != null) {
position.setSelectors(selector);
}
}
/**
* Add this property to the CssStyle
*
* @param style The CssStyle
*/
public void addToStyle(ApplContext ac, CssStyle style) {
((Css1Style) style).cssBackground.same = same;
((Css1Style) style).cssBackground.byUser = byUser;
if (color != null) {
color.addToStyle(ac, style);
}
if (image != null) {
image.addToStyle(ac, style);
}
if (repeat != null) {
repeat.addToStyle(ac, style);
}
if (attachment != null) {
attachment.addToStyle(ac, style);
}
if (position != null) {
position.addToStyle(ac, style);
}
}
/**
* 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).getBackground();
} else {
return ((Css1Style) style).cssBackground;
}
}
/**
* Compares two properties for equality.
*
* @param property The other property.
*/
public boolean equals(CssProperty property) {
return false; // FIXME
}
/**
* Update the source file and the line.
* Overrides this method for a macro
*
* @param line The line number where this property is defined
* @param source The source file where this property is defined
*/
public void setInfo(int line, String source) {
super.setInfo(line, source);
if (color != null) {
color.setInfo(line, source);
}
if (image != null) {
image.setInfo(line, source);
}
if (repeat != null) {
repeat.setInfo(line, source);
}
if (attachment != null) {
attachment.setInfo(line, source);
}
if (position != null) {
position.setInfo(line, source);
}
}
}