WP_Style_Engine_CSS_Declarations

17#[AllowDynamicProperties]18class WP_Style_Engine_CSS_Declarations {19 20	/**21	 * An array of CSS declarations (property => value pairs).22	 *23	 * @since 6.1.024	 *25	 * @var string[]26	 */27	protected $declarations = array();28 29	/**30	 * Constructor for this object.31	 *32	 * If a `$declarations` array is passed, it will be used to populate33	 * the initial `$declarations` prop of the object by calling add_declarations().34	 *35	 * @since 6.1.036	 *37	 * @param string[] $declarations Optional. An associative array of CSS definitions,38	 *                               e.g. `array( "$property" => "$value", "$property" => "$value" )`.39	 *                               Default empty array.40	 */41	public function __construct( $declarations = array() ) {42		$this->add_declarations( $declarations );43	}44 45	/**46	 * Adds a single declaration.47	 *48	 * @since 6.1.049	 *50	 * @param string $property The CSS property.51	 * @param string $value    The CSS value.52	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.53	 */54	public function add_declaration( $property, $value ) {55		// Sanitizes the property.56		$property = $this->sanitize_property( $property );57		// Bails early if the property is empty.58		if ( empty( $property ) ) {59			return $this;60		}61 62		// Trims the value. If empty, bail early.63		$value = trim( $value );64		if ( '' === $value ) {65			return $this;66		}67 68		// Adds the declaration property/value pair.69		$this->declarations[ $property ] = $value;70 71		return $this;72	}73 74	/**75	 * Removes a single declaration.76	 *77	 * @since 6.1.078	 *79	 * @param string $property The CSS property.80	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.81	 */82	public function remove_declaration( $property ) {83		unset( $this->declarations[ $property ] );84		return $this;85	}86 87	/**88	 * Adds multiple declarations.89	 *90	 * @since 6.1.091	 *92	 * @param string[] $declarations An array of declarations.93	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.94	 */95	public function add_declarations( $declarations ) {96		foreach ( $declarations as $property => $value ) {