定位资源

优质

小牛编辑

130浏览

2023-12-01

定位资源

定位资源能力，可以有效地分离开发路径与部署路径之间的关系，工程师不再关心资源部署到线上之后去了哪里，变成了什么名字，这些都可以通过配置来指定。而工程师只需要使用相对路径来定位自己的开发资源即可。这样的好处是：资源可以发布到任何静态资源服务器的任何路径上而不用担心线上运行时找不到它们，而且代码具有很强的可移植性，甚至可以从一个产品线移植到另一个产品线而不用担心线上部署不一致的问题。

定位资源

在html中定位资源

FIS3 支持对html中的script、link、style、video、audio、embed等标签的src或href属性进行分析，一旦这些标签的资源定位属性可以命中已存在文件，则把命中文件的url路径替换到属性中，同时可保留原来url中的query查询信息。

例如：

<!--源码：
<img title="百度logo" src="images/logo.gif"/>
编译后-->
<img title="百度logo" src="/images/logo_74e5229.gif"/>

<!--源码：
<link rel="stylesheet" type="text/css" href="demo.css">
编译后-->
<link rel="stylesheet" type="text/css" href="/demo_7defa41.css">

<!--源码：
<script type="text/javascript" src="demo.js"></script>
编译后-->
<script type="text/javascript" src="/demo_33c5143.js"></script>

值得注意的是， 资源定位结果可以被fis的配置文件控制，比如添加配置，调整文件发布路径：

资源定位工作原理

fis.match('*.{js,css,png,gif}', {
    useHash: true // 开启 md5 戳
});

// 所有的 js
fis.match('**.js', {
    //发布到/static/js/xxx目录下
    release : '/static/js$0'
});

// 所有的 css
fis.match('**.css', {
    //发布到/static/css/xxx目录下
    release : '/static/css$0'
});

// 所有image目录下的.png，.gif文件
fis.match('/images/(*.{png,gif})', {
    //发布到/static/pic/xxx目录下
    release: '/static/pic/$1$2'
});

再次编译得到：

<!--源码：
<img title="百度logo" src="images/logo.gif"/>
编译后-->
<img title="百度logo" src="/static/pic/logo_74e5229.gif"/>

<!--源码：
<link rel="stylesheet" type="text/css" href="demo.css">
编译后-->
<link rel="stylesheet" type="text/css" href="/static/css/demo_7defa41.css">

<!--源码：
<script type="text/javascript" src="demo.js"></script>
编译后-->
<script type="text/javascript" src="/static/js/demo_33c5143.js"></script>

我们甚至可以让 url和发布目录不一致。比如：


fis.match('*.{js,css,png,gif}', {
    useHash: true // 开启 md5 戳
});

// 所有的 js
fis.match('**.js', {
    //发布到/static/js/xxx目录下
    release : '/static/js$0',
    //访问url是/mm/static/js/xxx
    url : '/mm/static/js$0'
});

// 所有的 css
fis.match('**.css', {
    //发布到/static/css/xxx目录下
    release : '/static/css$0',
    //访问url是/pp/static/css/xxx
    url : '/pp/static/css$0'
});

// 所有image目录下的.png，.gif文件
fis.match('/images/(*.{png,gif})', {
    //发布到/static/pic/xxx目录下
    release: '/static/pic/$1',
    //访问url是/oo/static/baidu/xxx
    url : '/oo/static/baidu$0'
});

再次编译得到：

<!--源码：
<img title="百度logo" src="images/logo.gif"/>
编译后-->
<img title="百度logo" src="/oo/static/baidu/logo_74e5229.gif"/>

<!--源码：
<link rel="stylesheet" type="text/css" href="demo.css">
编译后-->
<link rel="stylesheet" type="text/css" href="/pp/static/css/demo_7defa41.css">

<!--源码：
<script type="text/javascript" src="demo.js"></script>
编译后-->
<script type="text/javascript" src="/mm/static/js/demo_33c5143.js"></script>

在js中定位资源

js语言中，可以使用编译函数 __uri(path) 来定位资源，fis分析js文件或 html中的script标签内内容 时会替换该函数所指向文件的线上url路径。

源码:
```
  var img = __uri('images/logo.gif');
```
编译后
```
  var img = '/images/logo_74e5229.gif';
```
源码:
```
  var css = __uri('demo.css');
```
编译后
```
  var css = '/demo_7defa41.css';
```
源码:
```
  var js = __uri('demo.js');
```
编译后
```
  var js = '/demo_33c5143.js';
```

资源定位结果可以被fis的配置文件控制，比如添加配置，调整文件发布路径：

fis.match('*.{js,css,png,gif}', {
    useHash: true // 开启 md5 戳
});

// 所有的 js
fis.match('**.js', {
    //发布到/static/js/xxx目录下
    release : '/static/js$0'
});

// 所有的 css
fis.match('**.css', {
    //发布到/static/css/xxx目录下
    release : '/static/css$0'
});

// 所有image目录下的.png，.gif文件
fis.match('/images/(*.{png,gif})', {
    //发布到/static/pic/xxx目录下
    release: '/static/pic/$1'
});

再次编译得到：

源码:
```
  var img = __uri('images/logo.gif');
```

编译后

  var img = '/static/pic/logo_74e5229.gif';

源码:
```
  var css = __uri('demo.css');
```

编译后

  var css = '/static/css/demo_7defa41.css';

源码:
```
  var js = __uri('demo.js');
```

编译后

  var js = '/static/js/demo_33c5143.js';

在css中定位资源

fis编译工具会识别css文件或 html的style标签内容 中 url(path) 以及 src=path 字段，并将其替换成对应资源的编译后url路径

源码：
```
  @import url('demo.css');
```
编译后
```
  @import url('/demo_7defa41.css');
```

源码：

  .style {
      background: url('images/body-bg.png');
  }

编译后

  .style {
      background: url('/images/body-bg_1b8c3e0.png');
  }

源码：

  .style {
      _filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='images/body-bg.png');
  }

编译后

  .style {
      _filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='/images/body-bg_1b8c3e0.png');
  }

资源定位结果可以被fis的配置文件控制，比如添加配置，调整文件发布路径：


fis.match('*.{js,css,png,gif}', {
    useHash: true // 开启 md5 戳
});

//所有的css文件
fis.match('**.css', {
    //发布到/static/css/xxx目录下
    release : '/static/css$0'
});

//所有image目录下的.png，.gif文件
fis.match('/images/(*.{png,gif})', {
    //发布到/static/pic/xxx目录下
    release : '/static/pic/$1$2'
});

再次编译得到：

源码：
```
  @import url('demo.css');
```

编译后

  @import url('/static/css/demo_7defa41.css');

源码：

  .style {
      background: url('images/body-bg.png');
  }

编译后

  .style {
      background: url('/static/pic/body-bg_1b8c3e0.png');
  }

源码：

  .style {
      _filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='images/body-bg.png');
  }

编译后

  .style {
      _filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='/static/pic/body-bg_1b8c3e0.png');
  }

文档内容有误，可提 PR，文档地址: /doc/docs/user-dev/uri.md