Changelog

Source: NEWS.md

htmltools (development version)

htmltools 0.5.82024-03-25

Improvements

  • The fill CSS attached to fillable containers and fill items with bindFillRole() now uses a CSS cascade layer named htmltools to reduce the precedence order of the fill CSS. (#425)

  • Improved documentation for boolean attributes in tagAppendAttributes() to note that they can be set via an NA value, e.g. tagAppendAttributes(div(), contenteditable = NA) creates <div contenteditable></div>. (thanks @russHyde, #427)

Bug fixes

  • bindFillRole() now attaches its HTMLDependency() to fill items, thus reducing the possibility of filling layout breaking due to missing CSS. (#421)

htmltools 0.5.72023-11-03

New Features

  • save_html() is now an S3 generic, allowing for more customization over how certain classes are saved to an HTML file. (#411)

Improvements

  • Fill items no longer set overflow: auto or width: 100% by default. (#401)

  • css() now fully supports setting custom CSS properties (or CSS variables) via inline styles. When the name of a value passed to css() starts with --, it will be treated as a custom CSS property and absolutely no changes will be made to the variable. For example, css("--font_size" = "3em") returns --font_size:3em; while css(font_size = "3em") will return font-size:3em. (#402)

Bug fixes

htmltools 0.5.6.12023-10-06

Improvements

  • tagQuery() no longer throws an error when attempting to traverse a NULL value with r-devel. (#407)

htmltools 0.5.62023-08-10

Possibly breaking changes

  • Closed #386: Fillable containers no longer set overflow: auto by default. Instead, they set min-width and min-height to 0 to ensure that fill items a constrained in the fillable container without clipping their direct children. (#387)

  • Closed #370: Non-fill items in fillable containers no longer grow or shrink and instead respect their intrinsic size. Use height to control the height of non-fill items in fillable containers and min-height and max-height on fill items to limit how much they are allowed to grow or shrink within a fillable container. (#391)

Minor improvements

  • Closed #375: calling htmlDependency() or a function that returns an htmlDependency() object (e.g., fontawesome::fa_html_dependency()) in an R chunk in an R Markdown or knitr-powered Quarto document will now include the dependency rather than printing the object structure. If you want to print the object structure, you can use print() or str(). (#376)

  • Closed #124: includeHTML() will now issue a warning if it detects that the file passed to it contains a complete HTML document. includeHTML() is designed to include HTML fragments where the contents of the file can be written directly into the current app or document, but subtle errors can occur when the file contains a complete HTML document. In most cases, you should instead use tags$iframe() to embed external documents. (#382)

htmltools 0.5.52023-03-23

Bug fixes

htmltools 0.5.42022-12-07

New Features

Bug fixes

  • Closed #331: copyDependencyToDir() creates outputDir recursively, which happens in Quarto or when lib_dir points to a nested directory. (@gadenbuie, #332)

  • Closed #346: tagQuery()’s $remove(), $after(), $before(), $replaceWith() had a bug that prevented expected behavior when sibling children values where not tag elements. (#348)

htmltools 0.5.32022-07-18

Breaking changes

  • Closed #305: htmlPreserve() no longer uses inline code blocks for Pandoc’s raw attribute feature when used inside a non-inline knitr/rmarkdown code chunk, and as a result, in this case, an additional <p> tag is no longer wrapped around the HTML content. (#306)

Bug fixes

htmltools 0.5.22021-08-25

Breaking Changes

  • Closed #205: When calling tagGetAttribute(x) on an object with a non-atomic attribute, a list of untouched values will be returned. It is still recommended to only store character values inside attributes. (#212)

New Features & Improvements

Bug Fixes

  • When retrieving a tag attribute using tagGetAttribute(tag, attr), NA values will be removed before combining remaining attribute values. If all attribute values are NA, then a single NA value will be returned. (#212)

  • Closed #197: Fixed rendering of boolean attributes in <script> tags rendered via renderDependencies() (#197, thanks @atusy).

  • Closed #222: Unnamed attributes are no longer allowed to be appended via tagAppendAttribs(). When trying to print unnamed tag attribs, a better error message is provided. (#229)

htmltools 0.5.1.12021-01-22

  • Added shiny as a suggested package.

htmltools 0.5.12021-01-12

New Features & Improvements

Breaking Changes

  • Closed #161: parseCssColors(x) now requires x to be a character vector (it no longer accepts a list() of strings) and an error is no longer thrown when mustWork = FALSE and x contains NA value(s). (#194)

Bug fixes

  • print(as.tags(x)) no longer results in error when x is a generic list() of tag-like objects. (#181)

htmltools 0.5.02020-06-16

  • tags is now generated by a script which collects all HTML and SVG element tags documented in MDN Web Docs. This feature only appends to the existing set of tags (#159)

  • Removed the Rcpp dependency and the compiled code now uses C rather than C++ (#158)

  • BREAKING CHANGE: Fixed #57, #153: htmlTemplate output no longer inserts extra whitespace around {{…}} replacement values. (#154)

  • HTML() now takes .noWS argument, which can be used to suppress surrounding whitespace (similar to the new argument for tags in htmltools 0.4.0). (#154)

  • css() now returns NULL instead of "" when no non-empty properties are specified. (#145)

  • save_html(tags$body(...)) no longer results in double

    tags being written to the .html file. (Note that save_html(tags$html(...)) is not supported at this time.) (#145)

  • Trailing commas now permitted in ... arguments to css(), tagList(), and the var-arg mutation functions: tagAppendAttributes(), tagSetChildren(), and tagAppendChildren(). (#145)

  • Added capturePlot and plotTag functions, for easily creating image files and HTML tags (respectively) from plot expressions. (#150)

  • Added parseCssColors function, for normalizing the various CSS color formats into #RRGGBB(AA) strings. (#155)

  • Fixed #156: Now extractPreserveChunks() handles strings contain Emoji Unicode strings correctly on Windows. (#157)

  • The .noWS parameter for suppressing whitespace can now take an "inside" value (equivalent to c("after-start", "before-end")). (#163)

htmltools 0.4.02019-10-04

  • Fixed #128: Added support for trailing commas in tagLists and the predefined tags. (#135)

  • Added some HTML tag functions to tags that were missing. (#111)

  • Updated RcppExports for new version of Rcpp. (#93)

  • as.character.shiny.tags() will handle non-ASCII attributes correctly if they are not encoded in native encoding.

  • Fixed #99: NA attributes were sometimes rendered as "NA" in the HTML, instead of being blank. (#100)

  • The error message for trailing commas in tag functions now provides context and useful information. (#109)

  • Stopped using inline styles to set background color for save_html, as doing so makes it difficult to override using other CSS rules. (#123)

  • Added a .noWS argument to tag() and tags which can be used to suppress the automatically generated whitespace around a particular tag. (#131)

  • Added a shim for system.file() so that htmltools works with htmlDependency objects created by a package that was loaded with devtools::load_all(). (#129)

  • validateCssUnit() now accepts ch, rem, and calc(). (#134)

  • Fixed #125: print.html removes html dependencies. (#126)

  • Stopped extra carriage returns from being inserted by save_html on Windows. (#137)

htmltools 0.3.62017-04-28

htmltools 0.3.52016-03-21

  • as.character now returns a character vector with no other attributes. Previously it returned a character vector of class ‘html’. (#31, #41)

  • htmlTemplate now can use a string as a template instead of requiring a file. (#41, #43)

  • HTML dependencies can now be added inline, instead of needing to use attachDependencies(). (#40, #42)

  • htmlDependency() gained a new argument all_files to indicate whether all files under the src directory should be copied when rendering dependencies, or only those specified in the dependency objects. (#48)

  • copyDependencyToDir() will always completely overwrite the target directory when copying HTML dependency files to make sure all dependency files are definitely updated in the target directory when the original dependency directory has been updated. In the past, the dependency files were not updated if they already existed. (#36)

  • The version number in the directory name of an HTML dependency can be suppressed by setting options(htmltools.dir.version = FALSE) when the dependency is copied via copyDependencyToDir(). (#37)

  • Performance improvement rendering tags, by switching from readLines to readChar.

htmltools 0.32015-12-29

htmltools 0.2.9

  • Add check that htmlDependency() isn’t called with an absolute path when a binary package is built. (#22)

  • Allow HTML content to include UTF-8, Latin1, and system encoded content. All will be converted to UTF-8 using enc2utf8() at render time. (#21)

  • Add tagGetAttribute() and tagHasAttribute() functions.

htmltools 0.2.7

  • Add “append” parameter to attachDependencies, to allow adding dependencies, instead of replacing them.

htmltools 0.2.62014-09-08

  • Add “attachment” parameter to htmlDependency, which can be used to allow any file in the dependency directory to be available via URL at runtime.

htmltools 0.2.5

  • Explicit library(htmltools) is no longer required for tags to be rendered in knitr/rmarkdown documents.

  • Added “viewer” parameter to html_print.

htmltools 0.2.42014-05-28

Initial release