Home » HTML » HTML_CSS

Provides a simple interface for validate, handle and generate cascading style sheets

This package is unmaintained.

Download latest release 1.5.4 (archived versions might be outdated)

License: BSD

Description

HTML_CSS provides a simple interface to handle stylesheets declaration.
It is completely standards compliant, and has some great features:
* Simple OO interface to CSS definitions
* Can parse existing CSS (string or file)
* Output to
- Inline stylesheet declarations
- Document internal stylesheet declarations
- Standalone stylesheet declarations
- Array of definitions
- File
* Can validate contents with the WC3 CSS Validator Web Service

In addition, it shares the following with HTML_Common based classes:
* Indent style support
* Line ending style

Documentation

Manual

Maintainers

• Klaus Guenther (thesaur) — lead, inactive
• Laurent Laville (farell) — lead, inactive

Dependencies

Required

• PHP (>= 4.3.0)
• PEAR Installer (>= 1.5.4)
• HTML_Common (>= 1.2.4)
• pcre (extension)

Optional

• PEAR
• Services_W3C_CSSValidator (>= 0.1.0)
• PHPUnit (pear.phpunit.de, >= 3.2.0)

Releases

• 1.5.4 (stable, 2009-07-04)
  Release notes

  License: BSD

  Changes
  - createAtRule signature changed : add optional duplicates parameter

  Bug fixes
  - 16354 : Does not parse multiple simple At-rules properly
  - 16355 : Simple at rules nested within other at rules are reported as top level at rules
  - 16357 : Multiple equal complex at rules not parsed correctly
  - 16358 : Multiple media types on media at rule not parsed correctly
  - 16359 : Multiple selectors on a single rule inside a complex at rule not properly parsed
  - 16360 : Multiple selectors inside a complex at rule not properly parsed

  Last action as active package leader

• 1.5.3 (stable, 2009-01-21)
  Release notes

  License: BSD

  * QA
  - prevent wrong usage of setSameStyle(); see bug #15690

• 1.5.2 (stable, 2009-01-20)
  Release notes

  License: BSD

  * QA
  - fix minor notice errors
  - implement Mock Object (PHPUnit feature) to replace call to W3C CSS Validator Web Service
  - add many new unit test cases to improve code coverage from 77 to 96%

• 1.5.1 (stable, 2008-03-15)
  Release notes

  License: BSD

  * bugs
  - fix bug #12996 : Call-time pass-by-reference has been deprecated
  - fix bug #13314 : Notice error raised on parsing string

• 1.5.0 (stable, 2008-01-15)
  Release notes

  License: BSD

  * changes
  - copyright year bump

  * news
  - implement request #12194 : support of At-Rules
  - add new function getOptions() to retrieve easily all configuration options at once
  - add new function validate() to check data source with W3C CSS validator service.
  Require PHP5. See file examples/CSS_validate.php

  * QA
  - User Guide (HTML version) included in previous versions was removed, since
  its now part of PEAR manual

• 1.4.0 (stable, 2007-12-13)
  Release notes

  License: BSD

  * changes
  - removed old class (private) properties related to options ($_xhtmlCompliant,
  $_cache, $_singleLine, $_charset, $_contentDisposition, $_groupsFirst,
  $_allowDuplicates), now group by in a private array $options.
  - added class constructor (ZE2) for PHP5.
  - Error handler allow now to use PEAR_ERROR_CALLBACK to customize action
  (log yes/no, print yes/no) when an error/exception is raised.
  - remove trailing EOL in toString() output (with oneline option set to true)

  * news
  - API 1.4.0 allow now a setter/getter PHP5 facility compatible
  (magic function __set, __get) for read/write CSS options.

  * QA
  - PHP minimum set to 4.3.0
  - PEAR installer minimum set to 1.5.4 (to avoid security vulnerability)
  - Coding Standard fixes (recommandation by PHP_CodeSniffer)
  - tests suite migrated from PHPUnit 1.x to 3.x
  - User Guide 1.4.0 included in this release cover all versions
  1.x.x, 1.1.x, 1.2.x, 1.3.x, 1.4.x

• 1.3.0 (stable, 2007-10-22)
  Release notes

  License: BSD

  * changes
  - prevent invalide CSS data source in to parse

  * news
  - add Content-Disposition to the headers in display(); implement request #12195

  * QA
  User Guide 1.3.0 included in this release cover all versions 1.x.x, 1.1.x, 1.2.x, 1.3.x

• 1.2.0 (stable, 2007-06-12)
  Release notes

  License: BSD

  * changes
  - No code changes since previous release, but license changed
  from PHP 3.01 to new BSD (give more freedom)

  * QA
  User Guide 1.2.0 included in this release cover all versions 1.x.x, 1.1.x, 1.2.x

• 1.1.3 (stable, 2007-02-18)
  Release notes

  License: PHP License 3.01

  * bugs
  - fixed typo error in "oneline" attribute used with class constructor (Bug #10103)

  * QA
  User Guide 1.1.3 included in this release cover all versions 1.x.x, 1.1.x

• 1.1.2 (stable, 2007-01-03)
  Release notes

  License: PHP License 3.01

  * bugs
  - fixed error into grepStyle() method : conflict between goup (alibis) and simple element

  * QA
  User Guide 1.1.0 included in this release cover also versions 1.1.1 and 1.1.2 (bug fixes)

• 1.1.1 (stable, 2007-01-01)
  Release notes

  License: PHP License 3.01

  * bugs
  - it was impossible to use isError() in cascade with version 1.1.0
  - fixed version number on license declared and used in CSS.php file

• 1.1.0 (stable, 2007-01-01)
  Release notes

  License: PHP License 3.01

  * news
  - add new feature : ability to search if an element/property is defined or not
  - upgraded copyright notice to new year 2007

  * QA
  - add new example CSS_grepStyles.php for function grepStyle()
  - include a new revision of User Guide (TDG).
  see http://pear.laurent-laville.org/HTML_CSS for more format to download.

• 1.0.1 (stable, 2006-12-21)
  Release notes

  License: PHP License 3.01

  - fix a bug with HTML_CSS::isError() method
  - drop support of package xml 1.0; Now we must have at least PEAR 1.4.3
  - License change from PHP 3.0 to PHP 3.01

• 1.0.0 (stable, 2006-06-24)
  Release notes

  License: PHP License 3.0

  After 2 releases candidate and no bug reported since 6 months, it's time to build the final stable version 1.0.0

  * Improvements
  - add @ignore phpdoc tag in all unit tests to hide them in API doc generation.
  - introduces package xml 2.0

  * Quality Assurance
  - header comment blocks were updated (copyright dates, ...)
  - include a user-guide in html format (others format to download on http://pear.laurent-laville.org/HTML_CSS/docs)

• 1.0.0RC2 (beta, 2005-12-15)
  Release notes

  License: PHP License 3.0

  New features:
  - parseData() : Ability to parse multiple data sources (filename, string) at once
  - isError() : Tell whether a value return by HTML_CSS is an error.

  See new script: examples/CSS_parseData.php

• 1.0.0RC1 (beta, 2005-07-26)
  Release notes

  License: PHP License 3.0

  New features:
  - PEAR_ErrorStack was replaced by a simple way to plug in any error handling system you might want (default used PEAR_Error object)
  - Duplicate properties can now be allowed.

  Bug fixes
  - Allows to fix a HTML_Progress problem (bug #2784)
  - Inappropriate style rule reordering (bug #3920)

  Changes
  - Removes PEAR_ErrorStack and Log packages dependencies
  - All unitTests are now fully PEAR_Error compatible
  - apiVersion() returns now a string rather than a float; compatible with php.version_compare()
  - createGroup() always returns a value now
  - parseSelectors() status goes from public to protected
  - collapseInternalSpaces() status goes from public to protected
  - setSameStyle() is now optimized and single old reference is removed from CSS declarations
  - toArray reimplemented (API changed if duplicates allowed)

  Quality Assurance
  - Updates headers comment block on all files

• 0.3.4 (beta, 2004-05-21)
  Release notes

  License: PHP License 3.0

  New features:
  * Added testcases for all bugs (Laurent)

  Bugfixes:
  * Added dependency on PEAR 1.3.1 or greater (necessary for error handling)
  * Compatibility fix for PHP5 in parseSelectors
  * Now parseSelectors correctly divides selectors with IDs (output mode 2)

• 0.3.3 (beta, 2004-05-20)
  Release notes

  License: PHP License 3.0

  New features:
  * New error implementation (PEAR_Error_Stack) (Laurent)
  * Added more testcases (Laurent)
  * Output definitions on single line

  Bugfixes:
  * #1072 (incomplete internal inheritance support in parseString and getStyle)
  * #1084 (parseSelectors unable to handle inheritance)

• 0.3.2 (beta, 2004-03-24)
  Release notes

  License: PHP License 3.0

  New features:
  * setXhtmlCompliance(bool)
  Determines whether elements are automatically lowercased
  for XHTML compliance. May also be passed to class constructor
  as array element 'xhtml'.
  * Selectors are now properly parsed to ensure compliance

  Bugfixes:
  * #725 (Elements differentiated because of whitespace)
  * #998 (parseString failure to parse property value when it contained a colon)
  * #1066 (Trim property values in parseString)

• 0.3.1 (beta, 2003-11-03)
  Release notes

  License: PHP License 3.0

  Warning:
  Major BC break!

  License change:
  Now PHP License 3.0

  New features:
  * Parse CSS from string (Laurent)
  * Read and parse CSS from file (Laurent)
  * Retrieve the settings of individual properties (Laurent)
  * Fully redesigned group handling
  * Output to file
  * Error handling introduced (Laurent)
  * Added unit tests (Laurent)

  Bugfixes:
  * Fixed setSameStyle functionality

• 0.3.0 (beta, 2003-11-03)
  Release notes

  License: PHP License 3.0

  Warning:
  Major BC break!

  License change:
  Now PHP License 3.0

  New features:
  * Parse CSS from string (Laurent)
  * Read and parse CSS from file (Laurent)
  * Retrieve the settings of individual properties (Laurent)
  * Fully redesigned group handling
  * Output to file
  * Error handling introduced (Laurent)
  * Added unit tests (Laurent)

  Bugfixes:
  * Examples updated

• 0.2.0 (stable, 2003-07-31)
  Release notes

  License: PHP License 2.02

  It is completely standards compliant, and has some great features:
  * Inline stylesheet declarations
  * Document internal stylesheet declarations
  * Standalone stylesheet declarations

  In addition, it shares the following with HTML_Common based classes:
  * Indent style support
  * Line ending style

Bugs