style

Discussion 議論

The style property controls length of the string representation of the name.

For example: 例えば：

var tlc = PersonNameComponents()
tlc.familyName = "Clark"
tlc.givenName = "Thomas"
tlc.middleName = "Louis"
tlc.namePrefix = "Dr."
tlc.nickname = "Tom"
tlc.nameSuffix = "Esq."


let longFormatStyle = PersonNameComponents.FormatStyle(style: .long, locale: Locale(identifier: "us_EN"))
print(tlc.formatted(longFormatStyle)) // Dr. Thomas Louis Clark Esq.
        
let mediumFormatStyle = PersonNameComponents.FormatStyle(style: .medium, locale: Locale(identifier: "us_EN"))
print(tlc.formatted(mediumFormatStyle)) // Thomas Clark
        
let shortFormatStyle = PersonNameComponents.FormatStyle(style: .short, locale: Locale(identifier: "us_EN"))
print(tlc.formatted(shortFormatStyle)) // Tom
        
let abbrevFormatStyle = PersonNameComponents.FormatStyle(style: .abbreviated, locale: Locale(identifier: "us_EN"))
print(tlc.formatted(abbrevFormatStyle)) // TC


let defaultFormatStyle = PersonNameComponents.FormatStyle(locale: Locale(identifier: "us_EN"))
print(tlc.formatted(defaultFormatStyle)) // Thomas Clark

The default value is PersonNameComponents.FormatStyle.Style.medium.

Styles スタイル

You can configure PersonNameComponents.FormatStyle to format names in the following styles:

PersonNameComponents.FormatStyle.Style.medium

The minimally necessary features for differentiation in a casual setting. ふだんの設定における識別のために最小限必要な機能性。

PersonNameComponents.FormatStyle.Style.short

Relies on user preferences and language defaults to display shortened form appropriate in space-constrained settings.

PersonNameComponents.FormatStyle.Style.long

The fully-qualified name complete with all known components.

PersonNameComponents.FormatStyle.Style.abbreviated

The maximally abbreviated form of a name. ある名前の最大限に省略された形式。

The following table demonstrates the style for various names and locales.

Long

The Long style provides the most explicit representation of names. It uses all available name components, with the exception of nickname. Long（長）スタイルは、名前の最も率直な表現を提供します。それはすべての利用可能な名前構成要素を使います、ニックネームを除いて。

Medium

The Medium, or default, style presents names in a way that is suitable for most contexts. It uses the given and family names, as well as a nickname, if provided, and enabled by the user.

Short

The Short style offers an alternative display method for names whose default representation may exceed a certain length constraint. Short（短）スタイルは、ある代替の表示方法を、省略時の表現が特定の長さ制約を超えるかもしれない名前に対して提案します。 Users customize how the system displays short names in the preferences for the Contacts app. For scripts that don’t support Short name, or cases where the specified Short style is unavailable, the format uses Medium style.

The table below shows the formatted string output for each Short Name configuration and for a variety of locales:

Abbreviated

The Abbreviated style offers the most compact representation of names, similar to a monogram. Abbreviated（省略）スタイルは、モノグラムのような、名前の最も簡潔な表現を提案します。

Abbreviated style is supported for names in several scripts, with the following general characteristics: Abbreviatedスタイルは、いくつかの書体での名前によってサポートされます、以下の一般的な特徴を持ちます：

• For names in Cyrillic, Greek, or Latin script, the first characters of givenName, middleName, and familyName may be used. キリル語、ギリシャ語、またはラテン語書体での名前に対して、givenName、middleName、そしてfamilyNameの最初の表意文字が使われるかもしれません。

• For names in Chinese or Japanese script, familyName may be used. If familyName is too long, or if the family name is nil, the Short or Medium style may be used instead. 中国語または日本語書体での名前に対して、familyNameが使われるかもしれません。familyNameが長すぎるならば、または姓がnilならば、ShortまたはMediumスタイルが代わりに使われるかもしれません。

• For names in Korean script, givenName may be used. If givenName is too long, the first character of givenName may be used. If givenName is nil, the familyName may be used instead. 朝鮮語書体での名前に対して、givenNameが使われるかもしれません。givenNameが長すぎるならば、givenNameの最初の表意文字が使われるかもしれません。givenNameがnilならば、familyNameが代わりに使われるかもしれません。

• For names in Bengali, Devanagari, Gujarati, Gurmukhi, Kannada, Malayalam, Oriya, Sinhala, Tamil, Telugu, Tibetan, or Thai script, the first character of givenName may be used. If givenName is nil, the first character of familyName may be used instead. ベンガル語、デーヴァナーガリー、グジャラート語、グルムキー文字、カンナダ語、マラヤーラム語、オリヤー語、シンハラ語、タミル語、テルグ語、チベット語、またはタイ語書体での名前に対して、givenNameの最初の表意文字が使われるかもしれません。givenNameがnilならば、familyNameの最初の表意文字が代わりに使われるかもしれません。

• For names that contain more than one script, the abbreviated style may use the familyName, givenName, or the first characters of givenName and/or familyName. １つ以上の書体を含む名前に対して、省略されたスタイルはfamilyName、givenNameを、またはgivenNameおよび／またはfamilyNameの最初の表意文字を使うかもしれません。

If the Abbreviated style is unavailable, the Short style is used instead—unless that too is unsupported, in which case the Medium style is used instead. Abbreviatedスタイルが利用可能でないならば、Shortスタイルが代わりに使われます — それがまたサポートされない場合を除いて、その場合にはMediumスタイルが代わりに使われます。