76.HarmonyOS NEXT ImageItemView组件深度剖析：边界处理与高级特性(二)

evaluateBound(): boolean[] {
  // 返回 [上边界, 下边界, 左边界, 右边界]
}

// 在 PanGesture 的 onActionUpdate 中
const [top, bottom, left, right] = this.evaluateBound();
if (currentY < -verticalLimit) currentY = -verticalLimit * (1 + 0.2 * 过度系数);
if (currentY > verticalLimit) currentY = verticalLimit * (1 + 0.2 * 过度系数);
// 横向同理

// 父组件
@Component
struct ImageViewer {
  @Provide isEnableSwipe: boolean = true;

  build() {
    Swiper() {
      ForEach(this.images, (item) => {
        ImageItemView({ 
          isEnableSwipe: $isEnableSwipe 
        })
      })
    }
  }
}

// 子组件
@Reusable
@Component
export struct ImageItemView {
  @Link isEnableSwipe: boolean;
}

PanGesture({ fingers: 1 })
  .onActionStart(() => {
    if (this.imageScaleInfo.scaleValue === 1) {
      // 默认状态下将事件传递给父组件
      return GestureMask.Ignore; 
    }
  })

initCurrentImageInfo() {
  // 使用 LRU 缓存
  const cached = ImageCache.get(this.imageUri);
  if (cached) {
    this.imagePixelMap = cached;
    return;
  }
  imageSource.createPixelMap().then((data) => {
    ImageCache.set(this.imageUri, data); // 缓存策略
  });
}

// 避免频繁创建新矩阵
this.matrix = matrix4.identity()
  .scale(this.scale)
  .translate(this.offsetX, this.offsetY)
  .reuse(); // 复用矩阵对象

.expandSafeArea([SafeAreaType.SYSTEM], 
  [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])

// string.json
{
  "name": "imageviewer_image_item_stack_width",
  "value": "100%"
}

class ScaleModel {
  defaultScaleValue: number = 1.0;
  maxScaleValue: number = 3.0;
  extraScaleValue: number = 0.3; // 弹性缩放系数
  
  reset() {
    this.scaleValue = this.defaultScaleValue;
  }
}

class OffsetModel {
  lastX: number = 0;
  lastY: number = 0;

  stash() {
    this.lastX = this.currentX;
    this.lastY = this.currentY;
  }
}

imageSource.getImageInfo().catch((err) => {
  this.imagePixelMap = $r("app.media.error_image");
  logger.error("Image load failed: " + err.code);
});

// 开启调试模式
#if DEBUG
.enabled(this.$isDebug)
.border({ width: 1, color: Color.Red })
#endif

// 在 evaluateBound 中实现
if (超过边界) {
  const distance = 当前偏移 - 最大偏移;
  return 最大偏移 + distance * 0.3; // 阻力系数
}

// 快速滑动惯性效果
PanGesture()
  .onActionEnd((event) => {
    const velocity = event.velocity;
    this.imageOffsetInfo.applyInertia(velocity);
  })