Merge pull request #147 from NativeScript/niliev/fonts

add section about icon fonts in Image

Author: tsonevn

app/ns-ui-category/icon-fonts/basics/article.md

@@ -1,11 +1,11 @@
 const ListViewLinksModel = require("../../links-view-model");
 const link = require("../../link");
 const navigationLinks = [
-    new link("Basics", "ns-ui-category/icon-fonts/basics/basics-page"),
-    new link("Code Behind", "ns-ui-category/icon-fonts/code-behind/code-behind-page")
+    new link("Usage", "ns-ui-category/icon-fonts/usage/usage-page"),
+    new link("Tips & Tricks", "ns-ui-category/icon-fonts/tips-and-tricks/tips-and-tricks-page")
 ];
 const navigationLinksTsc = [
-    new link("Code Behind", "ns-ui-category/icon-fonts/code-behind/code-behind-ts-page")
+    new link("Tips & Tricks", "ns-ui-category/icon-fonts/tips-and-tricks/tips-and-tricks-ts-page")
 ];
 function onNavigatingTo(args) {
     const page = args.object;

app/ns-ui-category/icon-fonts/icon-fonts-page.js

@@ -5,3 +5,4 @@ position: 265
 slug: icon-fonts
 previous_url: /icon-fonts
 ---
+example-order: usage, tips-and-tricks

app/ns-ui-category/icon-fonts/metadata.md

@@ -0,0 +1,12 @@
+
+The example demonstrates, how to use setup the  `font-family` property via CSS and how to define the needed icons via XML.
+
+<snippet id='icon-font-xml-def'/>
+<snippet id='icon-font-css-class-def'/>
+
+WIth NativeScript 6 and above, we can use icon fonts with `Image` elements. For that purpose the `font://` prefix is needed to set the icon font code.
+
+<snippet id='icon-font-xml-images'/>
+<snippet id='icon-font-css-class-def'/>
+
+>> **Note:** Images have specific stretch options (`none`, `aspectFit`, `aspectFill`). At the same time the icon fonts are having `font-size` which can contorl the size of our font. If you want to set the size of your icon through the `font-size` property then set `stretch` property to `none`. Any other values of the stretch property (including the default one) will cause the icon to be resized by measuring the image (or if there is no sizes set, the parent layout in whcih the image is nested).

app/ns-ui-category/icon-fonts/code-behind/article.md renamed to app/ns-ui-category/icon-fonts/tips-and-tricks/article.md

@@ -25,6 +25,17 @@
         <!-- << icon-font-xml-def -->
 
         <!-- Using font icons in Images requires the font:// prefix -->
-        <Image src="font://&#xf019;" class="far"></Image>
+        <Image src="font://&#xf015;" stretch="none" class="fas"></Image>
+
+        <!-- >> icon-font-xml-images -->
+        <!-- 
+            In case, when the stretch property is set to aspectFit or aspectFill
+            the font-sizde will be disreagarderd and the image will take the vailable space
+            assigned through width/height or through its parent size
+
+            Setting the stretch property to none will allow using the font-size property
+        -->
+        <Image src="font://&#xf51e;" stretch="none" class="fas"></Image>
+        <!-- << icon-font-xml-images -->
     </StackLayout>
 </Page>

app/ns-ui-category/icon-fonts/code-behind/code-behind-page.css renamed to app/ns-ui-category/icon-fonts/tips-and-tricks/tips-and-tricks-page.css

@@ -1,5 +1,6 @@
 const ListViewLinksModel = require("../../links-view-model");
 const link = require("../../link");
+
 const navigationLinks = [
     new link("Usage", "ns-ui-widgets-category/tabs/usage/usage-page"),
     new link("Theming", "ns-ui-widgets-category/tabs/theming/theming-page"),