Changeset 51729

Timestamp:

09/03/2021 01:36:20 AM (3 years ago)

Author:

SergeyBiryukov

Message:

Docs: Move @since notes from the safe_style_css filter to the safecss_filter_attr() function.

The filter allows to modify the list of allowed CSS attributes, however support for specific CSS attributes is added to the function rather than the filter.

Follow-up to [37931], [38121], [42880], [44136], [44531], [45242], [45363], [46235], [46793], [50634], [50923].

Props tmatsuur, muhammadfaizanhaidar, sabernhardt.
Fixes #53731.

File:

• trunk/src/wp-includes/kses.php (modified) (2 diffs)

trunk/src/wp-includes/kses.php

@@ -2153 +2153 @@
  *
  * @since 2.8.1
+ * @since 4.4.0 Added support for `min-height`, `max-height`, `min-width`, and `max-width`.
+ * @since 4.6.0 Added support for `list-style-type`.
+ * @since 5.0.0 Added support for `background-image`.
+ * @since 5.1.0 Added support for `text-transform`.
+ * @since 5.2.0 Added support for `background-position` and `grid-template-columns`.
+ * @since 5.3.0 Added support for `grid`, `flex` and `column` layout properties.
+ *              Extend `background-*` support of individual properties.
+ * @since 5.3.1 Added support for gradient backgrounds.
+ * @since 5.7.1 Added support for `object-position`.
+ * @since 5.8.0 Added support for `calc()` and `var()` values.
  *
  * @param string $css        A string of CSS rules.
@@ -2171 +2181 @@
 
     /**
-     * Filters list of allowed CSS attributes.
+     * Filters the list of allowed CSS attributes.
      *
      * @since 2.8.1
-     * @since 4.4.0 Added support for `min-height`, `max-height`, `min-width`, and `max-width`.
-     * @since 4.6.0 Added support for `list-style-type`.
-     * @since 5.0.0 Added support for `background-image`.
-     * @since 5.1.0 Added support for `text-transform`.
-     * @since 5.2.0 Added support for `background-position` and `grid-template-columns`.
-     * @since 5.3.0 Added support for `grid`, `flex` and `column` layout properties.
-     *              Extend `background-*` support of individual properties.
-     * @since 5.3.1 Added support for gradient backgrounds.
-     * @since 5.7.1 Added support for `object-position`.
-     * @since 5.8.0 Added support for `calc()` and `var()` values.
      *
      * @param string[] $attr Array of allowed CSS attributes.