Fluent Özellikler

Her kontrolün her bindable özelliği, bir fluent genişletme metodu ailesi alır. Bu aileyi anlamak — her zaman aynı dört kalıptır — kütüphanenin tamamının kilidini açar; çünkü kalıp, source generator'ın işlediği üçüncü parti kontroller dahil tüm kontrollerde tekrarlanır.

Dört Overload Kalıbı#

Label.FontSize gibi bir özellik için kütüphane şunları sağlar:

// 1. Doğrudan değer — zamanın %90'ında kullandığınız
public static T FontSize<T>(this T self, double fontSize) where T : Label;

// 2. Property builder — binding'ler, tema/platform/idiom değerleri, dinamik kaynaklar
public static T FontSize<T>(this T self,
    Func<PropertyContext<double>, IPropertyBuilder<double>> configure) where T : Label;

// 3. Stil setter'ı — Style<T> tanımları içinde kullanılır
public static SettersContext<T> FontSize<T>(this SettersContext<T> self, double fontSize) where T : Label;

// 4. Builder'lı stil setter'ı — stiller içinde binding'ler vb.
public static SettersContext<T> FontSize<T>(this SettersContext<T> self,
    Func<PropertySettersContext<double>, IPropertySettersBuilder<double>> configure) where T : Label;

Ek olarak double, Color gibi tipteki özellikler bir animasyon yardımcısı alır (bkz. Animasyonlar):

Task<bool> AnimateFontSizeTo(double value, uint length = 250, Easing? easing = null);

3–4 numaralı kalıpları asla doğrudan çağırmazsınız; new Style<T>(e => e...) içinde özellik çağrısı yazdığınızda otomatik devreye girerler — aynı metot adları her iki bağlamda da çalışır.

Kalıp 1 — Doğrudan Değerler#

new Label()
    .Text("Bu bir test")
    .Padding(20)
    .FontSize(30)
    .Center()

Tüm metotlar T üzerinde generic olduğundan ve T döndürdüğünden, zincirleme somut kontrol tipini korur: .Text(...) sonrasında elinizde hâlâ bir Label vardır, Label'a özgü metotlar kullanılabilir kalır.

Kalıp 2 — Property Builder (e => e…)#

Lambda overload'u bir PropertyContext<TValue> alır (geleneksel adıyla e) ve sabit değer olmayan her şeyin kapısıdır:

Binding'ler#

new Label().Text(e => e.Path("UserName"));                       // BindingContext.UserName'e bağla
new Label().Text(e => e.Path("Value").Source(slider));           // başka bir kontrole bağla
new Label().Text(e => e.Path("Price").StringFormat("{0:C}"));    // biçimlendir
new Entry().Text(e => e.Path("Query").BindingMode(BindingMode.TwoWay));

Tüm binding yetenekleri (converter'lar, fallback değerleri, multi-binding, derlenmiş getter binding'leri) şu dokümanlarda: Özellik Bağlama, Binding Converter'ları, MultiBinding ve Derlenmiş Binding'ler.

Uygulama teması değerleri (`#

new Label()
    .TextColor(e => e.OnLight(Colors.Black).OnDark(Colors.Teal))

Tema her değiştiğinde değer canlı olarak güncellenir — kullanıcı işletim sistemi temasını değiştirdiğinde de, uygulama Application.Current.UserAppTheme atadığında da. Bu gerçek bir AppThemeBinding'dir, tek seferlik kontrol değildir (10.2.1 ve sonrası).

Cihaz idiom değerleri (`#

new Label()
    .FontSize(e => e.OnDesktop(80).OnPhone(30).Default(50))

Mevcut: OnPhone, OnTablet, OnDesktop, OnTV, OnWatch, Default.

Platform değerleri (`#

new Label()
    .Margin(e => e.OniOS(new Thickness(0, 20, 0, 0)).Default(new Thickness(0)))

Mevcut: OnAndroid, OniOS, OnMacCatalyst, OnWinUI, OnTizen, Default.

Dinamik kaynaklar (`#

new Frame()
    .BackgroundColor(e => e.DynamicResource("CardBackground"))

Özellik kaynak anahtarını takip eder: çalışma zamanında Resources["CardBackground"]'ı değiştirin, UI güncellenir.

Yerelleştirme#

new Label().Text(e => e.Translate("Hello"));        // JSON yerelleştirme
new Label().Text(e => e.TranslateResx("Hello"));    // RESX yerelleştirme

Bunlar da canlı binding'lerdir — Translator.Instance.ChangeCulture(...) çağrısı bağlı tüm özellikleri anında yeniden çevirir. Bkz. Yerelleştirme (JSON) ve Yerelleştirme (RESX).

Builder'ları iç içe kullanma#

Idiom/tema/platform builder'ları birleşir: her dal, ham değer yerine kendisi bir builder alabilir.

new Label()
    .TextColor(e => e
        .OnLight(Colors.Black)
        .OnDark(l => l.DynamicResource("DarkAccent")))   // karanlık tema dinamik kaynak kullanıyor

İç içe builder bir tema binding'i içinde taşınamaz; bu yüzden bu biçim, sayfa kurulurken geçerli olan temaya göre bir kez çözülür ve sonraki tema değişikliklerini takip etmez. Temanın çalışma anında değişmesi gereken yerlerde düz değer biçimini — .OnLight(x).OnDark(y) — kullanın.

Kalıplar 3–4 — Stillerin İçinde#

Aynı metot adları Style<T> tanımında da çalışır; orada canlı bir kontrole dokunmak yerine XAML Setter'ları üretirler:

new Style<Button>(e => e
    .TextColor(e => e.OnLight(Colors.White).OnDark(AppColors.Primary))
    .BackgroundColor(AppColors.Primary)
    .FontSize(14)
    .CornerRadius(8)
    .Padding(new Thickness(14, 10)))

Tam anlatım için bkz. Stiller.

Bilinmesi Gereken Kolaylık Kısayolları#

1:1 özellik eşlemesinin ötesinde kütüphane birleşik setter'lar ekler:

Ayrıca sıradan tipler üzerinde küçük yardımcılar vardır:

"#FF3366".ToColor()          // string → Color (hex; ToColorFromArgb / ToColorFromRgba varyantlarıyla)

Kapsanmayan Bir Şeyi Ayarlamak#

İki kaçış yolu asla tıkanmamanızı garanti eder:

InvokeOnElement — zincirin ortasında kontrole karşı rastgele kod çalıştırın:

new Entry()
    .Placeholder("Ad")
    .InvokeOnElement(entry => entry.ReturnCommand = someCommand)

Saf C# — view'lar sıradan nesneler olduğundan sonradan atama her zaman mümkündür:

var entry = new Entry().Placeholder("Ad");
entry.ReturnType = ReturnType.Done;

İlgili Konular#

• Özellik Bağlama — builder'ın binding yetenekleri derinlemesine
• Stiller — setters context
• Özel Genişletme Metotları — aynı dört kalıbı kendi özelliklerinize ekleyin