D3.js - 选择

选择是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>

通过浏览器请求网页,您将在屏幕上看到以下输出 :

Selection by Class name

可以使用以下语法选择使用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>

通过浏览器请求网页,您将在屏幕上看到以下输出:

Selection by 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>

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

Adding DOM Elements

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

The append() Method

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>

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

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

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

The text() Method

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");

Modifying Elements

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

The html() Method

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>

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

The attr() Method

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>

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

The style() Method

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>

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

The classed() Method

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"));

The selectAll() Method

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>

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

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