%
% API Documentation for cssutils
% Module cssutils.css.selectorlist
%
% 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.selectorlist \textit{(module)}|(}
\section{Module cssutils.css.selectorlist}

    \label{cssutils:css:selectorlist}

SelectorList is a list of CSS Selector objects.
\begin{description}
\item[{TODO}] \leavevmode \begin{itemize}
\item {} 
remove duplicate Selectors. -{\textgreater} CSSOM canonicalize

\item {} \begin{description}
\item[{??? CSS2 gives a special meaning to the comma (,) in selectors.}] \leavevmode 
However, since it is not known if the comma may acquire other
meanings in future versions of CSS, the whole statement should be
ignored if there is an error anywhere in the selector, even though
the rest of the selector may look reasonable in CSS2.

Illegal example(s):

For example, since the ``{\&}'' is not a valid token in a CSS2 selector,
a CSS2 user agent must ignore the whole second line, and not set
the color of H3 to red:

\end{description}

\end{itemize}

\end{description}
\textbf{Version:} \$LastChangedRevision: 959 \$



\textbf{Date:} \$LastChangedDate: 2008-01-29 20:11:57 +0100 (Di, 29 Jan 2008) \$



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




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

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

    \label{cssutils:css:selectorlist:SelectorList}
\begin{tabular}{cccccccc}
% Line for object, linespec=[False, False]
\multicolumn{2}{r}{\settowidth{\BCL}{object}\multirow{2}{\BCL}{object}}
&&
&&
  \\\cline{3-3}
  &&\multicolumn{1}{c|}{}
&&
&&
  \\
% Line for cssutils.util.Base, linespec=[False]
\multicolumn{4}{r}{\settowidth{\BCL}{cssutils.util.Base}\multirow{2}{\BCL}{cssutils.util.Base}}
&&
  \\\cline{5-5}
  &&&&\multicolumn{1}{c|}{}
&&
  \\
% Line for object, linespec=[False, True]
\multicolumn{2}{r}{\settowidth{\BCL}{object}\multirow{2}{\BCL}{object}}
&&
&&\multicolumn{1}{|c}{}
  \\\cline{3-3}
  &&\multicolumn{1}{c|}{}
&&
&\multicolumn{1}{|c}{}&
  \\
% Line for cssutils.util.ListSeq, linespec=[True]
\multicolumn{4}{r}{\settowidth{\BCL}{cssutils.util.ListSeq}\multirow{2}{\BCL}{cssutils.util.ListSeq}}
&&\multicolumn{1}{|c}{}
  \\\cline{5-5}
  &&&&\multicolumn{1}{c|}{}
&\multicolumn{1}{|c}{}&
  \\
&&&&\multicolumn{2}{l}{\textbf{cssutils.css.selectorlist.SelectorList}}
\end{tabular}


(cssutils) a list of Selectors of a CSSStyleRule


%___________________________________________________________________________

\hypertarget{properties}{}
\pdfbookmark[3]{Properties}{properties}
\paragraph*{Properties}
\label{properties}
\begin{description}
\item[{length: of type unsigned long, readonly}] \leavevmode 
The number of Selector elements in the list.

\item[{parentRule: of type CSSRule, readonly}] \leavevmode 
The CSS rule that contains this selector list or None if this
list is not attached to a CSSRule.

\item[{selectorText: of type DOMString}] \leavevmode 
The textual representation of the selector for the rule set. The
implementation may have stripped out insignificant whitespace while
parsing the selector.

\item[{seq: (internal use!)}] \leavevmode 
A list of Selector objects

\item[{wellformed}] \leavevmode 
if this selectorlist is wellformed regarding the Selector spec

\end{description}

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

  \subsubsection{Methods}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{\_\_init\_\_}(\textit{self}, \textit{selectorText}={\tt None}, \textit{parentRule}={\tt None}, \textit{readonly}={\tt False})

    \vspace{-1.5ex}

    \rule{\textwidth}{0.5\fboxrule}
\setlength{\parskip}{2ex}

initializes SelectorList with optional selectorText
\setlength{\parskip}{1ex}
      \textbf{Parameters}
      \vspace{-1ex}

      \begin{quote}
        \begin{Ventry}{xxxxxxxxxxxx}

          \item[selectorText]


parsable list of Selectors
          \item[parentRule]


the parent CSSRule if available
        \end{Ventry}

      \end{quote}

      Overrides: object.\_\_init\_\_

    \end{boxedminipage}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{\_\_setitem\_\_}(\textit{self}, \textit{index}, \textit{newSelector})

    \vspace{-1.5ex}

    \rule{\textwidth}{0.5\fboxrule}
\setlength{\parskip}{2ex}

overwrites ListSeq.{\_}{\_}setitem{\_}{\_}

Any duplicate Selectors are \textbf{not} removed.
\setlength{\parskip}{1ex}
      Overrides: cssutils.util.ListSeq.\_\_setitem\_\_

    \end{boxedminipage}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{append}(\textit{self}, \textit{newSelector})

    \vspace{-1.5ex}

    \rule{\textwidth}{0.5\fboxrule}
\setlength{\parskip}{2ex}

overwrites ListSeq.append
\setlength{\parskip}{1ex}
      Overrides: cssutils.util.ListSeq.append

    \end{boxedminipage}

    \label{cssutils:css:selectorlist:SelectorList:appendSelector}
    \index{cssutils \textit{(package)}!cssutils.css \textit{(package)}!cssutils.css.selectorlist \textit{(module)}!cssutils.css.selectorlist.SelectorList \textit{(class)}!cssutils.css.selectorlist.SelectorList.appendSelector \textit{(method)}}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{appendSelector}(\textit{self}, \textit{newSelector})

    \vspace{-1.5ex}

    \rule{\textwidth}{0.5\fboxrule}
\setlength{\parskip}{2ex}

Append newSelector (a string will be converted to a new
Selector).
\setlength{\parskip}{1ex}
      \textbf{Parameters}
      \vspace{-1ex}

      \begin{quote}
        \begin{Ventry}{xxxxxxxxxxx}

          \item[newSelector]


comma-separated list of selectors or a tuple of
(selectorText, dict-of-namespaces)
        \end{Ventry}

      \end{quote}

      \textbf{Return Value}
    \vspace{-1ex}

      \begin{quote}

New Selector or None if newSelector is not wellformed.
      \end{quote}

      \textbf{Raises}
    \vspace{-1ex}

      \begin{quote}
        \begin{description}

          \item[\texttt{NAMESPACE\_ERR}]


(self)
Raised if the specified selector uses an unknown namespace
prefix.
          \item[\texttt{SYNTAX\_ERR}]


(self)
Raised if the specified CSS string value has a syntax error
and is unparsable.
          \item[\texttt{NO\_MODIFICATION\_ALLOWED\_ERR}]


(self)
Raised if this rule is readonly.
        \end{description}

      \end{quote}

    \end{boxedminipage}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{\_\_repr\_\_}(\textit{self})

\setlength{\parskip}{2ex}
    repr(x)

\setlength{\parskip}{1ex}
      Overrides: object.\_\_repr\_\_ 	extit{(inherited documentation)}

    \end{boxedminipage}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{\_\_str\_\_}(\textit{self})

\setlength{\parskip}{2ex}
    str(x)

\setlength{\parskip}{1ex}
      Overrides: object.\_\_str\_\_ 	extit{(inherited documentation)}

    \end{boxedminipage}


\large{\textbf{\textit{Inherited from cssutils.util.ListSeq}}}

\begin{quote}
\_\_contains\_\_(), \_\_delitem\_\_(), \_\_getitem\_\_(), \_\_iter\_\_(), \_\_len\_\_()
\end{quote}

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

\begin{quote}
\_\_delattr\_\_(), \_\_getattribute\_\_(), \_\_hash\_\_(), \_\_new\_\_(), \_\_reduce\_\_(), \_\_reduce\_ex\_\_(), \_\_setattr\_\_()
\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 l\-e\-n\-g\-t\-h\- & \raggedright The number of Selector elements in the list.&\\
\cline{1-2}
\raggedright p\-a\-r\-e\-n\-t\-R\-u\-l\-e\- & \raggedright (DOM) The CSS rule that contains this SelectorList or        None if this SelectorList is not attached to a CSSRule.&\\
\cline{1-2}
\raggedright s\-e\-l\-e\-c\-t\-o\-r\-T\-e\-x\-t\- & \raggedright (cssutils) The textual representation of the selector for
a rule set.&\\
\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.selectorlist \textit{(module)}!cssutils.css.selectorlist.SelectorList \textit{(class)}|)}
    \index{cssutils \textit{(package)}!cssutils.css \textit{(package)}!cssutils.css.selectorlist \textit{(module)}|)}
