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
让我们通过示例了解它的实际作用。
按标签选择
您可以使用其标签选择 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> d3.select("div").text(); </script> </body> </html>
通过浏览器请求网页,您将在屏幕上看到以下输出 −
按类名选择
可以使用以下语法选择使用 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> ad3.select(".myclass").text(); </script> </body> </html>
通过浏览器请求网页,您将在屏幕上看到以下输出 −
按 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> d3.select("#hello").text(); </script> </body> </html>
通过浏览器请求网页,您将在屏幕上看到以下输出。
添加 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>
通过浏览器请求网页,您可以在屏幕上看到以下输出,
在这里,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>
通过浏览器请求网页,您将在屏幕上看到以下输出。
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>
通过浏览器请求网页,您将在屏幕上看到以下输出。
style() 方法
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>
通过浏览器请求网页,您将在屏幕上看到以下输出。
classed() 方法
classed() 方法专门用于设置 HTML 元素的"class"属性。由于单个 HTML 元素可以有多个类;我们在将类分配给 HTML 元素时需要小心。此方法知道如何处理元素上的一个或多个类,并且它将是高效的。
添加类 − 要添加类,必须将 classed 方法的第二个参数设置为 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 方法选择与特定选择器字符串匹配的所有元素。如果选择不匹配,则返回空选择。我们也可以在 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 标签,并且两个标签中的文本颜色均变为红色。