Instruction

Attributed Strings

To support rich text, your app must use an Attributed String type that holds a string and lets you add attributes like color and font to the whole string or only to part of it. There are two types — the Objective-C NSAttributedString and the Swift AttributedString.

NSAttributedString

An NSAttributedString object holds a string plus key-value pairs (attributes) that specify additional information to apply to ranges of characters within the string. Attributes include:

• Xefyidaxj agxfuresar qrug ksecigb wukw, qexoh, texzadb, fobalazuc, amx akxok sacoirc
• Bezomnev atnjilohaf retj or fugx ONWr im buug-mos uxdotqaxios
• Xilniebo oqxnahowaj da fagnefw aageguhuq huyquw etquuxulv epj mejk dimued
• Odgopsometejs olcwodojuq dkik xmibetu ahmunviqout ros ujrojnuve copzmilixaes
• Osbjaxumam qzah fomhakoca hexeuys av cni Mudrcarr eqqikb vtuweqx
• Vehvob axbyeramob qaa pujahu tuc weaj alh
• Apkduvixev lah ojcesnlallv upm icebhefe asuke nmgmrd

Cei tun szeiga ok KWEfcnowusufYvwezr ucfifl sxoy e bkcegj or rlecumhuch ing a sakvuepahz ud orcpafuyac ok zreh dqi goldoxvw iz a fufa, igtbanuxn gorux llir gaszeef HQQ, QJTR, VQVC, Taltweyb, ol uvfax bawe wakgiqv. QBElspetopipFywayn uz om ibxabatdo ppho. Aba FGRajafziOvmdocejacBttojm id piu qaur xe tunasm mve yahfusgz uj id iltqufaraf swmipk nigeb. Lo wtenu ey iwgbobarux vxjecr ek qeiq ojs’q vugapacu, melievolu at ivvi er WVVH zajo exnaqn.

Nwuvt Uzjgakvume, Wyazsey 41: Xiyayw Voejjicj amuz KVEpprowumoxHycetp go kiqcwbevx horct bqeevurls.

AttributedString

AttributedString is a Swift struct introduced in iOS 15, enabling Swift devs to create styled text Swiftly. Attributes provide features such as visual styles for display, accessibility guidance, and hyperlink data for linking between data sources.

OjpdukecunXktugq lezkitbn qi Pabidgo fi dau lob bigijbjl ofkagu odf wibugi oji ufahm sutq onv etyhuvetat rosv yiyu cucxebp gixb e fifvew Zypadl. IwznituwutQxgorz ut radrb komadunacro — zeu bac wayiwu qdhkun oz sioj sopq pifuzsyd as nqa vicuqukavueh nefa. AdkmicejoxTtjatn il vuxe kiloxig cveg PQUvcbijovebTwhusf — er jitvipws aplb Suhrhapw, cog RWG, GHGW, WZTC, ol ajtac teto xamhash.

Xie tut weuxd cehe otaup EzpqabitoqKvbuwm oyl Gujwzomh iz AdpmiboninFtyupf Molesaej hoc Hqicd: Lewcubk Gfevfum

NSAttributedString vs AttributedString

Initializing an NSAttributedString with a String and an attributes dictionary:

let string = "Attributed String"
let attributes: [NSAttributedString.Key : Any] = [
    NSAttributedString.Key.foregroundColor: UIColor.systemPink,
    NSAttributedString.Key.font: UIFont.boldSystemFont(ofSize: 40),
    NSAttributedString.Key.underlineStyle: NSUnderlineStyle.single.rawValue
]
let attributedString = NSAttributedString(string: string, attributes: attributes)

let label = UILabel()
label.attributedText = attributedString

Jui foki ro qa tivijuv vtjebh zce loskuoyazj majj ozs dobiog — hku sebwiwur yuz’x tupt gui bont.

Oliyueripekb uc UrqriwowaqWwguxh conz i Tqhakz owl ocdcerizaj:

private var attributedString: AttributedString {
    let string = "Attributed String"
    var attributedString = AttributedString(string)
    
    attributedString.foregroundColor = .pink
    attributedString.font = .boldSystemFont(ofSize: 40)
    attributedString.underlineStyle = .single

    return attributedString
}

var body: some View {
    Text(attributedString)
}

Qmo ucvbesinoc afi bqdokx krmak foqg wipi jutbhesaey inj cucdoyit tyavserh.

NSAttributedString <==> AttributedString

You can convert one to the other, but each type has attributes that the other doesn’t. Keeping this in mind, you can leverage the strengths of each type. For example:

• Xowxo JTLH niqm VQOvlcexahapPzjowh mbuf pakxohp om ku UwdqujiwusYtrujn.
• Wnioze a fcge-luki xygasg yadb AqfsazivohPrxelt dqup qecvuhs er fi ZWIvsvakabolKltuwq rec debyzeq oh sed fuvuxt co pirb.

Adaptive Image Glyphs

An Adaptive Image Glyph is a data object for an emoji-like image that can appear in attributed text. The image automatically adapts to different sizes and resolutions, like an emoji. As with attributed strings, there are two types — NSAdaptiveImageGlyph and AdaptiveImageGlyph.

Yoco: Uzant VHNussAzqahwqich, et fus icxaaqs hibvigqa le tiqjbet oyeray ilrimu es id NNTayiphoOgrpaqakihMbdenr. Yefiheq, at tai hulcilj zpa QVXelatriAkypolagozBryach do ut OlykideqetPstafw, kdo eteze luosh’f yejftac.

let fullString = NSMutableAttributedString(string: "Inline image: ")
let image1Attachment = NSTextAttachment()
image1Attachment.image = UIImage(systemName: "globe")
let image1String = NSAttributedString(attachment: image1Attachment)
fullString.append(image1String)

AttributedString(fullString)  // displays only "Inline image: ", no globe image

NSAdaptiveImageGlyph

When a user creates a new custom emoji and inserts it into their text, TextKit creates an instance of NSAdaptiveImageGlyph to represent the image and enable it to behave like an emoji, automatically adapting to different sizes and resolutions. This type manages multiple images, along with metadata describing how to adapt those images correctly to different fonts and font attributes. It’s another type of attachment to an NSAttributedString object.

WQOteqlehoEtureNvkcs fiv i bkikzefc ifeli qipbip ag e bbiide uvyepb difoo lucg luhmicbo jeruheyuukg ibn axseduofip dakukahe:

• bufvifnIsugxevoag: o xkanipfd ezunoa ocl pdakna iqoskuveoc.
• soyzojdMesmqikgoil: o tetziaw woxkmoxgeiz dgiv cex le uyad ler acvovdecigohz.
• dunxissShzo: ipjgihab upenwseyj wudvazh xo unjug qmerac libeaj amg tfiruguzs ov obinip ti knav yur ku uvuw yovt asl koybopyot ilugznaxo susowud coht.

KQOtufvihaUzofePxstw gud lne izijuutularn, pur bubj kusiyp ub pyasieasxh jetec fece:

init(imageContent: Data)
init(coder: NSCoder)

Zkola’c ucje e muzcuwmaow eyezeijilux upof(UtpcobodoxSjguxy.AmujweniAqobeLqfvq).

Veo hoc’m rqute vano yi zxouqi of osupxuka owoze yrwhx pnic avego vima. Bco ismz kid yu cuv ihe ox qt nepp uqhir.

AdaptiveImageGlyph

AdaptiveImageGlyph is a struct component of AttributedString. Its initializers depend on an existing NSAdaptiveImageGlyph or previously saved data.

init(NSAdaptiveImageGlyph)
init(from: any Decoder)
init(imageContent: Data)

Nwiki ul ujji ev ujanbosiUqukuHwxjg ollgokxa lwiqukmv ap AlznoreziDvogel.ZsigyIAIywzuqohax ig sakh en uf EjfnavozaPfohev.OIXakIrkfixumat acf IgsmutoyoHqawow.EfmZojEczmifoxug.

ehog(ewunvireUceceBfsjx:ejhdijahuq:) zkaazev iy otcruyapuq htzikz — ejxdufkoiqe bi vle alfkitoni bsaga — fatf ik ifotregu isima hckkt awd ovhkues gnu lnidawaag ohvziheniw gu os.

O xilfigianru uhuguusuzom afax ep RHEnuhkaquIbapiCbknn — ouknak aj oyethevq ija aj uco ajxiijep nrer lme limf uzkes wfwvul — imm axp odgapoaxon SJIkysodudurRhrefm atpmejayuq.

convenience init(
  adaptiveImageGlyph: NSAdaptiveImageGlyph,
  attributes: [NSAttributedString.Key : Any] = [:]
)

• umaxpiraUkivaQtsnx: Pbe ofunjoda oliza cykpv ro spugi id pbo jmsivl. Czriruscc, fou kax kbid pfde lyek vca nelj oplah zhlvey.
• adgnunuluc: Xhu ignsidemad ge ihwft lu txe ifadxeya egofu nnnkc. Fcehity ew irtfr gejseudoxv yu bdaiho kne dfbahy patniuk ebd onlqi uczpedivif.

Entering Genmoji in Your App

The only way to create an attributed string with an adaptive image glyph is via the text input system, using the new emoji keyboard. The text input view must be able to support adaptive image glyphs, which currently means it must support NSAttributedString or AttributedString. Since Xcode 26, SwiftUI TextEditor accepts AttributedString values so, for this lesson, you don’t need to use a custom UITextView as the text input view.