%
% API Documentation for cssutils
% Module cssutils.css.cssproperties
%
% Generated by epydoc 3.0.1
% [Fri Feb 01 19:05:21 2008]
%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                          Module Description                           %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

    \index{cssutils \textit{(package)}!cssutils.css \textit{(package)}!cssutils.css.cssproperties \textit{(module)}|(}
\section{Module cssutils.css.cssproperties}

    \label{cssutils:css:cssproperties}

CSS2Properties (partly!) implements DOM Level 2 CSS CSS2Properties used
by CSSStyleDeclaration
\begin{description}
\item[{TODO: CSS2Properties}] \leavevmode 
If an implementation does implement this interface, it is expected to
understand the specific syntax of the shorthand properties, and apply
their semantics; when the margin property is set, for example, the
marginTop, marginRight, marginBottom and marginLeft properties are
actually being set by the underlying implementation.

When dealing with CSS ``shorthand'' properties, the shorthand properties
should be decomposed into their component longhand properties as
appropriate, and when querying for their value, the form returned
should be the shortest form exactly equivalent to the declarations made
in the ruleset. However, if there is no shorthand declaration that
could be added to the ruleset without changing in any way the rules
already declared in the ruleset (i.e., by adding longhand rules that
were previously not declared in the ruleset), then the empty string
should be returned for the shorthand property.

For example, querying for the font property should not return
``normal normal normal 14pt/normal Arial, sans-serif'', when
``14pt Arial, sans-serif'' suffices. (The normals are initial values, and
are implied by use of the longhand property.)

If the values for all the longhand properties that compose a particular
string are the initial values, then a string consisting of all the
initial values should be returned (e.g. a border-width value of
``medium'' should be returned as such, not as ``'').

For some shorthand properties that take missing values from other
sides, such as the margin, padding, and border-{[}width{\textbar}style{\textbar}color{]}
properties, the minimum number of sides possible should be used; i.e.,
``0px 10px'' will be returned instead of ``0px 10px 0px 10px''.

If the value of a shorthand property can not be decomposed into its
component longhand properties, as is the case for the font property
with a value of ``menu'', querying for the values of the component
longhand properties should return the empty string.

\item[{TODO: CSS2Properties DOMImplementation}] \leavevmode 
The interface found within this section are not mandatory. A DOM
application can use the hasFeature method of the DOMImplementation
interface to determine whether it is supported or not. The feature
string for this extended interface listed in this section is ``CSS2''
and the version is ``2.0''.

\end{description}


%___________________________________________________________________________

\hypertarget{cssvalues}{}
\pdfbookmark[3]{cssvalues}{cssvalues}
\paragraph*{cssvalues}
\label{cssvalues}

contributed by Kevin D. Smith, thanks!

``cssvalues'' is used as a property validator.
it is an importable object that contains a dictionary of compiled regular
expressions.  The keys of this dictionary are all of the valid CSS property
names.  The values are compiled regular expressions that can be used to
validate the values for that property. (Actually, the values are references
to the 'match' method of a compiled regular expression, so that they are
simply called like functions.)
\textbf{Version:} \$LastChangedRevision: 632 \$



\textbf{Date:} \$LastChangedDate: 2007-11-03 22:43:36 +0100 (Sa, 03 Nov 2007) \$



\textbf{Author:} \$LastChangedBy: cthedot \$




%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                               Variables                               %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

  \subsection{Variables}

    \vspace{-1cm}
\hspace{\varindent}\begin{longtable}{|p{\varnamewidth}|p{\vardescrwidth}|l}
\cline{1-2}
\cline{1-2} \centering \textbf{Name} & \centering \textbf{Description}& \\
\cline{1-2}
\endhead\cline{1-2}\multicolumn{3}{r}{\small\textit{continued on next page}}\\\endfoot\cline{1-2}
\endlastfoot\raggedright c\-s\-s\-v\-a\-l\-u\-e\-s\- & \raggedright \textbf{Value:} 
{\tt \{'azimuth': r'\{angle\}{\textbar}(behind{\textbackslash}s+)?(left-side{\textbar}far-left{\textbar}lef\texttt{...}}&\\
\cline{1-2}
\end{longtable}


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                           Class Description                           %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

    \index{cssutils \textit{(package)}!cssutils.css \textit{(package)}!cssutils.css.cssproperties \textit{(module)}!cssutils.css.cssproperties.CSS2Properties \textit{(class)}|(}
\subsection{Class CSS2Properties}

    \label{cssutils:css:cssproperties:CSS2Properties}
\begin{tabular}{cccccc}
% Line for object, linespec=[False]
\multicolumn{2}{r}{\settowidth{\BCL}{object}\multirow{2}{\BCL}{object}}
&&
  \\\cline{3-3}
  &&\multicolumn{1}{c|}{}
&&
  \\
&&\multicolumn{2}{l}{\textbf{cssutils.css.cssproperties.CSS2Properties}}
\end{tabular}

\textbf{Known Subclasses:} cssutils.css.cssstyledeclaration.CSSStyleDeclaration


The CSS2Properties interface represents a convenience mechanism
for retrieving and setting properties within a CSSStyleDeclaration.
The attributes of this interface correspond to all the properties
specified in CSS2. Getting an attribute of this interface is
equivalent to calling the getPropertyValue method of the
CSSStyleDeclaration interface. Setting an attribute of this
interface is equivalent to calling the setProperty method of the
CSSStyleDeclaration interface.

cssutils actually also allows usage of \texttt{del} to remove a CSS property
from a CSSStyleDeclaration.

This is an abstract class, the following functions need to be present
in inheriting class:
\begin{itemize}
\item {} 
\texttt{{\_}getP}

\item {} 
\texttt{{\_}setP}

\item {} 
\texttt{{\_}delP}

\end{itemize}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                                Methods                                %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

  \subsubsection{Methods}


\large{\textbf{\textit{Inherited from object}}}

\begin{quote}
\_\_delattr\_\_(), \_\_getattribute\_\_(), \_\_hash\_\_(), \_\_init\_\_(), \_\_new\_\_(), \_\_reduce\_\_(), \_\_reduce\_ex\_\_(), \_\_repr\_\_(), \_\_setattr\_\_(), \_\_str\_\_()
\end{quote}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                              Properties                               %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

  \subsubsection{Properties}

    \vspace{-1cm}
\hspace{\varindent}\begin{longtable}{|p{\varnamewidth}|p{\vardescrwidth}|l}
\cline{1-2}
\cline{1-2} \centering \textbf{Name} & \centering \textbf{Description}& \\
\cline{1-2}
\endhead\cline{1-2}\multicolumn{3}{r}{\small\textit{continued on next page}}\\\endfoot\cline{1-2}
\endlastfoot\raggedright a\-z\-i\-m\-u\-t\-h\- & &\\
\cline{1-2}
\raggedright b\-a\-c\-k\-g\-r\-o\-u\-n\-d\- & &\\
\cline{1-2}
\raggedright b\-a\-c\-k\-g\-r\-o\-u\-n\-d\-A\-t\-t\-a\-c\-h\-m\-e\-n\-t\- & &\\
\cline{1-2}
\raggedright b\-a\-c\-k\-g\-r\-o\-u\-n\-d\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright b\-a\-c\-k\-g\-r\-o\-u\-n\-d\-I\-m\-a\-g\-e\- & &\\
\cline{1-2}
\raggedright b\-a\-c\-k\-g\-r\-o\-u\-n\-d\-P\-o\-s\-i\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright b\-a\-c\-k\-g\-r\-o\-u\-n\-d\-R\-e\-p\-e\-a\-t\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-B\-o\-t\-t\-o\-m\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-B\-o\-t\-t\-o\-m\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-B\-o\-t\-t\-o\-m\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-B\-o\-t\-t\-o\-m\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-C\-o\-l\-l\-a\-p\-s\-e\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-L\-e\-f\-t\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-L\-e\-f\-t\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-L\-e\-f\-t\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-R\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-R\-i\-g\-h\-t\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-R\-i\-g\-h\-t\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-R\-i\-g\-h\-t\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-S\-p\-a\-c\-i\-n\-g\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-T\-o\-p\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-T\-o\-p\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-T\-o\-p\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-T\-o\-p\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright b\-o\-r\-d\-e\-r\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright b\-o\-t\-t\-o\-m\- & &\\
\cline{1-2}
\raggedright c\-a\-p\-t\-i\-o\-n\-S\-i\-d\-e\- & &\\
\cline{1-2}
\raggedright c\-l\-e\-a\-r\- & &\\
\cline{1-2}
\raggedright c\-l\-i\-p\- & &\\
\cline{1-2}
\raggedright c\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright c\-o\-n\-t\-e\-n\-t\- & &\\
\cline{1-2}
\raggedright c\-o\-u\-n\-t\-e\-r\-I\-n\-c\-r\-e\-m\-e\-n\-t\- & &\\
\cline{1-2}
\raggedright c\-o\-u\-n\-t\-e\-r\-R\-e\-s\-e\-t\- & &\\
\cline{1-2}
\raggedright c\-u\-e\- & &\\
\cline{1-2}
\raggedright c\-u\-e\-A\-f\-t\-e\-r\- & &\\
\cline{1-2}
\raggedright c\-u\-e\-B\-e\-f\-o\-r\-e\- & &\\
\cline{1-2}
\raggedright c\-u\-r\-s\-o\-r\- & &\\
\cline{1-2}
\raggedright d\-i\-r\-e\-c\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright d\-i\-s\-p\-l\-a\-y\- & &\\
\cline{1-2}
\raggedright e\-l\-e\-v\-a\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright e\-m\-p\-t\-y\-C\-e\-l\-l\-s\- & &\\
\cline{1-2}
\raggedright f\-l\-o\-a\-t\- & &\\
\cline{1-2}
\raggedright f\-o\-n\-t\- & &\\
\cline{1-2}
\raggedright f\-o\-n\-t\-F\-a\-m\-i\-l\-y\- & &\\
\cline{1-2}
\raggedright f\-o\-n\-t\-S\-i\-z\-e\- & &\\
\cline{1-2}
\raggedright f\-o\-n\-t\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright f\-o\-n\-t\-V\-a\-r\-i\-a\-n\-t\- & &\\
\cline{1-2}
\raggedright f\-o\-n\-t\-W\-e\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright h\-e\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright l\-e\-f\-t\- & &\\
\cline{1-2}
\raggedright l\-e\-t\-t\-e\-r\-S\-p\-a\-c\-i\-n\-g\- & &\\
\cline{1-2}
\raggedright l\-i\-n\-e\-H\-e\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright l\-i\-s\-t\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright l\-i\-s\-t\-S\-t\-y\-l\-e\-I\-m\-a\-g\-e\- & &\\
\cline{1-2}
\raggedright l\-i\-s\-t\-S\-t\-y\-l\-e\-P\-o\-s\-i\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright l\-i\-s\-t\-S\-t\-y\-l\-e\-T\-y\-p\-e\- & &\\
\cline{1-2}
\raggedright m\-a\-r\-g\-i\-n\- & &\\
\cline{1-2}
\raggedright m\-a\-r\-g\-i\-n\-B\-o\-t\-t\-o\-m\- & &\\
\cline{1-2}
\raggedright m\-a\-r\-g\-i\-n\-L\-e\-f\-t\- & &\\
\cline{1-2}
\raggedright m\-a\-r\-g\-i\-n\-R\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright m\-a\-r\-g\-i\-n\-T\-o\-p\- & &\\
\cline{1-2}
\raggedright m\-a\-x\-H\-e\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright m\-a\-x\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright m\-i\-n\-H\-e\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright m\-i\-n\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright o\-r\-p\-h\-a\-n\-s\- & &\\
\cline{1-2}
\raggedright o\-u\-t\-l\-i\-n\-e\- & &\\
\cline{1-2}
\raggedright o\-u\-t\-l\-i\-n\-e\-C\-o\-l\-o\-r\- & &\\
\cline{1-2}
\raggedright o\-u\-t\-l\-i\-n\-e\-S\-t\-y\-l\-e\- & &\\
\cline{1-2}
\raggedright o\-u\-t\-l\-i\-n\-e\-W\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright o\-v\-e\-r\-f\-l\-o\-w\- & &\\
\cline{1-2}
\raggedright p\-a\-d\-d\-i\-n\-g\- & &\\
\cline{1-2}
\raggedright p\-a\-d\-d\-i\-n\-g\-B\-o\-t\-t\-o\-m\- & &\\
\cline{1-2}
\raggedright p\-a\-d\-d\-i\-n\-g\-L\-e\-f\-t\- & &\\
\cline{1-2}
\raggedright p\-a\-d\-d\-i\-n\-g\-R\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright p\-a\-d\-d\-i\-n\-g\-T\-o\-p\- & &\\
\cline{1-2}
\raggedright p\-a\-g\-e\-B\-r\-e\-a\-k\-A\-f\-t\-e\-r\- & &\\
\cline{1-2}
\raggedright p\-a\-g\-e\-B\-r\-e\-a\-k\-B\-e\-f\-o\-r\-e\- & &\\
\cline{1-2}
\raggedright p\-a\-g\-e\-B\-r\-e\-a\-k\-I\-n\-s\-i\-d\-e\- & &\\
\cline{1-2}
\raggedright p\-a\-u\-s\-e\- & &\\
\cline{1-2}
\raggedright p\-a\-u\-s\-e\-A\-f\-t\-e\-r\- & &\\
\cline{1-2}
\raggedright p\-a\-u\-s\-e\-B\-e\-f\-o\-r\-e\- & &\\
\cline{1-2}
\raggedright p\-i\-t\-c\-h\- & &\\
\cline{1-2}
\raggedright p\-i\-t\-c\-h\-R\-a\-n\-g\-e\- & &\\
\cline{1-2}
\raggedright p\-l\-a\-y\-D\-u\-r\-i\-n\-g\- & &\\
\cline{1-2}
\raggedright p\-o\-s\-i\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright q\-u\-o\-t\-e\-s\- & &\\
\cline{1-2}
\raggedright r\-i\-c\-h\-n\-e\-s\-s\- & &\\
\cline{1-2}
\raggedright r\-i\-g\-h\-t\- & &\\
\cline{1-2}
\raggedright s\-p\-e\-a\-k\- & &\\
\cline{1-2}
\raggedright s\-p\-e\-a\-k\-H\-e\-a\-d\-e\-r\- & &\\
\cline{1-2}
\raggedright s\-p\-e\-a\-k\-N\-u\-m\-e\-r\-a\-l\- & &\\
\cline{1-2}
\raggedright s\-p\-e\-a\-k\-P\-u\-n\-c\-t\-u\-a\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright s\-p\-e\-e\-c\-h\-R\-a\-t\-e\- & &\\
\cline{1-2}
\raggedright s\-t\-r\-e\-s\-s\- & &\\
\cline{1-2}
\raggedright t\-a\-b\-l\-e\-L\-a\-y\-o\-u\-t\- & &\\
\cline{1-2}
\raggedright t\-e\-x\-t\-A\-l\-i\-g\-n\- & &\\
\cline{1-2}
\raggedright t\-e\-x\-t\-D\-e\-c\-o\-r\-a\-t\-i\-o\-n\- & &\\
\cline{1-2}
\raggedright t\-e\-x\-t\-I\-n\-d\-e\-n\-t\- & &\\
\cline{1-2}
\raggedright t\-e\-x\-t\-T\-r\-a\-n\-s\-f\-o\-r\-m\- & &\\
\cline{1-2}
\raggedright t\-o\-p\- & &\\
\cline{1-2}
\raggedright u\-n\-i\-c\-o\-d\-e\-B\-i\-d\-i\- & &\\
\cline{1-2}
\raggedright v\-e\-r\-t\-i\-c\-a\-l\-A\-l\-i\-g\-n\- & &\\
\cline{1-2}
\raggedright v\-i\-s\-i\-b\-i\-l\-i\-t\-y\- & &\\
\cline{1-2}
\raggedright v\-o\-i\-c\-e\-F\-a\-m\-i\-l\-y\- & &\\
\cline{1-2}
\raggedright v\-o\-l\-u\-m\-e\- & &\\
\cline{1-2}
\raggedright w\-h\-i\-t\-e\-S\-p\-a\-c\-e\- & &\\
\cline{1-2}
\raggedright w\-i\-d\-o\-w\-s\- & &\\
\cline{1-2}
\raggedright w\-i\-d\-t\-h\- & &\\
\cline{1-2}
\raggedright w\-o\-r\-d\-S\-p\-a\-c\-i\-n\-g\- & &\\
\cline{1-2}
\raggedright z\-I\-n\-d\-e\-x\- & &\\
\cline{1-2}
\multicolumn{2}{|l|}{\textit{Inherited from object}}\\
\multicolumn{2}{|p{\varwidth}|}{\raggedright \_\_class\_\_}\\
\cline{1-2}
\end{longtable}

    \index{cssutils \textit{(package)}!cssutils.css \textit{(package)}!cssutils.css.cssproperties \textit{(module)}!cssutils.css.cssproperties.CSS2Properties \textit{(class)}|)}
    \index{cssutils \textit{(package)}!cssutils.css \textit{(package)}!cssutils.css.cssproperties \textit{(module)}|)}
