HOWTO · Angular
AngularJS 中的数组映射
了解如何在 AngularJS 应用中使用 JavaScript 的 Array.prototype.map 转换数组元素,并通过示例了解何时与 filter 配合筛选数据。
本页内容
在 AngularJS 应用中,数组转换来自 JavaScript,而不是 AngularJS 单独提供的映射功能。Array.prototype.map 方法会为每个实际存在(非空)的数组元素调用回调函数,并返回一个由回调结果组成的新数组。对于稀疏数组,它会跳过空槽位,并在结果中保留这些空位。可用它转换每个实际存在的元素,例如将记录转换为显示标签;它不会筛选元素。
回调函数会收到当前元素、它的索引以及源数组。通常只需要当前元素。回调返回的值会成为结果中的对应值。如果回调没有返回值,相应的结果项就是 undefined;请显式返回你需要的值。映射会保留所访问数组元素的数量和顺序,不会移除不符合条件的元素。
AngularJS 中的数组映射作用
AngularJS 可以在控制器、服务或其他处理数组的代码中使用普通 JavaScript 数组方法。操作写作 items.map(callback),不依赖模板指令或 AngularJS 专用服务。map 本身会创建新的结果数组,不会修改源数组。不过,回调函数仍可能修改源数组或产生其他副作用。对于稀疏数组,回调只会处理实际存在(非空)的元素,结果中的空槽位也会保留。因此,可以用它为视图准备数据,同时保留原始记录以供其他操作使用。
返回的数组虽然是新数组,但其中的对象不会自动克隆。如果回调返回源数组中的对象,两个数组可能会引用同一个对象。若要进行直接的值转换,请避免在回调中修改源对象;如果需要不同的对象结构,请返回一个新对象。
使用 Array.prototype.map 转换每个元素
在数组上调用 .map(),并传入一个会返回转换后值的函数。例如,users.map(user => user.name) 会返回姓名数组。箭头函数中的表达式就是它的返回值。如果使用带代码块的函数体,请显式写出 return:users.map(user => { return user.name; })。如果代码块中没有 return,每个被处理的元素都会对应一个 undefined。
运行此示例:
本节中的代码以及显示的标签或输出仍为英文。
const tagNames = { 1: "JavaScript", 2: "AngularJS", 3: "TypeScript" };
const selectedIds = [2, 3];
const selectedNames = selectedIds.map(id => tagNames[id]);
console.log(JSON.stringify(selectedNames));
["AngularJS","TypeScript"]
这里,每个选中的 ID 都会作为 tagNames 中的键,回调函数会返回对应的标签。结果中每个选中的 ID 都有一个标签,且顺序保持不变。JSON.stringify 会将数组转换为一行文本,便于查看。
将选中的 ID 映射为对应值
当表单或组件存储的是标识符,而视图需要显示易读的名称时,选中 ID 的处理模式就很有用。可以根据可用的标签记录构建或获取查找表,再通过该查找表映射选中的 ID 数组。请为输入和结果使用不同的变量名,以便清楚区分标识符和标签。在实际应用中,应根据数据源提供的记录生成查找表,而不是手动维护重复的名称。
请考虑缺失 ID 对数据意味着什么。查找表中没有对应键时,结果会是 undefined;应决定在渲染前显示、报告还是以其他方式处理该值。如果结果只应包含拥有已知标签的 ID,请先筛选出匹配的 ID,再映射这些值。不要指望 map 根据回调结果丢弃元素。
何时使用 map 和 filter
如果每个元素都应在结果中对应一个转换后的值,请使用 map。如果目标是只保留符合条件的元素,请使用 filter。若要先筛选记录再转换,可以组合使用 items.filter(isVisible).map(toLabel)。中间数组包含通过筛选的元素,最终数组则包含它们对应的标签。
这两种方法本身都不会修改源数组,但回调函数仍可能修改该数组或产生其他副作用,例如更改外部状态或对象。如果需要直接明了的转换,请让回调专注于返回值。只提取属性时,直接使用 map;需要按条件选取子集时,先用 filter;两者都需要时,先筛选再转换。
JavaScript 的 Map 集合与 Array.prototype.map 是不同的功能。set、get、has、delete、clear 等集合操作以及 size 属性属于 Map 对象,并非数组映射方法。小写的 .map() 调用会转换数组元素;它不会创建或更新键值集合。