WP_Style_Engine_CSS_Rule

17#[AllowDynamicProperties]18class WP_Style_Engine_CSS_Rule {19 20	/**21	 * The selector.22	 *23	 * @since 6.1.024	 * @var string25	 */26	protected $selector;27 28	/**29	 * The selector declarations.30	 *31	 * Contains a WP_Style_Engine_CSS_Declarations object.32	 *33	 * @since 6.1.034	 * @var WP_Style_Engine_CSS_Declarations35	 */36	protected $declarations;37 38	/**39	 * A parent CSS selector in the case of nested CSS, or a CSS nested @rule,40	 * such as `@media (min-width: 80rem)` or `@layer module`.41	 *42	 * @since 6.6.043	 * @var string44	 */45	protected $rules_group;46 47	/**48	 * Constructor.49	 *50	 * @since 6.1.051	 * @since 6.6.0 Added the `$rules_group` parameter.52	 *53	 * @param string                                    $selector     Optional. The CSS selector. Default empty string.54	 * @param string[]|WP_Style_Engine_CSS_Declarations $declarations Optional. An associative array of CSS definitions,55	 *                                                                e.g. `array( "$property" => "$value", "$property" => "$value" )`,56	 *                                                                or a WP_Style_Engine_CSS_Declarations object.57	 *                                                                Default empty array.58	 * @param string                                    $rules_group  A parent CSS selector in the case of nested CSS, or a CSS nested @rule,59	 *                                                                such as `@media (min-width: 80rem)` or `@layer module`.60	 */61	public function __construct( $selector = '', $declarations = array(), $rules_group = '' ) {62		$this->set_selector( $selector );63		$this->add_declarations( $declarations );64		$this->set_rules_group( $rules_group );65	}66 67	/**68	 * Sets the selector.69	 *70	 * @since 6.1.071	 *72	 * @param string $selector The CSS selector.73	 * @return WP_Style_Engine_CSS_Rule Returns the object to allow chaining of methods.74	 */75	public function set_selector( $selector ) {76		$this->selector = $selector;77		return $this;78	}79 80	/**81	 * Sets the declarations.82	 *83	 * @since 6.1.084	 * @since 7.1.0 Preserves declaration options when declarations are provided as a `WP_Style_Engine_CSS_Declarations` object.85	 *86	 * @param string[]|WP_Style_Engine_CSS_Declarations $declarations An array of declarations (property => value pairs),87	 *                                                                or a WP_Style_Engine_CSS_Declarations object.88	 * @return WP_Style_Engine_CSS_Rule Returns the object to allow chaining of methods.89	 */90	public function add_declarations( $declarations ) {91		$is_declarations_object = ! is_array( $declarations );92		$declarations_array     = $is_declarations_object ? $declarations->get_declarations() : $declarations;93		$declaration_options    = $is_declarations_object ? $declarations->get_declaration_options() : array();94 95		if ( null === $this->declarations ) {96			if ( $is_declarations_object ) {