【教程】微信小程序导入外部字体详细流程

这篇具有很好参考价值的文章主要介绍了【教程】微信小程序导入外部字体详细流程。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

前言

在微信小程序中,我们在wxss文件中通过font-family这一CSS属性来设置文本的字体,并且微信小程序有自身支持的内置字体,可以通过代码提示查看微信小程序支持字体:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

这些字体具体是什么样式可以参考:

微信小程序--字体展示_别动我的指针的博客-CSDN博客字体一font-family:‘Courier New’, Courier, monospace;字体二font-family:‘Franklin Gothic Medium’, ‘Arial Narrow’, Arial, sans-serif;字体三font-family:‘Gill Sans’, ‘Gill Sans MT’, Calibri, ‘Trebuchet MS’, ...https://blog.csdn.net/include_IT_dog/article/details/98382276

在实际开发中,我们的UI设计师可能会在绘制原型图的时候用到多种字体,这些字体不属于微信小程序的内置字体,接下来将会详细讲解怎样在微信小程序中使用这些字体;

1.字体导入流程

微信小程序为开发者提供了导入外部字体专用的API:wx.loadFontFace

其官方文档如下:

wx.loadFontFace(Object object) | 微信开放文档

具体的使用规范可以自行参考上述文档,接下来着重说明几个需要注意的问题:

  1. 通过source参数指定字体文件资源,可以是本地资源,也可以是网络资源,本示例中采用网络资源;如果是网络资源,字体链接必须是https的,不能是http,否则无法正常导入字体资源;
  2. 微信小程序对于所支持的字体格式有限制,但文档中没有明确说明,经实测,ttf|ttc|otf等常见的字体格式都是支持的
  3. 字体链接必须是同源下的,或开启了cors支持;所谓cors,即跨域资源共享,也就是说如果小程序和存放字体链接的服务器不是同源的,需要开启cors支持,使得小程序能够正常访问服务器,获取到字体资源;在本示例中,字体资源通过nginx进行部署,在其中添加cors支持即可(后面会详细讲到)

明确注意事项之后我们来看一下具体的导入方式(由于需要导入的字体文件较多,在app.js中进行批量导入):

以在app.js文件中导入DIN_Alternate_Bold.ttf为例:

App({
  data: {

  },
  getFonts(name) //导入外部字体
    {
      let url = "yourURL" //自己服务器的域名(或IP)
      let source = 'url(' + url + name + ')'
      console.log(source)
      wx.loadFontFace({
        family: name.substring(0, name.length - 4), //名称去掉后缀
        source: source,
        global: true,
        success(res) {
          console.log("load " + name.substring(0, name.length - 4) + " success")
          //   console.log(res)
        },
        fail(res) {
          console.log("load " + name.substring(0, name.length - 4) + " failed")
          console.log(res) //出错则打印信息
        }
      })
    },

  onLaunch() {
    console.log('app.js载入')
    this.getFonts('DIN_Alternate_Bold.ttf')
  },

  globalData: {
  }
})

我们通过getFonts方法调用了官方提供的API来导入外部字体文件,然后在onLaunch中调用方法即可在app.js载入的时候加载外部字体资源;

wx.loadFontFace中的参数进行简单的说明:

  1. family:自定义的字体名称(这里的名称完全自定义,但需与wxss中使用的名称相一致)
  2. source:字体资源的地址;格式:url(https://yourURL/DIN_Alternate_Bold.ttf)
  3. global:字体是否全局生效,因为我们在app.js中导入,需要设置全局生效,否则各页面的wxss文件中无法使用这里导入的字体样式
  4. success/fail:字体资源导入成功/失败的回调函数,可以打印一些提示信息

字体资源导入成功后,我们就可以在wxss文件中使用了,示例如下:
app.wxss中:

.DIN_Alternate_Bold{
    font-family: 'DIN_Alternate_Bold';
}

这里的DIN_Alternate_Bold是在上述js代码中自定义的字体名称(通过设置family)

这样的话哪一部分文本需要设置为DIN_Alternate_Bold的字体样式,只需class = "DIN_Alternate_Bold"即可,比较方便

2.字体资源部署

在上文的注意事项中已说明,我们需要将字体资源部署到nginx服务器上,并开启cros支持,而且必须能够通过https访问,接下来我们逐步解决这些问题;

2.1服务器准备

本示例中使用的是华为云ECS服务器(操作系统是ubuntu),并配置好了安全组规则,开放了80端口(nginx的默认端口)

需要注意的是,如果微信小程序需要上线,则使用的服务器必须有公网ip;如果只是本地学习测试使用,则可以使用虚拟机;

2.2nginx安装

2.2.1 nginx下载

访问官网:nginx: download

找到想要下载的版本:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

建议版本呢不要太低,本示例中使用的是1.20.2

下载完成后传输到服务器上,通过tar zxvf nginx-1.20.2.tar.gz -C /opt/指令解压即可

nginx-1.20.2.tar.gz为压缩包的名称;/opt/为解压的路径,可以自定义

2.2.2 nginx安装

首先进入nginx的解压目录:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

然后配置ssl:

执行指令:./configure --prefix=/usr/local/nginx --with-http_ssl_module

./configure是对nginx进行配置;--prefix是nginx的安装路径;--with-http_ssl_module表面开启ssl支持;

接下来编译安装:

执行指令:make && make install

然后等待编译安装完成即可;

安装完成后进入安装路径/usr/local/nginx,查看nginx的版本即安装模块:sbin/nginx -V

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

2.2.3 nginx启动/关闭

nginx启停的指令均在sbin文件夹内:

  • nginx启动:sbin/nginx

启动完成后通过ps -ef | grep nginx查看是否启动成功:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

如上所示即说明启动成功;

也可以通过netstat -anp | grep 80来查看:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

  • nginx关闭:sbin/nginx -s stop

注意事项:

  1. nginx如果无法正常启停,如启动时报错端口已占用,则可以通过netstat -anp | grep 80来查看80端口是否已占用,如果是,则结束进程即可(kill -9 PID);
  2. 如果结束进程后nginx:master已结束,但出现了nginx:worker,并且杀死一个进程后,会自动再启动一个worker进程,具体表现为进程号顺延;这表明出现了僵尸进程,仅仅通过kill -9无法结束进程,需要使用killall -9 nginx,杀死与nginx相关的所有进程;

2.2.4 nginx使用

安装部署完成后,在浏览器中输入http://你的服务器ip/即可访问nginx:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

如果无法访问,首先考虑是否配置了安全组规则,开放80端口(云服务器)

然后考虑防火墙设置,如果是因为防火墙开启导致无法在浏览器中访问,则可以考虑先关闭防火墙:

  • 开启防火墙:systemctl start firewalld.service
  • 查看防火墙状态:systemctl status firewalld.service
  • 关闭防火墙:systemctl stop firewalld.service

如果都解决不了问题,可以考虑重新部署安装nginx,因为可能是服务器上之前通过yumapt安装过nginx导致的,在重新安装部署之前,可以通过find / -name nginx查找服务器上所有与nginx相关的文件,然后逐一删除后再重新部署(注意,删除时一定要弄清这个文件的作用是什么,以免误删)

2.2.5 nginx配置文件

路径:/usr/local/nginx/conf/nginx.conf,默认配置的是http server;

设置默认打开的页面:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

设置状态码为500,502,503,504时出现的页面

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

其他配置下文会详细介绍;

2.3 配置ssl证书

首先我们需要申请ssl证书,并和域名进行绑定

证书申请可以参考:2022阿里云免费SSL证书申请全过程(图文详解)-阿里云开发者社区

域名绑定自行查找文档进行设置即可;

申请了ssl证书之后我们可以下载.key.pem两个文件,用于nginx的配置:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

然后打开/usr/local/nginx/conf/nginx.conf文件

首先先不修改默认配置文件,定位到http server:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

在该server外部新增https server,内容如下:

server{
		listen       443 ssl;  #端口号
		server_name  yourURL;  #服务器 (域名或ip 示例:localhost)
		ssl_certificate   /opt/certs/gongzai.xyz.pem; # .pem文件
		ssl_certificate_key  /opt/certs/gongzai.xyz.key; # .key文件
		ssl_session_cache    shared:SSL:1m;
		ssl_session_timeout  5m;

		ssl_protocols TLSv1.2;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;


	     location / {
            root   html;
            index  index.html index.htm;
        }

        error_page   500 502 503 504  /50x.html;
        
        location = /50x.html {
            root   html;
        }

        # 配置字体资源的访问路径
        location ~ .*\.(ttf|otf|ttc|TTF)$ { 
            root /usr/local/nginx/html/ttfs;
            expires 10d;
        }

    }

以上内容,除了注释说明的地方需要根据实际情况调整之外,其余参数固定即可;

对于以下代码进行说明

# 配置字体资源的访问路径
location ~ .*\.(ttf|otf|ttc|TTF)$ { 
    root /usr/local/nginx/html/ttfs;
    expires 10d;
}

ttf|otf|ttc|TTF为文件资源后缀; /usr/local/nginx/html/ttfs为字体资源的存储路径;

该配置表明,想要在访问nginx服务器上的字体资源,则到对应路径下去寻找相应的资源;

配置好https server之后,回到http server,删除其中内容,只保留:

server {
        listen       80; # 默认端口号
        server_name  yourURL; #服务器 (域名或ip 示例:localhost)
        rewrite ^(.*)$ https://$host$1 permanent; #将http请求转发为https请求
}

至此ssl证书配置完毕,重启nginx服务器即可;

之后想要访问字体资源,则在浏览器中输入https://yourURL/字体资源名称即可下载,在微信小程序中访问方式相同

2.4 开启cros支持

打开nginx的配置文件nginx.conf

在location中添加add_header Access-Control-Allow-Origin *;即可,如下:

location ~ .*\.(ttf|otf|ttc|TTF)$ {
    add_header Access-Control-Allow-Origin *;
    root /usr/local/nginx/html/ttfs;
    expires 10d;
}

该行代码的含义为在HTTP响应中添加一个名为"Access-Control-Allow-Origin"的头部字段,并将其值设置为"*",这个头部字段的作用是指定允许访问资源的源(origin),即哪些域名可以与服务器进行跨域请求;

当浏览器向服务器发送跨域请求时,服务器会返回这个头部字段的值作为响应头的一部分。通过将该字段的值设置为"*",表示允许来自任何域名的请求都能够得到响应。换句话说,服务器允许来自任何域名的前端应用程序通过AJAX、Fetch API等方法来获取资源

因此通过这样的设置,我们的小程序就可以正常获取字体资源了(否则真机调试会无法加载字体资源)

后记

如果在微信开发者工具中报错:

微信小程序字体资源,全栈,微信小程序,微信小程序,小程序,nginx,ssl,https

可以不予理会,官方文档中也有说明,该报错不会对字体文件的正常导入造成影响;

此外,如果字体文件比较大(10M以上),或者需要导入的字体资源比较多,可以考虑设置一个资源加载界面,等到所有资源加载完毕后再进入小程序,以免造成卡顿等问题;

本文介绍的nginx部署字体资源并通过https进行请求属于最简单的一种方式,作者能力有限,如果优化需求请自行查找资料解决

如果文章中有错误的地方欢迎指正! 如果遇到其他问题,欢迎在评论区讨论交流!文章来源地址https://www.toymoban.com/news/detail-765412.html

到了这里,关于【教程】微信小程序导入外部字体详细流程的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 微信小程序注册流程及APPID获取(完整版图文教程)

    本文将图文介绍微信小程序注册、完善小程序账号信息、添加项目成员和体验成员和获取小程序ID(AppID)及小程序密钥(AppSecret)的详细流程,旨在提供简明的入门指导和实践建议。 小程序开发 与 网页开发不一样,在开始微信小程序开发之前, 需要访问 微信公众平台注册

    2024年03月10日
    浏览(84)
  • 微信小程序第五节——登录那些事儿(超详细的前后端完整流程)

    📌 微信小程序第一节 ——自定义顶部、底部导航栏以及获取胶囊体位置信息。 📌 微信小程序第二节 —— 自定义组件 📌 微信小程序第三节 —— 页面跳转的那些事儿 📌 微信小程序第四节—— 网络请求那些事儿 😜 作           者 :是江迪呀 ✒️ 本文 : 微

    2024年02月09日
    浏览(43)
  • 微信小程序API(详细 教程)

    小程序中的 API 是由宿主环境提供的,通过这些丰富的小程序 API,开发者可以方便的调用微信提供的能力,例如:获取用户信息、本地存储、支付功能等。 小程序提供了很多实用的方法供开发者使用 小程序全局对象是: wx 所有的 API 都保存在 wx 对象中 显示消息提示框: wx.sh

    2023年04月15日
    浏览(46)
  • 微信小程序详细教程(建议收藏)

    1. 小程序的安装与创建 第一步 打开小程序官网 第二步 找到开发管理,找到开发设置,下面有一个 AppID ,复制即可,后面开发小程序需要用 新建项目 ,需要先下载微信开发工具下载网址,安装完成之后进入如下的界面。复制刚才的AppID,选择 不使用云开发 , javascript基础模

    2024年02月03日
    浏览(46)
  • 微信小程序对接微信支付详细教程

    小程序 微信支付官方文档 https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_11index=2 https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_8_0.shtml 前提 在进行对接微信支付之前,我们首先需要将以下几点准备好: 申请APPID 申请商户号 小程序开通微信支付,绑定已经申请好的商户号。

    2024年02月09日
    浏览(49)
  • 微信小程序云开发入门详细教程

    本篇是《从零开始Python+微信小程序开发》专栏第九篇,主要介绍最新最全的云开发入门教程,微信小程序云开发,云函数,云数据库学习,微信小程序云开发扩展功能学习,希望大家能够一起学习,互相交流。 小程序云开发是微信团队联合腾讯云推出的专业的小程序开发服

    2024年02月11日
    浏览(44)
  • 【小程序】微信小程序云开发笔记详细教程(建议收藏)

    1.1 微信云开发是什么? 微信云开发是微信团队联合腾讯云推出的专业的小程序开发服务。 开发者可以使用云开发快速开发小程序、小游戏、公众号网页等,并且原生打通微信开放能力。 开发者无需搭建服务器,可免鉴权直接使用平台提供的 API 进行业务开发。 1.2 怎么快速

    2024年02月09日
    浏览(61)
  • 微信小程序首页-----布局(详细教程赶快收藏吧)

                                                      🎬 艳艳耶✌️:个人主页                                                   🔥 个人专栏 :《Spring与Mybatis集成整合》《Vue.js使用》                                                   ⛺️ 越努力 ,越幸运

    2024年02月04日
    浏览(51)
  • 微信小程序个人账号申请和配置详细教程

    在微信公众平台官网首页(mp.weixin.qq.com),点击右上角的“ 立即注册 ”按钮。 选择“小程序”,点击“查看类型区别”可查看不同类型账号的区别和优势。 请填写 未注册过公众平台、开放平台、企业号、未绑定个人号 的邮箱。 登录邮箱,查收激活邮件,点击激活链接。

    2024年02月04日
    浏览(58)
  • 微信小程序向公众号推送消息超详细教程

    官方教程 官方教程 开通一下服务号公众号 超级管理员登录服务号公众号后台 登录地址 开通模板消息 申请一个模板消息,获取模板ID 注意此处的参数,后续接口需要使用 绑定公众号与小程序 官方教程 1.登录微信公众号后台 2.点击小程序管理 3.关联小程序 获取微信公众号

    2024年02月11日
    浏览(63)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包