tagQuery() docs; Add .cssSelector parameter to tag methods

.Rbuildignore

@@ -10,3 +10,5 @@
 ^_pkgdown\.yml$
 ^docs$
 ^pkgdown$
+^vignettes$
+^logo$

.github/workflows/pkgdown.yaml

@@ -34,6 +34,7 @@ jobs:
         run: |
           install.packages("pak", repos = "https://r-lib.github.io/p/pak/dev/")
           saveRDS(pak::pkg_deps_tree("local::.", dependencies = TRUE), ".github/r-depends.rds")
+          pak::pkg_install("rstudio/quillt")
       - name: Cache R packages
         uses: actions/cache@v2
         with:
@@ -49,12 +50,13 @@ jobs:
         run: |
           pak::local_system_requirements(execute = TRUE)
           pak::pkg_system_requirements("pkgdown", execute = TRUE)
+          pak::pkg_system_requirements("microbenchmark", execute = TRUE)
 
       - name: Install dependencies
         shell: Rscript {0}
         run: |
           pak::local_install_dev_deps(upgrade = TRUE)
-          pak::pkg_install("pkgdown")
+          pak::pkg_install(c("pkgdown", "microbenchmark"), upgrade = TRUE)
 
       - name: Install package
         run: R CMD INSTALL .

NEWS.md

@@ -2,7 +2,9 @@
 
 ## New Features & Improvements
 
-* Added `tagQuery(tags)`. A tag query object implements many popular features of jQuery.  Similar to jQuery, tag query objects can find internal html using CSS selections. Given a selection (which defaults to the original `tags`), many alterations may be performed before converting the tag query object back to tag objects. (#208)
+* `{htmltools}` now has its own `{pkgdown}` site hosted at <https://rstudio.github.io/htmltools/>.
+
+* The new `tagQuery()` function provides a [jQuery](https://jquery.com/) inspired interface to query and/or modify HTML `tag()` (e.g., `div()`) or `tagList()` objects. To learn more, see the [{pkgdown} article](https://rstudio.github.io/htmltools/articles/tagQuery.html). (#208)
 
 * Added `tagAddRenderHook()` for delaying modification of a tag object until it is rendered. A list of render-time hooks may also be added via the new `.renderHook` argument added to all `tag()` functions. (#215)
 

R/selector.R

@@ -49,13 +49,6 @@ asSelector <- function(selector) {
     )
   }
 
-  # if it contains multiple elements, recurse
-  if (txt_detect(selector, "* ", fixed = TRUE)) {
-    # we already match on all elements. No need to know about this selector
-    warning("Removing `* ` from selector. ")
-    selector <- txt_remove_all(selector, "* ", fixed = TRUE)
-  }
-
   # Check here to avoid inf recursion
   if (txt_detect(selector, ">", fixed = TRUE)) {
     # If there is a `>`, pad it with spaces

README.md

@@ -1,7 +1,4 @@
-# htmltools
-
 <!-- badges: start -->
-
 [![R build
 status](https://github.com/rstudio/htmltools/workflows/R-CMD-check/badge.svg)](https://github.com/rstudio/htmltools)
 [![CRAN
@@ -13,4 +10,51 @@ Downloads](https://cranlogs.r-pkg.org/badges/grand-total/htmltools)](https://www
 experimental](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://www.tidyverse.org/lifecycle/#stable)
 <!-- badges: end -->
 
-Tools for HTML generation and output.
+# htmltools <a href='https://rstudio.github.io/htmltools'><img src='man/figures/logo.png' align="right" height="138" /></a>
+
+Tools for creating, manipulating, and writing HTML from R.
+
+## Installation
+
+Install the stable release of `htmltools` on CRAN:
+
+```r
+install.packages("htmltools")
+```
+
+Install the development version with:
+
+```r
+remotes::install_github("rstudio/htmltools")
+```
+
+## Quick overview
+
+`{htmltools}` makes it easy to customize the user interface (UI) of any [Shiny](https://shiny.rstudio.com/) or [R Markdown](https://rmarkdown.rstudio.com/) project by using R code to generate custom HTML (including JavaScript and CSS).
+
+[This Shiny article](https://shiny.rstudio.com/articles/html-tags.html) provides a great introduction to `{htmltools}` (even if you're not interested in Shiny). As you'll learn in that article, the general foundation that `{htmltools}` provides allows other R packages (e.g., [`{htmlwidgets}`](http://www.htmlwidgets.org/), [`{crosstalk}`](https://rstudio.github.io/crosstalk/), etc.) to provide "HTML components" in R that users can manipulate and combine in ways the component authors didn't foresee.
+
+For example, as described in depth [here](https://plotly-r.com/arranging-views.html#arranging-htmlwidgets), `{htmltools}` makes it fairly easy to arrange numerous `{htmlwidgets}` (e.g., `{plotly}` graphs) into a single static HTML webpage:
+
+```r
+library(htmltools)
+browsable(tagList(
+  plot_ly(diamonds, x = ~carat, height = 200),
+  plot_ly(diamonds, x = ~price, height = 200)
+))
+```
+
+<div align="center">
+  <img src="man/figures/plotly-taglist.png" width="60%" />
+</div>
+
+Also, thanks to `tagQuery()`, it fairly easy to query and manipulate the underlying HTML structure of components. See the [`tagQuery()` article](https://rstudio.github.io/htmltools/articles/tagQuery.html) to learn more.
+
+
+## Learn more
+
+If you're looking to learn how to build more custom user interfaces by  writing custom HTML/JavaScript/CSS, we recommend the following resource:
+
+* Shiny's [UI](https://shiny.rstudio.com/articles/#user-interface) and [extensions](https://shiny.rstudio.com/articles/#extensions) articles
+* [Outstanding UI with Shiny](https://unleash-shiny.rinterface.com/) by David Granjon
+* [JavaScript for R](https://book.javascript-for-r.com/) by John Coene

logo/.gitignore

@@ -0,0 +1 @@
+old