页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

版本 1 下一个 »

1.需求背景

客户在做大屏展示,对字体是有自己的规范和要求,而这些字体往往在应用服务器上是缺失的。

2.功能说明

允许通过扩展包的方式把字体上传到应用服务器上,方便更新和维护。

生效资源:交互式仪表盘

例如:集群环境的同步和更新,生产环境的迁移等。

1)字体文件需要使用者自己提供。

2)字体的使用版权需要使用者自行解决。


3.使用说明

3.1. 扩展包部署

扩展包:Smartbi_Special_ExtendedFonts

部署说明:扩展包部署

1)更新扩展包之前,请做好知识库以及扩展包的备份。

2)服务器必须重启,否则,交互式仪表盘的相关设置项不会看到对应的字体。

3.2.配置说明

需要用解压工具,把对应的字体文件放到 Smartbi_Special_ExtendedFonts.ext 对应的目录下,同时 把修改的配置文件替换原来的文件。


1)字体目录:把对应的字体文件放到以下目录中

目录:Smartbi_Special_ExtendedFonts.ext\vision\js\ext\fonts

字体文件需要兼容应用服务器所在的操作系统。

扩展包自带的字体文件只作为演示使用,如果使用者要用于商用,请自行进行授权的购买。


2)css样式文件:修改ExtendedFonts.css文件内容,增加对应的字体文件的定义

目录:Smartbi_Special_ExtendedFonts.ext\vision\css\ExtendedFonts.css

示例:

@font-face {
    font-family: 'impact-2';
    font-style: normal;
    font-weight: 400;
    src: url(../js/ext/fonts/impact-2.ttf) format('truetype');
}

@font-face {
    font-family: 'NotoSansCJK-Regular-1';
    font-style: normal;
    font-weight: 400;
    src: url(../js/ext/fonts/NotoSansCJK-Regular-1.otf) format('opentype');
}

@font-face {
    font-family: 'PingFang-Jian-ChangGuiTi-2';
    font-style: normal;
    font-weight: 400;
    src: url(../js/ext/fonts/PingFang-Jian-ChangGuiTi-2.ttf) format('truetype');
}

不同格式的字体,配置css中的format不同;

例如:

ttf后缀的字体:format('truetype')

otf后缀的字体:format('opentype');

woff后缀的字体:format('woff');

woff2后缀的字体:format('woff2');

eot后缀的字体:format('embedded-opentype');


3)配置文件:修改ConfigurationPatch.js文件内容,增加对应的字体文件的配置

目录:Smartbi_Special_ExtendedFonts.ext\vision\js\ext\ConfigurationPatch.js

示例:

var ConfigurationPatch = {
    extensionPoints: {
        css: ["vision/css/ExtendedFonts.css"],
		//自定义字体名称:值格式为二维数组
		//第一维数组的每一个元素代表一种字体配置
		//第二维数组的第1个元素为字体真实值,第2个元素为字体显示值(不要使用中文)
        xfontFamilies: [
            ["impact-2", "impact"], 
			["NotoSansCJK-Regular-1", "NotoSansCJK"],
            ["PingFang-Jian-ChangGuiTi-2", "PingFang-Jian"]
        ],
    }
};

字体真实值为字体的英文字体名字,若输入的字体真实值无效,该字体便以默认值为准。


3.3.前端效果



  • 无标签