* 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: 1.1.1.1 $ * @see CssBackgroundColor * @see CssBackgroundImage * @see CssBackgroundRepeat * @see CssBackgroundAttachment * @see CssBackgroundPosition */ public class CssBackground extends CssProperty implements CssOperator, CssBackgroundConstants { CssBackgroundColor color; CssBackgroundImage image; CssBackgroundRepeat repeat; CssBackgroundAttachment attachment; CssBackgroundPosition position; CssBackgroundSize size; boolean sizedefined; boolean same; /** * Create a new CssBackground */ public CssBackground() { } /** * Set the value of the property * * @param expression The expression for this property * @exception InvalidParamException The expression is incorrect */ public CssBackground(ApplContext ac, CssExpression expression) throws InvalidParamException { CssValue val = expression.getValue(); char op = SPACE; boolean find = true; sizedefined = false; setByUser(); if (val.equals(inherit)) { color = new CssBackgroundColor(); color.color = inherit; image = new CssBackgroundImage(); image.url = inherit; repeat = new CssBackgroundRepeat(); repeat.repeat = REPEAT.length - 1; attachment = new CssBackgroundAttachment(); attachment.attachment = ATTACHMENT.length - 1; position = new CssBackgroundPosition(); position.horizontal = inherit; position.vertical = inherit; size = new CssBackgroundSize(); size.value1 = inherit; same = true; expression.next(); return; } while (find) { find = false; val = expression.getValue(); op = expression.getOperator(); if (val == null) { break; } if (color == null) { try { color = new CssBackgroundColor(ac, expression); find = true; } catch (InvalidParamException e) {} } if (!find && image == null) { try { image = new CssBackgroundImage(ac, expression); find = true; } catch (InvalidParamException e) {} } if (!find && repeat == null) { try { repeat = new CssBackgroundRepeat(ac, expression); find = true; } catch (InvalidParamException e) {} } if (!find && attachment == null) { try { attachment = new CssBackgroundAttachment(ac, expression); find = true; } catch (InvalidParamException e) {} } if (!find && position == null) { try { position = new CssBackgroundPosition(ac, expression); find = true; } catch (InvalidParamException e) {} } if (op != SPACE) { if (op != SLASH) { throw new InvalidParamException("operator", ((new Character(op)).toString()), ac); } else { //try { size = new CssBackgroundSize(ac, expression); sizedefined = true; break; //} catch (InvalidParamException e) { // error! //} } } } if (color == null) color = new CssBackgroundColor(); if (image == null) image = new CssBackgroundImage(); if (repeat == null) repeat = new CssBackgroundRepeat(); if (attachment == null) attachment = new CssBackgroundAttachment(); if (position == null) position = new CssBackgroundPosition(); if (!sizedefined) size = new CssBackgroundSize(); } /** * 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 the name of this property */ public String getPropertyName() { return "background"; } /** * Returns a string representation of the object. */ public String toString() { if (same) { return inherit.toString(); } else { String ret = ""; if (color.byUser) ret += " " + color.toString(); if (image.byUser) ret += " " + image.toString(); if (image.byUser) ret += " " + repeat.toString(); if (attachment.byUser) ret += " " + attachment.toString(); if (position.byUser) ret += " " + position.toString(); if (sizedefined) ret += "/" + size.toString(); return ret.trim(); } } /** * Set this property to be important. * Overrides this method for a macro */ public void setImportant() { color.important = true; image.important = true; repeat.important = true; attachment.important = true; position.important = true; } /** * Returns true if this property is important. * Overrides this method for a macro */ public boolean getImportant() { return ((color == null || color.important) && (image == null || image.important) && (repeat == null || repeat.important) && (attachment == null || attachment.important) && (position == null || position.important)); } /** * Print this property. * * @param printer The printer. * @see #toString() * @see #getPropertyName() */ public void print(CssPrinterStyle printer) { if ((color != null && image != null && repeat != null && attachment !=null && position != null) && (getImportant() || (!image.important && !color.important && !repeat.important && !attachment.important && !position.important))) { if (color.byUser || image.byUser || repeat.byUser || attachment.byUser || position.byUser) { printer.print(this); } } else { if (color != null) color.print(printer); if (image != null) image.print(printer); if (repeat != null) repeat.print(printer); if (attachment != null) attachment.print(printer); if (position != null) position.print(printer); } } /** * 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; color.addToStyle(ac, style); image.addToStyle(ac, style); repeat.addToStyle(ac, style); attachment.addToStyle(ac, style); 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 value 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); color.setInfo(line, source); image.setInfo(line, source); repeat.setInfo(line, source); attachment.setInfo(line, source); position.setInfo(line, source); } }