Buton

Yaklaşık 4 dk okuma

TwButton · Kategori: Butonlar

Dokunmatik paneller

Butonun dokunmatik paneller için ayarları Dokunmatik Paneller sayfasında anlatılır:

• Kilit Nedeni: kilitli butona dokununca gösterilen metin.
• İki Adımda Uygula ve İkinci Basış Süresi (sn): değer yalnız ikinci basışta yazılır; bkz. İki adımda uygula.
• Rozet ve Rozet Sınıfı: sağ üst köşedeki sayı, ör. aktif alarm sayısı; bkz. Buton rozeti.
• Onay Gerektirir açıkken onay penceresi butonun başlığını taşır; bkz. Onay.
• onMouseDown ve onMouseUp kodu dokunmatik ekranda da çalışır; bkz. Olay kodu ve dokunma.

Ayarlar

Bu ayarlar widget seçiliyken sağ özellikler panelinde yer alır. Varsayılan değer, widget sayfaya ilk eklendiğindeki değerdir.

Değer / Yazma

Ayar	Tip	Varsayılan	Açıklama
Proses Değeri processValue	Değer (tip seçmeli)	true	Yazma/okuma için temel değer alanı. Durum Kaynağı Proses Değeri iken görünüm bu değere göre hesaplanır.
Eylem Modu actionMode	Seçim	write	Yaz: yalnızca Proses Değeri'ni yazar, Bağlantı: yalnızca bağlantı çalışır, Yaz ve Bağlantıya Git: önce yazar sonra bağlantı çalışır. Seçenekler: write Yaz, link Bağlantı, writeAndLink Yaz ve Bağlantıya Git

Davranış

Ayar	Tip	Varsayılan	Açıklama
Salt Okunur readOnly	Onay kutusu	Açık	Açıkken kullanıcı çalışma zamanında değeri değiştiremez.
İki Adımda Uygula twoStepApply	Onay kutusu	Kapalı	Yazma eyleminde ilk basış düğmeyi hazırlar (yanıp sönen çerçeve ve "Uygulamak için tekrar basın" yazısı); değer yazma, tıklama kodu ve bağlantı yalnız süre dolmadan yapılan ikinci basışta çalışır. Süre dolarsa, başka yere basılırsa, pencere odağı kaybolursa, sayfa gizlenir veya değişirse hazır durum hiçbir şey yazmadan biter. Onay Gerektirir de açıksa onay penceresi ikinci basıştan sonra yine açılır. Yalnız bağlantı açan veya değer Tag'i bağlı olmayan düğmelerde uygulanmaz. Butonun basma/bırakma (onMouseDown/onMouseUp) olay kodu bu seçenekten etkilenmez ve ilk basışta da çalışır.
Kilit Nedeni lockReason	Metin	—	İsteğe bağlı. Kontrol çalışma zamanında kilitliyken (Salt Okunur bir tag'e bağlı ve değeri doğru ya da kullanıcının yazma yetkisi yok) dokununca bu metin yetki mesajı yerine kısa süre gösterilir ve ipucu olarak da görünür. Örnek: "Kilitleme: kapı açık". Dil anahtarı yazılırsa çevrilir. Boş bırakılırsa davranış değişmez.
Onay Gerektirir needsConfirmation	Onay kutusu	Kapalı	Değer Tag'e yazılmadan önce onay sorulur.
İkinci Basış Süresi (sn) twoStepSeconds	Sayı (1–10)	3	İki Adımda Uygula açıkken ikinci basış için beklenen süre, saniye (1 ile 10 arası, varsayılan 3).

Etiketler / İkonlar

Ayar	Tip	Varsayılan	Açıklama
İkon icon	İkon	—	Otomatik: önce görseli (IconSrc), yoksa CSS sınıfı ikonunu kullanır. CSS Sınıfı: yalnızca sınıf ikonu. Görsel: yalnızca IconSrc (boşsa sınıf ikonuna döner).
İkon Konumu iconPos	Seçim	left	İkon her zaman metnin önünde gösterilir. Seçenekler: left Sol, right Sağ, top Üst, bottom Alt
İpucu hint	Metin	—	Çalışma zamanında fare widget üzerinde beklerken gösterilen ipucu metni.
Rozet badge	Metin	—	Sağ üst köşede küçük sayı; genellikle bir tag'e bağlanır, örneğin __activeAlarmCount sistem tag'i. Boş veya 0 iken gizlenir; 99'dan büyük sayılar 99+ görünür; metnin en fazla 4 karakteri gösterilir.

Görünüm

Ayar	Tip	Varsayılan	Açıklama
Stil Modu stylingMode	Seçim	outlined	Dolgulu düğmeyi renkle doldurur, Çerçeveli yalnızca kenarlık gösterir (varsayılan), Metin kenarlık ve arka plan göstermez. Seçenekler: contained Dolgulu, outlined Çerçeveli, text Metin
Tip type	Seçim	normal	Temadan gelen düğme rengi: Normal nötr, Varsayılan vurgu rengi, Başarılı yeşil, Tehlike kırmızı. Seçenekler: normal Normal, success Başarılı, default Varsayılan, danger Tehlike
Buton Sınıfı buttonClass	CSS sınıfları	—	Düğme öğesine eklenen CSS sınıfları.
Rozet Sınıfı badgeClass	CSS sınıfları	—	Rozete eklenecek CSS sınıfları; örneğin başka renk için bg-orange-500.

Diğer ayarlar

Ayar	Tip	Varsayılan	Açıklama
Enable Flashing enableFlashing	Onay kutusu	Kapalı	Bileşeni yanıp söndürür (saniyede bir saydamlık darbesi). Genellikle bir alarm koşuluna bağlanır.
Log Button logButton	Onay kutusu	Kapalı	Çalışma zamanında bileşenin üzerine gelince bir grafik ikonu gösterir; tıklanınca bileşene bağlı Tag'ler log Tag listesine eklenir.

Bağlantılar

Özellikler panelinin İlişkiler (Binding) bölümünde, Direct bağlantıda bir Tag bu widget'ın aşağıdaki özelliklerine bağlanabilir. Bağlantı tipleri (Direct, IntRange, FloatRange, Boolean, Bit) tüm widget'larda aynıdır; açıklamaları Widget Referansı sayfasındadır.

title, visible, authorization, x, y, width, height, rotation, class, foregroundColor, backgroundColor, borderColor, borderStyle, borderWidth, borderRadius, borderTopLeftRadius, borderTopRightRadius, enableFlashing, logButton, onClick, onMouseDown, onMouseUp, to.type, lockReason, readOnly, needsConfirmation, twoStepApply, twoStepSeconds, processValue, buttonClass, badge, badgeClass, hint, icon, iconPos, stylingMode, actionMode

Ortak bölümler

Bu widget seçiliyken özellikler panelinde şu ortak bölümler de görünür: Genel, Yerleşim, Görünüm, Yönlendirme (To), Olaylar, İlişkiler (Binding). Bu bölümler Sayfa Editörü sayfasında anlatılır.