style.backgroundRepeatプロパティ

style.backgroundRepeatは、要素のスタイル属性のbackground-repeatプロパティの値を取得、もしくは、設定するプロパティ。

background-repeatプロパティは、要素の背景画像を水平方向(X軸)や垂直方向(Y軸)へ並べて表示するかどうかを指定することができる。

構文

取得

var $backgroundRepeat = $elementReference.style.backgroundRepeat;

戻り値

要素のスタイル属性のbackground-repeatプロパティの値。

設定

$elementReference.style.backgroundRepeat = "repeat | repeat-x | repeat-y | no-repeat | inherit";
repeat | repeat-x | repeat-y | no-repeat | inherit
背景画像を水平方向(X軸)や垂直方向(Y軸)へ並べて表示するかどうか。
下記の何れかの方法で指定する。初期設定値は、「repeat」。
  • repeat:水平方向(X軸)にも垂直方向(Y軸)にも並べて表示。
  • repeat-x:水平方向(X軸)にだけ並べて表示。
  • repeat-y:垂直方向(Y軸)にだけ並べて表示。
  • no-repeat:並べない。
  • inherit:親要素の「background-repeat」プロパティを継承。

サンプル

サンプルボックス要素

変更後のスタイルのbackground-repeatプロパティの値:

サンプルの動作について

  • 「設定(repeat)」ボタンをクリックすると、「サンプルボックス要素」の背景画像を水平方向にも垂直方向にも並べて表示し、「変更後のスタイルのbackground-repeatプロパティの値:」の右横に「repeat」と表示する。
  • 「設定(repeat-x)」ボタンをクリックすると、「サンプルボックス要素」の背景画像を水平方向にだけ並べて表示し、「変更後のスタイルのbackground-repeatプロパティの値:」の右横に「repeat-x」と表示する。
  • 「設定(repeat-y)」ボタンをクリックすると、「サンプルボックス要素」の背景画像を垂直方向にだけ並べて表示し、「変更後のスタイルのbackground-repeatプロパティの値:」の右横に「repeat-y」と表示する。
  • 「設定(no-repeat)」ボタンをクリックすると、「サンプルボックス要素」の背景画像を水平方向にも垂直方向にも並べずに、左上にだけ表示し、「変更後のスタイルのbackground-repeatプロパティの値:」の右横に「no-repeat」と表示する。

サンプルのソースコード

JavaScript

<script type="text/javascript">
function setBackground( $repeat ) {
 var $elementReference = document.getElementById( "sample" );
 $elementReference.style.backgroundRepeat = $repeat;
 var $backgroundRepeat = $elementReference.style.backgroundRepeat;
 document.getElementById( "sampleOutput" ).innerHTML = $backgroundRepeat;
}
</script>

HTML

<div id="sample" style="background: yellow url('http://alphasis.info/wp-content/uploads/2012/01/gimp-tutorial-12012402.jpg'); margin: 10px 0; width: 300px; height: 200px;">サンプルボックス要素</div>
<button onclick="setBackground('repeat');">設定(repeat)</button>
<button onclick="setBackground('repeat-x');">設定(repeat-x)</button>
<button onclick="setBackground('repeat-y');">設定(repeat-y)</button>
<button onclick="setBackground('no-repeat');">設定(no-repeat)</button>
<p>変更後のスタイルのbackground-repeatプロパティの値:<span id="sampleOutput"></span></p>

スポンサード リンク

カテゴリー: DOM, JavaScript, Styleオブジェクト, プロパティ, リファレンス, 背景 パーマリンク