😎 Give your xaringan slides some style
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.

245 lines
22KB

  1. <!DOCTYPE html>
  2. <!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>Themed ggplot2 Scales — scale_xaringan • xaringanthemer</title><!-- favicons --><link rel="icon" type="image/png" sizes="96x96" href="../favicon-96x96.png"><link rel="icon" type="”image/svg+xml”" href="../favicon.svg"><link rel="apple-touch-icon" sizes="180x180" href="../apple-touch-icon.png"><link rel="icon" sizes="any" href="../favicon.ico"><link rel="manifest" href="../site.webmanifest"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/IBM_Plex_Mono-0.4.10/font.css" rel="stylesheet"><link href="../deps/Outfit-0.4.10/font.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><link href="../extra.css" rel="stylesheet"><meta property="og:title" content="Themed ggplot2 Scales — scale_xaringan"><meta name="description" content="
  3. Color and fill single-color scales for discrete and continuous values,
  4. created using the primary accent color of the xaringanthemer styles. See
  5. vignette(&quot;ggplot2-themes&quot;) for more information and examples of
  6. xaringanthemer's ggplot2-related functions."><meta property="og:description" content="
  7. Color and fill single-color scales for discrete and continuous values,
  8. created using the primary accent color of the xaringanthemer styles. See
  9. vignette(&quot;ggplot2-themes&quot;) for more information and examples of
  10. xaringanthemer's ggplot2-related functions."><meta property="og:image" content="https://pkg.garrickadenbuie.com/xaringanthemer/logo.png"><meta name="twitter:card" content="summary"><meta name="twitter:creator" content="@grrrck"><meta name="twitter:site" content="@grrrck"><meta name="robots" content="noindex"></head><body>
  11. <a href="#main" class="visually-hidden-focusable">Skip to contents</a>
  12. <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">
  13. <a class="navbar-brand me-2" href="../index.html">xaringanthemer</a>
  14. <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.4.4.9000</small>
  15. <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
  16. <span class="navbar-toggler-icon"></span>
  17. </button>
  18. <div id="navbar" class="collapse navbar-collapse ms-3">
  19. <ul class="navbar-nav me-auto"><li class="nav-item"><a class="nav-link" href="../articles/xaringanthemer.html">Features</a></li>
  20. <li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
  21. <li class="nav-item dropdown">
  22. <button class="nav-link dropdown-toggle" type="button" id="dropdown-themes" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Themes</button>
  23. <ul class="dropdown-menu" aria-labelledby="dropdown-themes"><li><h6 class="dropdown-header" data-toc-skip>Themes</h6></li>
  24. <li><a class="dropdown-item" href="../articles/themes.html">Slide Themes</a></li>
  25. <li><a class="dropdown-item" href="../articles/ggplot2-themes.html">ggplot2 Themes</a></li>
  26. <li><hr class="dropdown-divider"></li>
  27. <li><h6 class="dropdown-header" data-toc-skip>More Customization</h6></li>
  28. <li><a class="dropdown-item" href="../articles/fonts.html">Fonts</a></li>
  29. <li><a class="dropdown-item" href="../articles/template-variables.html">Template Variables</a></li>
  30. </ul></li>
  31. </ul><ul class="navbar-nav"><li class="nav-item dropdown">
  32. <button class="nav-link dropdown-toggle" type="button" id="dropdown-" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true"><span class="fa far fa-newspaper fa-lg"></span> </button>
  33. <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="dropdown-"><li><a class="external-link dropdown-item" href="https://garrickadenbuie.com/blog/xaringanthemer-v0-3-0/">xaringanthemer 0.3.0</a></li>
  34. <li><hr class="dropdown-divider"></li>
  35. <li><a class="dropdown-item" href="../news/index.html">Changelog</a></li>
  36. </ul></li>
  37. <li class="nav-item"><a class="external-link nav-link" href="https://github.com/gadenbuie/xaringanthemer"><span class="fa fab fa-github fa-lg"></span></a></li>
  38. <li class="nav-item"><a class="external-link nav-link" href="https://twitter.com/grrrck"><span class="fa fab fa-twitter fa-lg"></span></a></li>
  39. <li class="nav-item"><a class="external-link nav-link" href="https://www.garrickadenbuie.com"><span class="fa fas fa-home fa-lg"></span></a></li>
  40. </ul></div>
  41. </div>
  42. </nav><div class="container template-reference-topic">
  43. <div class="row">
  44. <main id="main" class="col-md-9"><div class="page-header">
  45. <img src="../logo.png" class="logo" alt=""><h1>Themed ggplot2 Scales</h1>
  46. <small class="dont-index">Source: <a href="https://github.com/gadenbuie/xaringanthemer/blob/main/R/ggplot2.R" class="external-link"><code>R/ggplot2.R</code></a></small>
  47. <div class="d-none name"><code>scale_xaringan.Rd</code></div>
  48. </div>
  49. <div class="ref-description section level2">
  50. <p><a href="https://lifecycle.r-lib.org/articles/stages.html#maturing" class="external-link"><img src="figures/lifecycle-maturing.svg" alt="[Maturing]"></a></p>
  51. <p>Color and fill single-color scales for discrete and continuous values,
  52. created using the primary accent color of the xaringanthemer styles. See
  53. <code><a href="../articles/ggplot2-themes.html">vignette("ggplot2-themes")</a></code> for more information and examples of
  54. <span class="pkg">xaringanthemer</span>'s <span class="pkg">ggplot2</span>-related functions.</p>
  55. </div>
  56. <div class="section level2">
  57. <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
  58. <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">scale_xaringan_discrete</span><span class="op">(</span></span>
  59. <span> aes_type <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">"color"</span>, <span class="st">"colour"</span>, <span class="st">"fill"</span><span class="op">)</span>,</span>
  60. <span> <span class="va">...</span>,</span>
  61. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  62. <span> direction <span class="op">=</span> <span class="fl">1</span>,</span>
  63. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span>,</span>
  64. <span> na.value <span class="op">=</span> <span class="st">"grey50"</span></span>
  65. <span><span class="op">)</span></span>
  66. <span></span>
  67. <span><span class="fu">scale_xaringan_fill_discrete</span><span class="op">(</span><span class="va">...</span>, color <span class="op">=</span> <span class="cn">NULL</span>, direction <span class="op">=</span> <span class="fl">1</span>, inverse <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span></span>
  68. <span></span>
  69. <span><span class="fu">scale_xaringan_color_discrete</span><span class="op">(</span></span>
  70. <span> <span class="va">...</span>,</span>
  71. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  72. <span> direction <span class="op">=</span> <span class="fl">1</span>,</span>
  73. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span></span>
  74. <span><span class="op">)</span></span>
  75. <span></span>
  76. <span><span class="fu">scale_xaringan_colour_discrete</span><span class="op">(</span></span>
  77. <span> <span class="va">...</span>,</span>
  78. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  79. <span> direction <span class="op">=</span> <span class="fl">1</span>,</span>
  80. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span></span>
  81. <span><span class="op">)</span></span>
  82. <span></span>
  83. <span><span class="fu">scale_xaringan_continuous</span><span class="op">(</span></span>
  84. <span> aes_type <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">"color"</span>, <span class="st">"colour"</span>, <span class="st">"fill"</span><span class="op">)</span>,</span>
  85. <span> <span class="va">...</span>,</span>
  86. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  87. <span> begin <span class="op">=</span> <span class="fl">0</span>,</span>
  88. <span> end <span class="op">=</span> <span class="fl">1</span>,</span>
  89. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span>,</span>
  90. <span> na.value <span class="op">=</span> <span class="st">"grey50"</span></span>
  91. <span><span class="op">)</span></span>
  92. <span></span>
  93. <span><span class="fu">scale_xaringan_fill_continuous</span><span class="op">(</span></span>
  94. <span> <span class="va">...</span>,</span>
  95. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  96. <span> begin <span class="op">=</span> <span class="fl">0</span>,</span>
  97. <span> end <span class="op">=</span> <span class="fl">1</span>,</span>
  98. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span></span>
  99. <span><span class="op">)</span></span>
  100. <span></span>
  101. <span><span class="fu">scale_xaringan_color_continuous</span><span class="op">(</span></span>
  102. <span> <span class="va">...</span>,</span>
  103. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  104. <span> begin <span class="op">=</span> <span class="fl">0</span>,</span>
  105. <span> end <span class="op">=</span> <span class="fl">1</span>,</span>
  106. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span></span>
  107. <span><span class="op">)</span></span>
  108. <span></span>
  109. <span><span class="fu">scale_xaringan_colour_continuous</span><span class="op">(</span></span>
  110. <span> <span class="va">...</span>,</span>
  111. <span> color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  112. <span> begin <span class="op">=</span> <span class="fl">0</span>,</span>
  113. <span> end <span class="op">=</span> <span class="fl">1</span>,</span>
  114. <span> inverse <span class="op">=</span> <span class="cn">FALSE</span></span>
  115. <span><span class="op">)</span></span></code></pre></div>
  116. </div>
  117. <div class="section level2">
  118. <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>
  119. <dl><dt id="arg-aes-type">aes_type<a class="anchor" aria-label="anchor" href="#arg-aes-type"></a></dt>
  120. <dd><p>The type of aesthetic to which the scale is being applied.
  121. One of "color", "colour", or "fill".</p></dd>
  122. <dt id="arg--">...<a class="anchor" aria-label="anchor" href="#arg--"></a></dt>
  123. <dd><p>Arguments passed on to either the <span class="pkg">colorspace</span> scale
  124. functions — one of <code><a href="https://colorspace.R-Forge.R-project.org/reference/scale_colour_discrete_sequential.html" class="external-link">colorspace::scale_color_discrete_sequential()</a></code>,
  125. <code><a href="https://colorspace.R-Forge.R-project.org/reference/scale_colour_continuous_sequential.html" class="external-link">colorspace::scale_color_continuous_sequential()</a></code>,
  126. <code><a href="https://colorspace.R-Forge.R-project.org/reference/scale_colour_discrete_sequential.html" class="external-link">colorspace::scale_fill_discrete_sequential()</a></code>, or
  127. <code><a href="https://colorspace.R-Forge.R-project.org/reference/scale_colour_continuous_sequential.html" class="external-link">colorspace::scale_fill_continuous_sequential()</a></code> — or to
  128. <a href="https://ggplot2.tidyverse.org/reference/continuous_scale.html" class="external-link">ggplot2::continuous_scale</a> or <a href="https://ggplot2.tidyverse.org/reference/discrete_scale.html" class="external-link">ggplot2::discrete_scale</a>.</p></dd>
  129. <dt id="arg-color">color<a class="anchor" aria-label="anchor" href="#arg-color"></a></dt>
  130. <dd><p>A color value, in hex, to override the default color. Otherwise,
  131. the primary color of the resulting scale is chosen from the xaringanthemer
  132. slide styles.</p></dd>
  133. <dt id="arg-direction">direction<a class="anchor" aria-label="anchor" href="#arg-direction"></a></dt>
  134. <dd><p>Direction of the discrete scale. Use values less than 0 to
  135. reverse the direction, e.g. <code>direction = -1</code>.</p></dd>
  136. <dt id="arg-inverse">inverse<a class="anchor" aria-label="anchor" href="#arg-inverse"></a></dt>
  137. <dd><p>If <code>color</code> is not supplied and <code>inverse = TRUE</code>, a primary
  138. color is chosen to work well with the inverse slide styles, namely the
  139. value of <code>inverse_header_color</code></p></dd>
  140. <dt id="arg-na-value">na.value<a class="anchor" aria-label="anchor" href="#arg-na-value"></a></dt>
  141. <dd><p>Color to be used for missing data points.</p></dd>
  142. <dt id="arg-begin">begin<a class="anchor" aria-label="anchor" href="#arg-begin"></a></dt>
  143. <dd><p>Number in the range of <code>[0, 1]</code> indicating to which point in the color scale the smallest data value should be mapped.</p></dd>
  144. <dt id="arg-end">end<a class="anchor" aria-label="anchor" href="#arg-end"></a></dt>
  145. <dd><p>Number in the range of <code>[0, 1]</code> indicating to which point in the color scale the largest data value should be mapped.</p></dd>
  146. </dl></div>
  147. <div class="section level2">
  148. <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
  149. <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="co"># Requires ggplot2</span></span></span>
  150. <span class="r-in"><span><span class="va">has_ggplot2</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/ns-load.html" class="external-link">requireNamespace</a></span><span class="op">(</span><span class="st">"ggplot2"</span>, quietly <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></span>
  151. <span class="r-in"><span></span></span>
  152. <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="va">has_ggplot2</span><span class="op">)</span> <span class="op">{</span></span></span>
  153. <span class="r-in"><span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://ggplot2.tidyverse.org" class="external-link">ggplot2</a></span><span class="op">)</span></span></span>
  154. <span class="r-in"><span> <span class="co"># Saving the theme to a temp file because this is an example</span></span></span>
  155. <span class="r-in"><span> <span class="va">path_to_css_file</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/tempfile.html" class="external-link">tempfile</a></span><span class="op">(</span>fileext <span class="op">=</span> <span class="st">".css"</span><span class="op">)</span></span></span>
  156. <span class="r-in"><span></span></span>
  157. <span class="r-in"><span> <span class="co"># Create the xaringan theme: dark blue background with teal green accents</span></span></span>
  158. <span class="r-in"><span> <span class="fu"><a href="style_duo.html">style_duo</a></span><span class="op">(</span></span></span>
  159. <span class="r-in"><span> primary_color <span class="op">=</span> <span class="st">"#002b36"</span>,</span></span>
  160. <span class="r-in"><span> secondary_color <span class="op">=</span> <span class="st">"#31b09e"</span>,</span></span>
  161. <span class="r-in"><span> <span class="co"># Using basic fonts for this example, but the plot theme will</span></span></span>
  162. <span class="r-in"><span> <span class="co"># automatically use your theme font if you use Google fonts</span></span></span>
  163. <span class="r-in"><span> text_font_family <span class="op">=</span> <span class="st">"sans"</span>,</span></span>
  164. <span class="r-in"><span> header_font_family <span class="op">=</span> <span class="st">"serif"</span>,</span></span>
  165. <span class="r-in"><span> outfile <span class="op">=</span> <span class="va">path_to_css_file</span></span></span>
  166. <span class="r-in"><span> <span class="op">)</span></span></span>
  167. <span class="r-in"><span></span></span>
  168. <span class="r-in"><span> <span class="co"># Here's some very basic example data</span></span></span>
  169. <span class="r-in"><span> <span class="va">ex</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/data.frame.html" class="external-link">data.frame</a></span><span class="op">(</span></span></span>
  170. <span class="r-in"><span> name <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">"Couple"</span>, <span class="st">"Few"</span>, <span class="st">"Lots"</span>, <span class="st">"Many"</span><span class="op">)</span>,</span></span>
  171. <span class="r-in"><span> n <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">2</span>, <span class="fl">3</span>, <span class="fl">5</span>, <span class="fl">7</span><span class="op">)</span></span></span>
  172. <span class="r-in"><span> <span class="op">)</span></span></span>
  173. <span class="r-in"><span></span></span>
  174. <span class="r-in"><span> <span class="co"># Fill color scales demo</span></span></span>
  175. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/ggplot.html" class="external-link">ggplot</a></span><span class="op">(</span><span class="va">ex</span><span class="op">)</span> <span class="op">+</span></span></span>
  176. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span><span class="va">name</span>, <span class="va">n</span>, fill <span class="op">=</span> <span class="va">n</span><span class="op">)</span> <span class="op">+</span></span></span>
  177. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_bar.html" class="external-link">geom_col</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
  178. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">ggtitle</a></span><span class="op">(</span><span class="st">"Matching fill scales"</span><span class="op">)</span> <span class="op">+</span></span></span>
  179. <span class="r-in"><span> <span class="co"># themed to match the slides: dark blue background with teal text</span></span></span>
  180. <span class="r-in"><span> <span class="fu"><a href="theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
  181. <span class="r-in"><span> <span class="co"># Fill color matches teal text</span></span></span>
  182. <span class="r-in"><span> <span class="fu">scale_xaringan_fill_continuous</span><span class="op">(</span><span class="op">)</span></span></span>
  183. <span class="r-in"><span></span></span>
  184. <span class="r-in"><span> <span class="co"># Color scales demo</span></span></span>
  185. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/ggplot.html" class="external-link">ggplot</a></span><span class="op">(</span><span class="va">ex</span><span class="op">)</span> <span class="op">+</span></span></span>
  186. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span><span class="va">name</span>, y <span class="op">=</span> <span class="fl">1</span>, color <span class="op">=</span> <span class="va">name</span><span class="op">)</span> <span class="op">+</span></span></span>
  187. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_point.html" class="external-link">geom_point</a></span><span class="op">(</span>size <span class="op">=</span> <span class="fl">10</span><span class="op">)</span> <span class="op">+</span></span></span>
  188. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">ggtitle</a></span><span class="op">(</span><span class="st">"Matching color scales"</span><span class="op">)</span> <span class="op">+</span></span></span>
  189. <span class="r-in"><span> <span class="co"># themed to match the slides: dark blue background with teal text</span></span></span>
  190. <span class="r-in"><span> <span class="fu"><a href="theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
  191. <span class="r-in"><span> <span class="co"># Fill color matches teal text</span></span></span>
  192. <span class="r-in"><span> <span class="fu">scale_xaringan_color_discrete</span><span class="op">(</span>direction <span class="op">=</span> <span class="op">-</span><span class="fl">1</span><span class="op">)</span></span></span>
  193. <span class="r-in"><span><span class="op">}</span></span></span>
  194. <span class="r-plt img"><img src="scale_xaringan-1.png" alt="" width="700" height="433"></span>
  195. </code></pre></div>
  196. </div>
  197. </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
  198. </nav></aside></div>
  199. <footer><div class="pkgdown-footer-left">
  200. <p>Developed by <a href="https://www.garrickadenbuie.com" class="external-link">Garrick Aden-Buie</a>.</p>
  201. </div>
  202. <div class="pkgdown-footer-right">
  203. <p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.1.3.</p>
  204. </div>
  205. </footer></div>
  206. <script src="../doc-versions.js"></script></body></html>