safecss_filter_attr

（2.8.1以降）
safecss_filter_attr - インラインスタイルをサニタイズする

説明

string safecss_filter_attr( string $css [ , string $deprecated = '' ] )

インラインスタイルをサニタイズする。

パラメータ

$css
style属性値を指定。
$deprecated
使用不可（省略時は''）。

返り値

ルールに適合しない内容を取り除いたstyle属性値を返す。

注意

有効なスタイルのプロパティ名はバージョンによって異なる（適宜追加されてきている）。

プロパティ名	6.6.0	6.5.0	6.4.0	6.3.0	6.2.0	6.1.0	5.8.0	5.7.1	5.3.0	5.2.0	5.1.0
プロパティ名	6.6.0	6.5.0	6.4.0	6.3.0	6.2.0	6.1.0	5.8.0	5.7.1	5.3.0	5.2.0	5.1.0
background	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
background-color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
background-image	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
background-position	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
background-repeat	〇	〇
background-size	〇	〇	〇	〇	〇	〇	〇	〇	〇
background-attachment	〇	〇	〇	〇	〇	〇	〇	〇	〇
background-blend-mode	〇	〇	〇	〇	〇	〇	〇	〇	〇
border	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-radius	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-style	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-right	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-right-color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-right-style	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-right-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-bottom	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-bottom-color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-bottom-style	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-bottom-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-left	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-left-color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-left-style	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-left-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-top	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-top-color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-top-style	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-top-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-spacing	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
border-collapse	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
caption-side	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
columns	〇	〇	〇	〇	〇	〇	〇	〇	〇
column-count	〇	〇	〇	〇	〇	〇	〇	〇	〇
column-fill	〇	〇	〇	〇	〇	〇	〇	〇	〇
column-gap	〇	〇	〇	〇	〇	〇	〇	〇	〇
column-rule	〇	〇	〇	〇	〇	〇	〇	〇	〇
column-span	〇	〇	〇	〇	〇	〇	〇	〇	〇
column-width	〇	〇	〇	〇	〇	〇	〇	〇	〇
color	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
filter	〇	〇	〇	〇
font	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
font-family	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
font-size	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
font-style	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
font-variant	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
font-weight	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
letter-spacing	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
line-height	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
text-align	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
text-decoration	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
text-indent	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
text-transform	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
height	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
min-height	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
max-height	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
min-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
max-width	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
margin	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
margin-right	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
margin-bottom	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
margin-left	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
margin-top	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
margin-block-start	〇	〇	〇	〇	〇	〇
margin-block-end	〇	〇	〇	〇	〇	〇
margin-inline-start	〇	〇	〇	〇	〇	〇
margin-inline-end	〇	〇	〇	〇	〇	〇
padding	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
padding-right	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
padding-bottom	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
padding-left	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
padding-top	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
padding-block-start	〇	〇	〇	〇	〇	〇
padding-block-end	〇	〇	〇	〇	〇	〇
padding-inline-start	〇	〇	〇	〇	〇	〇
padding-inline-end	〇	〇	〇	〇	〇	〇
flex	〇	〇	〇	〇	〇	〇	〇	〇	〇
flex-basis	〇	〇	〇	〇	〇	〇	〇	〇	〇
flex-direction	〇	〇	〇	〇	〇	〇	〇	〇	〇
flex-flow	〇	〇	〇	〇	〇	〇	〇	〇	〇
flex-grow	〇	〇	〇	〇	〇	〇	〇	〇	〇
flex-shrink	〇	〇	〇	〇	〇	〇	〇	〇	〇
flex-wrap	〇	〇	〇	〇	〇	〇
gap	〇	〇	〇	〇	〇	〇
column-gap	〇	〇	〇	〇	〇	〇
row-gap	〇	〇	〇	〇	〇	〇
grid-template-columns	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-auto-columns	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-column-start	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-column-end	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-column	〇
grid-column-gap	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-template-rows	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-auto-rows	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-row-start	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-row-end	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-row	〇
grid-row-gap	〇	〇	〇	〇	〇	〇	〇	〇	〇
grid-gap	〇	〇	〇	〇	〇	〇	〇	〇	〇
justify-content	〇	〇	〇	〇	〇	〇	〇	〇	〇
justify-items	〇	〇	〇	〇	〇	〇	〇	〇	〇
justify-self	〇	〇	〇	〇	〇	〇	〇	〇	〇
align-content	〇	〇	〇	〇	〇	〇	〇	〇	〇
align-items	〇	〇	〇	〇	〇	〇	〇	〇	〇
align-self	〇	〇	〇	〇	〇	〇	〇	〇	〇
clear	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
cursor	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
direction	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
float	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
list-style-type	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
object-fit	〇	〇	〇	〇	〇	〇
object-position	〇	〇	〇	〇	〇	〇	〇	〇
overflow	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
vertical-align	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇	〇
writing-mode	〇	〇	〇
position	〇	〇	〇	〇	〇
top	〇	〇	〇	〇	〇
right	〇	〇	〇	〇	〇
bottom	〇	〇	〇	〇	〇
left	〇	〇	〇	〇	〇
z-index	〇	〇	〇	〇	〇
box-shadow	〇	〇	〇	〇
aspect-ratio	〇	〇	〇	〇	〇
container-type	〇
calc()	〇	〇	〇	〇	〇	〇	〇
var()	〇	〇	〇	〇	〇	〇	〇
min()	〇	〇	〇	〇	〇	〇
max()	〇	〇	〇	〇	〇	〇
minmax()	〇	〇	〇	〇	〇	〇
clamp()	〇	〇	〇	〇	〇	〇

'safe_style_css'フィルターにて得られる内容が空の場合、パラメータ$cssはそのまま返り値となる。

使用例

インラインスタイルをサニタイズする。

<?php $inline_style = safecss_filter_attr( $inline_style ); ?>

フィルター

[2.8.1]'safe_style_css'フィルターを呼び出す。パラメータ$attrには有効なスタイルのプロパティ名を列挙した配列が格納されている。

$allowed_attr = apply_filters( 'safe_style_css', $attr );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/kses.php

最終更新 : 2024年07月19日 15:14

参考

Code Reference: safecss_filter_attr

お勧め

任意の名前でエラーログファイルを指定する（2019年2月15日更新）

来週にはWordPress 5.1がリリース。RC1のソースコードを見ていると、 wp_debug_mode関数が変更されており、興味深かった。

Gutenbergでカスタムフィールドを使う（2018年8月10日更新）

Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。

Slightly troublesome permalink：プラグイン作ってみました（2021年4月20日更新）

カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。

WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日更新）

WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。

テキストエディタの文字を変更する（2018年5月27日更新）

テキストエディタ（投稿ページの「テキスト」タブのエディタ）に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。