index.html

--- layout: single property_name: background-image ---<section id="background-image" class="property"><header class="property-header"><nav class="property-links"><a class="property-links-direct" href="{{site.url}}/property/background-image/" data-property-name="background-image" data-tooltip="Single page for this property" target="_blank">Link</a> <a class="property-share" data-tooltip="Share on Twitter or Facebook" data-property-name="background-image">Share</a> <a target="_blank" href="https://developer.mozilla.org/en/docs/Web/CSS/background-image" data-tooltip="See on Mozilla Developer Network" rel="external">MDN</a></nav><h2 class="property-name"><a href="{{site.url}}/#background-image"><span>#</span>background-image</a></h2><div class="property-description"><p>Defines an image as the background of the element.</p></div></header><style type="text/css">.background-image { background-repeat: no-repeat;height: 200px; }</style><section class="example"><header class="example-header"><p class="example-name"><code class="example-default" data-tooltip="This is the property's default value">default</code> <code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: none;">background-image: none;</code></p><div class="example-description"><p>Removes any background image.</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-none">Hello world</div></div></aside><style type="text/css">#background-image-none{ background-image:none;}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: url(/images/jt.png);">background-image: url(/images/jt.png);</code></p><div class="example-description"><p>Uses the image defined in the <strong>url</strong> path. This path can either be <em>relative</em> (to the css file) or <em>absolute</em> (like <code>http://cssreference.io/images/jt.png</code>).</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-urlimagesjtpng">Hello world</div></div></aside><style type="text/css">#background-image-urlimagesjtpng{ background-image:url(/images/jt.png);}</style><style type="text/css">#background-image-urlimagesjtpng{ background-size: 64px 64px; }</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: linear-gradient(red, blue);">background-image: linear-gradient(red, blue);</code></p><div class="example-description"><p>You can define a <strong>linear gradient</strong> as the background image.</p><p>You need to define at least <strong>two colors</strong>. The first one will start at the top, the second one at the bottom.</p><p>The default angle is <code>to bottom</code> (or <code>180deg</code>), which means the gradient is <strong>vertical</strong>, starting at the top, ending at the bottom of the element.</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-linear-gradientred-blue">Hello world</div></div></aside><style type="text/css">#background-image-linear-gradientred-blue{ background-image:linear-gradient(red, blue);}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: linear-gradient(45deg, red, blue);">background-image: linear-gradient(45deg, red, blue);</code></p><div class="example-description"><p>You can specify an <strong>angle</strong>, either in <strong>degrees</strong>, or with keywords.</p><p>When using degress, you specify the <em>direction</em> of the gradient, or when it ends. So <code>0deg</code> means the the <strong>top</strong> of the element, like 12:00 on a clock.</p><p>In this example, <code>45deg</code> means 2:30, or the top right corner.</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-linear-gradient45deg-red-blue">Hello world</div></div></aside><style type="text/css">#background-image-linear-gradient45deg-red-blue{ background-image:linear-gradient(45deg, red, blue);}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: radial-gradient(green, purple);">background-image: radial-gradient(green, purple);</code></p><div class="example-description"><p>You can define a <strong>radial gradient</strong> as the background image.</p><p>You need to define at least <strong>two colors</strong>. The first one will be at the center, the second one at the edges.</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-radial-gradientgreen-purple">Hello world</div></div></aside><style type="text/css">#background-image-radial-gradientgreen-purple{ background-image:radial-gradient(green, purple);}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: radial-gradient(circle, green, purple);">background-image: radial-gradient(circle, green, purple);</code></p><div class="example-description"><p>You can specify the <strong>shape</strong> of the radial gradient: <strong>circle</strong> or <strong>ellipse</strong> (default).</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-radial-gradientcircle-green-purple">Hello world</div></div></aside><style type="text/css">#background-image-radial-gradientcircle-green-purple{ background-image:radial-gradient(circle, green, purple);}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: radial-gradient(circle, green 0%, purple 20%, orange 100%);">background-image: radial-gradient(circle, green 0%, purple 20%, orange 100%);</code></p><div class="example-description"><p>You can specify <strong>color stops</strong> using percentage values.</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-radial-gradientcircle-green-0-purple-20-orange-100">Hello world</div></div></aside><style type="text/css">#background-image-radial-gradientcircle-green-0-purple-20-orange-100{ background-image:radial-gradient(circle, green 0%, purple 20%, orange 100%);}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: radial-gradient(circle closest-side, green 0%, purple 20%, orange 100%);">background-image: radial-gradient(circle closest-side, green 0%, purple 20%, orange 100%);</code></p><div class="example-description"><p>You can specify <em>where</em> the gradient should <strong>end</strong>:</p><ul><li><code>closest-side</code></li><li><code>closest-corner</code></li><li><code>farthest-side</code></li><li><code>farthest-corner</code></li></ul></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-radial-gradientcircle-closest-side-green-0-purple-20-orange-100">Hello world</div></div></aside><style type="text/css">#background-image-radial-gradientcircle-closest-side-green-0-purple-20-orange-100{ background-image:radial-gradient(circle closest-side, green 0%, purple 20%, orange 100%);}</style></section><section class="example"><header class="example-header"><p class="example-name"><code class="example-value" data-tooltip="Click to copy" data-clipboard-text="background-image: radial-gradient(circle closest-side at 45px 45px, green 0%, purple 20%, orange 100%);">background-image: radial-gradient(circle closest-side at 45px 45px, green 0%, purple 20%, orange 100%);</code></p><div class="example-description"><p>Like with the <a href="http://cssreference.io/#background-position"><code>background-position</code></a>, you can specify the <strong>position</strong> of the gradient.</p></div></header><aside class="example-preview"><div class="example-browser"><i></i><i></i><i></i></div><div class="example-output"><div class="example-output-div background-image" id="background-image-radial-gradientcircle-closest-side-at-45px-45px-green-0-purple-20-orange-100">Hello world</div></div></aside><style type="text/css">#background-image-radial-gradientcircle-closest-side-at-45px-45px-green-0-purple-20-orange-100{ background-image:radial-gradient(circle closest-side at 45px 45px, green 0%, purple 20%, orange 100%);}</style></section></section>