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	 * CSS declaration options keyed by property name.31	 *32	 * @since 7.1.033	 *34	 * @var array35	 */36	protected $declaration_options = array();37 38	/**39	 * Constructor for this object.40	 *41	 * If a `$declarations` array is passed, it will be used to populate42	 * the initial `$declarations` prop of the object by calling add_declarations().43	 *44	 * @since 6.1.045	 *46	 * @param string[] $declarations Optional. An associative array of CSS definitions,47	 *                               e.g. `array( "$property" => "$value", "$property" => "$value" )`.48	 *                               Default empty array.49	 */50	public function __construct( $declarations = array() ) {51		$this->add_declarations( $declarations );52	}53 54	/**55	 * Adds a single declaration.56	 *57	 * @since 6.1.058	 * @since 7.1.0 Added the `$options` parameter.59	 *60	 * @param string $property The CSS property.61	 * @param string $value    The CSS value.62	 * @param array  $options  {63	 *     Optional. An array of options. Default empty array.64	 *65	 *     @type bool $important Whether to output the declaration with !important. Default false.66	 * }67	 * @return WP_Style_Engine_CSS_Declarations Returns the object to allow chaining methods.68	 */69	public function add_declaration( $property, $value, $options = array() ) {70		// Sanitizes the property.71		$property = $this->sanitize_property( $property );72		// Bails early if the property is empty.73		if ( empty( $property ) ) {74			return $this;75		}76 77		// Bail early if value is not a string. Prevents fatal errors from malformed block markup.78		if ( ! is_string( $value ) ) {79			return $this;80		}81 82		// Trims the value. If empty, bail early.83		$value = trim( $value );84		if ( '' === $value ) {85			return $this;86		}87 88		$options = wp_parse_args(89			$options,90			array(91				'important' => false,92			)93		);94		$options = array_filter( $options );95 96		// Adds the declaration property/value pair.