com.helger.css.decl

Class CSSImportRule

java.lang.Object

com.helger.css.decl.CSSImportRule

All Implemented Interfaces:

ICSSSourceLocationAware, ICSSWriteable, Serializable

@NotThreadSafe
public class CSSImportRule
extends Object
implements ICSSWriteable, ICSSSourceLocationAware

Represents a single import rule on top level. It consists of a mandatory URI and an optional list of media queries.
Example:
@import url("style.css") screen;

Author:

Philip Helger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CSSImportRule(CSSURI aLocation)
CSSImportRule(String sLocation)

Method Summary

Methods

Modifier and Type	Method and Description
CSSImportRule	addMediaQuery(CSSMediaQuery aMediaQuery) Add a media query at the end of the list.
CSSImportRule	addMediaQuery(int nIndex, CSSMediaQuery aMediaQuery) Add a media query at the specified index of the list.
boolean	equals(Object o)
List<CSSMediaQuery>	getAllMediaQueries()
String	getAsCSSString(ICSSWriterSettings aSettings, int nIndentLevel) Get the contents of this object as a serialized CSS string for writing to an output.
CSSURI	getLocation()
String	getLocationString()
int	getMediaQueryCount()
CSSSourceLocation	getSourceLocation()
int	hashCode()
boolean	hasMediaQueries()
com.helger.commons.state.EChange	removeAllMediaQueries() Remove all contained media queries.
com.helger.commons.state.EChange	removeMediaQuery(CSSMediaQuery aMediaQuery) Remove the specified media query.
com.helger.commons.state.EChange	removeMediaQuery(int nMediumIndex) Remove the media query at the specified index.
CSSImportRule	setLocation(CSSURI aLocation) Set the URI of the file to be imported.
CSSImportRule	setLocationString(String sLocationURI) Set the URI of the file to be imported.
void	setSourceLocation(CSSSourceLocation aSourceLocation) Set the source location of the object, determined while parsing.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CSSImportRule

public CSSImportRule(@Nonnull
             String sLocation)

CSSImportRule

public CSSImportRule(@Nonnull
             CSSURI aLocation)

Method Detail

hasMediaQueries

public boolean hasMediaQueries()

Returns:

true if this import rule has any specific media queries, to which it belongs, false if not.

getMediaQueryCount

@Nonnegative
public int getMediaQueryCount()

Returns:

The number of contained media queries. Always ≥ 0.

addMediaQuery

@Nonnull
public CSSImportRule addMediaQuery(@Nonnull
                                  CSSMediaQuery aMediaQuery)

Add a media query at the end of the list.

Parameters:

aMediaQuery - The media query to be added. May not be null.

Returns:

this

addMediaQuery

@Nonnull
public CSSImportRule addMediaQuery(@Nonnegative
                                  int nIndex,
                                  @Nonnull
                                  CSSMediaQuery aMediaQuery)

Add a media query at the specified index of the list.

Parameters:

nIndex - The index where to add the media query. Must be ≥ 0.

aMediaQuery - The media query to be added. May not be null.

Returns:

this

removeMediaQuery

@Nonnull
public com.helger.commons.state.EChange removeMediaQuery(@Nullable
                                                        CSSMediaQuery aMediaQuery)

Remove the specified media query.

Parameters:

aMediaQuery - The media query to be removed. May be null.

Returns:

EChange.CHANGED if removal was successful.

removeMediaQuery

@Nonnull
public com.helger.commons.state.EChange removeMediaQuery(int nMediumIndex)

Remove the media query at the specified index.

Parameters:

nMediumIndex - The index of the media query to be removed.

Returns:

EChange.CHANGED if removal was successful.

removeAllMediaQueries

@Nonnull
public com.helger.commons.state.EChange removeAllMediaQueries()

Remove all contained media queries.

Returns:

EChange.CHANGED if at least one media query was contained.

getAllMediaQueries

@Nonnull
@ReturnsMutableCopy
public List<CSSMediaQuery> getAllMediaQueries()

Returns:

A list with all contained media queries. Never null and always a copy of the underlying list.

getLocation

@Nonnull
public CSSURI getLocation()

Returns:

The URL object of the CSS file to import. Never null.

getLocationString

@Nonnull
@Nonempty
public String getLocationString()

Returns:

The URL of the CSS file to import. Never null. This is a shortcut for getLocation().getURI()

setLocation

@Nonnull
public CSSImportRule setLocation(@Nonnull
                                CSSURI aLocation)

Set the URI of the file to be imported.

Parameters:

aLocation - The location to use. May not be null.

Returns:

this;

setLocationString

@Nonnull
public CSSImportRule setLocationString(@Nonnull
                                      String sLocationURI)

Set the URI of the file to be imported.

Parameters:

sLocationURI - The location URI to use. May not be null.

Returns:

this;

getAsCSSString

@Nonnull
@Nonempty
public String getAsCSSString(@Nonnull
                                     ICSSWriterSettings aSettings,
                                     @Nonnegative
                                     int nIndentLevel)

Description copied from interface: ICSSWriteable

Get the contents of this object as a serialized CSS string for writing to an output.

Specified by:

getAsCSSString in interface ICSSWriteable

Parameters:

aSettings - The settings to be used to format the output. May not be null.

nIndentLevel - The current indentation level

Returns:

The content of this object as CSS string.

setSourceLocation

public void setSourceLocation(@Nullable
                     CSSSourceLocation aSourceLocation)

Description copied from interface: ICSSSourceLocationAware

Set the source location of the object, determined while parsing.

Specified by:

setSourceLocation in interface ICSSSourceLocationAware

Parameters:

aSourceLocation - The source location to use. May be null.

getSourceLocation

@Nullable
public CSSSourceLocation getSourceLocation()

Specified by:

getSourceLocation in interface ICSSSourceLocationAware

Returns:

The source location of this object when it was read by the parser. May be null if an object was not read but manually created.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object