Displaying Text Content in iOS
Use Text Objects to Display Text Content
Text objects display styled, formatted text in a range of fonts, styles, and sizes. The UIKit framework provides three primary classes for displaying this text content in an app’s user interface:
UILabeldefines a label, which displays a static text string.
UITextFielddefines a text field, which displays a single line of editable text.
UITextViewdefines a text view, which displays multiple lines of editable text.
Although these classes actually can support the display of arbitrary amounts of text, labels and text fields are intended to be used for relatively small amounts of text, typically a single line. Text views, on the other hand, are meant to display large amounts of text.
Text view objects, created from the
UITextView class, display text formatted into paragraphs, columns, and pages, with all the characteristics of fine typesetting, such as kerning, ligatures, sophisticated line-breaking, and justification. These typographic services are supplied to
UITextView through an underlying technology called Text Kit, a powerful layout engine that is both easy to use and extensible. See “Using Text Kit to Draw and Manage Text” for more information about Text Kit.
Figure 1-1 shows examples of the primary text objects as they appear on screen. The image on the left shows several different styles of text fields while the image on the right shows a single text view. The callouts displayed on the background are
UILabel objects embedded inside the table cells used to display the different views. (These examples were taken from the UICatalog sample app, which demonstrates many of the views and controls available in UIKit.)
When working with editable text fields and text views, you should always provide a delegate object to manage the editing session. Text views send several different notifications to the delegate to let them know when editing begins, when it ends, and to give them a chance to override some editing actions. For example, the delegate can decide if the current text contains a valid value and prevent the editing session from ending if it does not. When editing does finally end, you also use the delegate to get the resulting text value and update your app’s data model.
Because there are slight differences in their intended usage, the delegate methods for each text view are slightly different. A delegate that supports the
UITextField class implements the methods of the
UITextFieldDelegate protocol. Similarly, a delegate that supports the
UITextView class implements the methods of the
UITextViewDelegate protocol. In both cases, you are not required to implement any of the protocol methods, but if you do not, the text field or view is not as useful.
“Managing Text Fields and Text Views” describes the sequence of delegation messages for both text fields and text views and discusses various tasks performed by the delegates of these objects. For more information about the methods of the
UITextViewDelegate protocols, see UITextFieldDelegate Protocol Reference and UITextViewDelegate Protocol Reference.
Use Web Views to Display Web Content
A web view object displays web-based content. It is an instance of the
UIWebView class that enables you to integrate what is essentially a miniature web browser into your app’s user interface. The
In addition to displaying content, you can also use a web view object to gather input from the user through the use of web forms. Like the other text classes in UIKit, if you have an editable text field on a form in your web page, tapping that field brings up a keyboard so that the user can enter text. Because it is an integral part of the web experience, the web view itself manages the displaying and dismissing of the keyboard for you.
Figure 1-2 shows an example of a
UIWebView object from the UICatalog sample app, which demonstrates many of the views and controls available in UIKit. Because it just displays HTML content, if you want the user to be able to navigate pages much like they would in a web browser, you need to add controls to do so.
A web view provides information about when pages are loaded, and whether there were any load errors, through its associated delegate object. A web delegate is an object that implements one or more methods of the
UIWebViewDelegate protocol. Your implementations of the delegate methods can respond to failures or perform other tasks related to the loading of a web page.
“Displaying Web Content” describes how to display HTML and other content in a web view.