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		// Bail early if value is not a string. Prevents fatal errors from malformed block markup.63		if ( ! is_string( $value ) ) {64			return $this;65		}66 67		// Trims the value. If empty, bail early.68		$value = trim( $value );69		if ( '' === $value ) {70			return $this;71		}72 73		// Adds the declaration property/value pair.74		$this->declarations[ $property ] = $value;75 76		return $this;77	}78 79	/**80	 * Removes a single declaration.81	 *82	 * @since 6.1.083	 *84	 * @param string $property The CSS property.85	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.86	 */87	public function remove_declaration( $property ) {88		unset( $this->declarations[ $property ] );89		return $this;90	}91 92	/**93	 * Adds multiple declarations.94	 *95	 * @since 6.1.096	 *