docs(theming): update icon playgrounds to use addIcons usage (#3758)

Author: brandyscarney

static/usage/v7/theming/automatic-dark-mode/angular/example_component_ts.md

@@ -1,11 +1,23 @@
 ```ts
 import { Component, OnInit } from '@angular/core';
 
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
 @Component({
   selector: 'app-example',
   templateUrl: 'example.component.html',
 })
 export class ExampleComponent implements OnInit {
+  constructor() {
+    /**
+     * Any icons you want to use in your application
+     * can be registered in app.component.ts and then
+     * referenced by name anywhere in your application.
+     */
+    addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+  }
+
   ngOnInit() {
     // Use matchMedia to check the user preference
     const prefersDark = window.matchMedia('(prefers-color-scheme: dark)');

static/usage/v7/theming/automatic-dark-mode/index.md

@@ -1,6 +1,7 @@
 import Playground from '@site/src/components/global/Playground';
 
-import javascript_index_html from './javascript.md';
+import javascript_index_html from './javascript/index_html.md';
+import javascript_index_ts from './javascript/index_ts.md';
 
 import react_main_tsx from './react/main_tsx.md';
 import react_main_css from './react/main_css.md';
@@ -19,8 +20,12 @@ import variables_css from './theme/variables_css.md';
     javascript: {
       files: {
         'index.html': javascript_index_html,
+        'index.ts': javascript_index_ts,
         'theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
     react: {
       files: {
@@ -42,6 +47,9 @@ import variables_css from './theme/variables_css.md';
         'src/global.css': angular_global_css,
         'src/theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
   }}
   src="usage/v7/theming/automatic-dark-mode/demo.html"

static/usage/v7/theming/automatic-dark-mode/javascript.md renamed to static/usage/v7/theming/automatic-dark-mode/javascript/index_html.md

@@ -0,0 +1,36 @@
+```ts
+import { defineCustomElements } from '@ionic/core/loader';
+
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
+/* Core CSS required for Ionic components to work properly */
+import '@ionic/core/css/core.css';
+
+/* Basic CSS for apps built with Ionic */
+import '@ionic/core/css/normalize.css';
+import '@ionic/core/css/structure.css';
+import '@ionic/core/css/typography.css';
+
+/* Optional CSS utils that can be commented out */
+import '@ionic/core/css/padding.css';
+import '@ionic/core/css/float-elements.css';
+import '@ionic/core/css/text-alignment.css';
+import '@ionic/core/css/text-transformation.css';
+import '@ionic/core/css/flex-utils.css';
+import '@ionic/core/css/display.css';
+
+/* Theme variables */
+import './theme/variables.css';
+
+/**
+ * On Ionicons 7.2+ these icons
+ * get mapped to a kebab-case key.
+ * Alternatively, developers can do:
+ * addIcons({ 'person-circle': personCircle, 'person-circle-outline': personCircleOutline,
+ * 'sunny': sunny, 'sunny-outline': sunnyOutline });
+ */
+addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+
+defineCustomElements();
+```

static/usage/v7/theming/automatic-dark-mode/javascript/index_ts.md

@@ -1,13 +1,25 @@
 ```ts
 import { Component, OnInit } from '@angular/core';
 
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
 @Component({
   selector: 'app-example',
   templateUrl: 'example.component.html',
 })
 export class ExampleComponent implements OnInit {
   themeToggle = false;
 
+  constructor() {
+    /**
+     * Any icons you want to use in your application
+     * can be registered in app.component.ts and then
+     * referenced by name anywhere in your application.
+     */
+    addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+  }
+
   ngOnInit() {
     // Use matchMedia to check the user preference
     const prefersDark = window.matchMedia('(prefers-color-scheme: dark)');

static/usage/v7/theming/manual-dark-mode/angular/example_component_ts.md

@@ -1,6 +1,7 @@
 import Playground from '@site/src/components/global/Playground';
 
-import javascript_index_html from './javascript.md';
+import javascript_index_html from './javascript/index_html.md';
+import javascript_index_ts from './javascript/index_ts.md';
 
 import react_main_tsx from './react/main_tsx.md';
 import react_main_css from './react/main_css.md';
@@ -19,8 +20,12 @@ import variables_css from './theme/variables_css.md';
     javascript: {
       files: {
         'index.html': javascript_index_html,
+        'index.ts': javascript_index_ts,
         'theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
     react: {
       files: {
@@ -42,6 +47,9 @@ import variables_css from './theme/variables_css.md';
         'src/global.css': angular_global_css,
         'src/theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
   }}
   src="usage/v7/theming/manual-dark-mode/demo.html"

static/usage/v7/theming/manual-dark-mode/index.md

@@ -0,0 +1,36 @@
+```ts
+import { defineCustomElements } from '@ionic/core/loader';
+
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
+/* Core CSS required for Ionic components to work properly */
+import '@ionic/core/css/core.css';
+
+/* Basic CSS for apps built with Ionic */
+import '@ionic/core/css/normalize.css';
+import '@ionic/core/css/structure.css';
+import '@ionic/core/css/typography.css';
+
+/* Optional CSS utils that can be commented out */
+import '@ionic/core/css/padding.css';
+import '@ionic/core/css/float-elements.css';
+import '@ionic/core/css/text-alignment.css';
+import '@ionic/core/css/text-transformation.css';
+import '@ionic/core/css/flex-utils.css';
+import '@ionic/core/css/display.css';
+
+/* Theme variables */
+import './theme/variables.css';
+
+/**
+ * On Ionicons 7.2+ these icons
+ * get mapped to a kebab-case key.
+ * Alternatively, developers can do:
+ * addIcons({ 'person-circle': personCircle, 'person-circle-outline': personCircleOutline,
+ * 'sunny': sunny, 'sunny-outline': sunnyOutline });
+ */
+addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+
+defineCustomElements();
+```

static/usage/v7/theming/manual-dark-mode/javascript.md renamed to static/usage/v7/theming/manual-dark-mode/javascript/index_html.md

@@ -0,0 +1,22 @@
+```ts
+import { Component } from '@angular/core';
+
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
+@Component({
+  selector: 'app-example',
+  templateUrl: 'example.component.html',
+  styleUrls: ['example.component.css'],
+})
+export class ExampleComponent {
+  constructor() {
+    /**
+     * Any icons you want to use in your application
+     * can be registered in app.component.ts and then
+     * referenced by name anywhere in your application.
+     */
+    addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+  }
+}
+```

static/usage/v7/theming/manual-dark-mode/javascript/index_ts.md

@@ -7,6 +7,7 @@ import react_app_tsx from './react/app_tsx.md';
 import react_main_tsx from './react/main_tsx.md';
 
 import angular_example_component_html from './angular/example_component_html.md';
+import angular_example_component_ts from './angular/example_component_ts.md';
 import angular_styles_css from './angular/styles_css.md';
 
 import vue_example from './vue/example_vue.md';
@@ -23,6 +24,9 @@ import variables_css from './theme/variables_css.md';
         'index.ts': javascript_index_ts,
         'theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
     react: {
       files: {
@@ -41,9 +45,13 @@ import variables_css from './theme/variables_css.md';
     angular: {
       files: {
         'src/app/example.component.html': angular_example_component_html,
+        'src/app/example.component.ts': angular_example_component_ts,
         'src/styles.css': angular_styles_css,
         'src/theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
   }}
   src="usage/v8/theming/always-dark-mode/demo.html"

static/usage/v8/theming/always-dark-mode/angular/example_component_ts.md

@@ -1,6 +1,9 @@
 ```ts
 import { defineCustomElements } from '@ionic/core/loader';
 
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
 /* Core CSS required for Ionic components to work properly */
 import '@ionic/core/css/core.css';
 
@@ -31,5 +34,14 @@ import '@ionic/core/css/palettes/dark.always.css';
 /* Theme variables */
 import './theme/variables.css';
 
+/**
+ * On Ionicons 7.2+ these icons
+ * get mapped to a kebab-case key.
+ * Alternatively, developers can do:
+ * addIcons({ 'person-circle': personCircle, 'person-circle-outline': personCircleOutline,
+ * 'sunny': sunny, 'sunny-outline': sunnyOutline });
+ */
+addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+
 defineCustomElements();
 ```

static/usage/v8/theming/always-dark-mode/index.md

@@ -0,0 +1,22 @@
+```ts
+import { Component } from '@angular/core';
+
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
+@Component({
+  selector: 'app-example',
+  templateUrl: 'example.component.html',
+  styleUrls: ['example.component.css'],
+})
+export class ExampleComponent {
+  constructor() {
+    /**
+     * Any icons you want to use in your application
+     * can be registered in app.component.ts and then
+     * referenced by name anywhere in your application.
+     */
+    addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+  }
+}
+```

static/usage/v8/theming/always-dark-mode/javascript/index_ts.md

@@ -7,6 +7,7 @@ import react_app_tsx from './react/app_tsx.md';
 import react_main_tsx from './react/main_tsx.md';
 
 import angular_example_component_html from './angular/example_component_html.md';
+import angular_example_component_ts from './angular/example_component_ts.md';
 import angular_styles_css from './angular/styles_css.md';
 
 import vue_example from './vue/example_vue.md';
@@ -20,6 +21,9 @@ import vue_main_ts from './vue/main_ts.md';
         'index.html': javascript_index_html,
         'index.ts': javascript_index_ts,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
     react: {
       files: {
@@ -36,8 +40,12 @@ import vue_main_ts from './vue/main_ts.md';
     angular: {
       files: {
         'src/app/example.component.html': angular_example_component_html,
+        'src/app/example.component.ts': angular_example_component_ts,
         'src/styles.css': angular_styles_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
   }}
   src="usage/v8/theming/always-high-contrast-mode/demo.html"

static/usage/v8/theming/always-high-contrast-mode/angular/example_component_ts.md

@@ -1,6 +1,9 @@
 ```ts
 import { defineCustomElements } from '@ionic/core/loader';
 
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
 /* Core CSS required for Ionic components to work properly */
 import '@ionic/core/css/core.css';
 
@@ -26,5 +29,17 @@ import '@ionic/core/css/display.css';
 
 import '@ionic/core/css/palettes/high-contrast.always.css';
 
+/* Theme variables */
+import './theme/variables.css';
+
+/**
+ * On Ionicons 7.2+ these icons
+ * get mapped to a kebab-case key.
+ * Alternatively, developers can do:
+ * addIcons({ 'person-circle': personCircle, 'person-circle-outline': personCircleOutline,
+ * 'sunny': sunny, 'sunny-outline': sunnyOutline });
+ */
+addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+
 defineCustomElements();
 ```

static/usage/v8/theming/always-high-contrast-mode/index.md

@@ -1,13 +1,25 @@
 ```ts
 import { Component, OnInit } from '@angular/core';
 
+import { addIcons } from 'ionicons';
+import { personCircle, personCircleOutline, sunny, sunnyOutline } from 'ionicons/icons';
+
 @Component({
   selector: 'app-example',
   templateUrl: 'example.component.html',
 })
 export class ExampleComponent implements OnInit {
   paletteToggle = false;
 
+  constructor() {
+    /**
+     * Any icons you want to use in your application
+     * can be registered in app.component.ts and then
+     * referenced by name anywhere in your application.
+     */
+    addIcons({ personCircle, personCircleOutline, sunny, sunnyOutline });
+  }
+
   ngOnInit() {
     // Use matchMedia to check the user preference
     const prefersDark = window.matchMedia('(prefers-color-scheme: dark)');

static/usage/v8/theming/always-high-contrast-mode/javascript/index_ts.md

@@ -26,6 +26,9 @@ import variables_css from './theme/variables_css.md';
         'index.ts': javascript_index_ts,
         'theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
     react: {
       files: {
@@ -50,6 +53,9 @@ import variables_css from './theme/variables_css.md';
         'src/styles.css': angular_styles_css,
         'src/theme/variables.css': variables_css,
       },
+      dependencies: {
+        ionicons: '7.4.0',
+      },
     },
   }}
   src="usage/v8/theming/class-dark-mode/demo.html"