
本文详细介绍了如何在r markdown中配置plotly图表,以实现`partial_bundle`功能的离线运行并有效减小html文件体积。核心方法是通过手动管理plotly的javascript依赖,将其从在线cdn或临时文件路径转移至本地存储,并更新图表对象的依赖引用。这确保了即使在无网络环境下,r markdown也能生成包含精简plotly图表的html报告,同时提供详细的步骤、代码示例及注意事项。
在R Markdown中嵌入交互式Plotly图表时,使用partial_bundle()函数可以显著减小最终HTML文件的大小,因为它只加载Plotly所需的核心JavaScript功能。然而,默认情况下,partial_bundle()会尝试从CDN(内容分发网络)下载必要的JavaScript脚本,这要求在渲染R Markdown时具备网络连接。对于需要在离线环境或对文件依赖有严格控制的场景,将Plotly的JavaScript依赖本地化是必要的。本教程将指导您完成这一过程,确保Plotly图表在R Markdown中能够离线且高效地工作。
当您在Plotly图表上调用partial_bundle()时,Plotly会动态判断并加载最精简的JavaScript文件,通常是plotly-basic.min.js。在首次调用时,这个文件会被下载到一个临时位置,或者尝试从CDN加载。我们的目标是将这个临时文件或CDN上的文件永久保存到本地,并修改Plotly图表的依赖指向这个本地文件。
首先,让我们创建一个简单的Plotly图表并查看其依赖项,以了解partial_bundle()的初始行为。
library(plotly)
library(htmltools) # 用于处理HTML依赖
# 示例数据
data(hobbs, package="plotly")
# 创建一个使用 partial_bundle() 的Plotly图表
plt <- plot_ly(type = "bar", data = hobbs, x = ~nms, y = ~r) %>% partial_bundle()
plt # 预览图表
# 检查图表的依赖项
# 通常 'plotly-basic' 是我们关注的第五个依赖项
invisible(lapply(1:length(plt$dependencies),
function(k) message(plt$dependencies[[k]]$name)))
# 查看 'plotly-basic' 依赖的详细信息
plotly_basic_dep <- plt$dependencies[[which(sapply(plt$dependencies, function(d) d$name == "plotly-basic"))]]
print(plotly_basic_dep)从plotly_basic_dep的输出中,您会看到src字段包含href(CDN链接)和file(临时文件路径)。script字段则指明了JavaScript文件的具体名称,例如plotly-basic-2.5.1.min.js。这表明该文件已下载到您的系统临时目录。
立即学习“前端免费学习笔记(深入)”;
# 示例输出片段 (您的临时路径会不同) # $name : chr "plotly-basic" # $version : chr "2.5.1" # $src :List of 2 # ..$ href: chr "https://cdn.plot.ly" # ..$ file: chr "/var/folders/zp/rgt0rwln7xq132_rnrmhfb400000gn/T//RtmpFtB0bB" # $script : chr "plotly-basic-2.5.1.min.js"
您有两种主要方式获取并存储JavaScript文件:从临时目录复制或从CDN下载。
由于partial_bundle()已经将文件下载到了临时目录,最简单的方法就是将其复制到您希望的永久位置。
# 获取临时文件路径和文件名
temp_file_path <- plotly_basic_dep$src$file
script_name <- plotly_basic_dep$script
full_temp_path <- file.path(temp_file_path, script_name)
# 目标存储位置:Plotly包的htmlwidgets/lib/plotlyjs子目录
# 这种方式将文件集成到Plotly包的内部结构中,对所有项目通用
plotly_lib_path <- system.file(package = "plotly", "htmlwidgets/lib/plotlyjs")
# 确保目标目录存在
if (!dir.exists(plotly_lib_path)) {
dir.create(plotly_lib_path, recursive = TRUE)
}
# 复制文件
file.copy(from = full_temp_path,
to = file.path(plotly_lib_path, script_name),
overwrite = TRUE)
# 验证文件是否已复制
list.files(plotly_lib_path)注意事项:
如果您无法访问临时文件,或者出于其他原因,可以直接从CDN下载文件。
# 构建完整的CDN链接
cdn_link <- with(plotly_basic_dep, paste0(src$href, "/", script))
# 定义本地保存路径 (例如,在当前工作目录下的'www/plotlyjs'中)
local_save_dir <- "www/plotlyjs"
if (!dir.exists(local_save_dir)) {
dir.create(local_save_dir, recursive = TRUE)
}
local_dest_file <- file.path(local_save_dir, script_name)
# 下载文件
download.file(url = cdn_link, destfile = local_dest_file)
# 验证文件是否下载
list.files(local_save_dir)文件存储在本地后,我们需要创建一个新的htmltools::htmlDependency对象,指向这个本地文件,并替换Plotly图表原有的依赖。
htmltools::htmlDependency函数是定义HTML资源依赖的关键。其主要参数包括:
如果JavaScript文件存储在Plotly包的htmlwidgets/lib/plotlyjs子目录中,src路径应为相对于包根目录的相对路径,并指定package = "plotly"。
# 创建新的本地依赖对象 (针对存储在Plotly库中的情况) local_pbund_lib <- htmltools::htmlDependency( name = plotly_basic_dep$name, version = plotly_basic_dep$version, src = "htmlwidgets/lib/plotlyjs", # 相对于plotly包根目录的路径 script = plotly_basic_dep$script, package = "plotly" # 指定包名 ) # 替换图表中的依赖 # 找到 'plotly-basic' 依赖的索引 dep_index <- which(sapply(plt$dependencies, function(d) d$name == "plotly-basic")) plt$dependencies[[dep_index]] <- local_pbund_lib # 再次检查依赖,确认已更新 print(plt$dependencies[[dep_index]]) # 渲染图表,此时将使用本地依赖 plt
如果JavaScript文件存储在您的项目目录(例如./www/plotlyjs/)中,src路径应是相对于R Markdown文件或项目根目录的相对路径。此时,package参数不需要指定,且all_files通常应设为FALSE。
# 假设文件存储在当前RMD文件同级目录下的 'www/plotlyjs' # local_save_dir <- "www/plotlyjs" # 从上一节获取 # 创建新的本地依赖对象 (针对存储在其他本地目录的情况) local_pbund_other <- htmltools::htmlDependency( name = plotly_basic_dep$name, version = plotly_basic_dep$version, src = local_save_dir, # 指向本地目录的相对路径或绝对路径 script = plotly_basic_dep$script, all_files = FALSE # 通常设为FALSE,除非您想包含整个目录 ) # 替换图表中的依赖 # 找到 'plotly-basic' 依赖的索引 dep_index <- which(sapply(plt$dependencies, function(d) d$name == "plotly-basic")) plt$dependencies[[dep_index]] <- local_pbund_other # 再次检查依赖,确认已更新 print(plt$dependencies[[dep_index]]) # 渲染图表,此时将使用本地依赖 plt
以下是一个将所有步骤整合在一起的完整R Markdown代码块示例,它将Plotly的plotly-basic脚本复制到Plotly包的内部库路径,并相应地更新图表依赖。
# R Markdown Chunk Options: eval=TRUE, include=TRUE
# 确保在R Markdown环境中运行,或在R脚本中运行一次以设置依赖
library(plotly)
library(htmltools)
# 1. 创建一个Plotly图表并触发 partial_bundle(),使其下载脚本到临时目录
data(hobbs, package="plotly")
plt <- plot_ly(type = "bar", data = hobbs, x = ~nms, y = ~r) %>% partial_bundle()
# 2. 获取 'plotly-basic' 依赖的详细信息
plotly_basic_dep <- plt$dependencies[[which(sapply(plt$dependencies, function(d) d$name == "plotly-basic"))]]
# 3. 确定源文件和目标位置
temp_file_path <- plotly_basic_dep$src$file
script_name <- plotly_basic_dep$script
full_temp_path <- file.path(temp_file_path, script_name)
plotly_lib_path <- system.file(package = "plotly", "htmlwidgets/lib/plotlyjs")
# 4. 复制文件到Plotly库目录 (仅需运行一次,或当Plotly更新时)
if (!file.exists(file.path(plotly_lib_path, script_name))) {
message("复制 ", script_name, " 到 Plotly 库目录...")
if (!dir.exists(plotly_lib_path)) {
dir.create(plotly_lib_path, recursive = TRUE)
}
file.copy(from = full_temp_path,
to = file.path(plotly_lib_path, script_name),
overwrite = TRUE)
message("复制完成。")
} else {
message(script_name, " 已存在于 Plotly 库目录。")
}
# 5. 创建新的本地依赖对象
local_pbund <- htmltools::htmlDependency(
name = plotly_basic_dep$name,
version = plotly_basic_dep$version,
src = "htmlwidgets/lib/plotlyjs",
script = plotly_basic_dep$script,
package = "plotly"
)
# 6. 替换图表中的依赖
dep_index <- which(sapply(plt$dependencies, function(d) d$name == "plotly-basic"))
plt$dependencies[[dep_index]] <- local_pbund
# 7. 显示图表
plt通过遵循本教程的步骤,您可以有效地管理Plotly在R Markdown中的JavaScript依赖,实现离线渲染和文件优化,从而提高报告的灵活性和可移植性。
以上就是优化R Markdown中Plotly图表的离线依赖管理以减小HTML文件大小的详细内容,更多请关注php中文网其它相关文章!
HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号