使用 htmlwidgets::scaffoldWidget 将外部 js 库合并到一个新包中,以进入闪亮的应用程序

using htmlwidgets::scaffoldWidget to incorporate external js libraries for a new package to go into a shiny app

我对 slick javascript 库 (http://kenwheeler.github.io/slick/) 印象深刻,想将其合并到我闪亮的 apps/flexboard 页面中。

我想在 R 中使用 htmlwidgets 包并包含 slick js 库,因此已开始尝试按照在线文档 (http://www.htmlwidgets.org/develop_intro.html) 中的建议创建一个包,通过执行以下操作...

devtools::create("slick")              
setwd("slick")                          
htmlwidgets::scaffoldWidget("slick")

我从https://github.com/kenwheeler/slick/archive/1.6.0.zip

下载了js库

并将其放入包的结构中,这样我就有了一个看起来有点像这样的文件结构。

R/
| slick.R

inst/
|-- htmlwidgets/
|   |-- slick.js
|   |-- slick.yaml
|   |-- lib/
|   |   |-- slick-1.6.0/
|   |   |   |-- slick/
|   |   |   |   |-- slick.min.js 
|   |   |   |   |-- slick.js
|   |   |   |   |-- slick.css
|   |   |   |   |-- slick-theme.css

我的 slick.yaml 文件看起来像这样...

dependencies:
  - name: slick
    version: 1.6.0
    src: htmlwidgets/lib/slick-1.6.0
    script:
        - slick/slick.min.js
        - slick/slick.js
    stylesheet: 
        - slick/slick.css
        - slick/slick-theme.css

但我真的不知道如何调整 inst/htmlwidget/slick.js 文件和 R/slick.R 文件,以便可以采用 url 向量并将它们显示在闪亮的应用程序中。这样做的原因是它似乎与提供的示例中的输入数据概念不匹配。

为了可重复性和使用包中示例中提供的相同 URL,我提供了一个占位符 img url 的矢量,我想将其用作内容。对于轮播中的每张图片。

image_vec <- paste0("http://placehold.it/350x300?text=",seq(1:9))

也许我可能需要使用这样的东西?...

lapply(image_vec,function(y){div(img(src=y))})

一如既往,我们将不胜感激。

编辑

我的新 slick.yaml 文件如下所示...在@NicE 的回答后 post...我是不是遗漏了什么?

dependencies:
  - name: jquery
    version: 3.1.0
    src: htmlwidgets/lib
    script:
      - jquery-3.1.0.min.js
  - name: slick
    version: 1.6.0
    src: htmlwidgets/lib/slick-1.6.0
    script:
        - slick/slick.min.js
        - slick/slick.js
    stylesheet: 
        - slick/slick.css
        - slick/slick-theme.css

现在我的文件结构如下所示:

R/
| slick.R

inst/
|-- htmlwidgets/
|   |-- slick.js
|   |-- slick.yaml
|   |-- lib/
|   |   |-- jquery-3.1.0.min.js
|   |   |-- slick-1.6.0/
|   |   |   |-- slick/
|   |   |   |   |-- slick.min.js 
|   |   |   |   |-- slick.js
|   |   |   |   |-- slick.css
|   |   |   |   |-- slick-theme.css

我的 /inst/htmlwidgets/slick.js 如下所示

HTMLWidgets.widget({

  name: 'slick',

  type: 'output',

  factory: function(el, width, height) {

    // TODO: define shared variables for this instance
    // create new slick object witht the given id?
    var sl = new slick(el.id);



    return {

          renderValue: function(x) {
                    //add class to the div and center it
                    el.setAttribute("class",x.class);
                    el.style.margin = "auto";

                    //add images to the div
                    content='';    
                    for(var image in x.message)
                    {
                      content += '<div><img src="' + x.message[image] + '"/></div>';
                    }
                    el.innerHTML = content;

                    //initialize the slider.
                    $(document).ready(function(){
                      $("."+x.class).slick(x.options);      
                    });

      },

      resize: function(width, height) {

        // TODO: code to re-render the widget with a new size

      }

    };
  }
});

这是一个尝试,使用 htmlwidgets_0.6:

对于依赖,yaml文件看起来是一样的,我只是在slick上面添加了jQuery:

dependencies:
  - name: jquery
    version: 3.1.0
    src: htmlwidgets/lib
    script:
      - jquery-3.1.0.min.js
  - name: slick ...

你可以得到它here并把它放在lib文件夹中。

slick.R文件中,需要将slick函数的参数改成添加选项,改成x将所有参数转发给JS代码:

slick <- function(message, class="slick_slider", options = list(), width = NULL, height = NULL) {

  # forward options using x
  x = list(
    message = message,
    class = class,
    options = options
  )
...

slick.js中主要需要修改renderValue将images/content加入div并显示轮播:

renderValue: function(x) {
          //add class to the div and center it
          el.setAttribute("class",x.class)
          el.style.margin = "auto";

          //add images to the div
          content='';    
          for(var image in x.message)
          {
            content += '<div><img src="' + x.message[image] + '"/></div>';
          }
          el.innerHTML = content;

          //initialize the slider.
          $(document).ready(function(){
            $("."+x.class).slick(x.options);      
          });

        }

使用 devtools::install() 安装后,您可以在 shiny 应用程序中使用它:

library(shiny)
library(htmlwidgets)
library(slick)

server <- function(input, output) {
  output$test_slick <- renderSlick({    
    slick(paste0("http://placehold.it/350x300?text=",1:9),
          options=list(dots=TRUE,autoplay=TRUE))
})
}

ui <- fluidPage(
  tags$style(HTML("body {background-color: #2682d5}")),
  slickOutput('test_slick',width="350px",height="300px")
)

shinyApp(ui = ui, server = server)