Version: 7.2.1

Font

API Reference: UI.Font

Font is used to assign text properties to UI objects. The font property is a shorthand for font-style, font-size and font-family .

note

The components in the example are added from the code for better showcase purposes. To learn more about the subject you can refer to:

Adding Component From Code

As a best practice, Smartface recommends using the WYSIWYG editor in order to add components and styles to your page or library. To learn how to use UI Editor better, please refer to this documentation

UI Editor Basics

import PageSampleDesign from 'generated/pages/pageSample';
import Application from '@smartface/native/application';
import Label from '@smartface/native/ui/label';
import { Route, Router } from '@smartface/router';
import { styleableComponentMixin } from '@smartface/styling-context'; 

class StyleableLabel extends styleableComponentMixin(Label) {}

//You should create new Page from UI-Editor and extend with it.
export default class Sample extends PageSampleDesign {
  myLabel: StyleableLabel;
  myLabel2: StyleableLabel;
  myLabel3: StyleableLabel;

  constructor(private router?: Router, private route?: Route) {
    super({});
  }

  /**
   * @event onShow
   * This event is called when a page appears on the screen (everytime).
   * @param {function} superOnShow super onShow function
   * @param {Object} parameters passed from Router.go function
   */
  onShow() {
    super.OnShow();
    Application.statusBar.visible = false;
    this.headerBar.visible = false;
  }

  /**
   * @event onLoad
   * This event is called once when page is created.
   * @param {function} superOnLoad super onLoad function
   */
  onLoad() {
    super.onLoad();

    this.myLabel = new StyleableLabel({
      text: 'SFProDisplay Medium '
    });

    this.addChild(this.myLabel, 'myLabel', '.sf-label', {
      width: 250,
      height: 60,
      marginBottom: 10,
      textAlignment: 'MIDCENTER',
      textColor: '#000000',
      font: {
        size: 16,
        family: 'SFProDisplay',
        style: 'Medium'
      }
    });

    this.myLabel2 = new StyleableLabel({
      text: 'SFProText Semibold'
    });

    this.addChild(this.myLabel2, 'myLabel2', '.sf-label', {
      width: 250,
      height: 60,
      marginBottom: 10,
      textAlignment: 'MIDCENTER',
      textColor: '#000000',
      font: {
        size: 16,
        family: 'SFProText',
        style: 'Semibold'
      }
    });

    this.myLabel3 = new StyleableLabel({
      text: 'SFProText Regular'
    });

    this.addChild(this.myLabel3, 'myLabel3', '.sf-label', {
      width: 250,
      height: 60,
      textAlignment: 'MIDCENTER',
      textColor: '#000000',
      font: {
        size: 16,
        family: 'SFProText',
        style: 'Regular'
      }
    });

    this.dispatch({
      type: 'updateUserStyle',
      userStyle: {
        flexProps: {
          flexDirection: 'COLUMN'
        }
      }
    });
  }
}

The "Default" Font

Android & iOS systems are using different fonts by default.

iOS uses San Francisco font by default
Android uses Roboto as the default font
There is an option to state "use the default font". Which means, use San Francisco on iOS and use Roboto on Android.

Wrapping Contents

A component that has a text property such as Label can have dynamic width & height regarding the text & font properties.

How to Install Custom Fonts?

Installing custom fonts is quick and easy.

Font Format

Only TrueType Fonts (ttf) are supported

Steps to add font

Get the full font name from the system

Mac

Windows

Create a folder for the font name. Remove all space characters
Rename your font file based on the FontName-FontWeight.ttf pattern; Remove all of the space characters
Upload your font files with drag & drop into font folder that you have just created.

iOS Font Name Issues

Some font names can cause problems with iOS. As you can see in the picture above, some font names do not match the pattern. It is commonly seen with the fonts Foundry name within.
If this is happening, try with the pattern as seen in the picture above.

iOS Installed Font Names

On iOS, font name that system recognizes must have the folder name and font name. Otherwise related text won't have desired font family. You can get all font names by running the following code.

The code below will give the font names installed in the App & the System (iOS only).

import Font from "@smartface/native/ui/font";

let fontNames = Font.ios.allFontNames();
for (const index in fontNames) {
  console.log(fontNames[index]);
}

Using Fonts Remotely

It is possible to download a font file from url and using this font for all _View_s. To create this font from a file, path is must be known with getAbsolutePath().

note

The components in the example are added from the code for better showcase purposes. To learn more about the subject you can refer to:

Adding Component From Code

UI Editor Basics

import PageSampleDesign from 'generated/pages/pageSample';
import Application from '@smartface/native/application';
import Font from '@smartface/native/ui/font';
import Label from '@smartface/native/ui/label';
import Button from '@smartface/native/ui/button';
import TextView from '@smartface/native/ui/textview';
import TextBox from '@smartface/native/ui/textbox';
import Http from '@smartface/native/net/http';
import { Route, Router } from '@smartface/router';
import { styleableComponentMixin } from '@smartface/styling-context'; 

class StyleableLabel extends styleableComponentMixin(Label) {}
class StyleableButton extends styleableComponentMixin(Button) {}
class StyleableTextView extends styleableComponentMixin(TextView) {}
class StyleableTextBox extends styleableComponentMixin(TextBox) {}


//You should create new Page from UI-Editor and extend with it.
export default class Sample extends PageSampleDesign {
  myLabel: StyleableLabel;
  myButton: StyleableButton;
  myTextview: StyleableTextView;
  myTextBox: StyleableTextBox;

  constructor(private router?: Router, private route?: Route) {
    super({});
  }

  /**
   * @event onShow
   * This event is called when a page appears on the screen (everytime).
   * @param {function} superOnShow super onShow function
   * @param {Object} parameters passed from Router.go function
   */
  onShow() {
    super.onShow();
    Application.statusBar.visible = false;
    this.headerBar.visible = false;

    var sessionManager = new Http();
    sessionManager.requestFile({
      url: 'https://smartfacecdn.blob.core.windows.net/common/Windsong.ttf',
      fileName: 'Windsong.ttf',
      onLoad: (e): void => {
        var file = e.file;
        if (file.exists) {
          console.log('file exists.');
        }
        console.log('Moving...');
        console.log('e.file.fullPath: ' + e.file.getAbsolutePath());
        this.myLabel.font = Font.createFromFile(e.file.getAbsolutePath(), 16);
        this.myButton.font = Font.createFromFile(e.file.getAbsolutePath(), 16);
        this.myTextview.font = Font.createFromFile(e.file.getAbsolutePath(), 16);
        this.myTextBox.font = Font.createFromFile(e.file.getAbsolutePath(), 16);
      },
      onError: function (e: any) {
        console.log('Something Wrong', e);
      }
    });
  }

  onLoad() {
    super.onLoad();

    this.myLabel = new StyleableLabel({
      text: 'Label'
    });

    this.myButton = new StyleableButton({
      text: 'Button'
    });
    this.myTextview = new StyleableTextView({
      text: 'TextView'
    });
    this.myTextBox = new StyleableTextBox({
      text: 'TextBox'
    });

    this.addChild(this.myTextBox, 'myTextBox', '.sf-textBox', {
      height: 60,
      width: 100,
      borderWidth: 0.5,
      marginBottom: 10,
      textAlignment: 'MIDCENTER'
    });
    this.addChild(this.myLabel, 'myLabel', '.sf-label', {
      width: 150,
      height: 60,
      marginBottom: 10,
      textAlignment: 'MIDCENTER'
    });
    this.addChild(this.myButton, 'myButton', 'sf-button', {
      width: 150,
      height: 60,
      marginBottom: 10
    });
    this.addChild(this.myTextview, 'myTextView', '.sf-textView', {
      height: 60,
      width: 150,
      textAlignment: 'MIDCENTER',
      marginBottom: 10
    });

    this.dispatch({
      type: 'updateUserStyle',
      userStyle: {
        flexProps: {
          flexDirection: 'COLUMN'
        }
      }
    });
  }
}

Using System Fonts

In order to use the system fonts (The ones that are shipped by the system, not bundled within the app) it is possible to use with code. UI editor does not support unknown font names, which are not added to the project.
While creating the font using create(fontName,size) that might work on the system that you are testing, but might not work with another. In that case, the system will assign a different font.

Create Font Catalog

tip

In best case, you can create a font catalog using the following code.

Catalog
Page

themes/yourTheme/styles/textStyleCatalog.json

{
  ".homePage": {
    "font": {
      "family": "SFProDisplay",
      "bold": true,
      "italic": false,
      "style": "Medium"
    },
    ".numbers": {
      "font": {
        "family": "SFProDisplay",
        "size": 20,
        "style": "Bold",
        "bold": true,
        "italic": false
      },
      "textColor": "${textDark}",
      ".small": {
        "font": {
          "size": 15
        }
      }
    },
    ".titles": {
      "font": {
        "family": "SFProDisplay",
        "size": 34,
        "style": "Bold",
        "bold": true,
        "italic": false
      },
      "textColor": "${textDark}",
      ".small": {
        "font": {
          "size": 24
        }
      }
    }
  }
}

import Page1Design from 'generated/pages/page1';
import { Route, Router } from '@smartface/router';
import { withDismissAndBackButton } from '@smartface/mixins';

export default class Page1 extends withDismissAndBackButton(Page1Design) {
  constructor(private router?: Router, private route?: Route) {
    super({});
  }

  onShow() {
    super.onShow();
    this.lbl.text = 'Smartface';
    this.lbl.dispatch({
      type: 'pushClassNames',
      classNames: '.home.title'
    });
  }
  onLoad() {
    super.onLoad();
  }
}

What are the Icon Fonts?

Icon fonts are just fonts. However, instead of containing letters or numbers, they contain symbols and glyphs. Smartface UI Editor & Framework make it possible to use icon fonts within your project.

tip

Custom fonts can be added under config/Fonts folder.

Font Awesome

If you don't have Font Awesome installed on your workspace, please perform following steps:

Download FontAwesome package from here
Upload related .ttf file under config/Fonts/FontAwesome and rename it as FontAwesome.ttf
After properties panel recognizes your new font, it will show up as a new option on font family selection
Create a component that has an input
Choose FontAwesome as font family from properties panel
Decide which character to show from here
Click related area to copy the icon and then paste it into your component

Ico Moon

Ico Moon provides icon management tool and icon libraries. It has a free version as well. To try it, please perform following steps:

Upload IcoMoon-Free.ttf to config/Fonts/IcoMoon-Free
For free icons visit here
Select an icon then click Generate Font
Click Get Code and then copy character
Then you can use it anywhere

Typing Special Characters

It is possible to paste special characters into UI editor or Code editor. They will just work fine. Those special characters are created via Unicode characters. In JavaScript Unicode characters are written with escaped code, such as: "\u1234"; backslash + lowercase u + 4 digit hexadecimal Unicode number.

Formatting the code with unicode characters

When the code is formatted, the code editor might convert \u1234 format Unicode character into a single "square". There is no loss of the code, it is just converted

Safari Browser & Unicode

Safari browser is known to "not to show" those characters on screen

Steps to type a Unicode character

Get the Unicode number, such as https://fontawesome.com/icons/address-book?style=regular --> f2b9
On the Smartface IDE go to the immediate panel
Make sure that immediate panel is on "Browser mode"

Write a JavaScript code that prints the result of the Unicode letter

"\uf2b9";

That will print a "square" there. Copy that square
Paste that square into the text value of the component (such as a label). Make sure that you have selected the appropriate font to display the character

Font

The "Default" Font​

How to Install Custom Fonts?​

Using Fonts Remotely​

Using System Fonts​

Create Font Catalog​

What are the Icon Fonts?​

Font Awesome​

Ico Moon​

Typing Special Characters​

Steps to type a Unicode character​