静态资源引用

在 Taro 中可以像使用 Webpack 那样自由地引用静态资源,而且不需要安装任何 Loaders。

引用样式文件

可以直接通过 ES6 的 import 语法来引用样式文件

例如引用 CSS 文件

  1. import './css/path/name.css'

引用 SCSS 文件

  1. import './css/path/name.scss'

引用 JS 文件

可以直接通过 ES6 的 import 语法来引用 JS 文件

  1. import { functionName } from './css/path/name.js'
  2. import defaultExportName from './css/path/name.js'

引用图片、音频、字体等文件

可以直接通过 ES6 的 import 语法来引用此类文件,拿到文件引用后直接在 JSX 中进行使用

  1. // 引用文件
  2. import namedPng from '../../images/path/named.png'
  3. // 使用
  4. <View>
  5. <Image src={namedPng} />
  6. </View>

引用 JSON 文件

可以直接通过 ES6 的 import 语法来引用此类文件,拿到 JSON 文件输出的 JSON 数据

  1. // 引用 json 文件
  2. /**
  3. * named.json
  4. * {
  5. * x: 1
  6. * }
  7. **/
  8. import namedJson from '../../json/path/named.json'
  9. console.log(namedJson.x)

小程序样式中引用本地资源

在小程序的样式中,默认不能直接引用本地资源,只能通过网络地址、Base64 的方式来进行资源引用,为了方便开发,Taro 提供了直接在样式文件中引用本地资源的方式,其原理是通过 PostCSSpostcss-url 插件将样式中本地资源引用转换成 Base64 格式,从而能正常加载。

Taro 默认会对 10kb 大小以下的资源进行转换,如果需要修改配置,可以在 config/index.js 中进行修改,配置位于 weapp.module.postcss

具体配置如下

  1. // 小程序端样式引用本地资源内联
  2. url: {
  3. enable: true,
  4. config: {
  5. limit: 10240 // 设定转换尺寸上限
  6. }
  7. }