Biçimlendirme Kodu ve Eski Biçimi

Text can be represented by using a special character indicating a formatting of some kind followed by a unique character indicating the specific formatting to be used. In SpongeAPI, there are two different characters that are supported by default: the ampersand (&) and the section character (§).

Her iki biçimlendirme şeması da Minecraft Wiki’da bulunan kodları kullanmaktadır. Minecraft Wiki’nin yalnızca bölüm karakterinin (§) kullanımını görüntüler, ancak aynı kodların ampersand (&) ile de çalıştığı unutulmamalıdır.

Uyarı

Text serialization using any kind of formatting code is limited to representing only some of the capabilities of a Text, namely formatting. It cannot represent any kind of click or hover actions. If brevity is not an issue (as it is in Minecraft chat), it is recommended to use the JSON formatı.

Işareti ‘&’ biçimlendirmme

Varsayılan olarak, Sponge biçimlendirme karakterini & (ampersand) destekler. Ampersand biçiminin kullanılması kullanıcıların metin biçimlendirmesini daha kolay bir şekilde girmesini sağlar ve Minecraft sohbet konsolunda olduğu gibi kısalıkların gerekli olduğu durumlarda yararlıdır.

Bu biçimlendirmeyi kullanmak için ilgili dosyaya erişebilirsiniz TextSerializerTextSerializers#FORMATTING_CODE. Oradan, seriize veya deserialize yöntemlerini normal şekilde kullanabilirsiniz:

import org.spongepowered.api.text.Text;
import org.spongepowered.api.text.format.TextColors;
import org.spongepowered.api.text.format.TextStyles;
import org.spongepowered.api.text.serializer.TextSerializers;

Text text = Text.of(TextColors.RED, TextStyles.UNDERLINE, "Hello World!");
String ampersandFormattedText = TextSerializers.FORMATTING_CODE.serialize(text);

Örneğin, kırmızı renkle ve bir alt çizgiyle biçimlendirilmiş “Merhaba Dünya!” Metni, ampersan biçimlendirme koduyla şu şekilde temsil edilir: &c&nMerhaba Dünya!

Eski Biçimlendirme

Eski metin gösterimi, Minecraft’ın eski sürümlerinde yaygın olarak kullanılan ve bölüm karakteriyle (§) temsil edilen biçimdir. Sponge seri hale getirme ve seri hale getirme işlemini eski biçim kullanarak yalnızca uyumluluk için sağlar. Kesinlikle gerekmedikçe kullanılmamalıdır. Bunun yerine, ampersand ile biçimlendirmeyi yukarıda belirtildiği gibi kullanmanız önerilir. Eski biçimlendirme, ampersan biçimlendirmesinin sahip olmadığı birkaç sınırlamaya sahiptir; bunların arasında en açık olan şey, kullanıcıların sohbet bölüm karakterini kolayca yazamamalarıdır.

Bu biçimlendirmeyi kullanmak için, karşılık gelen TextSerializer’a erişebilirsiniz TextSerializers#LEGACY_FORMATTING_CODE. Oradan, `` serialize`` veya `` deserialize`` yöntemlerini normal şekilde kullanabilirsiniz:

Text text = Text.of(TextColors.RED, TextStyles.UNDERLINE, "Hello World!");
String legacyText = TextSerializers.LEGACY_FORMATTING_CODE.serialize(text);

Örneğin, kırmızı renkle ve bir alt çizgiyle biçimlendirilmiş “Merhaba Dünya!” Metni, eski biçiminde şu temsiliyete sahip olacak: §c§nMerhaba Dünya!

Tüyo

Kullanımı önerilmese de, aşağıdakileri arayabilirsiniz TextSerializers#formattingCode(char), yalnızca argüman olarak bir char alanından geçerek hangisini istediğiniz biçimlendirme karakterini kullanarak :javadoc: FormattingCodeTextSerializer alabilirsiniz.