README

This is a repository for PEAR HTML_Common2 package that has been migrated from PEAR SVN.

The package contains an abstract HTML_Common2 class that implements methods for HTML attributes handling and setting document-wide options. It is quite helpful as a building block for packages generating HTML and is currently used as such by PEAR HTML_QuickForm2 package. The package is a PHP5 rewrite of PEAR HTML_Common.

Features:

• Allows easy setting, removing, merging of HTML attributes, working with CSS classes;
• Provides means to parse and generate HTML attribute strings;
• Global document options: charset, linebreak and indentation characters;
• Methods to handle indentation and HTML comments (useful in subclasses).

Please report all issues via the PEAR bug tracker or Github issues.

End-user documentation as well as generated API documentation for current release is available on PEAR website.

Pull requests are welcome.

Installation

The package may be installed either with PEAR

$ pear install HTML_Common2

or with composer

$ composer require pear/html_common2

Note that composer.json does not define include-path option: require_once 'HTML/Common2.php' will not work with composer installation, use autoloading.

Testing, Packaging and Installing (Pear)

To test, run either

$ phpunit tests/

or

$ pear run-tests -r

To build, simply

$ pear package

To install from scratch

$ pear install package.xml

To upgrade

$ pear upgrade -f package.xml