CSSList
2 months ago
Comment
2 months ago
Parsing
2 months ago
Position
2 months ago
Property
2 months ago
Rule
2 months ago
RuleSet
2 months ago
Value
2 months ago
CSSElement.php
2 months ago
OutputFormat.php
2 months ago
OutputFormatter.php
2 months ago
Parser.php
2 months ago
Renderable.php
2 months ago
Settings.php
2 months ago
Settings.php
99 lines
| 1 | <?php |
| 2 | |
| 3 | namespace ProfilePressVendor\Sabberworm\CSS; |
| 4 | |
| 5 | /** |
| 6 | * Parser settings class. |
| 7 | * |
| 8 | * Configure parser behaviour here. |
| 9 | */ |
| 10 | class Settings |
| 11 | { |
| 12 | /** |
| 13 | * Multi-byte string support. |
| 14 | * |
| 15 | * If `true` (`mbstring` extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr` |
| 16 | * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used. |
| 17 | * |
| 18 | * @var bool |
| 19 | * |
| 20 | * @internal since 8.8.0, will be made private in 9.0.0 |
| 21 | */ |
| 22 | public $bMultibyteSupport; |
| 23 | /** |
| 24 | * The default charset for the CSS if no `@charset` declaration is found. Defaults to utf-8. |
| 25 | * |
| 26 | * @var string |
| 27 | * |
| 28 | * @internal since 8.8.0, will be made private in 9.0.0 |
| 29 | */ |
| 30 | public $sDefaultCharset = 'utf-8'; |
| 31 | /** |
| 32 | * Whether the parser silently ignore invalid rules instead of choking on them. |
| 33 | * |
| 34 | * @var bool |
| 35 | * |
| 36 | * @internal since 8.8.0, will be made private in 9.0.0 |
| 37 | */ |
| 38 | public $bLenientParsing = \true; |
| 39 | private function __construct() |
| 40 | { |
| 41 | $this->bMultibyteSupport = extension_loaded('mbstring'); |
| 42 | } |
| 43 | /** |
| 44 | * @return self new instance |
| 45 | */ |
| 46 | public static function create() |
| 47 | { |
| 48 | return new Settings(); |
| 49 | } |
| 50 | /** |
| 51 | * Enables/disables multi-byte string support. |
| 52 | * |
| 53 | * If `true` (`mbstring` extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr` |
| 54 | * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used. |
| 55 | * |
| 56 | * @param bool $bMultibyteSupport |
| 57 | * |
| 58 | * @return self fluent interface |
| 59 | */ |
| 60 | public function withMultibyteSupport($bMultibyteSupport = \true) |
| 61 | { |
| 62 | $this->bMultibyteSupport = $bMultibyteSupport; |
| 63 | return $this; |
| 64 | } |
| 65 | /** |
| 66 | * Sets the charset to be used if the CSS does not contain an `@charset` declaration. |
| 67 | * |
| 68 | * @param string $sDefaultCharset |
| 69 | * |
| 70 | * @return self fluent interface |
| 71 | */ |
| 72 | public function withDefaultCharset($sDefaultCharset) |
| 73 | { |
| 74 | $this->sDefaultCharset = $sDefaultCharset; |
| 75 | return $this; |
| 76 | } |
| 77 | /** |
| 78 | * Configures whether the parser should silently ignore invalid rules. |
| 79 | * |
| 80 | * @param bool $bLenientParsing |
| 81 | * |
| 82 | * @return self fluent interface |
| 83 | */ |
| 84 | public function withLenientParsing($bLenientParsing = \true) |
| 85 | { |
| 86 | $this->bLenientParsing = $bLenientParsing; |
| 87 | return $this; |
| 88 | } |
| 89 | /** |
| 90 | * Configures the parser to choke on invalid rules. |
| 91 | * |
| 92 | * @return self fluent interface |
| 93 | */ |
| 94 | public function beStrict() |
| 95 | { |
| 96 | return $this->withLenientParsing(\false); |
| 97 | } |
| 98 | } |
| 99 |