D3.js - 选择

Created: November-04, 2018

选择是 D3.js 的核心概念之一。它基于 CSS 选择器。它允许我们选择网页中的一个或多个元素。此外，它允许我们修改，追加或删除与预定义数据集相关的元素。在本章中，我们将了解如何使用选择来创建数据可视化。

D3.js 有助于使用以下两种方法从 HTML 页面中选择元素 -

select() - 通过匹配给定的 CSS 选择器，仅选择一个 DOM 元素。如果给定的 CSS 选择器有多个元素，则仅选择第一个元素。
selectAll() - 通过匹配给定的 CSS 选择器来选择所有 DOM 元素。如果你熟悉使用 jQuery 选择元素，则 D3.js 选择器几乎相同。

让我们详细介绍每种方法。

`select()` 方法

select() 方法根据 CSS 选择器选择 HTML 元素。在 CSS 选择器中，你可以通过以下三种方式定义和访问 HTML 元素 -

HTML 元素的标记（例如 div，h1，p，span 等）
HTML 元素的类名
HTML 元素的 ID

让我们通过例子看看它的实际效果。

按标签选择

你可以使用其 TAG 选择 HTML 元素。以下语法用于选择 div 标记元素，

d3.select("div")

示例 - 创建页面“select_by_tag.html”并添加以下更改，

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div>
         Hello World!    
      </div>
      
      <script>
         alert(d3.select("div").text());
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出 -

Hello World!

按类名选择

可以使用以下语法选择使用 CSS 类设置样式的 HTML 元素。

d3.select(“.<class name>”)

创建一个网页“select_by_class.html”并添加以下更改 -

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         alert(d3.select(".myclass").text());
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出 -

Hello World!

按 ID 选择

HTML 页面中的每个元素都应具有唯一的 ID。我们可以使用元素的唯一 ID 来使用下面指定的 select() 方法来访问它。

d3.select(“#<id of an element>”)

创建一个网页“select_by_id.html”并添加以下更改。

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div id = "hello">
         Hello World!
      </div>
      
      <script>
         alert(d3.select("#hello").text());
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出。

Hello World!

添加 DOM 元素

D3.js 选择提供 append() 和 text() 方法，以将新元素附加到现有 HTML 文档中。本节将详细介绍如何添加 DOM 元素。

`append()` 方法

append() 方法将新元素作为当前选择中元素的最后一个子元素附加。此方法还可以修改元素的样式，其属性，属性，HTML 和文本内容。

创建一个网页“select_and_append.html”并添加以下更改 -

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         d3.select("div.myclass").append("span");
      </script>
   </body>
</html>

通过浏览器请求网页，你可以在屏幕上看到以下输出，

Hello World!

这里，append() 方法在 div 标签内添加一个新标签 span，如下所示 -

<div class = "myclass">
   Hello World!<span></span>
</div>

`text()` 方法

text() 方法用于设置所选/附加元素的内容。让我们更改上面的示例并添加 text() 方法，如下所示。

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         d3.select("div.myclass").append("span").text("from D3.js");
      </script>
   </body>
</html>

现在刷新网页，你将看到以下响应。

这里，上面的脚本执行链接操作。D3.js 巧妙地采用了一种称为链语法的技术，你可以从** jQuery 中**识别出来。通过将方法与句点链接在一起，你可以在一行代码中执行多个操作。它快速而简单。相同的脚本也可以在没有链语法的情况下访问，如下所示。

var body = d3.select("div.myclass");
var span = body.append("span");
span.text("from D3.js");

修改元素

D3.js 提供了各种方法， html()，attr() 和 style() 来修改所选元素的内容和样式。让我们看看本章中如何使用修改方法。

`html()` 方法

html() 方法用于设置所选/附加元素的 html 内容。

创建一个网页“select_and_add_html.html”并添加以下代码。

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         d3.select(".myclass").html("Hello World! <span>from D3.js</span>");
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出。

Hello World!

`attr()` 方法

attr() 方法用于添加或更新所选元素的属性。创建一个网页“select_and_modify.html”并添加以下代码。

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         d3.select(".myclass").attr("style", "color: red");
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出。

Hello World!

`style()` 方法

style() 方法用于设置所选元素的样式属性。创建一个网页“select_and_style.html”并添加以下代码。

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         d3.select(".myclass").style("color", "red");
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出。

Hello World!

`classed()` 方法

classed() 方法专门用于设置 HTML 元素的 class 属性。因为，单个 HTML 元素可以有多个类; 在为 HTML 元素分配类时，我们需要小心。此方法知道如何处理元素上的一个或多个类，并且它将具有高性能。

添加类 - 要添加类，必须将分类方法的第二个参数设置为 true。它定义如下 -

d3.select(".myclass").classed("myanotherclass", true);

删除类 - 要删除类，必须将分类方法的第二个参数设置为 false。它定义如下 -

d3.select(".myclass").classed("myanotherclass", false);

检查类 - 要检查是否存在类，只需省略第二个参数并传递要查询的类名。如果存在则返回 true，否则返回 false。

d3.select(".myclass").classed("myanotherclass");

如果选择中的任何元素具有类，则返回 true。使用 d3.select 进行单个元素选择。

切换类 - 将类翻转到相反的状态 - 如果它已经存在则将其删除，如果它尚不存在则添加它 - 你可以执行以下操作之一。

对于单个元素，代码可能如下所示 -

var element = d3.select(".myclass")
element.classed("myanotherclass", !oneBar.classed("myanotherclass"));

`selectAll()` 方法

selectAll() 方法用于选择 HTML 文档中的多个元素。select 方法选择第一个元素，但 selectAll 方法选择与特定选择器字符串匹配的所有元素。如果选择匹配 none，则返回空选择。我们也可以在 selectAll() 方法中链接所有附加的修改方法， append()，html()，text()，attr()，style()，classed() 等。在这种情况下，方法将影响所有匹配元素。让我们通过创建新网页“select_multiple.html”来理解并添加以下脚本 -

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <h2 class = "myclass">Message</h2>
      <div class = "myclass">
         Hello World!
      </div>
      
      <script>
         d3.selectAll(".myclass").attr("style", "color: red");
      </script>
   </body>
</html>

通过浏览器请求网页，你将在屏幕上看到以下输出。

Message
Hello World!

这里，attr() 方法适用于 div 和 h2 标记，两个标记中文本的颜色都变为红色。

select() 方法

按标签选择

按类名选择

按 ID 选择

添加 DOM 元素

append() 方法

text() 方法

修改元素

html() 方法

attr() 方法

style() 方法

classed() 方法

selectAll() 方法

`select()` 方法

`append()` 方法

`text()` 方法

`html()` 方法

`attr()` 方法

`style()` 方法

`classed()` 方法

`selectAll()` 方法