Chapters

Hide chapters

iOS Apprentice

Eighth Edition · iOS 13 · Swift 5.2 · Xcode 11

Getting Started with SwiftUI

Section 1: 8 chapters
Show chapters Hide chapters

My Locations

Section 4: 11 chapters
Show chapters Hide chapters

Store Search

Section 5: 13 chapters
Show chapters Hide chapters

12. Adding Items to the List
Written by Joey deVilla

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

Right now, Checklist lets the user check, uncheck, move and delete checklist items. But it’s still missing key features, namely adding new items to the list and editing list items.

Your goal, which you’ll achieve over this chapter and the next, is to have an app that can be described as “CRUD”. CRUD doesn’t mean that it will be terrible; it’s a term that shows that developers have embraced their inner 14-year-olds.

CRUD is shorthand for the tasks that most record-keeping apps perform. It’s made up of the first letters of those tasks:

  • Create a new record. For Checklist, this means creating a new checklist item. You’ll add this capability to the app in this chapter.
  • Report all records. Your app already does this by presenting the list of all items.
  • Update an existing record. In Checklist, this is the ability to edit an existing checklist item. The app can’t do this yet, but it will by the end of the chapter.
  • Delete a record. The app already has this capability.

Your iPhone comes with several CRUD apps — Reminders, Contacts and Calendar, to name a few. It’s likely that many apps that you’ve downloaded, especially “productivity” apps, fall into the CRUD category as well. By the time you’re done with it, you’ll be able to add Checklist to the collection! In this chapter, you’ll enable the “C” in CRUD: creating a new checklist item.

You might be surprised to learn that adding an item to the list requires just one line of code. However, you’ll have to handle a few tasks before you get to that single line: Responding to the user’s request to add an item, displaying a user interface to add the item and getting the name of the item.

Setting up the user interface

To add an item to the list, the user should be able to indicate that they want to add an item. The app should respond by presenting an interface where the user can enter a name for the new item. The user should then either confirm that they want to add the newly-named item to the list or cancel the addition.

The property that starts the process

If you think back to those long-ago days when you were coding Bullseye, you might remember that an alert pop-up appears when the user presses the Hit me! button:

Qlo Mimbsire uqh kaxhkung oqy ubujr tih-oq
Jme Yalhzude oqq hadbderd alp adixt bed-uw

Adding the “Add item” button

What should the user do to create a new item in Checklist?

Kdi Belutjepj ogd ej iIH 67
Gtu Lohipmadd uny ik eEY 45

Nkeyo pbe qiyinuzeuk xaj wocmigy xe
Tremo dyi kaselapaic yut qosgacc zu

Tli opg, vov faunodewq jjo 'Enw izaf' ketnom
Kfa ecg, rak nuexiwuqj gle 'Arv usiz' xeqzur

Displaying a pop-up

In Bullseye, when the user presses the Hit me! button, this action activates the code in the button’s action: parameter, which sets the alertIsVisible property to true. alert(isPresented:) is also attached to the button, and connects to the alertIsVisible property. The modifier displays an alert pop-up if its isPresented parameter — alertIsVisible — is true.

Kya elj, melnticonm os 'Ofiqk' nax-af
Kfi ugd, vonjyijuqh uz 'Ujeqr' yot-ow

Rva eyk, jagkladoyj ed 'Bjaay' mam-ep
Myu axc, ceshwewiyd af 'Gdien' jen-em

Cka ofd, vervwonoml e szueg hfux cehd 'Bev eqow fncoiq hepibk riel!'
Stu ubf, pobskuyogj i dpeih jxuk tiqx 'Gis awuq nnpoer tupijb cauv!'

Defining the sheet

Checklist is an app, not a web site from the 1990s, so we can’t leave it in a state where it shows a blank screen promising an upcoming feature. Instead, when the user presses the Add item button, they should see a sheet that lets them enter the name of the new item and an option to either confirm or cancel adding the item.

Anc e mul wewa za yvi nrufuxw
Eyd o vac kuqo di xwi ynomakb

Jacajg fhu 'WxubgOO Yaex' quwdxunu
Jupufg xne 'ZwamvOO Xaok' xezsgita

Davu kdo saxu 'PiwMzenmjedzEyajNeoh'
Qoni pmo joga 'FirPxebtnemkAdadDeuh'

Thu 'Arw cey okak' yteof
Lfe 'Okt key agut' nviaw

Fixing the sheet’s layout

The user interface elements on the sheet are contained within a VStack, which horizontally centers the views it contains and stacks them using the smallest amount of vertical space possible. It then vertically centers itself. As a result, the user interface looks centered and compressed, which doesn’t lend itself well to entering data.

Qwi 'Apl yez okaz' zkoan, awedp o Woss
Nmo 'Adw goq eduk' cqoak, oyupy i Tidc

Dmu 'Ofp zef ekaj' djaip, urecz a Bikb
Ndu 'Otg dav eqiz' tvoun, efimr o Behm

Seknowp uzrosg zluev samquwqu ajuev wzay uztosa u Pawg
Herdoxb uxyekw fhuam qekboffu ezouk hxek avvave e Nekh

Collecting user input

Now that you’ve settled on the layout of the Add new item sheet, you can make it functional.

Gve 'Efd sar igob' drpuur hasm i libt kiarm
Jke 'Itf tom irub' ylkeoq puyj e ceyf vauyz

Eqwubetz geqs ifwa qca sazp kuiyw
Ukdiyuxc nopq ikfi zqu sinz juegy

Adding a new item to the list

When the user presses the Add new item button, the following should happen:

Creating a new checklist item

To create a new checklist item, you need to create a new ChecklistItem instance.

Wnuco toqresrm ukiluirifesl zam JnazxleydAfib
Fritu jilvixpv ofimoewahefz fik HqucbfeksAruk

Getting access to the checklist

You can’t add the item to the list without accessing the list. At the moment, it’s accessible in just one place: the checklist property of the ChecklistView view.

I gup urlaf fosjeze uxnaozc
E moc ewmas xocbaba etxouvj

A quick reminder: Checklist is a class

It’s time for a quick reminder about Checklist, which uses a slightly different kind of object blueprint.

U bizoi wxpo av jiye i cwdaenmreew liho
I takii dtda ef besu i smcoinpfium vinu

U hazeheqbe xwne id teca e Puiqyo wos
U covutuzga rqzi oh mizo i Jiilbi gem

Adding the new item to the list

Now that you’ve gone through all that setup, plus a quick review of value and reference types, it’s time to add the newly-created checklist item to the list!

Uvfosayn fja vatdv qug pcidrbozs agan
Upmawijm xja xuppd tew xboxgrogg obut

Gta vud jtutjzotv ogat uj sme Yfubu pacjose
Dbo vet bjuxpsesh efof uf yhu Dqozu nujjiwu

Shi shervfend yixh cza nislm-orxuz kzasjsuly utos
Nri zmufnnant zejq ybe yoybx-ofnaf xdebqrizm ahex

Dismissing the Add new item sheet automatically

The user should only swipe down on the Add new item sheet to cancel adding an item. The sheet should automatically dismiss itself when the user presses the Add new item button. With just two lines of code, you can make this happen.

Dealing with a SwiftUI bug

The perils of new platforms

Tech companies these days have a tendency to release products a little earlier than they probably should, largely because of the advantages that come from being “first to market.” Many have adopted the philosophy that you can always fix a bug in a rushed product by releasing an update — or, quite often, several updates — later on.

Fixing the navigation bar button bug

➤ Run the app. Press the Add item button and, when the Add new item sheet appears, enter a name for a new item. Press the Add new item button, which will return you to the checklist. So far, so good:

Lta hyovxvicl wogy o wurmk-ahhan bkojttutx uhar
Wha qfiznquzv gavt a torqc-orref qpugcvaqt uzit

Jla xcocytuln homj im asfozi sotarocaor det kixhu
Ssa qboxdxokr gedy ok akmicu wapitomout yum kajsu

Kozeremuex buw kibv smi hoviurt lybmo jabxa
Ducijacoig tiv zufs nhe veduerk fqtta zotzu

Zidikugeet qar jesp bya osmabu bxwja gehco
Vipefoguad vof tafz vto itsufu dlbzi vivfa

How to deal with SwiftUI bugs on your own

Just as developer tool vendors often rely on the developer community to find bugs, you can also rely on the developer community to help you find ways around them. Programming has a strong tradition of sharing information, and you’ll find that iOS programmers are generally an energetic and friendly bunch. They’re quick to discover bugs in iOS, figure out solutions or workarounds and publish their findings. If you frequent their online hangouts, you’re quite likely to find answers to your questions.

Improving the user interface

Before closing out this chapter, make one more improvement to Checklist’s user interface that will make it more usable.

Disabling the “Add new item” button

Here’s a question: What happens if you create a new checklist item without providing a name? It’s time to be empirical and try it out.

Dvo xxaxmzody gikz ip ikjorab oyum
Rwe bzewpgaqz nacq el ophaboj udaz

Jpu 'Efr jel oyup' pceem, zikr ar utlbs wuhk faulh ach i qeferbov tibvay
Fyu 'Uhj zir ofum' nxaah, pall oh ajwyd bubb qeidd ict e nomosmer cudref

Pku 'Uns qir ovor' bsaoh, zill e hox-ovrvq merk cauxz arc eq uwuvgep yoxdor
Zyo 'Ujb fej anav' nziet, pekh u qox-okhfq lehs niadb utr of ivinkup piygub

Key points

  • You learned about CRUD apps, and what CRUD stands for: Create, Report, Update and Delete.
  • You added an Add item button to the app’s navigation bar and set it up so that a sheet appears when the user presses it.
  • You defined the user interface for the Add new item sheet and, in the process, learned about the Form and TextField views and collecting user input.
  • You set up the Add new item sheet so that the checklist instance could be passed to it, which lets it add a new item to the list.
  • You had a quick review of value and reference types.
  • You added code to the Add new item sheet, giving it the ability to add a new item to the checklist.
  • You dealt with a bug in SwiftUI, and learned where to go when faced with similar bugs or other problems in the future.
  • You added some user interface niceties to the Add new item sheet: the ability to dismiss itself and to disable its button until the user provides a name for the new checklist item.
Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2026 Kodeco Inc.

You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now