JavaScript ArcGIS Font.family用法及代码示例

基本信息

以下是所在类或对象的基本信息。

AMD: require(["esri/symbols/Font"], (Font) => { /* code goes here */ });

ESM: import Font from "@arcgis/core/symbols/Font";

类： esri/symbols/Font

继承: Font > Accessor

自从：用于 JavaScript 4.0 的 ArcGIS API

用法说明

Font.family函数(或属性)的定义如下：

family String

文本的字体系列。可能的值取决于图层类型，以及您使用的是 MapView 还是 SceneView 。详细解释见Labeling guide page，或点击下方Read more。

3D 字体系列SceneViews

3D SceneViews 支持的字体系列取决于用户计算机和 Web 浏览器上安装的字体。如果应用程序使用未安装的字体，Font 类将实现一个回退机制，该机制将使用默认字体系列值，即 sans-serif 。有关如何在 Windows 或 Mac 上安装新字体的说明，请参阅这些引用。

本地未安装的字体也可以通过在 css 文件中定义 @font-face 并从符号层中的 family 属性引用它来从 url 加载。

2D 字体系列MapImageLayer

MapView 中MapImageLayers 支持的字体系列取决于发布图层的ArcGIS Server 上安装的字体。如果应用程序使用未安装的字体，Font 类将实现一个回退机制，该机制将使用默认字体系列值，即 sans-serif 。

2D FeatureLayer、CSVLayer、StreamLayer 和 TextSymbol 的字体系列

支持的字体系列基于 .pbf 格式的托管字体文件。默认情况下，可用的字体大多与 Esri 矢量底图使用的字体相同。这些字体可通过 https://static.arcgis.com/fonts 获得。通过设置esriConfig.fontsUrl 属性，可以将 URL 配置为指向您自己的字体资源。如果应用程序使用未安装的字体，Font 类将实现一个回退机制，该机制将使用默认字体系列值，即 sans-serif 。这使用Arial Unicode MS 字体文件。

Labeling 概述页面中提供了下表中列出的字体的预览。

2D MapView 当前支持的字体列表：

字体	风格	重量	代码片段
Abril Fatface 常规版	normal	normal	字体：{ 系列：'Abril Fatface'，样式：'normal'，重量：'normal'}
阿莱格雷亚粗体	normal	bold	字体：{ 系列：'Alegreya'，样式：'normal'，重量：'bold'}
Alegreya 粗斜体	italic	bold	字体：{ 系列：'Alegreya'，样式：'italic'，重量：'bold'}
Alegreya 斜体	italic	normal	字体：{ 系列：'Alegreya'，样式：'italic'，重量：'normal'}
Alegreya 常规	normal	normal	字体：{ 系列：'Alegreya'，样式：'normal'，重量：'normal'}
Alegreya SC 粗体	normal	bold	字体：{ 系列：'Alegreya SC'，样式：'normal'，重量：'bold'}
Alegreya SC 斜体	italic	normal	字体：{ 系列：'Alegreya SC'，样式：'italic'，重量：'normal'}
Alegreya SC 常规	normal	normal	字体：{ 系列：'Alegreya SC'，样式：'normal'，重量：'normal'}
Alegreya 无斜体	italic	normal	字体：{ 系列：'Alegreya Sans'，样式：'italic'，重量：'normal'}
阿马兰特常规	normal	normal	字体：{ 系列：'Amarante'，样式：'normal'，重量：'normal'}
Amatic SC 粗体	normal	bold	字体：{ 系列：'Amatic SC'，样式：'normal'，重量：'bold'}
宋体粗体	normal	bold	字体：{ 系列：'Arial'，样式：'normal'，重量：'bold'}
Arial 粗斜体	italic	bold	字体：{ 系列：'Arial'，样式：'italic'，重量：'bold'}
宋体斜体	italic	normal	字体：{ 系列：'Arial'，样式：'italic'，重量：'normal'}
宋体常规	normal	normal	字体：{ 系列：'Arial'，样式：'normal'，重量：'normal'}
Arial Unicode MS 粗体	normal	bold	字体：{ 系列：'Arial Unicode MS'，样式：'normal'，重量：'bold' }
Arial Unicode MS 正则	normal	normal	字体：{ 系列：'Arial Unicode MS'，样式：'normal'，重量：'normal' }
原子时代常规	normal	normal	字体：{ 系列：'Atomic Age'，样式：'normal'，重量：'normal'}
Audiowide 常规	normal	normal	字体：{ 系列：'Audiowide'，样式：'normal'，重量：'normal'}
Avenir Next LT Pro Bold	normal	bold	字体：{系列：'Avenir Next LT Pro'，样式：'normal'，重量：'bold'}
Avenir Next LT Pro 粗斜体	italic	bold	字体：{系列：'Avenir Next LT Pro'，样式：'italic'，重量：'bold'}
Avenir Next LT Pro 半斜体	italic	normal	字体：{ 系列：'Avenir Next LT Pro Demi'，样式：'italic'，重量：'normal'}
Avenir Next LT Pro 斜体	italic	normal	字体：{系列：'Avenir Next LT Pro'，样式：'italic'，重量：'normal'}
Avenir Next LT Pro Light	normal	normal	字体：{系列：'Avenir Next LT Pro Light'，样式：'normal'，重量：'normal'}
Avenir Next LT Pro Light 斜体	italic	normal	字体：{系列：'Avenir Next LT Pro Light'，样式：'italic'，重量：'normal'}
Avenir Next LT Pro 中等粗体	normal	bold	字体：{ 系列：'Avenir Next LT Pro Medium'，样式：'normal'，重量：'bold'}
Avenir Next LT Pro 中粗斜体	italic	bold	字体：{ 系列：'Avenir Next LT Pro Medium'，样式：'italic'，重量：'bold'}
Avenir Next LT Pro Regular	normal	normal	字体：{系列：'Avenir Next LT Pro'，样式：'normal'，重量：'normal'}
Avenir Next LT Pro Regular 粗体	normal	bold	字体：{ 系列：'Avenir Next LT Pro Regular'，样式：'normal'，重量：'bold'}
BellTopo 无粗体	normal	bold	字体：{ 系列：'BellTopo Sans'，样式：'normal'，重量：'bold'}
BellTopo 无粗斜体	italic	bold	字体：{ 系列：'BellTopo Sans'，样式：'italic'，重量：'bold'}
BellTopo 无斜体	italic	normal	字体：{ 系列：'BellTopo Sans'，样式：'italic'，重量：'normal'}
BellTopo 无常规	normal	normal	字体：{ 系列：'BellTopo Sans'，样式：'normal'，重量：'normal'}
Belleza 常规	normal	normal	字体：{ 系列：'Belleza'，样式：'normal'，重量：'normal'}
黑色行动一号普通版	normal	normal	字体：{ 家族：'Black Ops One'，风格：'normal'，重量：'normal' }
机舱素描粗体	normal	bold	字体：{ 系列：'Cabin Sketch'，样式：'normal'，重量：'bold'}
机舱素描常规	normal	normal	字体：{ 系列：'Cabin Sketch'，样式：'normal'，重量：'normal'}
即将推出定期	normal	normal	字体：{ 系列：'Coming Soon'，样式：'normal'，重量：'normal'}
FGDC GeoAge 常规	normal	normal	字体：{ 系列：'FGDC GeoAge'，样式：'normal'，重量：'normal'}
自制苹果常规	normal	normal	字体：{ 系列：'Homemade Apple'，样式：'normal'，重量：'normal'}
IM FELL DW Pica PRO 斜体	italic	normal	字体：{系列：'IM FELL DW Pica PRO'，样式：'italic'，重量：'normal'}
IM FELL DW Pica PRO 常规	normal	normal	字体：{系列：'IM FELL DW Pica PRO'，样式：'normal'，重量：'normal'}
Josefin Sans 常规	normal	normal	字体：{ 系列：'Josefin Sans'，样式：'normal'，重量：'normal'}
Josefin Sans 半粗斜体	italic	bold	字体：{ 系列：'Josefin Sans Semibold'，样式：'italic'，重量：'bold'}
Josefin Slab 粗体	normal	bold	字体：{ 系列：'Josefin Slab'，样式：'normal'，重量：'bold'}
Josefin Slab 粗斜体	italic	bold	字体：{ 系列：'Josefin Slab'，样式：'italic'，重量：'bold'}
Josefin 平板斜体	italic	normal	字体：{ 系列：'Josefin Slab'，样式：'italic'，重量：'normal'}
Josefin Slab 浅斜体	italic	normal	字体：{ 系列：'Josefin Slab Light'，样式：'italic'，重量：'normal' }
Josefin Slab 常规	normal	normal	字体：{ 系列：'Josefin Slab'，样式：'normal'，重量：'normal'}
Josefin Slab 半粗斜体	italic	bold	字体：{系列：'Josefin Slab Semibold'，样式：'italic'，重量：'bold'}
Josefin Slab 薄斜体	italic	normal	字体：{ 系列：'Josefin Slab Thin'，样式：'italic'，重量：'normal' }
只是另一只手常规	normal	normal	字体：{ 系列：“只是另一只手”，样式：'normal'，重量：'normal' }
Kranky 常规	normal	normal	字体：{ 系列：'Kranky'，样式：'normal'，重量：'normal'}
救生员大胆	normal	bold	字体：{ 系列：'Life Savers'，样式：'normal'，重量：'bold'}
深受国王喜爱	normal	normal	字体：{ 家族：“国王所爱”，风格：'normal'，重量：'normal' }
梅里韦瑟粗体	normal	bold	字体：{ 系列：'Merriweather'，样式：'normal'，重量：'bold'}
Merriweather 粗斜体	italic	bold	字体：{ 系列：'Merriweather'，样式：'italic'，重量：'bold'}
梅里韦瑟斜体	italic	normal	字体：{ 系列：'Merriweather'，样式：'italic'，重量：'normal'}
Merriweather 常规	normal	normal	字体：{ 系列：'Merriweather'，样式：'normal'，重量：'normal'}
蒙特塞拉特粗体	normal	bold	字体：{ 系列：'Montserrat'，样式：'normal'，重量：'bold'}
蒙特塞拉特斜体	italic	normal	字体：{ 系列：'Montserrat'，样式：'italic'，重量：'normal'}
蒙特塞拉特中等斜体	italic	normal	字体：{ 系列：'Montserrat Medium'，样式：'italic'，重量：'normal'}
蒙特塞拉特常规	normal	normal	字体：{ 系列：'Montserrat'，样式：'normal'，重量：'normal'}
蒙特塞拉特半粗斜体	italic	bold	字体：{ 系列：'Montserrat Semibold'，样式：'italic'，重量：'bold'}
Noto Sans Bold	normal	bold	字体：{ 系列：'Noto Sans'，样式：'normal'，重量：'bold'}
Noto Sans 粗斜体	italic	bold	字体：{ 系列：'Noto Sans'，样式：'italic'，重量：'bold'}
Noto 无斜体	italic	normal	字体：{ 系列：'Noto Sans'，样式：'italic'，重量：'normal'}
Noto Sans 普通版	normal	normal	字体：{ 系列：'Noto Sans'，样式：'normal'，重量：'normal'}
Noto Serif 粗体	normal	bold	字体：{ 系列：'Noto Serif'，样式：'normal'，重量：'bold'}
Noto Serif 粗斜体	italic	bold	字体：{ 系列：'Noto Serif'，样式：'italic'，重量：'bold'}
Noto Serif 斜体	italic	normal	字体：{ 系列：'Noto Serif'，样式：'italic'，重量：'normal'}
Noto Serif 常规	normal	normal	字体：{ 系列：'Noto Serif'，样式：'normal'，重量：'normal'}
旧标准 TT 粗体	normal	bold	字体：{ 系列：'旧标准 TT'，样式：'normal'，重量：'bold' }
旧标准 TT 斜体	italic	normal	字体：{ 系列：'旧标准 TT'，样式：'italic'，重量：'normal' }
旧标准 TT 常规	normal	normal	字体：{ 系列：'旧标准 TT'，样式：'normal'，重量：'normal' }
Orbitron 粗体	normal	bold	字体：{ 系列：'Orbitron'，样式：'normal'，重量：'bold'}
Orbitron 常规	normal	normal	字体：{ 系列：'Orbitron'，样式：'normal'，重量：'normal'}
牛至斜体	italic	normal	字体：{ 系列：'Oregano'，样式：'italic'，重量：'normal'}
牛至常规	normal	normal	字体：{ 系列：'Oregano'，样式：'normal'，重量：'normal'}
奥斯瓦尔德·博尔德	normal	bold	字体：{ 系列：'Oswald'，样式：'normal'，重量：'bold'}
奥斯瓦尔德常规	normal	normal	字体：{ 系列：'Oswald'，样式：'normal'，重量：'normal'}
Pacifico 常规	normal	normal	字体：{ 系列：'Pacifico'，样式：'normal'，重量：'normal'}
Palatino Linotype 常规	normal	normal	字体：{ 系列：'Palatino Linotype'，样式：'normal'，重量：'normal'}
Playfair 展示黑色	normal	normal	字体：{系列：'Playfair Display Black'，样式：'normal'，重量：'normal'}
Playfair 显示粗体	normal	bold	字体：{ 系列：'Playfair Display'，样式：'normal'，重量：'bold'}
Playfair 显示粗斜体	italic	bold	字体：{ 系列：'Playfair Display'，样式：'italic'，重量：'bold'}
Playfair 显示斜体	italic	normal	字体：{ 系列：'Playfair Display'，样式：'italic'，重量：'normal'}
Playfair 显示常规	normal	normal	字体：{ 系列：'Playfair Display'，样式：'normal'，重量：'normal'}
Playfair 显示 SC 粗体	normal	bold	字体：{系列：'Playfair Display SC'，样式：'normal'，重量：'bold'}
Playfair Display SC 常规	normal	normal	字体：{系列：'Playfair Display SC'，样式：'normal'，重量：'normal'}
已修复的常规	normal	normal	字体：{ 系列：'Redressed'，样式：'normal'，重量：'normal'}
有伤风化的常规	normal	normal	字体：{ 系列：'Risque'，样式：'normal'，重量：'normal'}
Roboto 浓缩斜体	italic	normal	字体：{ 系列：'Roboto Condensed'，样式：'italic'，重量：'normal'}
Roboto 浓缩浅斜体	italic	normal	字体：{ 系列：'Roboto Condensed Light'，样式：'italic'，重量：'normal' }
黑麦常规	normal	normal	字体：{ 系列：'Rye'，样式：'normal'，重量：'normal'}
特别精英普通	normal	normal	字体：{ 系列：'Special Elite'，样式：'normal'，重量：'normal'}
切分音粗体	normal	bold	字体：{ 系列：'Syncopate'，样式：'normal'，重量：'bold'}
切分音规则	normal	normal	字体：{ 系列：'Syncopate'，样式：'normal'，重量：'normal'}
橘子常规	normal	normal	字体：{ 系列：'Tangerine'，样式：'normal'，重量：'normal'}
Ubuntu 粗体	normal	bold	字体：{ 系列：'Ubuntu'，样式：'normal'，重量：'bold'}
Ubuntu 粗斜体	italic	bold	字体：{ 系列：'Ubuntu'，样式：'italic'，重量：'bold'}
Ubuntu 精简版	normal	normal	字体：{ 系列：'Ubuntu Condensed'，样式：'normal'，重量：'normal'}
Ubuntu 斜体	italic	normal	字体：{ 系列：'Ubuntu'，样式：'italic'，重量：'normal'}
Ubuntu 灯	normal	normal	字体：{ 系列：'Ubuntu Light'，样式：'normal'，重量：'normal'}
Ubuntu 浅粗体	normal	bold	字体：{ 系列：'Ubuntu Light'，样式：'normal'，重量：'bold'}
Ubuntu 浅粗斜体	italic	bold	字体：{ 系列：'Ubuntu Light'，样式：'italic'，重量：'bold'}
Ubuntu 浅斜体	italic	normal	字体：{ 系列：'Ubuntu Light'，样式：'italic'，重量：'normal'}
Ubuntu 中斜体	italic	normal	字体：{ 系列：'Ubuntu Medium'，样式：'italic'，重量：'normal'}
Ubuntu Mono 粗体	normal	bold	字体：{ 系列：'Ubuntu Mono'，样式：'normal'，重量：'bold'}
Ubuntu Mono 粗斜体	italic	bold	字体：{ 系列：'Ubuntu Mono'，样式：'italic'，重量：'bold'}
Ubuntu 单斜体	italic	normal	字体：{ 系列：'Ubuntu Mono'，样式：'italic'，重量：'normal'}
Ubuntu Mono 常规	normal	normal	字体：{ 系列：'Ubuntu Mono'，样式：'normal'，重量：'normal'}
Ubuntu 常规版	normal	normal	字体：{ 系列：'Ubuntu'，样式：'normal'，重量：'normal'}
UnifrakturCook 粗体	normal	bold	字体：{ 系列：'UnifrakturCook'，样式：'normal'，重量：'bold'}
大影常规	normal	normal	字体：{ 系列：'Vast Shadow'，样式：'normal'，重量：'normal'}
Walter Turncoat 常规	normal	normal	字体：{ 系列：'Walter Turncoat'，样式：'normal'，重量：'normal'}

默认值：sans-serif

例子：

let textSymbol = {
  type: "text",  // autocasts as new TextSymbol()
  text: "Science of Where",
  font: {  // autocasts as new Font()
    family: "Merriweather",
    size: 12,
    style: "italic",
    weight: "bold"
  }
};

相关用法

注：本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 Font.family。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。