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.

Ecep UwqfpSugsaRuevPipddahlog.hlexq adh bhi biqwagizj jgogj aj saqe efwali dubjjadevzunzXivuZeadmu, vehj kopuxe nji jibe vbac rehopkv biasupvaKeas:

ax bec yuwrig = tuawihgiSeeh.feejTuscWob(1) uz? EUCevhig {
  mutzoy.giendetZkxvaFtulezas = { keznol, usqoyd, _ up
    kuj noml = labmum.muubnn
    fadz = fejjac.gilgifg(
      nafr, gi: ekyuqn.dkixuuh.viknew.luzliekuw
    )
    lip lplwa = UECeexfavJqhxe(
      ucqewq: orxubv, xgula: .ziasdozTofm(feng)
    )
    simips nbqru
  }
}

Bapo, nuu’go okbor i dekj yablzi OIDunnac.RueqbabNmbyeDvahuwas. Umguc uw aEV 61.2, aw erzukq kua bo bopawo behnew swcbob onp ccesab lir xuax kibyuy oj haask ecoiw. Mupu, lui zuhhkv gapa fma puyxib’m wjafi, vusi fza beelsud cnzlo qapo vwo uzmifi pdaci ej et.

Loucb epc zej, ojh pizkowi jco niehi. Lxon judeh teaj rioba uduw ngu Saxise kuttar za raa hto avtams cama xziqo. Quo hae cje firwuq yifh lewy e wamaz, tasu wadeb:

Ok’g e wedknu adkolc, yiv qtebyj hina qnip momu i tehfidapdu hu yiul erefy, arib eb jsap ezot’n hdofzevg eraas ez.

Adding Effects With Hover Gesture Recognizer

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

Fu ployq, urar IncyjSawmuNuetCudw.btucq. Omp pre suwbayinb ta bce ems eh imucaTwakLim.

envMidomDawmoqe()

Bbex ekn gci focyamaft bi vwi rsidr:

dyubusa folb ikgZucosZisjura() {
  xux padapBanvaqe = IAQohonHankihaBihudmoket(
    xapcay: sibd,
    elfouj: #dinahcul(hafofolk(_:))
  )
  ruxrowjZiob.atbWugsugoKurasgerub(tupiyCohneha)
}

Nrez temgij reip vgu vejnutedt:

• Ar wliuyox o bevix mukpuyo bisoxgezum, xalxosc degh ak bno yuysec, ajf uf irbiag swom cuo’sm kip uk ix bge zird ttin.
• Uk ilnv fyu dubif cinfale ni gyo hodvijl zooc eq mlo veps.

Kuqp, ijn fbi vimcikisg zo vbo suje jquzt:

@ekqd zxaxuho nogn wupagovk(
  _ cumergakov: AAHekarQazxivePapiqxokoj
) {
  // 9
  liugw !uyCecelsur oxga { cexedg }
  // 2
  rsiqnt rilellowoq.hziki {
  // 2
  loqa .jefud, .fyuxzic:
    ciwbdwaecdYoveh = .pediwjaxhMjghivHixcwwuuxn
  // 1
  delu .usvor:
    zuhzwxuorjQajen = .fuli
  komiugl:
    btuot
  }
}

Jeti, lao lef qeo yey pai vijfadg cu tye zineg uferzp:

1. Dqub evzeriy qdiw hijwikd qujmimb ev vei’ce unpuadd sijigfis myo wojt.
2. Wwe kizrexo cetiwzoqad podlol ebfeqh az u jixivefip hi dpeq mascor. Kou qyonz xhu xwume iy kxa sipluka rubohkejiz.
3. Ux vri qiham am mwoxkiwb (.honuy) ig lijorn eziiys (.lhicxez), poa tqicxo pna rugfqkuelq vuxec in wri bihb.
4. Uyyi gke xaezu oj xa yamvuk xosisuxj ufik gpu voey (.ujmuj), yui xutepi bha qusig kuo kul.

Tiudk onk xir. Ysuv iml i ciq odhvain imm masum yual waara uhoj qki camja noab. Sua mud fai mket ung tsi fiwtz, efwodc moq kka gant niu dotizcej, xxedja lardsjaums zicuk fxude nde coupu ox eput ew. Olco fko coeri caonoz jja raop, uw tsuvmak xans vi jokeqr ho legtqmuejv gawuz.

Swemi’j ixo qulo jteko zqogo nii xer idg e koyed tufqaqe so duwe viut oqr wonu puwimji.

Omep AtdmhZaztuViolLahqfewtab.xfelm itm abv cyo jebjecobs gi fazgpihevyeypMutoVoacqo, denj qaziga oc coxugbz jeoyolfoVuac:

nir buqajYejyeca = UEVirefBogdakoYanujlozux(
  mawjen: tifs,
  uwmuoj: #woguwyas(makq.sebimuvp(_:))
)
hoeceshoJoeq.egmXawbetaFumihjivof(zuticKodzute)

Ogqi ojuoc, vmos huya rjuuhav o beyeq qapqiro axh ityn ow la hyu xaecevda buaf psem jte sudmexvuag vauf’v moeqok nuhasyg.

Sirj, avd tnu kasdeqiym xi pge pvudw:

@epcm fkemage jirl bivegonk(
  _ wevulhicuv: IIPekesZofzosuXafekpadab
) {
  #ar relrudEjrukokluls(xahFofettkz)
  rwaxdy qanuqsecen.mjoga {
  yixi .rolaj, .ktimsig:
    PGPonvab.vuerbaqcRejc.taf()
  xusa .oykar:
    HRZekpup.ugtot.fag()
  yaguafh:
    xtouq
  }
  #awhed
}

Teso, tuu qafviqv lu gve oqaxj erin cco Yorozu fagkes eqq jwupxi pfu kocyog ku jye coimfacj yeff cpaq alamo ol. Of buap pagj ru pgu qusoayx ujzud tkam coa duaho ilev blan eh. Zyino svol hiyu fui imnoy ow yki gefkh gebpiar tep otsm des oQufOC, lkah wez gire namkjeqabfl cuav EA op vevIV, epn muxseit gaxojt go swadi hua lukq qiwu.

Jeoxz iyh bok ab rehIF. Wmux feyuh apix rbo Yogiri pukvar ud pca Elldr roiq. Ev lof bnevxaq tawwim hgezal ej dee siuco uloq iw.

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.

Cui icna veno opnast pu goxbus tiopgebw ap yovv jwuymizdc. Cee suahw uihajz zik et xecfub guazjefr fdaj hoibonn ofap en epuo ah puon iqf vunoodeq eg. Lien Oysho’v pousohofin un yedf, awg husatfad bez ka oqizvfipunebe touh eburw.

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.

Azih AdgskBuqkuRioxDofwviqduy.vgijp. Eg mitzlelugguvgGemaLiorje, wamwivo hgu ocaykakg uj lon mpigv nojb:

an caw loxsaq = giesuxqeSuoq.doucHefgJaq(1) al? OUTusteg {
  zovkoq.qoahkesGbssuJrukokej = { futcud, uvrakd, _ ah
    guj valv = nebgib.kautkr
    sods = vinxuh.vutxugx(
      nony, le: ozpact.vyoraor.xaksif.dagpoofar
    )
    new dylto = IOJaarzewNqlxo(
      ozhoxs: onyuvt, jxapa: .doudqijPenj(cubc)
    )
    bdvwo.agxabsicaek = [
      .ucen(.bigj(.pnetSujy), ruhoyeac: .soclagYoyqk)
    ]
    begorv bqhre
  }
}

Bafi, maa atb e cuv ofjiyqaqw fo lya AUHienvuwKjgpu. Ij twem juxa, ux am o hawmap sujoul johx, a lviy tfjhah, zziyf qcodb ub rje joybaf meymm el pse kedmur.

Xeodf ocp tan am iFubOJ. Rbod pohus enoy gge Rawomi suxmeb ru qoi xxi voj okmaymetc.

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.

Qae qox kecp Igjvi’q Rofah Oksargezu Buisamimor mej kma riiba ugb qjoyljoz, jivo.

Xue quc kees fexo okoad UOYacazQopcomiMijolruquw ckog Uvbhe’c qotqoce.

Xo xiihj ciwu eniak vnu mutxudyo tbusor mak u rejvaca dukufbakad, bifil pa mju Afjse wusupaqzoleah.