khtml Library API Documentation

cssparser.h

00001 /*
00002  * This file is part of the CSS implementation for KDE.
00003  *
00004  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
00005  *               1999 Waldo Bastian (bastian@kde.org)
00006  *
00007  * This library is free software; you can redistribute it and/or
00008  * modify it under the terms of the GNU Library General Public
00009  * License as published by the Free Software Foundation; either
00010  * version 2 of the License, or (at your option) any later version.
00011  *
00012  * This library is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00015  * Library General Public License for more details.
00016  *
00017  * You should have received a copy of the GNU Library General Public License
00018  * along with this library; see the file COPYING.LIB.  If not, write to
00019  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00020  * Boston, MA 02111-1307, USA.
00021  *
00022  * $Id: cssparser.h,v 1.60.2.1 2003/05/18 12:34:36 mueller Exp $
00023  */
00024 #ifndef _CSS_cssparser_h_
00025 #define _CSS_cssparser_h_
00026 
00027 #include "dom/dom_string.h"
00028 #include "dom/dom_misc.h"
00029 #include "misc/shared.h"
00030 #include <qdatetime.h>
00031 #include <qptrlist.h>
00032 
00033 namespace DOM {
00034 
00035     class StyleSheetImpl;
00036     class MediaList;
00037 
00038     class CSSSelector;
00039     class CSSProperty;
00040     class CSSValueImpl;
00041     class CSSPrimitiveValueImpl;
00042     class CSSStyleDeclarationImpl;
00043     class CSSRuleImpl;
00044     class CSSStyleRuleImpl;
00045 
00046     class DocumentImpl;
00047 
00048     int getPropertyID(const char *tagStr, int len);
00049 
00050 // this class represents a selector for a StyleRule
00051 class CSSSelector
00052 {
00053 public:
00054     CSSSelector(void)
00055     : tagHistory(0), attr(0), tag(0), relation( Descendant ),
00056     match( None ), nonCSSHint( false ), pseudoId( 0 ) {}
00057 
00058     ~CSSSelector(void) {
00059     if (tagHistory)
00060         delete tagHistory;
00061     }
00062 
00066     void print(void);
00067 
00071     DOMString selectorText() const;
00072 
00073     // checks if the 2 selectors (including sub selectors) agree.
00074     bool operator == ( const CSSSelector &other );
00075 
00076     // tag == -1 means apply to all elements (Selector = *)
00077 
00078     unsigned int specificity();
00079 
00080     /* how the attribute value has to match.... Default is Exact */
00081     enum Match
00082     {
00083     None = 0,
00084     Exact,
00085     Set,
00086     List,
00087     Hyphen,
00088     Pseudo,
00089     Contain,   // css3: E[foo*="bar"]
00090     Begin,     // css3: E[foo^="bar"]
00091     End        // css3: E[foo$="bar"]
00092     };
00093 
00094     enum Relation
00095     {
00096     Descendant = 0,
00097     Child,
00098     Sibling,
00099     SubSelector
00100     };
00101 
00102     DOM::DOMString value;
00103     CSSSelector *tagHistory;
00104     int          attr;
00105     int          tag;
00106 
00107     Relation relation     : 2;
00108     Match    match         : 4;
00109     bool    nonCSSHint : 1;
00110     unsigned int pseudoId : 3;
00111 
00112 
00113 };
00114 
00115     // a style class which has a parent (almost all have)
00116     class StyleBaseImpl : public khtml::TreeShared<StyleBaseImpl>
00117     {
00118     public:
00119     StyleBaseImpl()  { m_parent = 0; hasInlinedDecl = false; strictParsing = true; multiLength = false; }
00120     StyleBaseImpl(StyleBaseImpl *p) { m_parent = p; hasInlinedDecl = false; strictParsing = true; multiLength = false; }
00121 
00122     virtual ~StyleBaseImpl() {}
00123 
00124     // returns the url of the style sheet this object belongs to
00125     DOMString baseURL();
00126 
00127     virtual bool isStyleSheet() const { return false; }
00128     virtual bool isCSSStyleSheet() const { return false; }
00129     virtual bool isStyleSheetList() const { return false; }
00130     virtual bool isMediaList() { return false; }
00131     virtual bool isRuleList() { return false; }
00132     virtual bool isRule() { return false; }
00133     virtual bool isStyleRule() { return false; }
00134     virtual bool isCharetRule() { return false; }
00135     virtual bool isImportRule() { return false; }
00136     virtual bool isMediaRule() { return false; }
00137     virtual bool isFontFaceRule() { return false; }
00138     virtual bool isPageRule() { return false; }
00139     virtual bool isUnknownRule() { return false; }
00140     virtual bool isStyleDeclaration() { return false; }
00141     virtual bool isValue() { return false; }
00142     virtual bool isPrimitiveValue() const { return false; }
00143     virtual bool isValueList() { return false; }
00144     virtual bool isValueCustom() { return false; }
00145 
00146     void setParent(StyleBaseImpl *parent) { m_parent = parent; }
00147 
00148     const QString preprocess(const QString &str, bool justOneRule = false);
00149     const QChar *parseSpace(const QChar *curP, const QChar *endP);
00150     const QChar *parseToChar(const QChar *curP, const QChar *endP,
00151                  QChar c, bool chkws, bool endAtBlock = false);
00152 
00153     CSSSelector *parseSelector2(const QChar *curP, const QChar *endP, CSSSelector::Relation relation);
00154     CSSSelector *parseSelector1(const QChar *curP, const QChar *endP);
00155     QPtrList<CSSSelector> *parseSelector(const QChar *curP, const QChar *endP);
00156 
00157     void parseProperty(const QChar *curP, const QChar *endP);
00158     QPtrList<CSSProperty> *parseProperties(const QChar *curP, const QChar *endP);
00159 
00160     /* parses generic CSSValues, return true, if it found a valid value */
00161     bool parseValue(const QChar *curP, const QChar *endP, int propId);
00162     bool parseValue(const QChar *curP, const QChar *endP, int propId,
00163             bool important, bool nonCSSHint, QPtrList<CSSProperty> *propList);
00164     bool parseFont(const QChar *curP, const QChar *endP);
00165     bool parse4Values(const QChar *curP, const QChar *endP, const int *properties);
00166     bool parseShortHand(const QChar *curP, const QChar *endP, const int *properties, int num);
00167     void setParsedValue(int propId, const CSSValueImpl *parsedValue);
00168     void setParsedValue(int propId, const CSSValueImpl *parsedValue,
00169                 bool important, bool nonCSSHint, QPtrList<CSSProperty> *propList);
00170     QPtrList<QChar> splitShorthandProperties(const QChar *curP, const QChar *endP);
00171     bool parseBackgroundPosition(const QChar *curP, const QChar *&nextP, const QChar *endP);
00172 
00173     /* define CSS_AURAL in cssparser.cpp if you want to parse CSS2 Aural properties */
00174     bool parse2Values(const QChar *curP, const QChar *endP, const int *properties);
00175     bool parseAuralValue(const QChar *curP, const QChar *endP, int propId);
00176 
00177         CSSValueImpl* parseContent(const QChar *curP, const QChar *endP);
00178 
00179     // defines units allowed for a certain property, used in parseUnit
00180     enum Units
00181     {
00182         UNKNOWN   = 0x0000,
00183         INTEGER   = 0x0001,
00184         NUMBER    = 0x0002,  // real numbers
00185         PERCENT   = 0x0004,
00186         LENGTH    = 0x0008,
00187         ANGLE     = 0x0010,
00188         TIME      = 0x0020,
00189         FREQUENCY = 0x0040,
00190         NONNEGATIVE = 0x0080,
00191         RELATIVE  = 0x0100
00192     };
00193 
00194     /* called by parseValue, parses numbers+units */
00195     CSSPrimitiveValueImpl *parseUnit(const QChar * curP, const QChar *endP, int allowedUnits);
00196 
00197     CSSRuleImpl *parseAtRule(const QChar *&curP, const QChar *endP);
00198 
00199     // the caller is responible for deleting the returned lists in the next to methods
00200     CSSRuleImpl *parseStyleRule(const QChar *&curP, const QChar *endP);
00201     CSSRuleImpl *parseRule(const QChar *&curP, const QChar *endP);
00202 
00203     virtual bool parseString(const DOMString &/*cssString*/, bool = false) { return false; }
00204 
00205     virtual void checkLoaded();
00206 
00207     void setStrictParsing( bool b ) { strictParsing = b; }
00208     bool useStrictParsing() const { return strictParsing; }
00209 
00210     protected:
00211     bool hasInlinedDecl : 1;
00212     bool strictParsing : 1;
00213     bool multiLength : 1;
00214     private:
00215     bool isHexadecimal( QChar &c );
00216     };
00217 
00218     // a style class which has a list of children (StyleSheets for example)
00219     class StyleListImpl : public StyleBaseImpl
00220     {
00221     public:
00222     StyleListImpl() : StyleBaseImpl() { m_lstChildren = 0; }
00223     StyleListImpl(StyleBaseImpl *parent) : StyleBaseImpl(parent) { m_lstChildren = 0; }
00224 
00225     virtual ~StyleListImpl();
00226 
00227     unsigned long length() { return m_lstChildren->count(); }
00228     StyleBaseImpl *item(unsigned long num) { return m_lstChildren->at(num); }
00229 
00230     void append(StyleBaseImpl *item) { m_lstChildren->append(item); }
00231 
00232     protected:
00233     QPtrList<StyleBaseImpl> *m_lstChildren;
00234     };
00235 
00236 } // namespace
00237 #endif
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.4.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Sun Feb 27 22:16:32 2005 by doxygen 1.3.4 written by Dimitri van Heesch, © 1997-2001