Vue中v-for循环遍历静态图片时图片不能加载的原因和解决办法

Posted 2023-04-06

参考技术A 图片：

vue的 v-for 循环中图片加载路径问题

　　先看一下产品需求，如下图所示，

　　产品要求图片和它的名称一一对应，本来是非常简单的需求，后台直接返回图片路径和名称，前台直接读取就可以了，但是我们没有存储图片的服务器，再加上是一个实验性的需求，图片需要存放到前台。当时我想，vue 中的img 的src 可以动态绑定到一个变量上， 很简单吗，就没有考虑太多，直接开始做了。

　　首先和后台商量一下数据结构，因为图片要和名称一一对应，所以后台要返回中英文的名称的映射，我把前台的图片名称直接设置给后台给的英文名称，从而读取图片，图片和中文名称就一一对应了。数据结构如下：映射关系用对象表示，多个图片，所以放到一个数组中

[
            {
                CnName:\'荷花\',
                EnName: \'lotus\'
            },
            {
                CnName:\'康乃馨\',
                EnName: \'carnations\'
            },
            {
                CnName:\'牡丹\',
                EnName: \'peony\'
            }
        ]

　　现在前台用vue-cli, 后台用express 来模拟一下当时的开发场景，也可以还原一下错误和业务的迭代过程。新建一个文件夹，就叫vue-img吧，然后再在该文件夹中新建两个文件夹，client, server, client 表示客户端代码，server 表示服务端代码。 在client 文件夹中，打开命令窗口，执行 vue init webpack-simple . 命令，后面的点表示当前文件夹，为了简单，这里使用了simple 模版. server 文件夹，打开命令窗口，先执行npm init 初始化为node 项目，然后npm install express cors --save, 安装依赖，cors 是解决跨域的。

　　先来写前端代码，把app.vue 中的template和script中的内容清空，保留它的css 样式内容，我们就不用写样式了。前端页面，有两个部分，一个是button, 点击按钮来发送请求，一个是图片展示区域，它用的就是v-for  循环， template 内容如下

<div id="app">
  <button @click=\'getFlower\'>点击加载请求</button>
  <!-- 由于当时想当然地以为，src 就是绑定一个变量，所以就设置了一个默认变量，这是出错的过程 -->
  <ul>
      <li v-for ="item in flowers" :key="item">
          <img :src="defaultImg" alt="flowers">
          <p>{{item}}</p>
      </li>
  </ul>
</div>
</template>

　　由于template中用到了方法 getFlower,  变量defaultImg 和 flowers， 所以要在script中进行声明。defaultImg 是一个图片，所以还要引入进来, 在src  目录中新建一个img文件夹，放几张图片。flowers是一个数组，我先预写了一个[\'荷花\', \'康乃馨\']，getFlower，因为没有后台，所以先没有写， 注意如果数据量大的，交互复杂，是要写mock 数据的，这里比较简单就没有写。这也是出错的原因。代码如下

import defaultImg from \'./img/lotus.jpg\'; // import 引入图片

export default {
  data() {
    return {
      flowers: [\'荷花\', \'康乃馨\'],
      defaultImg: defaultImg
    };
  },
  methods: {
    getFlower() {}
  }
};

　　整个页面显示如下，我以为没有问题了。

　　现在再来写后台代码， 用express 写一个后台接口，还是非常简单的。在server 文件夹中，建一个文件server.js 来写后台代码

var express = require(\'express\');
var cors = require(\'cors\');  // 引入cors 中间件，解决跨域

var app = express();
app.use(cors());

// 前端发送的是get请求，接口是flowers. 返回的数据code 表示成功或失败，obj 表示数据
// 数据中Cn 表示中文名称，En表示中文名称
app.get(\'/flowers\', (req, res) => {
    res.json({
        code: 0,
        obj: [
            {
                CnName:\'荷花\',
                EnName: \'lotus\'
            },
            {
                CnName:\'康乃馨\',
                EnName: \'carnations\'
            },
            {
                CnName:\'牡丹\',
                EnName: \'peony\'
            }
        ]
    })
})
app.listen(3000, () => {
    console.log(\'server start at 3000\');
})

　　现在用nodemon server.js 启动服务，在浏览器地址输入http://localhost:3000/flowers， 可以看到返回的数据表示接口ok.

　　现在再重新写一下前端代码，进行前后端联调。由于要发送请求，还要安装axios 依赖。首先要根据后台接口改一下template 内容的li 

  <ul>
      <li v-for ="item in flowers" :key="item.EnName">
          <img :src="item.EnName" alt="flowers">
          <p>{{item.CnName}}</p>
      </li>
  </ul>

　　然后，在script中引入 axios， flowers 数组清空，default img 删除 , 引入后台数据所需要的三张图片， 同时getFlower 方法发送请求

// 引入axios，用于发送请求，defaults 设置后台请求地址
import axios from \'axios\';
axios.defaults.baseURL = "http://localhost:3000"

// 引入相关的图片, 命名要和后台保持一致
import lotus from \'./img/lotus.jpg\';
import carnations from \'./img/carnations.jpg\';
import peony from \'./img/peony.jpg\';

export default {
  data() {
    return {
      flowers: [], 
      lotus,
      carnations,
      peony
    };
  },
  methods: {
    getFlower() {
      axios.get(\'/flowers\')
        .then(res => {
            if(res.status === 200 && res.data.code === 0) {
              this.flowers = res.data.obj;
            }
        })
    }
  }
};

　　我以为成功了，点击按钮发送请求，但是看到的如下画面，没有图片

 

　　当时想不通，img 的src 绑定的是变量，它和defaultImg 不应该是一样吗？打开浏览器控制台，看到如下内容，img 的src 已经是一个字符串，它不是我们想要的变量了。

我想这里可能是它对item.EnName进行了一次解析变成了字符串，就完事了，绑定变量，就是解析一次。而对于defalutImg 来说，它本来就是变量，无法再进行分割解析，所以它会去data 里面去找，如果找不到，才报错。

　　那么我们现在要做的就是把item.EnName 变成图片的地址，这样进行一次解析的时候，直接去读取图片。要怎么做到呢？当时 我也不是很清楚，就百度了一下，有人提到了require 方法， require 一个图片路径，我想require 什么，以前没有听说过require 这个关键字啊。想了一段时间，突然就明白了，require 是一个commonJs 规范的关键字，当我们在写node 代码的时候，都是有require 去读取资源的。在前端js 中，一直使用import，直接忘记了，不知道怎么用了。webpack 把img 当做一种资源，所以使用时要先引进。引进方式有两种，一种是import ， 一种是require， 因为webpack 同时支持ES6 module 和 commonJs 规范.  import 是个语句，只能在js 代码顶部使用， 而require 不一样，它是一个表达式，可以进行赋值操作。我们试一下，用require 引入图片是怎么样的效果，在 script 标签时，写下

var img = require(\'./img/lotus.jpg\');
console.log(img);

　　刷新浏览器，在控制台上可以看到如下输出

　　正好是图片的路径，也正是我们想要的内容，刚才也说了，require是一个表达式，它可以用到任何js 表达式能用到的地方。我这时就想，把后台返回的代码进行重新组装，EnName 直接是图片路径。getFlower 方法修改如下

    getFlower() {
      axios.get(\'/flowers\')
        .then(res => {
            if(res.status === 200 && res.data.code === 0) {
              this.flowers = res.data.obj.map(item => {
                  return {
                    CnName: item.CnName,
                    EnName: require(`./img/${item.EnName}.jpg`)  // 利用require 引入图片，获得图片路径
                  }
                })
            }
        })
    }

　　这时刷新浏览器，点击按钮发送请求，可以看到图片了并且一一对应， 成功了。

 　　

　　这时又一想，既然require 是一个表达式，在template模版中是直接可以解析js 表达式，那么直接把img 的src 绑定到require 表达式就可以了，把getFlower 方法，回退到上一次代码，然后template 代码如下

  <ul>
      <li v-for ="item in flowers" :key="item.EnName">
          <img :src="require(`./img/${item.EnName}.jpg`)" alt="flowers">
          <p>{{item.CnName}}</p>
      </li>
  </ul>

　　同样也成功了。

　　最后写代码的时候发现，如果读取的图片不存在，上面的方法就会报错，并且没有办法处理。这时还要回到js 的代码处理。我又把html代码回到以前，然后在getFlower方法中进行错误处理，既然读取报错，我们读取的代码就放到try中， 如果有报错，就在catch 看处理，提供一个默认图片，try catch 处理读取异常。 try catch 的逻辑

                  try {
                    img = require(`./img/${item.EnName}.jpg`);
                  } catch (err) {
                    img = require(\'./img/lotus.jpg\');
                  }

　　整 个app.vue 

<template>
<div id="app">
  <button @click=\'getFlower\'>点击加载请求</button>
  <ul>
      <li v-for ="item in flowers" :key="item.EnName">
          <img :src="item.EnName" alt="flowers">
          <p>{{item.CnName}}</p>
      </li>
  </ul>
</div>
</template>

<script>
// 引入axios，用于发送请求，defaults 设置后台请求地址
import axios from \'axios\';
axios.defaults.baseURL = "http://localhost:3000";

export default {
  data() {
    return {
      flowers: []
    };
  },
  methods: {
    getFlower() {
      axios.get(\'/flowers\')
        .then(res => {
            if(res.status === 200 && res.data.code === 0) {
              this.flowers = res.data.obj.map(item => {
                  var img = null;
                  try {
                    img = require(`./img/${item.EnName}.jpg`);
                  } catch (err) {
                    img = require(\'./img/lotus.jpg\');
                  }

                  return {
                    CnName: item.CnName,
                    EnName: img
                  }
                })
            }
        })
    }
  }
};
</script>