safecss_filter_attr

Inline CSS filter.

Description

(string) safecss_filter_attr( (string) $css, (string) $deprecated = '' ); 

Returns (string)

Filtered string of CSS rules.

Parameters (2)

0. $css (string)
A string of CSS rules.
1. $deprecated — Optional. (string) => ''
The deprecated.

Usage

  1. if ( !function_exists( 'safecss_filter_attr' ) ) { 
  2.     require_once ABSPATH . WPINC . '/kses.php'; 
  3. } 
  4.   
  5. // A string of CSS rules. 
  6. $css = ''; 
  7.   
  8. // The deprecated. 
  9. $deprecated = ''; 
  10.   
  11. // NOTICE! Understand what this does before running. 
  12. $result = safecss_filter_attr($css, $deprecated); 
  13.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/kses.php  
  1. function safecss_filter_attr( $css, $deprecated = '' ) { 
  2.     if ( !empty( $deprecated ) ) 
  3.         _deprecated_argument( __FUNCTION__, '2.8.1' ); // Never implemented 
  4.  
  5.     $css = wp_kses_no_null($css); 
  6.     $css = str_replace(array("\n", "\r", "\t"), '', $css); 
  7.  
  8.     if ( preg_match( '%[\\\\(&=}]|/\*%', $css ) ) // remove any inline css containing \ ( & } = or comments 
  9.         return ''; 
  10.  
  11.     $css_array = explode( ';', trim( $css ) ); 
  12.  
  13.     /** 
  14.      * Filters list of allowed CSS attributes. 
  15.      * 
  16.      * @since 2.8.1 
  17.      * @since 4.4.0 Added support for `min-height`, `max-height`, `min-width`, and `max-width`. 
  18.      * @since 4.6.0 Added support for `list-style-type`. 
  19.      * 
  20.      * @param array $attr List of allowed CSS attributes. 
  21.      */ 
  22.     $allowed_attr = apply_filters( 'safe_style_css', array( 
  23.         'background',  
  24.         'background-color',  
  25.  
  26.         'border',  
  27.         'border-width',  
  28.         'border-color',  
  29.         'border-style',  
  30.         'border-right',  
  31.         'border-right-color',  
  32.         'border-right-style',  
  33.         'border-right-width',  
  34.         'border-bottom',  
  35.         'border-bottom-color',  
  36.         'border-bottom-style',  
  37.         'border-bottom-width',  
  38.         'border-left',  
  39.         'border-left-color',  
  40.         'border-left-style',  
  41.         'border-left-width',  
  42.         'border-top',  
  43.         'border-top-color',  
  44.         'border-top-style',  
  45.         'border-top-width',  
  46.  
  47.         'border-spacing',  
  48.         'border-collapse',  
  49.         'caption-side',  
  50.  
  51.         'color',  
  52.         'font',  
  53.         'font-family',  
  54.         'font-size',  
  55.         'font-style',  
  56.         'font-variant',  
  57.         'font-weight',  
  58.         'letter-spacing',  
  59.         'line-height',  
  60.         'text-decoration',  
  61.         'text-indent',  
  62.         'text-align',  
  63.  
  64.         'height',  
  65.         'min-height',  
  66.         'max-height',  
  67.  
  68.         'width',  
  69.         'min-width',  
  70.         'max-width',  
  71.  
  72.         'margin',  
  73.         'margin-right',  
  74.         'margin-bottom',  
  75.         'margin-left',  
  76.         'margin-top',  
  77.  
  78.         'padding',  
  79.         'padding-right',  
  80.         'padding-bottom',  
  81.         'padding-left',  
  82.         'padding-top',  
  83.  
  84.         'clear',  
  85.         'cursor',  
  86.         'direction',  
  87.         'float',  
  88.         'overflow',  
  89.         'vertical-align',  
  90.         'list-style-type',  
  91.  ) ); 
  92.  
  93.     if ( empty($allowed_attr) ) 
  94.         return $css; 
  95.  
  96.     $css = ''; 
  97.     foreach ( $css_array as $css_item ) { 
  98.         if ( $css_item == '' ) 
  99.             continue; 
  100.         $css_item = trim( $css_item ); 
  101.         $found = false; 
  102.         if ( strpos( $css_item, ':' ) === false ) { 
  103.             $found = true; 
  104.         } else { 
  105.             $parts = explode( ':', $css_item ); 
  106.             if ( in_array( trim( $parts[0] ), $allowed_attr ) ) 
  107.                 $found = true; 
  108.         } 
  109.         if ( $found ) { 
  110.             if( $css != '' ) 
  111.                 $css .= ';'; 
  112.             $css .= $css_item; 
  113.         } 
  114.     } 
  115.  
  116.     return $css; 
  117. }