Font Descriptor: şrift deskriptorunun əsas anlayışları və imkanları

Font Descriptor nədir və nə üçün lazımdır

Font Descriptor — şiftin xarakteristikalarını konkret şift faylı kimi deyil, açar-dəyər cütləri dəsti kimi təsvir edən obyektdir. Şifti adı ilə yaratmaq əvəzinə, tərtibatçı ailəni, üz şeklini, ölçünü və isteğə bağlı atributları təyin edir, sistem isə ən yaxşı uyğunluğu seçir. Bu yanaşma adaptiv tipoqrafiya üçün vacibdir: eyni deskriptor mövcud şiftlər dəstinin fərqli olduğu müxtəlif iOS versiyalarında işləyə bilər. iOS Human Interface Guidelines-ə görə, deskriptorlar vasitəsilə şift uyğunlaşdırması dinamik şiftlərlə işləmək üçün tövsiyə olunan üsuldur.

Font Descriptor olmadan tərtibatçı hər şiftin mövcudluğunu adı ilə yoxlamalı və əvəz variantları əl ilə təyin etməli olardı. Deskriptor bu prosesi avtomatlaşdırır: o, üz şkillərinin uyğunluq matrisasını ehtiva edir — normal, qalın, kursiv, qalın kursiv — və dəqiq uyğunluq olmadıqda ən yaxın mövcud olanı qaytarır. Sistem uyğunlaşdırması Core Text səviyyəsində işləyir və həm iOS, həm də macOS-da vahid NSFontDescriptor API vasitəsilə mövcuddur.

Deskriptorlar hççinin fərdi şiftlər üçün də istifadə olunur — Info.plist vasitəsilə yüklənmiş və ya əl ilə əlavə edilmiş. Əgər şift sistemdə qeydiyyatdan keçibsə, onun deskriptoru sistem şifti kimi eyni şəkildə yaradılır. Platformalararası qeyd: deskriptor konsepsiyası Android-də Typeface.Builder vasitƏsilə də mövcuddur, lakin iOS-un UIFontDescriptor vasitəsilə həyata keçirilməsi əhəmiyyətli dərəcədə daha çox atribut verir — Android-də 5-ə qarşı 20-dən çox.

Font Descriptor’ın əsas xüsusiyyətləri və atributları

UIFontDescriptor [UIFontDescriptor.AttributeName: Any] tipli fontAttributes lüğətində qruplaşdırılmış atributları ehtiva edir. Əsas atributlara şift ailəsi (family), adı (name), ölçüsü (size), üz şekli (traits), transformasiya matrisi (matrix), optik ölçü (opticalSize) və mətn stili (textStyle) daxildir. Apple WWDC 2019 Session 227-yə görə, mətn stillərinin — Dynamic Type — istifadəsi accessibility uyğun tətbiqlər üçün məcburidir.

Traits atributu — simvol xarakteristikalarını ehtiva edən lüğətdir: qalınlıq (UIFontWeightTrait), kursiv (UIFontSlantTrait), en (UIFontWidthTrait) və s. Bu dəyərlər şift uyəşdiricisi tərəfindən üz şeklinin seçilməsi üçün istifadə olunur. Məsələn, 0.0 dəyərində UIFontWeightTrait — normal üz şekli, 0.3 — qalın. Sistem çoxlu dəyərləri avtomatik olaraq mövcud şift variantlarına xəritələyir.

Əlavə atributlara OpenType xüsusiyyətləri (liqaturalar, kerning, rəqəm nisbətləri) üçün featureSettings, istifadəçiyə göstərmək üçün visibleName, şiftin afin transformasiyaları üçün matrix və ehtiyat şiftlərin kaskad siyahıları üçün cascadeList daxildir. Atributların tam siyahısı iOS və macOS-da tipoqrafiyanın bütün ssenarilərini əhatə edir.

Swift-də Font Descriptor vasitəsilə UIFont yaradılması

iOS-da Font Descriptor ilə işləməyin əsas üsulu — deskriptorun yaradılması və sonra UIFont-un generasiyası. Bu, dəqiq adı bilmədən müəyyən xüsusiyyətlərə malik şift əldə etmək lazım olduqda üstünlük verilən yanaşmadır. Proses iki addımdan ibarətdir: UIFontDescriptor-ın inisializator vasitəsilə yaradılması və deskriptorda font(withSize:) metodunun çağırılması.

import UIKit

// Ailə üçün şift deskriptoru yaradın
let descriptor = UIFontDescriptor.init(
    fontAttributes: [
        .family: "SF Pro",
        .traits: [
            .weight: UIFont.Weight.bold
        ]
    ]
)

// Deskriptordan UIFont yaradın
let font = descriptor.font(withSize: 17)

Bu yanaşma sistemin cari cihazda SF Pro-nun qalın üz şekli üçün ən yaxşı uyğunluğu seçəcəyini təmin edir. Əsas üstünlük — kod iOS versiyasından asılı deyil: iOS 13-də SF Pro, köhnə versiyalarda isə Helvetica Neue və ya standart sistem şifti istifadə olunacaq.

Dinamik ölçülü şift yaratmaq üçün mətn stili və miqyaslı inisializator istifadə olunur. Dynamic Type ölçünü avtomatik olaraq istifadəçi parametrlərinə uyğunlaşdırır:

// Dynamic Type deskriptoru
let bodyDescriptor = UIFontDescriptor
    .preferredFontDescriptor(withTextStyle: .body)

// Şifti qalın et
let boldDescriptor = bodyDescriptor.withSymbolicTraits([.traitBold])

// Dinamik ölçünü qoruyaraq UIFont yaradın
let boldBodyFont = UIFont(
    descriptor: boldDescriptor!,
    size: bodyDescriptor.pointSize
)

Vacib: withSymbolicTraits metodu isteğə bağlı deskriptor qaytarır — tələb olunan üz şekli mövcud deyilsə, nil qaytarılır. İstifadə etməzdən əvvəl həmişə opsionalı yoxlayın.

Atributların əlavə və dəyişdirmə yolu ilə modifikasiyası

Font Descriptor dəyişməz modeli dəstəkləyir — hər modifikasiya metodu dəyişdirilmiş atributla yeni deskriptor qaytarır. Bu dəyər semantikasına uyğundur və kodu proqnozlaşdırıla bilən edir: orijinal deskriptor heç vaxt dəyişmir. Əsas modifikasiya metodları: atributları əlavə etmək üçün addingAttributes, üz şeklini dəyişmək üçün withFace, ölçünü dəyişmək üçün withSize, afin transformasiya üçün withMatrix.

addingAttributes metodu — ən çevik olanı. O, atributlar lüğətini qəbul edir və yeni deskriptor qaytarır. Açarlar üst-üstə düşdükdə yeni dəyğrlər köhnələri əvəz edir. Bu, dəyişiklikləri birləşdirməyə imkan verir: çəkini artırmaq, ölçünü dəyişmək və liqaturaları bir çağırışla aktivləşdirmək. Apple Technical Q&A QA1682-yə görə, addingAttributes genişləndirmə vasitəsilə kütləvi modifikasiya üçün tövsiyə olunan üsuldur.

Praktik tətbiq: kod redaktorunda monospaced mətn üçün şift yaradılması. Tərtibatçı sistem monospace deskriptorunu götürür, nazik xətlər üçün azaldılmış çəki əlavə edir və featureSettings vasitəsilə hərflərarası boşluğu artırır. Bu, ayrıca şift yükləmədən daha oxunaqlı kod verir.

let monoDescriptor = UIFontDescriptor.monospacedDigitFontDescriptor()

// Fərdi atributlar əlavə edin
let customDescriptor = monoDescriptor.addingAttributes([
    .size: 14,
    .traits: [
        .weight: UIFont.Weight.medium
    ]
])

let monoFont = UIFont(
    descriptor: customDescriptor,
    size: 14
)

Məhdudiyyət: bütün atributlar deskriptor yaradıldıqdan sonra dəyişdirilə bilməz. Məsələn, şift ailəsi (family) inisializasiya zamanı bir dəfə təyin edilir. Ailəni dəyişmək lazımdırsa, yeni deskriptor yaradın. Bu, Core Text arxitekturası ilə bağlıdır, burada deskriptor konkret şift resursuna bağlıdır.

Şift uyğunlaşdırması və sistem şiftlərinin axtarışı

Şift uyğunlaşdırması — Font Descriptor-un əsas funksiyasıdır, quraşdırılmış şiftlər arasından tələb olunan atributlara ən yaxşı uyğunluğu avtomatik seçir. Proses üç mərhələdən ibarətdir: filtrləmə (uyğunsuz şiftlərin kənarlaşdırılması), sıralama (uyğunluq dərəcəsinə görə çeşid) və seçim (ən yaxşı nəticənin qaytarılması). Uyğunlaşdırma Core Text səviyyəsində yerinə yetirilir — bu, bütün iOS tipoqrafiyasının əsasında duran çərçivədir.

Deskriptora uyğun bütün şiftləri axtarmaq üçün matchingFontDescriptors metodundan istifadə olunur. O, uyğunluğa görə sıralanmış deskriptorlar massivi qaytarır. Tərtibatçı dəqiq uyğunluğu (birinci elementi) seçə və ya fərdi məntiq üçün variantları nəzərdən keçirə bilər. Apple Font Handling Guide-ə görə, bu, müəyyən ailə üçün mövcud üz şkillərinin siyahısını adla sadalamadan əldə etməyin yeganü üsuludur.

İstifadə ssenarisi: mətn parametrləri interfeysində şift seçimi. İstifadəçi ailəni seçir və tətbiq matchingFontDescriptors vasitəsilə bütün mövcud üz şkillərini əldə edərək onları picker-də göstərir. Uyğunlaşdırma olmadan iOS versiyaları arasında dəyişən variantların siyahısını sərt kodlaşdırmaq lazım gələrdi.

let searchDescriptor = UIFontDescriptor.init(
    fontAttributes: [.family: "SF Mono"]
)

// Bütün mövcud üz şkillərini əldə edin
let matchingDescriptors = searchDescriptor
    .matchingFontDescriptors(withMandatoryKeys: nil)

for descriptor in matchingDescriptors {
    print(descriptor.object(forKey: .visibleName) ?? "unnamed")
}

Mandatory keys — axtarışı məhdudlaşdıran parametr. [.family] göstərilərsə, uyğunlaşdırma göstərilən ailənin bütün şiftlərini qaytarır. [.family, .traits] göstərilərsə — yalnız ailəyə və üz şeklinə uyğun olanları. Mandatory keys istifadəsi şift alt dəstini axtararkən uyğunlaşdırmanı sürətləndirir.

Məhsuldarlıq: uyğunlaşdırma iOS-da 0.5 ilə 5 ms arasında çəkən sinxron əməliyyatdır. Tək axtarış üçün bu nəzərə çarpmır, lakin deskriptorların kütləvi nəzərdən keçirilməsi zamanı (məsələn, 50+ şiftli picker-də) nəticələrin keşlənməsi tövsiyə olunur. Apple ekran yüklərkən uyğunlaşdırmanı bir dəfə yerinə yetirməyi və deskriptorlar massivini saxlamağı tövsiyə edir.

Core Text və CTFontDescriptor ilə inteqrasiya

Core Text — iOS və macOS-da tipoqrafiya ilə işləmək üçün aşağı səviyyəli C çərçivəsidir. Onun UIFontDescriptor analoqu — CTFontDescriptor Core Foundation səviyyəsində eyni imkanları təmin edir. CTFontDescriptor Core Text API-də şift yaratmaq, mətni ölçmək və mürəkkəb tipoqrafiyanı göstərmək üçün istifadə olunur. UIFontDescriptor mahiyyətcə CTFontDescriptor üzərində genişləndirilmiş atribut dəsti ilə Objective-C örtüyüdür.

UIFontDescriptor və CTFontDescriptor arasında Toll-free bridging deskriptorların UIKit və Core Text arasında çevirmə olmadan ötürülməsinə imkan verir. Bu, fərdi mətn renderinqindən istifadə edən tətbiqlər — məsələn, TextKit əsaslı mətn redaktorları və ya sintaksis vurğulamalı kod redaktorları üçün vacibdir. Nümunə: CTFontDescriptorCreateCopyWithAttribute əlavə edilmiş atributla deskriptorun surətini yaradır — UIFontDescriptor-dən addingAttributes-in analoqu.

CTFontDescriptor-da kCTFontURLAttribute açar atributu şift faylının URL-ni ehtiva edir. Bu, şiftin sistem və ya fərdi olduğunu müəyyən etməyə imkan verir. Fərdi şiftlər üçün URL şift faylına (.ttf və ya .otf) aparır, sistem şiftləri üçün isə sistem şift qovluğuna. Deskriptor vasitəsilə məlumatlar yalnız oxumaq üçündür; URL vasitəsilə şift faylının dəyişdirilməsi dəstəklənmir.

Qabaqcıl tipoqrafiya — fərdi liqaturalar, kontekst dəyişdirmələr, alternativ gliflər — üçün kCTFontFeatureSettingsAttribute açarı ilə CTFontDescriptorCopyAttribute istifadə olunur. Bu atribut deskriptor vasitəsilə əlavə edilə bilən OpenType xüsusiyyətlərinin lüğətlər massivini ehtiva edir. Apple Core Text Programming Guide-ə görə, UIFontDescriptor və Core Text-in birləşdirməsi tətbiqin tipoqrafiyası üzərində tam nəzarət verir.