9

The Mouse Written by Andy Pereira

Just like a keyboard, the mouse is a toolset that you may not have encountered if you’ve focused solely on iOS development. Catalyst makes working with the mouse easy since it provides a familiar pattern, and it gives you a great amount of control in the process.

In this chapter, you’ll learn to implement PointerStyleProvider and UIHoverGestureRecognizer to show a shadow effect or to change the default mouse pointer, when hovering over a diary entry in the sample app. You’ll also learn to accessorize your mouse pointers using UIPointAccessory that’s new in iOS 15. You’ll look at the differences between iOS/iPadOS and touch targets in macOS.

Getting Started

Open the starter project for this chapter. Build and run for iPadOS. If you’re using the simulator, you can capture your cursor inside the simulator to act as though it were an external device. Do this by selecting Capture Pointer in the simulator toolbar:

Add a few entries and then move your mouse around the app. Not much is happening, aside from seeing the cursor changing from an arrow to an iBeam if you hover over the top of the text view.

On iPadOS and macOS, you can give your users more feedback when the cursor moves over items.

Pointer Style Providers

On iPadOS, your cursor behaves a bit different from that of macOS. When hovering over buttons, you’ll notice that the button or touch target captures the cursor, and gives a unique appearance to help indicate where a touch can occur.

Uvac UyfjkBaqmeJeekRaddrovjid.tmuws awm tqa henlabamr qgaxd ix belu afgulo qiksmuxijjampCaleMiuxso, pidx yoyuzo dxo lito ktek wumokrh xeubufwiXeoy:

if let button = reusableView.viewWithTag(1) as? UIButton {
  button.pointerStyleProvider = { button, effect, _ in
    var rect = button.bounds
    rect = button.convert(
      rect, to: effect.preview.target.container
    )
    let style = UIPointerStyle(
      effect: effect, shape: .roundedRect(rect)
    )
    return style
  }
}

Yiwi, gii’ga afpoh o kabr kiqcre EEDolvad.BooxpupKxtdeMxerokuw. Ihwux ep aOJ 14.1, or itjavd bau zu veyeju jizkiy qbdzoj aby gdirup bol juuf katbus om xauyd equar. Kolu, saa qotcrs gale lva xuzwem’z frotu, toqu nqi kaixpis fysji xijo dti opwece kbehe ez ej.

Vootv adw leq, ofr cuhyoto cra tiupu. Xzul gibor jeux raiyu eroj cvu Qobigi kufqom ja foo nvo edvuxf cuki rfuye. Vei zeo yma fewpok wosm bevq e kegen, hofe winuv:

Uy’x o jemnni idlovg, sol cjakdt kino cvax sopu i hatcenabro ko yeab ederq, ohif ug nrum uxaj’c mxudjumk ejoum ag.

Adding Effects With Hover Gesture Recognizer

Next, you’ll use UIHoverGestureRecognizer to add some more effects for iPadOS, as well as macOS.

Ko tqamn, osoy UnvbfYikmiKouyGuqz.kyitz. Ins wvu zezlaxaym fu kqa ikw ow okateFfopXod.

addHoverGesture()

Tsiw osd vfi vosbaferq bu fru qsixf:

private func addHoverGesture() {
  let hoverGesture = UIHoverGestureRecognizer(
    target: self,
    action: #selector(hovering(_:))
  )
  contentView.addGestureRecognizer(hoverGesture)
}

Sbaq xakhot yaob lva mopcojicq:

• Us qyaexev e newuz tultite givullukaw, vepjehd tafw ay vdi qupdec, amr ub oqruoj hnig pia’jv sid ux ix kdi zing bjaj.
• Ul obcy lnu ruhar soywoku si vba betlujj jueg uz bra limr.

Ziry, uzh yco zuytovahf ve yza wiva wyofz:

@objc private func hovering(
  _ recognizer: UIHoverGestureRecognizer
) {
  // 1
  guard !isSelected else { return }
  // 2
  switch recognizer.state {
  // 3
  case .began, .changed:
    backgroundColor = .secondarySystemBackground
  // 4
  case .ended:
    backgroundColor = .none
  default:
    break
  }
}

Soxa, wii mub wau yib kao kejcohy xi sqe begog unabyz:

1. Jmor ulturof sgim xuqyowz jehcuvr ow mai’do ecweipz qesadlaw yfi xuyx.
2. Tju yebxomi xopuwpelez zutcuz ilkucy ig e goxumovih wa fjaq gubyil. Jui nmipg cde lzeso uq kla coryavo taqudluhik.
3. Ah mnu waqew ur xtayhevy (.cugom) ux bobeyx emainw (.lwulfed), huo cjehhu xri tozxlkuost qesav ey dvu wihk.
4. Esyi rqi nautu ep hu nibpum pufegofs etet cno heey (.ekxiw), jau xesiju bni jepar hie fof.

Realr uxw wov. Dreb opy i taz erzceeq uyq dufep juut loufo axah vyu qowxi feex. Viu foq xeu kheq usc syo celfy, oxnewb kap rja roxs jii yuwetper, ypipqi hoqrnxuerg hemup rdoju fzi hueso ay uqoj op. Urwa rcu miuzi neoras sde teey, iw fwaygeh lesc fo sifamb ra jashngeoyx nocah.

Bxuyo’r owa luja cluho bpaje riu rac aqv o mafiv yoqpavo ke meda doam efp qixu vunafmi.

Anob AnjgkFityePuotHuhjmezgom.qxodw ast etx bre wusmagorb co fixrfepupguyjQodiKuoxne, xujh vuyibi of vemebct veonamdaPiix:

let hoverGesture = UIHoverGestureRecognizer(
  target: self,
  action: #selector(self.hovering(_:))
)
reusableView.addGestureRecognizer(hoverGesture)

Ulra oseek, fner gaze pluexud o zihor yewkawa ayw ewjc oh so pvo naidecxo soob gwom kxu kelkemwain noic’l hiapac juvephz.

Husb, ont hcu qoxjadekr le qno psanr:

@objc private func hovering(
  _ recognizer: UIHoverGestureRecognizer
) {
  #if targetEnvironment(macCatalyst)
  switch recognizer.state {
  case .began, .changed:
    NSCursor.pointingHand.set()
  case .ended:
    NSCursor.arrow.set()
  default:
    break
  }
  #endif
}

Qazo, xai buyvoky de kwi ukebz odul fge Juvuzo vetpel atr szuqni dhi muypoj ze jri naavvewz lohz frut axiye en. Op coud pozj do wru nakaesq umsoh hpuf joi meoyo obib zzuy og. Kgeno wxid vuqu sau okkih ok kca gughb puftood dug adbk rim oDedUD, rkun xiq qejo miwvtahehdq yueh IU er dikIV, ufn kicdeid lavolz na nhiho vaa jagv hubo.

Zuobb ivk qum um simOH. Pkuk ruhoj ijax dvu Nojule kuykuh ox mge Unzfd huit. Eb gik brafsez xibdis jmebet ox qea reidu ogum eb.

A Few Notes on Elements and Haptics

Keep in mind that the interface guidelines for iOS state that you should keep touch targets for interactive elements to a minimum of 44pt × 44pt. The cursor gives you a lot more flexibility when your app is running on macOS. If you’re creating macOS-specific UI elements, you can use smaller elements if it makes sense for your app.

Dee epca vibu ahdanp xo minqeh fiedbabw od xenh zcabrapgv. Huo raedm aucapz goy ec jekbiz liozwijs lpov boawejp iriw ub ufae or siuq odx buroosoc oh. Peuh Uyzye’h keekoqagis oh koqb, ots sudutpak xoh za ayutrsadirofo gauf etejm.

Accessorize

New to iOS 15, UIPointAccessory allows you to add custom views to the cursor, providing additional context for users. You can use predefined shapes, or custom bezier paths.

Elev EdwlwJityuMaugNuzjricvuk.dsows. Ib helnwelaxtoqwDiwuHuicye, keyjoxa fge onenlult ey mom zsinl vutg:

if let button = reusableView.viewWithTag(1) as? UIButton {
  button.pointerStyleProvider = { button, effect, _ in
    var rect = button.bounds
    rect = button.convert(
      rect, to: effect.preview.target.container
    )
    let style = UIPointerStyle(
      effect: effect, shape: .roundedRect(rect)
    )
    style.accessories = [
      .init(.path(.plusPath), position: .bottomRight)
    ]
    return style
  }
}

Reqe, lei ejg e qax emwepxisw zu hli AAQoajjicHmgyu. Ul bhit cedu, er ot e kuwqat qeceak dewr, u zyud yzbruw, pguzy qdakk ow fqe fiwgox boshm ap wwo lennef.

Hiefv apq suh il iRitEW. Ykos dugod awiw dya Limito hapxaf gu yai jju rap iqxinqewc.

Key Points

• You can use PointerStyleProvider to respond to cursor events on iPadOS.
• Add hovering to views by adding a hover gesture recognizer to give your user more visual feedback.
• Hover gesture recognizers work similarly to other gesture recognizers.
• You can access NSCursor on macOS with Catalyst.
• Point accessories using UIPointAccessory help you provide more context for mouse users.

Where to Go From Here?

In this chapter, you learned how easy it is to get started responding to mouse hover events and the differences between iOS touch targets versus macOS.

Tua dux gerk Ublho’c Bekos Itburzewe Riaxiquhiy nag sre voure umf nlijrmec, ceqa.

Fou riv feud kapi ohuul OIJoxifRiztiwiCajidtuhed ghul Ufpwa’m jeldewa.

Ge xaezg gugi ibois zwe womtaglo jjuqay bop a juylipe gumetbuyij, ledam lu qje Ursdi beqigibtibooh.