備忘録的プログラミングリファレンス

mask-repeat プロパティ

 mask-repeat プロパティは、マスク加工においてマスク画像の繰り返し表示の変更を指定するための CSS プロパティです。
 マスク画像または描写は mask-image プロパティを使用します。マスク画像はデフォルトで繰り返し表示されます。mask-repeat によってその繰り返し表示の方法を変更することができます。

mask-repeat プロパティ
mask-image: url(img/test.png);
mask-repeat: no-repeat;

詳しくは Example を参照してください

 mask プロパティによって、mask-imagemask-modemask-positionmask-size、mask-repeat、mask-originmask-clipmask-composite の一括指定ができます。

ページ内 Index

構文(Syntax)

 mask-repeat プロパティの構文についてです。

CSS

mask-repeat: [ repeat | repeat-x | repeat-y | space | round | no-repeat ] ;

DOM ( JavaScript )

値の取得
object.style.maskRepeat
値の設定
 object.style.maskRepeat = " [ repeat | repeat-x | repeat-y | space | round | no-repeat ] "

 横方向と縦方向を2つの値で指定することもできます。

 例えば以下は repeat-x と同じ意味です。

repeat-x と同じ
mask-repeat: repeat no-repeat;

 mask-repeat プロパティの値は複数を指定することもできます。複数を指定する場合にはカンマ,で区切ります。

 グローバル値として initialinheritrevertunset も使用することができます。

値(Values)

 以下は mask-repeat プロパティに指定できる値には以下があります。

Value摘要
repeatデフォルト
repeat-x横方向にのみ繰り返す
repeat-y縦方向にのみ繰り返す
spaceマスク画像が途中で切れる部分がないように、均等に繰り返し表示されます
roundマスク画像が途中で切れる部分がないように、マスク画像が拡大または縮小されます
no-repeat繰り返し表示されません

 以下のグローバル値も指定できます。

キーワード値機能
initial仕様で決められた設定値
inherit親エレメントの設定値を継承
revertブラウザで設定された値
unset継承値が優先される。値が継承値されるプロパティでは inherit に同じ。継承されない場合は revert に同じ

 指定値を固定化する場合は !important 宣言を加えます。

備考(Remarks)

 mask-repeat プロパティの備考についてです

初期値(Default value)repeat
継承(Inherited)no
変化(Animatable)no

Example

 mask-repeat プロパティの例です。mask-repeat プロパティはマスク画像の繰り返し表示を変更することができます。

 以下の例では、マスク画像が繰り返し表示されるように mask-size プロパティを 30% に指定してあります。mask-repeat: space; で均等に繰り返し表示されます。

 制作上の注意点としてマスク加工はサーバーからの読み込み( http プロトコルであることが必要 )でないと正常に機能しません。端末でのファイル読み込みではマスクによる表示はされません。