Extension:Page Forms/Giriş türleri
Bu sayfa, Page Forms'da bulunan çeşitli giriş türlerini ve bunlar için ayarlanabilen parametreleri ve diğer özelleştirmeleri kapsar.
Giriş türleri
text
Varsayılan giriş türü; HTML "metin" girişine karşılık gelir.
Özel parametreler:
size=boyut
|
Girişin genişliğini karakter cinsinden belirtir. |
maxlength=maksimum uzunluk
|
Girişin izin verilen maksimum uzunluğunu belirtir. |
placeholder=yer tutucu metin
|
Kullanıcı tıklatana kadar girişte görüntülenen yardım metnini belirtir. |
autocapitalize=value
|
the autocapitalize parameter in the corresponding HTML tag to whatever value is set for this parameter; examples include on, off, sentences, etc.
|
textarea
HTML <textarea> etiketine karşılık gelir.
Özel parametreler:
rows=num satırları
|
Satır sayısını belirtir. |
cols=num sütunları
|
Sütun sayısını belirtir. |
maxlength=maksimum uzunluk
|
Girişin izin verilen maksimum uzunluğunu belirtir. |
autogrow
|
Metin alanını, yüksekliğini içeriğinin yüksekliğine uyacak şekilde "otomatik olarak büyütecek" şekilde ayarlar, böylece bir kaydırma çubuğuna gerek kalmaz. |
editor=düzenleyici türü
|
İçeriğini daha kullanıcı dostu hale getirmek için metin alanına JavaScript tabanlı bir düzenleyici ekler. Aşağıdaki değerler desteklenmektedir:
|
max height=maksimum yükseklik
|
VisualEditor kullanılıyorsa, VE autgrow kullandığından metin alanı için maksimum yüksekliği (piksel cinsinden) belirtir. Varsayılan olarak bu değer 400'dür. The default value for this is set by the variable $wgPageFormsVisualEditorMaxHeight, which by default is 400.
|
placeholder=yer tutucu metin
|
Kullanıcı tıklatana kadar girişte görüntülenen yardım metnini belirtir. |
Otomatik tamamlamayla metin, metin alanı otomatik tamamlamayla
These were formerly real input types, but have been aliases for "combobox" or "tokens" (depending on whether the input holds a list of values, or just one) since version 5.0.
combobox
"Comboox" giriş türü bir combo box arabirimi sağlar: normal bir otomatik tamamlama alanı gibi işlev gören, ancak açılır listeninki gibi ek bir aşağı ok simgesi olan bir girişi, kullanıcı tüm mevcut değerleri aynı anda görür. [$url Select2] JavaScript kitaplığı kullanılarak uygulanır.
Özel parametreler:
size=boyut
|
Girişin genişliğini karakter cinsinden belirtir. |
height=height
|
Specifies the height of the combo box, in pixels. |
existing values only
|
Alandaki rastgele değerlere izin vermez. |
placeholder=yer tutucu metin
|
Kullanıcı üzerine tıklayana kadar girişte görüntülenen yardım metnini belirtir. |
tokens
Bu girdi türü, alandaki değerleri "tokenizes" haline getirir, yani her bir değerin etrafına bir blok koyar ve onu yalnızca bir karakter dizisi yerine tek bir birim haline getirir. Bu "tokens" daha sonra yeniden düzenlenebilir. "combobox" gibi, bu girişi Select2 JavaScript kitaplığı kullanılarak gerçekleştirilir.
Özel parametreler:
size=boyut
|
Girişin genişliğini karakter cinsinden belirtir. |
max values=maksimum değerler
|
İzin verilen maksimum değer sayısını belirtir. |
existing values only
|
Alandaki rastgele değerlere izin vermez. |
placeholder=yer tutucu metin
|
Kullanıcı tıklatana kadar girişte görüntülenen yardım metnini belirtir. |
Varsayılan olarak, "tokens" tek satırlı bir girdi olarak görünür ve daha fazla değer eklendikçe gerekirse dikey olarak genişler.
Bazı durumlarda, genişleyeceğini kullanıcılara daha açık hale getirmek için, bu girişinin başladığında bir satırdan daha uzun görünmesini isteyebilirsiniz.
Bunu tek bir giriş için yapmak için, alan etiketine "|class=ClassName" gibi bir class parametresi ekleyin, ardından MediaWiki:Common.css ile aşağıdakine benzer bir şey ekleyin:
.ClassName, .ClassName .select2-choices {
min-height:60px;
}
Bunun vikideki tüm "tokens" girişlerine uygulanmasını istiyorsanız, bunun yerine MediaWiki:Common.css ile şöyle bir şey ekleyin:
#pfForm .select2-container-multi .select2-choices {
min-height: 60px;
}
radiobutton
"radiobutton" girişi HTML "radio" girişine karşılık gelir. Kullanıcının yalnızca birini seçebileceği bir dizi değeri gösterir.
Varsayılan olarak, ilk radyo düğmesi değeri "None" ve kullanıcının boş bir değer seçmesine izin verir. "None" görünmesini önlemek için, alanı "mandatory" yapmanın yanı sıra izin verilen değerlerden birini alanın "default=" değeri yapmalısınız.
dropdown
"dropdown" giriş, HTML <select> etiketine karşılık gelir. Kullanıcının yalnızca birini seçebileceği bir açılır değerler listesi gösterir.
checkboxes
"checkboxes" girişi, kullanıcının herhangi bir sayıda değer seçmesine izin veren onay kutularını görüntüler.
Belirli bir sayıdan fazla onay kutusu varsa, "Tümünü seç" ve "Hiçbirini seçme" bağlantıları otomatik olarak onay kutuları kümesinin üzerinde görünerek kullanıcıların tümünü veya hiçbirini otomatik olarak işaretlemelerine olanak tanır.
Bu sayı $wgPageFormsCheckboxesSelectAllMinimum değişkeni tarafından belirlenir, varsayılan olarak 10'dur, ancak LocalSettings.php içinde değiştirilebilir.
Özel parametreler:
hide select all
|
Değerlerin sayısına bakılmaksızın bu giriş için "Tümünü seç" ve "Hiçbirini seçme" bağlantılarını gizleyin |
show select all
|
değerlerin sayısına bakılmaksızın bu giriş için "Tümünü seç" ve "Hiçbirini seçme" bağlantılarını görüntüleyin |
listbox
"listbox" girişi, "multiple" özniteliği eklenmiş HTML <select> etiketine karşılık gelir. Kullanıcının herhangi bir sayıda değeri seçebileceği dikey bir seçenek listesi gösterir.
Özel parametreler:
size=boyut
|
Liste kutusunun yüksekliğini belirtir. |
tree
"tree" giriş türü, alanın bir veya daha fazla öğeyi tutup tutamayacağına bağlı olarak tüm değerlerin yanlarında radiobuttons veya checkboxes olduğu hiyerarşik, ağaç tarzı bir girişe izin verir. Değerler, viki içindeki bir kategori ağacından gelebilir veya form tanımında manüel olarak ayarlanabilir.
Bu giriş, bir veya daha fazla değeri tutup tutamayacağını nasıl anlar ve bu nedenle radyo düğmelerini ve onay kutularını görüntülemelidir? Şablondaki alanın bir değerler listesi tutuyor olarak tanımlanıp tanımlanmadığını (#arraymap kullanarak) kontrol eder. Yine de bu kontrol mükemmel değil. tree girişi checkboxes yerine radiobuttons gösteriyorsa, bunun bir liste olduğunu belirlemek için form tanımındaki alan etiketine "|list" parametresini eklemeniz yeterlidir.
Değerlerin kaynağına bağlı olarak, şu iki ek parametreden birini belirtmeniz gerekir:
top category=- kategorinin adını "ağacın" tepesine ayarlar.structure=- tüm ağaç yapısını ayarlar; derinlik seviyesini ayarlamak için vikimetin tarzı madde işaretleri kullanmalısınız.
"structure" parametresini kullanırsanız, aşağıdaki gibi görünmelidir:
{{{field|Location|input type=tree|structure=*Universe
**Milky Way Galaxy
***Solar system
**Andromeda Galaxy
...etc.
}}}
Ayrıca isteğe bağlı olarak şu parametreleri de ayarlayabilirsiniz:
height=- ağacın içinde göründüğü kutunun yüksekliğini piksel cinsinden ayarlar.width=- ağacın içinde göründüğü kutunun genişliğini piksel cinsinden ayarlar.delimiter=- alan bir değerler listesi içerebileceği zaman sınırlayıcıyı ayarlar. Varsayılan ','.hideroot- üst kategorinin adını gizler.depth=- başlangıçta gösterilen üç seviyenin sayısını ayarlar. Varsayılan 10.
Bu giriş türünü burada kullanan örnek bir form görebilirsiniz.
Kategori adları için
Bir kategori ağacını görüntülemek için "tree" giriş türünü kullanıyorsanız, bu girişin önünde "Kategori:" ad alanı olmadan yalnızca seçilen kategorilerin adlarını yazdıracağını unutmayın; bu nedenle, bunun sayfada da görünmesini istiyorsanız, şablonun onu eklemesi gerekecektir.
Alan birden fazla kategori belirtiyorsa ve şablon bunu yapmak için #arraymap kullanıyorsa, #arraymap çağrısı şunun gibi görünmelidir:
{{#arraymap:{{{Categories|}}}|,|x|[[Category:x]] |<nowiki> </nowiki>}}
...başka bir deyişle, kategori etiketleri arasına virgül yazdırmaktan kaçınmak için #arraymap için son "delimeter" parametresini belirtmeniz ve onu boşluk veya benzeri bir şey yapmanız gerekir.
checkbox
Boole değerleri için kullanılan tek bir onay kutusu.
Özel parametreler:
label=
|
bu onay kutusu için bir <label> etiketine gidecek bir "etiket" belirtir. |
date
Bu giriş, yıl, ay ve gün için üç ayrı giriş içerir.
datetime
"datetime" girişi "date" girişine benzer, ancak saat, dakika, saniye ve ÖÖ/ÖS için ek girişler içerir.
Özel parametreler:
include timezone
|
bir saat dilimi girişinin de dahil edilmesi gerektiğini belirtir. |
year
"year", bir tarih alanı için yalnızca yıllık bir değer elde etmek için kullanılan basit bir metin girişidir.
datepicker
"datepicker", kullanıcının JavaScript tabanlı bir açılır pencere takvimi yardımıyla bir tarih seçmesine izin verir.
Special parameters:
date format=
|
sets a custom date format, used only for the input field. An example would be DD-MM-YYYY.
|
first date=
|
sets the first date the user is allowed to select. |
last date=
|
sets the last date the user is allowed to select. |
The starting day of the week (e.g., Saturday, Sunday or Monday) is set based on the language of the wiki; it unfortunately cannot be set independently of the language. If your wiki is in English and you would like weeks in the calendar input to start on Monday instead of Sunday (which is the default), you can do that by setting your wiki's language to be "en-gb" instead of "en".
datetimepicker
"datetimepicker", "datepicker" ile çok benzeyen JavaScript tabanlı bir girdi türüdür, ancak hem tarih hem de saati seçmek için açılır pencereler içerir.
Varsayılan olarak yyyy/mm/dd hh:mm şeklindedir.
Parametre seti, aşağıdakilerin yanı sıra tümü "datepicker" ile içerir:
mintime=
|
izin verilen minimum süre |
maxtime=
|
izin verilen maksimum süre |
interval=
|
kullanıcıya gösterilen seçenekler arasındaki aralık (dakika cinsinden) |
rating
"rating" giriş türü, kullanıcının bir derecelendirme girmesine izin vermek için bir dizi yıldız görüntüler.
Özel parametreler:
star width
|
her yıldızın genişliğini (ve yüksekliğini) belirtir. Varsayılan 24px. |
num stars
|
görüntülenecek yıldız sayısını belirtir. Varsayılan 5'tir. |
allow half stars
|
kullanıcıların yarım yıldız seçmesine izin verin. Varsayılan yanlıştır; true yapmak için 'yes' (veya başka bir değere) ayarlayın. |
googlemaps, leaflet, openlayers
"googlemaps", "leaflet" ve "openlayers" girdi türleri, sırasıyla Google Maps, Leaflet veya OpenLayers hizmetlerini kullanarak bir koordinat değeri elde etmek için bir harita görüntülemenizi sağlar.
"googlemaps" girişini kullanıyorsanız, bir Google Haritalar API anahtarı almanız ve ardından girdinin görüntülenmesi için $wgPageFormsGoogleMapsKey ayarıyla LocalSettings.php olarak ayarlamanız gerekebilir.
Bu giriş türleri için isteğe bağlı olarak şu parametreleri de ayarlayabilirsiniz:
height=
|
haritanın yüksekliğini piksel olarak ayarlar. |
width=
|
haritanın genişliğini piksel olarak ayarlar.
Both height and width are needed together to set the dimension.
|
starting bounds=
|
görüntülenen haritanın sınırlarını ayarlamak için bir çift koordinat alır; bu parametre yalnızca girişin bir değeri yoksa geçerlidir. (Bu parametre için örnek değer: "-20,-15;50,55".) |
"leaflet" giriş türü bir ek parametreye izin verir:
image=
|
coğrafi bir harita yerine, belirtilen resmi (vikiye yüklenmiş bir resim olmalıdır) harita için arka plan olarak ayarlar. |
Tüm harita girişleri, koordinatları daha kolay bulmak için bir adres girmenize izin verir. Ancak form, adresi girmek için zaten bir veya daha fazla alan içeriyorsa, kullanıcının iki kez girmesi gerekebilir. Birincisi verileri gerçekten saklamak için ve ikincisi koordinatları bulmak için. Kullanıcıların bu ikili işi yapmak zorunda kalmasını önlemek için, adres alanlarının, noktayı bulurken değerlerini doğrudan haritaya beslemesini sağlayabilirsiniz. Bunu "feeds to map=" parametresini kullanarak yapabilirsiniz. "feeds to map" ile burada arayın.
Varsayılan olarak bu biçimlerin tümü harici JavaScript koduna dayanır. Ancak, yalnızca OpenLayers uzantısını yükleyerek "openlayers" biçiminin bunun yerine yerel JavaScript kodunu kullanmasını sağlayabilirsiniz.
Devre dışı bırakma
Bu giriş türlerinin hepsinin vikinizin verilerini (yani, sorgu sonuçlarında bulunan verileri) harici hizmetlere gönderdiğini unutmayın. Bunlar, Page Forms kodunun, dış değerlerde otomatik tamamlama dışında harici olarak veri gönderen tek kısmıdır, ancak bunun çalışması için ek yapılandırma gerektirir. Özel bir vikiniz varsa ve veri çıkmaması konusunda çok endişeliyseniz, aşağıdakileri LocalSettings.php ile eklemek isteyebilirsiniz:
$wgPageFormsDisableOutsideServices = true;
Bu, herhangi bir dış hizmetin Page Forms tarafından kullanılmasına izin vermeyecektir. Bu, şu anda bu üç giriş türünü devre dışı bırakmak anlamına gelir.
regexp
"regexp" giriş türü gerçek bir girdi türü değil, daha ziyade ek, düzenli ifade tabanlı doğrulama ile başka bir girişi (çoğunlukla "metin") görüntüleme yeteneğidir. Bu giriş türü ve parametrelerinin daha ayrıntılı açıklaması için buraya bakın.
Veri türleri için izin verilen giriş türleri
Tanımlanmış her bir veri türü, Cargo veya Semantic MediaWiki kullanılırken, varsayılan bir giriş türüne ve uygun olduğunda varsayılan bir giriş boyutuna sahiptir. Ek olarak, alan yalnızca "tek bir değer" yerine sınırlandırılmış bir değerler listesi içeriyorsa, bazı veri türleri özel işlemeye sahiptir.
Her veri türü için varsayılanlar ve diğer izin verilen giriş türleri, tek değerler için:
| Cargo veri türi | SMW veri türü | Varsayılan giriş türü | Varsayılan boyut | İzin verilen diğer giriş türleri |
|---|---|---|---|---|
| Page | Page | combobox | 35 | text, dropdown, textarea, tree |
| String | N/A | text | 35 | combobox, textarea |
| Text | Text, Code | textarea | 5 x 30 | text |
| URL | URL | text | 100 | textarea |
| Integer, Float | Number | text | 10 | textarea |
| Date, Start date, End date | Date | date | datetime, year, datepicker | |
| Datetime, Start datetime, End datetime | N/A | datetime | datetimepicker, date, year | |
| Boolean | Boolean | checkbox | dropdown, radiobutton | |
| Coordinates | Geographic coordinate | openlayers | googlemaps, leaflet | |
| Rating | N/A | rating | ||
| Enumeration (izin verilen değerlerin listesini içeren herhangi bir Cargo alanı) | Enumeration ("izin verilen değerler" tanımlı herhangi bir SMW özelliği) | dropdown | radiobutton | |
| Hierarchy (hiyerarşik izin verilen değerler kümesine sahip herhangi bir Cargo alanı) | N/A | tree |
Ve burada, belirli bir veri türünün ayrılmış listeleri için varsayılan ve diğer izin verilen girdi türleri verilmiştir:
| Cargo veri türi | SMW veri türü | Varsayılan giriş türü | Varsayılan boyut | İzin verilen diğer giriş türleri |
|---|---|---|---|---|
| Page | Page | tokens | 100 | text, textarea, tree, checkboxes |
| String | Text | text | 100 | textarea, tokens |
| Enumeration | Enumeration | checkboxes | listbox | |
| Hierarchy | N/A | tree |
Dosya yükleme
Formdaki bir alan, yüklenen bir dosyanın adını (örneğin, bir resim) barındırıyorsa, kullanıcıların bu dosyayı doğrudan form aracılığıyla yüklemesine izin verebilirsiniz. Bu, form tanımında bu alanın bildirimine "uploadable" parametresini ekleyerek yapılır. Bu, formdaki bu alanın yanına "Dosya yükle" yazan bir bağlantı ekleyecektir; kullanıcı bu bağlantıyı tıklarsa, kullanıcının bir dosya yüklemesine izin veren (FancyBox JavaScript kitaplığını kullanarak) bir "lightbox" tarzı pencere açacaktır. Kullanıcı bunu yaptığında, pencere kapanacak ve alan yüklenen dosyanın adını içerecektir. Alan bir değerler listesi içerecek şekilde yapılandırılırsa, yeni dosya adı daha önce ne varsa ona eklenir; aksi takdirde, dosya adı daha önce içerdiği alanın üzerine yazacaktır.
"uploadable" parametresinin yalnızca "text", "text ile otomatik tamamlama", "combobox" veya "tokens" türündeki alanlarda kullanılabileceğini unutmayın.
Yüklenebilir alanlar için, alan tanımında "default filename=" parametresini ayarlayarak yüklenen dosyaların varsayılan dosya adını da ayarlayabilirsiniz. Bu parametrenin değeri ayrıştırıcı işlevlerini, sihirli sözcükleri ve benzerlerini içerebilir. Ayrıca, eklenen veya düzenlenen sayfanın adıyla değiştirilen "<page name>" değişkenini de içerebilir. Dolayısıyla, alan tanımına "default filename=Image for <page name>" parametresini eklemek, örneğin "Abc" adlı bir sayfa için, yüklenen herhangi bir dosyanın varsayılan adını "Image for Abc" olarak ayarlayacaktır. Yalnızca "Imageneeded.png" gibi kullanmak için varsayılan bir dosya belirtmek isterseniz, normal "default=Imageneeded.png" parametresinin işe yarayacağını unutmayın.
Dosya yükleme demosunu burada görebilirsiniz.
LocalSettings.php dosyanızda $wgBreakFrames, true olarak ayarlanmışsa yükleme penceresinin çalışmayacağını unutmayın.
MediaWiki'nin yükleme sistemini kullanmak yerine, doğrudan işletim sisteminin kendi yüklemesini kullanmak için yüklenebilir alanları da ayarlayabilirsiniz. Bu, kullanıcıya daha az seçenek sunar, ancak daha basit bir işlemdir ve mobil cihazlarda fotoğraf yükleme gibi bazı ilginç seçenekler alındıktan hemen sonra sunabilir. Bunu yapmak için, aşağıdaki satırı LocalSettings.php dosyasına ekleyin:
$wgPageFormsSimpleUpload = true;
Yüklenebilir alanlar için özel parametreler şunlardır:
uploadable- Bunun yüklenebilir bir alan olduğunu belirtir.image preview- Yüklenen resmini küçük resminin formdaki alanın altına yerleştirilmesi gerektiğini belirtir.default filename=filename - Bu alanla yüklenen dosyalar için varsayılan dosya adını belirtir.