From 831a5637d735b850f81fb84ddebdfac42a130416 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Tue, 4 Jul 2023 06:45:18 +0800 Subject: [PATCH] [zh-cn] Update 'styling lists' (#14012) Co-authored-by: A1lo --- .../css/styling_text/styling_lists/index.md | 297 ++++++++++-------- 1 file changed, 174 insertions(+), 123 deletions(-) diff --git a/files/zh-cn/learn/css/styling_text/styling_lists/index.md b/files/zh-cn/learn/css/styling_text/styling_lists/index.md index eb5a5351abb4b4..7fb4d5becb7ec7 100644 --- a/files/zh-cn/learn/css/styling_text/styling_lists/index.md +++ b/files/zh-cn/learn/css/styling_text/styling_lists/index.md @@ -1,28 +1,26 @@ --- -title: 样式列表 +title: 为列表添加样式 slug: Learn/CSS/Styling_text/Styling_lists -original_slug: Learn/CSS/为文本添加样式/Styling_lists --- {{LearnSidebar}}{{PreviousMenuNext("Learn/CSS/Styling_text/Fundamentals", "Learn/CSS/Styling_text/Styling_links", "Learn/CSS/Styling_text")}} -[List 列表](/zh-CN/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#Lists) 大体上和其他文本一样，但是仍有一些你需要知道的特殊 CSS 属性，和一些可供参考的最佳实践，这篇文章将阐述这一切。 +[列表](/zh-CN/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#列表)大体上和其他文本一样，但是仍有一些你需要知道的特殊 CSS 属性，和一些可供参考的最佳实践，这篇文章将阐述这一切。 - +
- + @@ -32,70 +30,84 @@ original_slug: Learn/CSS/为文本添加样式/Styling_lists
前置知识：前提： - Basic computer literacy, HTML basics (study + 基本的计算机知识，HTML 基础（已学习 Introduction to HTML), CSS basics (study + >HTML 介绍），CSS 基础（已学习 Introduction to CSS), - 基本文本和字体样式. + >CSS 基础），掌握基本的 CSS 文本和字体样式。
-## 一个简单的例子 +## 一个简单的列表示例 -首先，让我们看一个简单的例子。文章中我们将看到无序，有序和描述列表——它们都具有相似的样式特性，而某些特性却又各不相同。[Github](http://mdn.github.io/learning-area/css/styling-text/styling-lists/unstyled-list.html)上有未加载样式的例子（也可以查看[源码](https://github.com/mdn/learning-area/blob/master/css/styling-text/styling-lists/unstyled-list.html)。） +首先，让我们看一个简单的列表示例。文章中我们将看到无序、有序和描述列表——它们都具有相似的样式特性，而某些特性却又各不相同。[Github](http://mdn.github.io/learning-area/css/styling-text/styling-lists/unstyled-list.html) 上有无额外样式的例子（也可以查看[源码](https://github.com/mdn/learning-area/blob/master/css/styling-text/styling-lists/unstyled-list.html)）。 -例子中列表的 HTML 代码如下： +示例列表的 HTML 代码如下： ```html

Shopping (unordered) list

-

Paragraph for reference, paragraph for reference, paragraph for reference, -paragraph for reference, paragraph for reference, paragraph for reference.

+

+ Paragraph for reference, paragraph for reference, paragraph for reference, + paragraph for reference, paragraph for reference, paragraph for reference. +

Recipe (ordered) list

-

Paragraph for reference, paragraph for reference, paragraph for reference, -paragraph for reference, paragraph for reference, paragraph for reference.

+

+ Paragraph for reference, paragraph for reference, paragraph for reference, + paragraph for reference, paragraph for reference, paragraph for reference. +

    -
  1. Toast pitta, leave to cool, then slice down the edge.
    2. -
  2. Fry the halloumi in a shallow, non-stick pan, until browned on both sides.
    3. +
  3. Toast pita, leave to cool, then slice down the edge.
    4. +
  4. + Fry the halloumi in a shallow, non-stick pan, until browned on both sides. +
  5. Wash and chop the salad.
    6. -
  6. Fill pitta with salad, humous, and fried halloumi.
    7. +
  7. Fill pita with salad, hummus, and fried halloumi.

Ingredient description list

-

Paragraph for reference, paragraph for reference, paragraph for reference, -paragraph for reference, paragraph for reference, paragraph for reference.

+

+ Paragraph for reference, paragraph for reference, paragraph for reference, + paragraph for reference, paragraph for reference, paragraph for reference. +

-
Humous
-
A thick dip/sauce generally made from chick peas blended with tahini, lemon juice, salt, garlic, and other ingredients.
-
Pitta
+
Hummus
+
+ A thick dip/sauce generally made from chick peas blended with tahini, lemon + juice, salt, garlic, and other ingredients. +
+
Pita
A soft, slightly leavened flatbread.
Halloumi
-
A semi-hard, unripened, brined cheese with a higher-than-usual melting point, usually made from goat/sheep milk.
+
+ A semi-hard, unripened, brined cheese with a higher-than-usual melting + point, usually made from goat/sheep milk. +
Green salad
That green healthy stuff that many of us just use to garnish kebabs.
``` -现在，如果你去到例子的展示页面，并使用[浏览器开发者工具](/zh-CN/docs/Learn/Common_questions/What_are_browser_developer_tools)查看那些列表元素，你会注意到若干个默认的样式预设值： +现在，如果你去到示例的展示页面，并使用[浏览器开发者工具](/zh-CN/docs/Learn/Common_questions/What_are_browser_developer_tools)查看那些列表元素，你会注意到若干个默认的样式预设值： -- {{htmlelement("ul")}} 和 {{htmlelement("ol")}} 元素设置{{cssxref("margin")}}的顶部和底部：16px(1em) 0;和 padding-left: 40px(2.5em); （在这里注意的是浏览器默认字体大小为 16px）。 -- {{htmlelement("li")}} 默认是没有设置间距的。 -- {{htmlelement("dl")}} 元素设置 margin 的顶部和底部：16px(1em) ，无内边距设定。 -- {{htmlelement("dd")}} 元素设置为： {{cssxref("margin-left")}} `40px` (`2.5em`)。 -- 在参考中提到的 {{htmlelement("p")}} 元素设置 margin 的顶部和底部：16px(1em)，和其他的列表类型相同。 +- {{htmlelement("ul")}} 和 {{htmlelement("ol")}} 元素含有 `16px`（`1em`）的顶部和底部 {{cssxref("margin")}} 和 `40px`（`2.5em`）的 {{cssxref("padding-left")}}。 +- 列表项（{{htmlelement("li")}} 元素）默认是没有设置间距的。 +- {{htmlelement("dl")}} 元素设置含有 `16px`（`1em`）的顶部和底部 {{cssxref("margin")}}，但不含内边距。 +- {{htmlelement("dd")}} 元素含有 `40px`（`2.5em`）的 {{cssxref("margin-left")}}。 +- 在参考中提到的 {{htmlelement("p")}} 元素设置含有 `16px`（`1em`）的顶部和底部 {{cssxref("margin")}}——与其他的列表类型相同。 ## 处理列表间距 -当您创建样式列表时，您需要调整样式，使其保持与周围元素相同的垂直间距（例如段落和图片，有时称为垂直节奏））和相互间的水平间距（您可以在 Github 上参考[完成的样式示例](http://mdn.github.io/learning-area/css/styling-text/styling-lists/) ，也可以找到[源代码](https://github.com/mdn/learning-area/blob/master/css/styling-text/styling-lists/index.html)。） +当为列表添加样式时，你需要调整样式，使其保持与周围元素相同的垂直间距（例如段落和图片，有时称为垂直节奏）和相互间的水平间距（你可以在 Github 上参考[完成添加样式后的示例](https://mdn.github.io/learning-area/css/styling-text/styling-lists/) ，也可以[找到源代码](https://github.com/mdn/learning-area/blob/main/css/styling-text/styling-lists/index.html)）。 用于文本样式和间距的 CSS 如下所示： ```css -/* General styles */ +/* 通用样式 */ html { font-family: Helvetica, Arial, sans-serif; @@ -106,46 +118,46 @@ h2 { font-size: 2rem; } -ul,ol,dl,p { +ul, +ol, +dl, +p { font-size: 1.5rem; } -li, p { +li, +p { line-height: 1.5; } -/* Description list styles */ - +/* 描述列表样式 */ -dd, dt { +dd, +dt { line-height: 1.5; } dt { font-weight: bold; } - -dd { - margin-bottom: 1.5rem; -} ``` - 第一条规则集设置一个网站字体，基准字体大小为 10px。页面上的所有内容都将继承该规则集。 - 规则集 2 和 3 为标题、不同的列表类型和段落以及设置了相对字体大小（这些列表的子元素将会继承该规则集），这就意味着每个段落和列表都将拥有相同的字体大小和上下间距，有助于保持垂直间距一致。 -- 规则集 4 在段落和列表项目上设置相同的 {{cssxref("line-height")}} ，因此段落和每个单独的列表项目将在行之间具有相同的间距。这也将有助于保持垂直间距一致。 -- 规则集 5-7 适用于描述列表 - 我们在描述列表的术语和其描述上设置与段落和列表项相同的行高，以及 {{cssxref("margin-bottom")}} 为 1.5 rem（与段落（p）和列表项目（li））相同。再次强调一遍，这里很好地实现了一致性！我们还使描述术语具有粗体字体，因此它们在视觉上脱颖而出。 +- 规则集 4 在段落和列表项目上设置相同的 {{cssxref("line-height")}}，因此段落和每个单独的列表项目将在行之间具有相同的间距。这也将有助于保持垂直间距一致。 +- 规则集 5 和 6 适用于描述列表。我们在描述列表的术语和其描述上设置与段落和列表项相同的 `line-height`。再次强调一遍，这里很好地实现了一致性！我们还使描述术语具有粗体字体，因此它们在视觉上脱颖而出。 ## 列表特定样式 现在我们来看一下列表的一般间距，我们来研究一些列表具有的特定属性。我们从三个属性开始了解，这三个属性可以在 {{htmlelement("ul")}} 或 {{htmlelement("ol")}} 元素上设置： -- {{cssxref("list-style-type")}} ：设置用于列表的项目符号的类型，例如无序列表的方形或圆形项目符号，或有序列表的数字，字母或罗马数字。 -- {{cssxref("list-style-position")}} ：设置在每个项目开始之前，项目符号是出现在列表项内，还是出现在其外。 -- {{cssxref("list-style-image")}} ：允许您为项目符号使用自定义图片，而不是简单的方形或圆形。 +- {{cssxref("list-style-type")}}：设置用于列表的项目符号的类型，例如无序列表的方形或圆形项目符号，或有序列表的数字、字母或罗马数字。 +- {{cssxref("list-style-position")}}：设置在每个项目开始之前，项目符号是出现在列表项内，还是出现在其外。 +- {{cssxref("list-style-image")}}：允许为项目符号使用自定义图片，而不是简单的方形或圆形。 ### 符号样式 -像上面所提及的， {{cssxref("list-style-type")}} 属性允许你设置项目符号点的类型，在我们的例子中，我们在有序列表上设置了大写罗马数字： +像上面所提及的，{{cssxref("list-style-type")}} 属性允许你设置项目符号的类型，在我们的示例中，我们在有序列表上设置了大写罗马数字： ```css ol { @@ -155,15 +167,15 @@ ol { 效果显示如下： -![an ordered list with the bullet points set to appear outside the list item text.](outer-bullets.png) +![一个有序列表，项目符号被设置为出现在列表项之外](outer-bullets.png) -您可以通过 {{cssxref("list-style-type")}} 参考页面查找到更多选项。 +你可以通过 {{cssxref("list-style-type")}} 参考页面查找到更多选项。 ### 项目符号位置 -{{cssxref("list-style-position")}} 设置在每个项目开始之前，项目符号是出现在列表项内，还是出现在其外。如上所示，默认值为 outside，这使项目符号位于列表项之外。 +{{cssxref("list-style-position")}} 设置在每个项目开始之前，项目符号是出现在列表项内，还是出现在其外。如上所示，默认值为 `outside`，这使项目符号位于列表项之外。 -如果值设置为 inside，项目条目则位于行内。 +如果值设置为 `inside`，项目符号则位于行内。 ```css ol { @@ -172,7 +184,7 @@ ol { } ``` -![an ordered list with the bullet points set to appear inside the list item text.](inner-bullets.png) +![一个有序列表，项目符号被设置为出现在列表项之内](inner-bullets.png) ### 使用自定义的项目符号图片 @@ -184,9 +196,9 @@ ul { } ``` -然而，这个属性在控制项目符号的位置，大小等方面是有限的。您最好使用{{cssxref("background")}} 系列属性，您将在 [Styling boxes](/zh-CN/docs/Learn/CSS/Styling_boxes) 模块中了解更多信息。在这里我们仅做一点尝试！ +然而，这个属性在控制项目符号的位置，大小等方面是有限的。最好使用 {{cssxref("background")}} 系列属性，你将在[背景和边框](/zh-CN/docs/Learn/CSS/Building_blocks/Backgrounds_and_borders)文章中了解更多信息。在这里我们仅做一点尝试！ -结束我们的例子，我们样式化无序列表像这样（放到您之前所见的顶部）： +在我们的示例中，我们的无序列表最终样式像这样（在之前所见的顶部）： ```css ul { @@ -203,24 +215,24 @@ ul li { } ``` -我们的所做如下： +我们做了这些事情： -- 将 {{htmlelement("ul")}} 的 {{cssxref("padding-left")}} 从默认的 `40px`设置为 `20px`，然后在列表项上设置相同的数值。这就是说，整个列表项仍然排列在列表中，但是列表项产生了一些用于背景图像的填充。如果我们没有设置填充，背景图像将与列表项文本重叠，这看起来会很乱。 -- 将 {{cssxref("list-style-type")}} 设置为 none，以便默认情况下不会显示项目符号。我们将使用 {{cssxref("background")}} 属性来代替项目符号。 -- 为每个无序列表项插入项目符号，其相应的属性如下： +- 将 {{htmlelement("ul")}} 的 {{cssxref("padding-left")}} 从默认的 `40px` 下调为 `20px`，然后在列表项上设置相同的数值。这就是说，整个列表项仍然排列在列表中，但是列表项产生了一些用于背景图像的填充。如果我们没有设置填充，背景图像将与列表项文本重叠，这看起来会很乱。 +- 将 {{cssxref("list-style-type")}} 设置为 `none`，以便默认情况下不会显示项目符号。我们将使用 {{cssxref("background")}} 属性来代替项目符号。 +- 为每个无序列表项插入项目符号，相关的属性如下： - - {{cssxref("background-image")}}: 充当项目符号的图片文件的参考路径 - - {{cssxref("background-position")}}: 这定义了所选元素背景中的图像将出现在哪里 - 在我们的示例中设置 `0 0`，这意味着项目符号将出现在每个列表项的最左上侧。 - - {{cssxref("background-size")}}: 设置背景图片的大小。理想条件下，我们想要项目符号与列表项的大小相同（比列表项稍大或稍小亦可）。我们使用的尺寸为 1.6rem（16px），它非常吻合我们为项目符号设置的 20px 的填充，16px 加上 4px 的空格间距，可以使项目符号和列表项文本效果更好。 - - {{cssxref("background-repeat")}}：默认条件下，背景图片不断复制直到填满整个背景空间，在我们的例子中，背景图片只需复制一次，所以我们设置值为 `no-repeat`。 + - {{cssxref("background-image")}}：充当项目符号的图片文件的参照路径。 + - {{cssxref("background-position")}}：这定义了所选元素背景中的图像将出现在哪里——在我们的示例中设置为 `0 0`，这意味着项目符号将出现在每个列表项的最左上侧。 + - {{cssxref("background-size")}}：设置背景图片的大小。理想条件下，我们想要项目符号与列表项的大小相同（比列表项稍大或稍小亦可）。我们使用的尺寸为 `1.6rem`（`16px`），它非常吻合我们为项目符号设置的 `20px` 的填充，16px 加上 4px 的空格间距，可以使项目符号和列表项文本效果更好。 + - {{cssxref("background-repeat")}}：默认条件下，背景图片不断复制直到填满整个背景空间，在我们的示例中，背景图片只需复制一次，所以我们设置值为 `no-repeat`。 效果显示如下： -![an unordered list with the bullet points set as little star images](image-bullets.png) +![一个无序列表，其项目符号设置为了小星星的图片](list_formatting.png) -### list-style 速记 +### list-style 简写 -上述提到的三种属性可以用一个单独的速记属性 {{cssxref("list-style")}} 来设置。例如： +上述提到的三种属性可以用一个单独的简写属性 {{cssxref("list-style")}} 来设置。例如，以下 CSS： ```css ul { @@ -238,22 +250,24 @@ ul { } ``` -属性值可以任意顺序排列，你可以设置一个，两个或者三个值（该属性的默认值为 disc, none, outside），如果指定了 type 和 image，如果由于某种原因导致图像无法加载，则 type 将用作回退。 +属性值可以任意顺序排列，你可以设置一个，两个或者所有三个值（不包括的属性使用的默认值是 `disc`、`none` 和 `outside`），如果指定了 `type` 和 `image`，如果由于某种原因导致图像无法加载，则 type 将用作回退。 ## 管理列表计数 -有时，您可能想在有序列表上进行不同的计数方式。例如：从 1 以外的数字开始，或向后倒数，或者按步或多于 1 计数。HTML 和 CSS 有一些工具可以帮助您 +有时，你可能想在有序列表上进行不同的计数方式。例如：从 1 以外的数字开始，或从后面倒数，或者按大于 1 的步长计数。HTML 和 CSS 有一些工具可以帮助你： ### start -[`start`](/zh-CN/docs/Web/HTML/Element/ol#start) 属性允许你从 1 以外的数字开始计数。示例如下： +[`start`](/zh-CN/docs/Web/HTML/Element/ol#start) 属性允许你从 1 以外的数字开始计数。以下示例： ```html
    -
  1. Toast pitta, leave to cool, then slice down the edge.
    2. -
  2. Fry the halloumi in a shallow, non-stick pan, until browned on both sides.
    3. +
  3. Toast pita, leave to cool, then slice down the edge.
    4. +
  4. + Fry the halloumi in a shallow, non-stick pan, until browned on both sides. +
  5. Wash and chop the salad.
    6. -
  6. Fill pitta with salad, humous, and fried halloumi.
    7. +
  7. Fill pita with salad, hummus, and fried halloumi.
``` @@ -263,14 +277,16 @@ ul { ### reversed -[`reversed`](/zh-CN/docs/Web/HTML/Element/ol#reversed) 属性将启动列表倒计数。示例如下： +[`reversed`](/zh-CN/docs/Web/HTML/Element/ol#reversed) 属性将使列表反向计数。以下示例： ```html
    -
  1. Toast pitta, leave to cool, then slice down the edge.
    2. -
  2. Fry the halloumi in a shallow, non-stick pan, until browned on both sides.
    3. +
  3. Toast pita, leave to cool, then slice down the edge.
    4. +
  4. + Fry the halloumi in a shallow, non-stick pan, until browned on both sides. +
  5. Wash and chop the salad.
    6. -
  6. Fill pitta with salad, humous, and fried halloumi.
    7. +
  7. Fill pita with salad, hummus, and fried halloumi.
``` @@ -278,16 +294,20 @@ ul { {{ EmbedLiveSample('reversed', '100%', 150) }} +> **备注：** 如果反向计数的列表项数比 `start` 属性的值还要多，计数将继续到零并向负数方向增加。 + ### value -[`value`](/zh-CN/docs/Web/HTML/Element/ol#value) 属性允许设置列表项指定数值，示例如下： +[`value`](/zh-CN/docs/Web/HTML/Element/ol#value) 属性允许设置列表项指定数值，以下示例： ```html
    -
  1. Toast pitta, leave to cool, then slice down the edge.
    2. -
  2. Fry the halloumi in a shallow, non-stick pan, until browned on both sides.
    3. +
  3. Toast pita, leave to cool, then slice down the edge.
    4. +
  4. + Fry the halloumi in a shallow, non-stick pan, until browned on both sides. +
  5. Wash and chop the salad.
    6. -
  6. Fill pitta with salad, humous, and fried halloumi.
    7. +
  7. Fill pita with salad, hummus, and fried halloumi.
``` @@ -295,57 +315,77 @@ ul { {{ EmbedLiveSample('value', '100%', 150) }} -> **备注：** 纵然你使用非数字的 {{cssxref("list-style-type")}}, 你仍需要使用与数值同等意义的值作为 value 的属性。 +> **备注：** 即使使用非数字的 {{cssxref("list-style-type")}}，仍需要在 `value` 属性中使用等效的数值。 -## 主动学习：为嵌套式列表添加样式 +## 动手练习：为嵌套式列表添加样式 -在该学习环节，我们希望你使用如上所学尝试为一个嵌套式列表添加样式。我们已经提供了 HTML , 在此之上请完成如下： +在该学习环节，我们希望你使用如上所学尝试为一个嵌套式列表添加样式。我们已经提供了 HTML 代码，在此之上请完成如下任务： 1. 为该无序列表提供方形项目符号。 -2. 为该无序列表项和有序列表项提供基于其字体大小 1.5 的行高。 +2. 为该无序列表项和有序列表项提供基于其字体大小 1.5 倍的行高。 3. 为有序列表提供小写字母的项目符号。 4. 对列表进行自由发挥，尝试不同的项目符号类型，间距，以及其他的各种属性。 -如果犯了错误，可以随时点击 Reset（重置）按钮进行重新设置。如果你真的遇到困难无法继续下去，点击 Show solution（显示解决方案）按钮查看可行的解决方案。 +如果犯了错误，可以随时点击*重置*按钮进行重新设置。如果你真的遇到困难无法继续下去，点击*显示解答*按钮查看一种可能的解法。 ```html hidden -
-

HTML Input

- - -

CSS Input

- - -

Output

-
+ + + +

CSS 输入

+ + +

输出

+
- - + +
``` ```js hidden -var htmlInput = document.querySelector(".html-input"); -var cssInput = document.querySelector(".css-input"); -var reset = document.getElementById("reset"); -var htmlCode = htmlInput.value; -var cssCode = cssInput.value; -var output = document.querySelector(".output"); -var solution = document.getElementById("solution"); - -var styleElem = document.createElement('style'); -var headElem = document.querySelector('head'); +const htmlInput = document.querySelector(".html-input"); +const cssInput = document.querySelector(".css-input"); +const reset = document.getElementById("reset"); +const htmlCode = htmlInput.value; +const cssCode = cssInput.value; +const output = document.querySelector(".output"); +const solution = document.getElementById("solution"); + +const styleElem = document.createElement("style"); +const headElem = document.querySelector("head"); headElem.appendChild(styleElem); function drawOutput() { @@ -353,15 +393,26 @@ function drawOutput() { styleElem.textContent = cssInput.value; } -reset.addEventListener("click", function() { +reset.addEventListener("click", () => { htmlInput.value = htmlCode; cssInput.value = cssCode; drawOutput(); }); -solution.addEventListener("click", function() { +solution.addEventListener("click", () => { htmlInput.value = htmlCode; - cssInput.value = 'ul {\n list-style-type: square;\n}\n\nul li, ol li {\n line-height: 1.5;\n}\n\nol {\n list-style-type: lower-alpha\n}'; + cssInput.value = `ul { + list-style-type: square; +} + +ul li, +ol li { + line-height: 1.5; +} + +ol { + list-style-type: lower-alpha; +}`; drawOutput(); }); @@ -374,7 +425,7 @@ window.addEventListener("load", drawOutput); ## 总结 -一旦你掌握一些相关的基础原则和特定属性，列表的样式还是相对容易理解的。在下篇文章中我们将转到另一话题——为链接提供样式的各种技巧。 +一旦你掌握一些相关的基础原则和特定属性，列表的样式还是相对容易理解的。在下篇文章中我们将转到另一话题——[为链接提供样式](/zh-CN/docs/Learn/CSS/Styling_text/Styling_links)的各种技巧。 ## 参见