January 2024 release

What's Changed

• Improve detection of element in query by @tfedor in #168
• build: hard dependencies by @g105b in #178
• Bump phpstan/phpstan from 1.8.0 to 1.8.1 by @dependabot in #179
• Add default Editorconfig by @Alkarex in #182
• Implement star selector by @Alkarex in #181
• Markdownlint by @Alkarex in #183
• Bump phpstan/phpstan from 1.8.1 to 1.8.2 by @dependabot in #180
• 189 dependabot by @g105b in #191
• Match attribute names in a case-insensitive manner. by @chrishow in #219
• Implement 'equals starts with' ('^=') and 'equals or starts with hyphenated' ('|=') selectors by @chrishow in #221

New Contributors

• @tfedor made their first contribution in #168
• @Alkarex made their first contribution in #182
• @chrishow made their first contribution in #219

Full Changelog: v1.1.4...v1.2.0

PHP 7.3 compatibility

Backwards compatibility is added in this release to allow PHP.Gt/Dom v2 to retain compatibility with PHP 7.3

CI and type safety improvements

This minor patch release includes the switch from Circle CI to Github Actions along with a few improvements to how types are hinted, for static analysis improvement.

November 2019 bugfixes

When using continue within switch statements, special care has to be taken to ensure the loops are continued as expected. This release removes ambiguity by specifying the continue nesting argument.

From https://www.php.net/manual/en/control-structures.continue.php :

Note: In PHP the switch statement is considered a looping structure for the purposes of continue. continue behaves like break (when no arguments are passed). If a switch is inside a loop, continue 2 will continue with the next iteration of the outer loop.

August 2019 bugfixes

This release contains a number of bugfixes:

• Bugfix for selecting children of attribute selector. The bug meant that the selector context was reset to the documentElement when in a deeper query than selecting attribute values.
• Update DOM dependency fixing issue with iterators in tests. Iterating over HTMLCollections is only one method of working with HTMLCollections. Asking for the current() item would use the iterator but it would throw a RunTime exception if the iterator wasn't rewound.
• Expose other attribute selector types. There are many types of attribute selector. Now these types are defined as constants in the Translator.
• More descriptive variable names.

Regular expression splitting multiple queries

Multiple CSS selectors can be present within the same query like this: div>a, div>li>a, and a simple explode() was being called to split the strings. However, this caused an issue when one selector was looking for an attribute selector whose value contained a comma.

To solve this, a regular expression has been used to split only commas that are not surrounded by quotes.

Stable release

With the push to release PhpGt repositories to their stable versions, this release includes the single piece of functionality that was holding it back from being integrated within WebEngine: the ability to assign a prefix to the XPath query.

This is used within the PhpGt/Dom repository to allow typical child-based searches, but also parent-based searches for using DOM functionality such as $element->closest($selector).

The library has been in use within WebEngine for a number of weeks so is receiving its first stable release, and even though advanced functionality like :not selector is missing right now (and admittedly, doing advanced CSS selectors within your server-side code is probably a bad idea), we're looking forward to adding more completeness to the library for future releases.

Have fun and stay productive!

Multiple CSS selectors, comma separated

Part of the CSS specification is the ability to match multiple selectors as one, separated by a comma. This has now been implemented in this repository by splitting the input string on a comma and converting to multiple XPath queries that are chainable.

Amongst this feature, unit tests and continuous integration platforms have been upgraded to the latest versions, and unit tests have been hardened.

Class selection improvements

Multiple class selectors can now be chained together, fixing a known bug. Classes are now normalised on entry to fix some false positives.

Test, test, test

Because of the reliance on Symfony's CSS selector package, it's very important to test real-world use cases of CSS selectors.

It is not greatly important to get to full CSS-spec for v1 release, because there are so many complex selectors that just shouldn't be performed on the server, but getting 100% test coverage is a must.

Currently at 68%!