Include a font icon in a single widget

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분

    • If you only want one widget to have access to a font icon, include the font icon in a single widget.

    시작하기 전에

    Role required: admin or sp_admin

    이 태스크 정보

    Adding an icon to a specific widget keeps the icon scoped and prevents it from interfering with other CSS on the page.

    프로시저

    1. In the platform UI, navigate to Service Portal > Widgets, then click the widget you want to add an icon to.
    2. Attach the individual icon file to the widget record.
    3. In the HTML template, include something like the following: 
      <div>
<i class='font-family'>icon_name</i> you did it!
</div>

      Make sure that the class is exactly the same as the font family called out in the CSS. For example, <i class='material-icons'> should be the same as the .material-icons included in the CSS. The icon_name should match the name of the file you attached.

    4. In the CSS field for the widget, add the CSS for the font-icon definition.

      Most font-icon sets include a CSS file similar to the material icons one used below. Use the sys_id of the attachment as the src in the CSS. For example:

      /* fallback */
@font-face {
  font-family: 'Material Icons';
  font-style: normal;
  font-weight: 400;
  src: url('/828b8ca8b7033010897725cbde11a9f7.iix') format('woff2');
}

.material-icons {
  font-family: 'Material Icons';
  font-weight: normal;
  font-style: normal;
  font-size: 24px;  /* Preferred icon size */
  display: inline-block;
  line-height: 1;
  text-transform: none;
  letter-spacing: normal;
  word-wrap: normal;
  white-space: nowrap;
  direction: ltr;

  /* Support for all WebKit browsers. */
  -webkit-font-smoothing: antialiased;
  /* Support for Safari and Chrome. */
  text-rendering: optimizeLegibility;

  /* Support for Firefox. */
  -moz-osx-font-smoothing: grayscale;

  /* Support for IE. */
  font-feature-settings: 'liga';
}

    결과

    An icon that you can select in the widget or widget instance. For example:

    Example icon that matches the HTML in the widget example, with a check circle that says "you did it!"

    다음에 수행할 작업

    To use custom font-icons across widgets, add the icon to a page or make it a widget dependency.