美文网首页
基于 Swift 多地图源业务向地图控件实现(三):交互事件处理

基于 Swift 多地图源业务向地图控件实现(三):交互事件处理

作者: 没故事的卓同学 | 来源:发表于2019-12-24 16:22 被阅读0次

    有的时候地图控件上还会有交互需求。比如在我的业务场景里,需要编辑无人机巡航的区域。要编辑区域,区域的多边形顶点就需要可以拖动。

    image

    简化一下需求,我们现在来实现一下点拖动编辑的功能。

    首先我们定义一下可以移动的顶点 View:

    class MapMoveableAnnotation: UIImageView {
        
        init(type: MoveableAnnotationType) {
            self.type = type
            super.init(frame: CGRect.zero)
            isUserInteractionEnabled = true
            setupUI()
        }
        
        private func setupUI() {
            bounds = CGRect(x: 0, y: 0, width: 44, height: 44)
            contentMode = .center
            image = Asset.Map.iconAreaEditPoint.image
            highlightedImage = Asset.Map.iconAreaEditPointSelected.image
        }
    }
    

    上面要注意的细节是需要设置 isUserInteractionEnabled 为 true。

    接着我们定义一个 view 专门响应用户的交互事件,因为要首先响应交互,这个 view 要在地图控件的最顶层。

    class MapInteractionView: UIView {
        
         override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
            for subview in subviews {
                let subPoint = subview.convert(point, from: self)
                if let result = subview.hitTest(subPoint, with: event) {
                    return result
                }
            }
            return nil
        }
    }
    

    因为 MapInteractionView 里所有元素都会响应交互事件,因此直接重新实现了 hitTest 方法。如果交互的点在内部元素上响应事件,如果不在的话不响应,让交互事件可以传到下层的地图源响应。

    接下来我们在 MapInteractionView 中定义添加可拖动控制点的方法:

    class MapInteractionView: UIView {
        
        private var areaControlAnnotations: [MapMoveableAnnotation] = []
        
        func renderAreaEdit(vertexs: [CGPoint]) {
            if areaControlAnnotations.count != vertexs.count {
                areaControlAnnotations.forEach { $0.removeFromSuperview() }
                areaControlAnnotations.removeAll()
                areaControlAnnotations = vertexs.map { _ in MapMoveableAnnotation() }
                areaControlAnnotations.forEach {
                  addSubview($0)
                }
            }
    
            for (index, point) in vertexs.enumerated() {
                areaControlAnnotations[index].center = point
                areaControlAnnotations[index].tag = index
            }
        }
    }
    

    接着我们给 MapInteractionView 添加手势响应:

    protocol MapInteractionDelegate: class {
        func areaVertexMoved(index: Int, point: CGPoint, isFinish: Bool)
        func areaFinishChanging()
    }
    
    class MapInteractionView: UIView {
    
        weak var delegate: MapInteractionDelegate?
    
        private var panGesture: UIPanGestureRecognizer?
    
        override init(frame: CGRect) {
           super.init(frame: frame)
           panGesture = UIPanGestureRecognizer(target: self, action: #selector(handlePanGesture))
                addGestureRecognizer(panGesture!)
        }
    
        private var panSelectedView: UIView?
    
        @objc private func handlePanGesture(_ gesture: UIPanGestureRecognizer) {
            switch gesture.state {
            case .began:
                guard let selectedView = hitTest(gesture.location(in: self), with: nil) else { return }
                panSelectedView = selectedView
                if let movableAnnotation = selectedView as? MapMoveableAnnotation {
                    movableAnnotation.isHighlighted = true
                }
            case .changed:
                guard let panSelectedView = panSelectedView else { return }
                let touchPoint = gesture.location(in: self)
                panSelectedView.center = touchPoint
                delegate?.areaVertexMoved(index: panSelectedView.tag, point: touchPoint, isFinish: false)
            case .ended:
                if let movableAnnotation = panSelectedView as? MapMoveableAnnotation {
                    movableAnnotation.isHighlighted = false
                    if movableAnnotation.type == .areaControlPoint {
                        delegate?.areaVertexMoved(index: movableAnnotation.tag, point: movableAnnotation.center, isFinish: true)
                    }
                    delegate?.areaFinishChanging()
                }
                panSelectedView = nil
            default:
                break
            }
        }
    }
    

    这里要强调的还是每个类职责的划分。在架构中我们常说单一职责,单一职责对于维护性的影响至关重要。我们对 MapInteractionView 的定义就是接受用户的交互事件。因此它在上面的场景中,处理移动手势,通知外界哪个顶点开始移动,移动结束。

    如何检验单一职责执行的好不好呢?我的一个建议是思考这个模块是否可以抽离出来独立验证,也就是可测试性。以 MapInteractionView 为例,现在这样设计如果想要单独测试这个类,可以做到吗?相对而言是比较容易的,可以在单元测试项目中初始化添加到 VC 中,输入特定的坐标点,接着在模拟控制坐标点位置模拟拖动手势。在 MapInteractionDelegate 中断言返回的结果和模拟的手势值是否一致。

    最后一环就是把 MapInteractionView 添加到地图控件的最顶层,这块代码比较简单代码我就不列举了。

    总结

    复杂的业务必然会有“复杂”的实现。架构设计要解决的是:面对复杂的需求,复杂的实现应该让开发者容易理解,容易维护。怎样做到呢?我们在规划时就划分好各个模块,让各个模块通过合理的组合实现复杂的功能。这样开发者在维护的时候只需要关注两件事:1.模块是如何划分的 2.我要维护的部分在模块中是如何实现的。每个模块因为职责清晰,所以即便不清楚全局,也可以维护这个模块的实现细节。这样的设计就达到了易理解、已维护的目标。

    相关文章

      网友评论

          本文标题:基于 Swift 多地图源业务向地图控件实现(三):交互事件处理

          本文链接:https://www.haomeiwen.com/subject/ladfoctx.html