initial commit

1 files changed, 183 insertions, 0 deletions

diff --git a/files/zh-cn/web/css/box-shadow/index.html b/files/zh-cn/web/css/box-shadow/index.html
new file mode 100644
index 0000000000..dadc4abfd0
--- /dev/null
+++ b/files/zh-cn/web/css/box-shadow/index.html
@@ -0,0 +1,183 @@
+---
+title: box-shadow
+slug: Web/CSS/box-shadow
+tags:
+  - CSS
+  - CSS 属性
+  - Reference
+  - shadow
+  - 参考
+  - 样式
+  - 阴影
+translation_of: Web/CSS/box-shadow
+---
+<p>{{CSSRef}}</p>
+
+<p><span class="seoSummary"><a href="/zh-CN/docs/Web/CSS">CSS</a> <code><strong>box-shadow</strong></code><strong> </strong>属性用于在元素的框架上添加阴影效果。你可以在同一个元素上设置多个阴影效果，并用逗号将他们分隔开。该属性可设置的值包括阴影的X轴偏移量、Y轴偏移量、模糊半径、扩散半径和颜色。</span></p>
+
+<div>{{EmbedInteractiveExample("pages/css/box-shadow.html")}}</div>
+
+
+
+<p>你几乎可以在任何元素上使用<code>box-shadow</code>来添加阴影效果。如果元素同时设置了 {{ cssxref("border-radius") }}属性 ，那么阴影也会有圆角效果。多个阴影在z轴上的顺序和多个 <a href="/zh-CN/CSS/text-shadow" title="text-shadow">text shadows</a> 规则相同(第一个阴影在最上面)。</p>
+
+<p><a href="/zh-CN/docs/Web/CSS/CSS_Box_Model/Box-shadow_generator">Box-shadow generator</a>  是一个允许你生成 <code>box-shadow</code> 的交互式工具。</p>
+
+<h2 id="Syntax" name="Syntax">语法</h2>
+
+<pre class="brush: css no-line-numbers notranslate">/* x偏移量 | y偏移量 | 阴影颜色 */
+box-shadow: 60px -16px teal;
+
+/* x偏移量 | y偏移量 | 阴影模糊半径 | 阴影颜色 */
+box-shadow: 10px 5px 5px black;
+
+/* x偏移量 | y偏移量 | 阴影模糊半径 | 阴影扩散半径 | 阴影颜色 */
+box-shadow: 2px 2px 2px 1px rgba(0, 0, 0, 0.2);
+
+/* 插页(阴影向内) | x偏移量 | y偏移量 | 阴影颜色 */
+box-shadow: inset 5em 1em gold;
+
+/* 任意数量的阴影，以逗号分隔 */
+box-shadow: 3px 3px red, -1em 0 0.4em olive;
+
+/* 全局关键字 */
+box-shadow: inherit;
+box-shadow: initial;
+box-shadow: unset;
+</pre>
+
+<p>向元素添加单个 box-shadow 效果时使用以下规则：</p>
+
+<ul>
+ <li>当给出两个、三个或四个 <code><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/CSS/length">&lt;length&gt;</a></code>值时。
+
+  <ul>
+   <li>如果只给出两个值, 那么这两个值将会被当作 <code><a href="#offset-x">&lt;offset-x&gt;&lt;offset-y&gt;</a></code> 来解释。</li>
+   <li>如果给出了第三个值, 那么第三个值将会被当作<code><a href="#blur-radius">&lt;blur-radius&gt;</a></code>解释。</li>
+   <li>如果给出了第四个值, 那么第四个值将会被当作<code><a href="#spread-radius">&lt;spread-radius&gt;</a></code>来解释。</li>
+  </ul>
+ </li>
+ <li>可选，<code><a href="#inset">inset</a></code>关键字。</li>
+ <li>可选，<code><a href="#color">&lt;color&gt;</a></code>值。</li>
+</ul>
+
+<p>若要对同一个元素添加多个阴影效果，请使用逗号将每个阴影规则分隔开。</p>
+
+<h3 id="Values" name="Values">取值</h3>
+
+<dl>
+ <dt><a name="inset"><code>inset</code></a></dt>
+ <dd>如果没有指定<code>inset</code>，默认阴影在边框外，即阴影向外扩散。<br>
+ 使用 <code>inset</code> 关键字会使得阴影落在盒子内部，这样看起来就像是内容被压低了。 此时阴影会在边框之内 (即使是透明边框）、背景之上、内容之下。</dd>
+ <dt><a id="offset-x" name="offset-x"><code>&lt;offset-x&gt;</code> <code>&lt;offset-y&gt;</code></a></dt>
+ <dd>这是头两个 {{cssxref("&lt;length&gt;")}} 值，用来设置阴影偏移量。x,y 是按照数学二维坐标系来计算的，只不过y垂直方向向下。  <code>&lt;offset-x&gt;</code> 设置水平偏移量，正值阴影则位于元素右边，负值阴影则位于元素左边。 <code>&lt;offset-y&gt;</code> 设置垂直偏移量，正值阴影则位于元素下方，负值阴影则位于元素上方。可用单位请查看 {{cssxref("&lt;length&gt;")}} 。</dd>
+ <dd>如果两者都是0，那么阴影位于元素后面。这时如果设置了<code>&lt;blur-radius&gt;</code> 或<code>&lt;spread-radius&gt;</code> 则有模糊效果。需要考虑 <code>inset</code> </dd>
+ <dt><a id="blur-radius" name="blur-radius"><code>&lt;blur-radius&gt;</code></a></dt>
+ <dd>这是第三个 {{cssxref("&lt;length&gt;")}} 值。值越大，模糊面积越大，阴影就越大越淡。 不能为负值。默认为0，此时阴影边缘锐利。本规范不包括如何计算模糊半径的精确算法，但是，它详细说明如下：</dd>
+</dl>
+
+<blockquote>对于长而直的阴影边缘，它会创建一个过渡颜色用于模糊 以阴影边缘为中心、模糊半径为半径的局域，过渡颜色的范围在完整的阴影颜色到它最外面的终点的透明之间。 （译者注：对此有兴趣的可以了解下数字图像处理的模糊算法。）</blockquote>
+
+<dl>
+ <dt><code>&lt;<a id="spread-radius" name="spread-radius">spread-radius</a>&gt;</code></dt>
+ <dd>这是第四个 {{cssxref("&lt;length&gt;")}} 值。取正值时，阴影扩大；取负值时，阴影收缩。默认为0，此时阴影与元素同样大。需要考虑 <code>inset</code> </dd>
+ <dt><code>&lt;<a id="color" name="color">color</a>&gt;</code></dt>
+ <dd>相关事项查看 {{cssxref("&lt;color&gt;")}} 。如果没有指定，则由浏览器决定——通常是{{cssxref("color")}}的值，不过目前Safari取透明。</dd>
+</dl>
+
+<h3 id="合成">合成</h3>
+
+<p>将none看做是长度为0的列表。</p>
+
+<p>列表中的每个阴影通过<code>color</code>组件（作为颜色），以及 x，y，blur，（合适的时候）加上spread组件（作为长度）进行合成。对于每个阴影，如果两个输入的阴影都是inset或者都不是inset，那么要添加的阴影必须考虑已存在的阴影。如果任何一对输入阴影中，一个是inset，另一个不是inset，那么整个阴影列表就是不可合成的。如果阴影列表有不同的长度，那么较短的列表会在尾部补上这类阴影：颜色透明，所有长度为0，inset还是非inset同较长的列表。</p>
+
+<h3 id="正规文法">正规文法</h3>
+
+<pre class="syntaxbox notranslate">{{csssyntax}}</pre>
+
+<div class="hidden">
+<p>此处应翻译为“正规文法”或“正则文法”。对此有兴趣的可以了解下 编译原理 的 “正规文法”</p>
+</div>
+
+<h2 id="例子">例子</h2>
+
+<p>第一个例子中，包括了三种shadows，内置的阴影, 常规的下沉阴影, 和一个2个像素宽度的border式的阴影 (可以用 {{cssxref('outline')}} 来替代第三种)。</p>
+
+<div id="Examples1">
+<h3 id="HTML">HTML</h3>
+
+<pre class="brush: html notranslate">&lt;blockquote&gt;&lt;q&gt;You may shoot me with your words,&lt;br/&gt;
+You may cut me with your eyes,&lt;br/&gt;
+You may kill me with your hatefulness,&lt;br/&gt;
+But still, like air, I'll rise.&lt;/q&gt;
+&lt;p&gt;&amp;mdash; Maya Angelou&lt;/p&gt;
+&lt;/blockquote&gt;</pre>
+
+<h3 id="CSS">CSS</h3>
+
+<pre class="brush: css notranslate">blockquote {
+  padding: 20px;
+  box-shadow:
+       inset 0 -3em 3em rgba(0,0,0,0.1),
+             0 0  0 2px rgb(255,255,255),
+             0.3em 0.3em 1em rgba(0,0,0,0.3);
+}</pre>
+</div>
+
+<p>{{EmbedLiveSample('Examples1', '300', '300')}}</p>
+
+<div id="Examples2">
+<h3 id="HTML_2">HTML</h3>
+
+<pre class="brush: html notranslate">&lt;div&gt;&lt;p&gt;Hello World&lt;/p&gt;&lt;/div&gt;</pre>
+
+<h3 id="CSS_2">CSS</h3>
+
+<pre class="brush: css notranslate">p {
+  box-shadow: 0 0 0 2em #F4AAB9,
+              0 0 0 4em #66CCFF;
+  margin: 4em;
+  padding:1em;
+}</pre>
+</div>
+
+<p>{{EmbedLiveSample('Examples2', '300', '300')}}</p>
+
+<p>当 <code>x-offset</code>, <code>y-offset</code>, 和  <code>blur</code> 都是0, 盒阴影将是一个四边都是一样长度的带有颜色的<code>outline</code>. 当设置了多个阴影时，阴影绘制由最后一个开始， 故第一个设置的阴影将覆盖在后设置的阴影之上. 当<code>border-radius设置为0时（也是其默认值）</code>, 阴影的四角将没有弧度. 当我们设置了<code>border-radius</code>为其他不为0的值时，阴影的四角也随之形成弧度。</p>
+
+<p>我们通常在元素上增加一个大小为最大阴影宽度的<code>margin</code>值以保证阴影不会覆盖到相邻的元素或者覆盖到元素的<code>border</code>上. <code>box-shadow</code>属性不会影响到盒模型的构成。</p>
+
+<h2 class="cleared" id="规范">规范</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">规范</th>
+   <th scope="col">状态</th>
+   <th scope="col">注</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{ SpecName('CSS3 Backgrounds', '#box-shadow', 'box-shadow') }}</td>
+   <td>{{ Spec2('CSS3 Backgrounds') }}</td>
+   <td>初次定义</td>
+  </tr>
+ </tbody>
+</table>
+
+<p>{{cssinfo}}</p>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+<div class="hidden">此页面上的兼容性表由结构化数据生成。 如果您想为数据做出贡献，请查看https://github.com/mdn/browser-compat-data并向我们发送拉取请求。 </div>
+
+<p>{{Compat("css.properties.box-shadow")}}</p>
+
+<h2 id="参见">参见</h2>
+
+<ul>
+ <li> {{cssxref("&lt;color&gt;")}} 数据类型</li>
+ <li>其他与color相关的属性: {{cssxref("color")}}, {{cssxref("background-color")}}, {{cssxref("border-color")}}, {{cssxref("outline-color")}}, {{cssxref("text-decoration-color")}}, {{cssxref("text-emphasis-color")}}, {{cssxref("caret-color")}}, and {{cssxref("column-rule-color")}}</li>
+ <li><a href="/zh-CN/docs/Web/HTML/Applying_color">使用 CSS 给 HTML 元素添加颜色</a></li>
+</ul>