aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/html/element/blockquote/index.html
blob: 4bd40652b7b8818ae6c1eeac3571d48a7744e510 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
---
title: <blockquote>:块级引用元素
slug: Web/HTML/Element/blockquote
tags:
  - Blockquote
  - 元素
  - 块级引用
  - 引用
translation_of: Web/HTML/Element/blockquote
---
<div>{{HTMLRef}}</div>

<p><strong>HTML <code>&lt;blockquote&gt;</code> 元素</strong>(或者 HTML 块级引用元素),代表其中的文字是引用内容。通常在渲染时,这部分的内容会有一定的缩进(<a href="/zh-CN/docs/Web/HTML/Element/blockquote#Notes"></a> 中说明了如何更改)。若引文来源于网络,则可以将原内容的出处 URL 地址设置到 cite 特性上,若要以文本的形式告知读者引文的出处时,可以通过 {{HTMLElement("cite")}} 元素。</p>

<div>{{EmbedInteractiveExample("pages/tabbed/blockquote.html","tabbed-standard")}}</div>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row"><a href="/en-US/docs/HTML/Content_categories">Content categories</a></th>
   <td><a href="/en-US/docs/HTML/Content_categories#Flow_content">Flow content</a>, sectioning root, palpable content.</td>
  </tr>
  <tr>
   <th scope="row">Permitted content</th>
   <td><a href="/en-US/docs/HTML/Content_categories#Flow_content">Flow content</a>.</td>
  </tr>
  <tr>
   <th scope="row">Tag omission</th>
   <td>{{no_tag_omission}}</td>
  </tr>
  <tr>
   <th scope="row">Permitted parents</th>
   <td>Any element that accepts <a href="/en-US/docs/HTML/Content_categories#Flow_content">flow content</a>.</td>
  </tr>
  <tr>
   <th scope="row">Permitted ARIA roles</th>
   <td>Any</td>
  </tr>
  <tr>
   <th scope="row">DOM interface</th>
   <td>{{domxref("HTMLQuoteElement")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="属性">属性</h2>

<p>此元素的属性包含 <a href="https://developer.mozilla.org/zh-CN/docs/Web/HTML/Global_attributes">全局属性</a></p>

<dl>
 <dt>{{htmlattrdef("cite")}}</dt>
 <dd>是一个标注引用的信息的来源文档或者相关信息的URL。通常用来描述能够解释引文的上下文或者引用的信息。</dd>
</dl>


<h2 id="使用备注">使用备注</h2>

<p>若要修改被引用内容的缩进距离,可以使用 {{Glossary("CSS")}} {{cssxref("margin-left")}} 和/或 {{cssxref("margin-right")}} 属性,或使用 {{cssxref("margin")}} 缩写属性。</p>

<p>若想使用在行内引用较短的内容而非创建一个单独的引用块,可使用 {{HTMLElement("q")}}(Quotation)元素。</p>

<p>如果想要使用短引用(行间引用),可以使用{{HTMLElement("q")}} 标签。</p>

<h2 id="例子">例子</h2>

<p>下面的这个例子演示了使用 <code>&lt;blockquote&gt;</code> 元素引用一段来自 {{RFC(1149)}} 的内容,<cite>以禽类作为载体的IP 数据包传输标准。</cite></p>

<pre class="brush: html">&lt;blockquote cite="https://tools.ietf.org/html/rfc1149"&gt;
  &lt;p&gt;Avian carriers can provide high delay, low
  throughput, and low altitude service.  The
  connection topology is limited to a single
  point-to-point path for each carrier, used with
  standard carriers, but many carriers can be used
  without significant interference with each other,
  outside of early spring.  This is because of the 3D
  ether space available to the carriers, in contrast
  to the 1D ether used by IEEE802.3.  The carriers
  have an intrinsic collision avoidance system, which
  increases availability.&lt;/p&gt;
&lt;/blockquote&gt;
</pre>

<p>上面的HTML代码将会生成:</p>

<p>{{EmbedLiveSample("Example", 640, 180)}}</p>

<h2 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('HTML WHATWG', 'grouping-content.html#the-blockquote-element', '&lt;blockquote&gt;')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', 'grouping-content.html#the-blockquote-element', '&lt;blockquote&gt;')}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML4.01', 'struct/text.html#h-9.2.2', '&lt;blockquote&gt;')}}</td>
   <td>{{Spec2('HTML4.01')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



<p>{{Compat("html.elements.blockquote")}}</p>

<h2 id="参见">参见</h2>

<ul>
 <li>适用于行内引用的 {{HTMLElement("q")}} 元素。</li>
 <li>适用于来源引文的 {{HTMLElement("cite")}} 元素。</li>
</ul>