Web 图形与 3D / 系统课时
悬停高亮如何保留原始材质
悬停高亮如何保留原始材质
产品展示中,多个零件常复用同一个材质。直接修改射线命中网格的颜色,可能让其他零件一起变色。本篇用 Raycaster 找到悬停对象,在目标切换时克隆材质,并在移出时恢复原始引用、释放临时副本。
学习目标
- 识别共享材质引用导致的联动高亮。
- 实现命中切换时的材质保存、克隆与恢复。
- 验证从 A 切到 B、移到空白处和离开画布时的行为。
为什么直接改材质会串色
Mesh.material 保存的是材质对象的引用。假设零件 A 和 B 都使用同一个 MeshStandardMaterial,执行 A.material.emissive.setHex(0x00ffcc) 会同时改变 B 的外观,因为两者访问的是同一实例。离开时再写死为黑色也不安全:原材质可能本来就有自发光颜色。
推荐保留原始材质对象,不修改它;只把被悬停网格的 material 临时指向克隆副本。这样其他共享原材质的网格不会受影响,退出时也无须猜测原来的颜色、贴图或粗糙度。
悬停目标变化时如何恢复
单指针、同一时刻只高亮一个网格时,用 hovered、original 和 temporary 三个变量保存状态。按以下顺序切换:
- 新命中对象与
hovered相同:不做任何材质操作。 - 如果原来有悬停对象:先将其
material恢复为original,再对旧的temporary调用dispose()。 - 如果新命中对象存在:保存其当前材质为
original,调用clone(),只调整副本的emissive,最后把副本赋给新对象。 - 新对象为
null时保持无悬停状态;鼠标移出画布也执行这一步。

在浏览器中运行完整示例
准备已安装 Node.js 的环境,使用 Vite 创建原生 JavaScript 项目,并安装 Three.js:
npm create vite@latest hover-demo -- --template vanilla
cd hover-demo
npm install
npm install three
npm run dev预期输出(实际端口可能不同):
Local: http://localhost:<PORT>/将 src/main.js 全部替换为以下代码。示例放置两个共享同一材质的立方体,射线只检测这两个可交互对象;坐标使用画布的实际边界换算,避免页面布局变化造成命中偏移。
import * as THREE from 'three';
document.body.style.margin = '0';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf3f7fa);
const camera = new THREE.PerspectiveCamera(
50, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(0, 1, 7);
camera.lookAt(0, 0, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
renderer.domElement.style.display = 'block';
document.body.appendChild(renderer.domElement);
scene.add(new THREE.AmbientLight(0xffffff, 0.8));
const light = new THREE.DirectionalLight(0xffffff, 2);
light.position.set(3, 5, 5);
scene.add(light);
// 两个网格共用同一个材质实例,用来检验是否发生串色。
const shared = new THREE.MeshStandardMaterial({
color: 0x315c74, roughness: 0.55, metalness: 0.15
});
const geometry = new THREE.BoxGeometry(1.4, 1.4, 1.4);
const meshes = [-1.35, 1.35].map((x) => {
const mesh = new THREE.Mesh(geometry, shared);
mesh.position.x = x;
scene.add(mesh);
return mesh;
});
const raycaster = new THREE.Raycaster();
const pointer = new THREE.Vector2();
let hovered = null;
let original = null;
let temporary = null;
function switchHover(next) {
if (next === hovered) return; // 同一目标不重复克隆
if (hovered) {
hovered.material = original;
temporary.dispose(); // 仅释放自行创建的副本
}
hovered = next;
original = null;
temporary = null;
if (hovered) {
original = hovered.material;
temporary = original.clone();
temporary.emissive.setHex(0x00a896);
temporary.emissiveIntensity = 0.9;
hovered.material = temporary;
}
renderer.domElement.style.cursor = hovered ? 'pointer' : 'default';
}
renderer.domElement.addEventListener('pointermove', (event) => {
const rect = renderer.domElement.getBoundingClientRect();
pointer.set(
((event.clientX - rect.left) / rect.width) * 2 - 1,
-((event.clientY - rect.top) / rect.height) * 2 + 1
);
raycaster.setFromCamera(pointer, camera);
const hit = raycaster.intersectObjects(meshes, false)[0];
switchHover(hit ? hit.object : null);
});
renderer.domElement.addEventListener('pointerleave', () => switchHover(null));
window.addEventListener('resize', () => {
camera.aspect = window.innerWidth / window.innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(window.innerWidth, window.innerHeight);
});
renderer.setAnimationLoop(() => renderer.render(scene, camera));预期结果:浏览器里出现两个深蓝色立方体。鼠标停在左侧时仅左侧泛青绿色高光,移到右侧时左侧恢复原色、右侧高亮;移至空白处时两者都恢复。终端中的 <PORT> 只是动态端口占位符。
如何验收与避免泄漏
依次测试 A → B → 空白区域 → A → 画布外:始终只能有一个立方体高亮;退出后两者的 material 引用应重新等于 shared。在同一立方体内部反复移动指针不应创建新材质,因为 next === hovered 会提前返回。
dispose() 只用于高亮副本,不要对仍被其他网格使用的 shared 调用它。材质克隆通常仍引用原贴图,释放临时材质也不会自动释放这些共享贴图。示例适用于每个网格只有一个 MeshStandardMaterial 的场景;多材质数组、ShaderMaterial 或 InstancedMesh 需要分别处理材质类型与实例级状态。如果相机或零件会在鼠标静止时移动,还应在变化后重新执行射线检测,避免高亮停留在旧目标。