WordPress 7.1 40 Piksellik Bileşen Varsayılanını Kalıcı Yapıyor

WordPress’te henüz “components” paketi bile yokken @wordpress/components üstüne yönetim ekranları kuruyordum. Tasarım sistemi altımdan her değiştiğinde müşterilerden aynı soruyu alıyorum: eklentimi bu sefer kıracak olan bu mu.

Bu hafta o haftalardan biri, ama cevap ilk defa sıkıcı. WordPress 6.4’ten beri ağır ağır yürüdüğü 40 piksellik kontrol yüksekliği, sonunda 7.1’de kalıcı varsayılan oluyor. Kodunuz yıllar önce tercih ettiyse bir şey değişmiyor. Etmediyse fark edeceksiniz — ve API yüzeyi sabitlenmeden önce düzeltmek için tek bir Beta döngünüz var.

Fiilen ne indi, sürüm ekibi işi neden böyle götürdü, ve bir müşteri kod tabanında bu hafta hangi denetimleri yapardım — hepsi aşağıda.

Asıl yeni olan ne

__next40pxDefaultSize tercihe bağlı özelliği, çekirdek bileşenlerin ilk dalgasında artık sert kullanımdan kaldırıldı. Ryan Welcher’ın WordPress Developer Blog’da yayımladığı Temmuz 2026 geliştirici derlemesi en açık özet ve Gutenberg 23.5’te değişikliği alan on bileşeni listeliyor — bu, WordPress 7.1’in içine geri taşınan eklenti sürümü: TextControl, BoxControl, BorderControl, FontSizePicker, RangeControl, ComboboxControl, ToggleGroupControl, UnitControl, FormTokenField ve CustomSelectControl.

Buradaki “sert kullanımdan kaldırma” ifadesi net. Özellik tip imzasından silinmedi — hâlâ derleniyor, mevcut çağrılar hata fırlatmıyor. Ama çalışma zamanı işleyicisi gitti. 40 piksellik boyut artık varsayılan stillere gömülü, özellik ise işlevsiz bir kabuk. TextControl değişikliği Gutenberg PR #79386, mirka tarafından 23 Haziran 2026’da birleştirildi — PR açıklaması özelliğin “artık işlevsel bir etkisi olmadığını” ve dış uyumluluk için kullanımdan kaldırılmış bir tip kabuğuyla değiştirildiğini açıkça söylüyor. BoxControl karşılığı PR #79419, ertesi gün birleşti; özelliği o bileşenin genel API’sinden kaldırıyor ama içerideki UnitControl ve RangeControl örneklerine, o ilkel bileşenler kendi kullanımdan kaldırma döngülerini bitirene kadar hâlâ iletiyor.

Uzun bir yürüyüştü. 40 piksellik varsayılan Ekim 2023’teki WordPress 6.4 bileşenler geliştirici notunda duyurulmuş, temaların ve eklentilerin kendi takvimlerinde geçebilmesi için geçici bir tercih özelliğiyle sarmalanmıştı. Asıl takip meselesi planı çizdi: özelliği tanıt, her şey göç etsin, sonra varsayılanı değiştir ve bayrağı emekli et. Hiç tercih etmeyen tüketiciler 36 piksellik varsayılanda kaldı ve 6.7’den sonra yumuşak kullanımdan kaldırma uyarıları aldı. 7.1 dalgası, özelliğin gerçekten anlamsız hale gelmesinden önceki son durak.

İki destekleyici mekanik önemli. Birincisi, @wordpress/eslint-plugin içindeki components-no-missing-40px-size-prop ESLint kuralı, tercih bayrağını geçmeyen her bileşen kullanımını zaten işaretliyordu. Yapınız WordPress ön ayarı altında temizse büyük ihtimalle bitirmişsinizdir. İkincisi, Gutenberg’in ana dalı 15 Temmuz 2026’da yayınlanan Beta 1’de wp/7.1 dalına sabitlendi — 7.1 sürüm partisi takvimine göre. 19 Ağustos için API yüzeyi, bugün Beta 1’de olanın aynısı. Bu bileşen kümesi için bu döngüde artık “yumuşaktan serte” sürprizler olmayacak.

WordPress ve WooCommerce dünyasında bu neden önemli

Ajans eklentilerinin çoğu en az bir ayar ekranı çiziyor ve bu ekranların çoğu aynı bir avuç kontrolün üstünde kurulu. TextControl kaçınamayacağınız olan. RangeControl ve UnitControl neredeyse her “boşluk”, “font boyutu” ya da “kesme noktası” panelinde çıkıyor. SelectControl varyantları ve ComboboxControl, REST API ile konuşan her açılır menünün sahibi. 2022 veya 2023’te bir eklenti kurup arayüze o günden beri hiç dokunmadıysanız, test ettiğiniz düzen 36 piksel yüksekliğindeydi. 7.1 altında 40. Dört piksel çok gibi durmuyor — ta ki sıkı dikey ritmi olan iki sütunlu bir ızgaraya ve Y koordinatı CSS ile sabitlenmiş bir Kaydet düğmesine çarpana kadar.

WooCommerce aynı saatte. WC_Settings_Page, yeni Ayarlar Arayüzü çerçevesi ya da Ödemeler/Kargo yöntemi ekranlarında çizim yapan uzantı ekiplerinin hepsi aynı bileşenleri tüketiyor. Woo 11.0 ön sürüm notları zaten kullanımdan kalkan dependency-group kuralının yerine geçen import/order ile ilgili ayrı bir ESLint kuralı değişikliğini işaret etti — hâlâ eski yapılandırmaya sabitli ekiplerin sürekli tümleştirme boru hattını kırıyor. İki lint kuralı göçü artı canlı bir bileşen varsayılan değişikliği, kimse önden uyarmadıysa Pazartesi sabahını yiyecek türden küçük bir yığın.

Daha geniş sinyal şu: Gutenberg’in tasarım sistemi katmanı sonunda gerçek bir tasarım sistemi gibi davranıyor. 8 Temmuz’da işlediğimiz tasarım sistemi temalandırma birleştirme önerisi token borusunu indiriyor. Bu 40 piksellik varsayılan da boyut tarafındaki son tercih bayrağını çeviriyor. İkisi birlikte, eklenti yazarlarının 6.4’ten beri istediği şey: öngörülebilir varsayılanlar, tek bir temalandırma katmanı, üstüne inşa edilecek tek bir kararlı bileşen API’si.

Ben ne yapardım (veya yapmazdım)

Yönetim arayüzü çizen her eklenti ya da temada, bu sırayla dört tur atın — WordPress 7.1 Beta 1 ve Gutenberg 23.5 yan yana kurulu bir hazırlık ortamında.

1. Özelliği tarayın. Kod tabanında __next40pxDefaultSize arayın. Her sonucu bugün yerinde bırakmak güvenli — özellik hâlâ tipli ve hâlâ geçerli — ama her biri geleceğin ölü kodu. En düşük WordPress sürümünüzü 7.1’e çıkaran aynı PR’de temizlemeyi planlayın.
2. ESLint kuralını kod tabanında çalıştırın. @wordpress/eslint-plugin henüz devDependencies içinde değilse ekleyin ve önerilen ön ayarı açın. Etkilenen listedeki bir kontrolü çizen ve 40 piksellik varsayılandan haberdar olmayan her bileşen işaretlenecek. Özellik varsa kaldırıp yoksa düzeni tekrar kontrol ederek onarın.
3. Her ayar ekranında görsel tur. Kimsenin yapmak istemediği ve her hatayı yakalayan tur bu. Eklentideki her yönetim sayfasını 1x ve 2x’te açın, eklenen kontrol başına dört pikselin ızgaranızı bozup bozmadığına bakın. Sık başarısızlıklar: kırpılan yan panel şeritleri, son satırla örtüşen yapışkan Kaydet düğmeleri, karışık kontrol yüksekliği olan tablolar ve etiketlerin girdilerle hizasının kaçtığı iki sütunlu düzenler.
4. Kullanımdan kaldırma uyarısı denetimi. SCRIPT_DEBUG‘ı açın, sahip olduğunuz her düzenleyici ve yönetim ekranında tarayıcı konsolunu açın ve Gutenberg kullanımdan kaldırma çalışma zamanının kaydettiği her şeyi kopyalayın. Yığın izi bileşeni ve çağıran dosyayı adlandırır. Onarın ya da bildirin, görmezden gelmeyin.

İki şeyi yapmazdım. Birincisi, 36 piksellik boyutu CSS geçersiz kılmalarıyla zorla geri getirmeye çalışmayın. 7.1’de çalışır, 7.2’de sizinle kavga eder ve 40 piksellik varsayılanı bitirişte sürükleyen erişilebilirlik argümanını — kullanıcının gözlerini kısmasına gerek kalmadan WCAG rehberine uyan dokunma hedeflerini — çürütür. İkincisi, bu denetimi ilk kez 19 Ağustos’ta canlıda yapmayın. Beta 1’in API yüzeyini sabitlemesinin bütün amacı, yayına çıkacak kodun aynısıyla hazırlık ortamında test edilecek dört haftanız olması. Kullanın.

Yavaş yayılmış bir kullanımdan kaldırmanın güzel yanı, indiği vakit haber olmaktan çıkmasıdır. Erken tercih edenler işi bitirmiş oluyor. Etmeyenler için tek bir Beta döngüsü ve üstünde çalışılacak net bir PR listesi var. Yönetişimin böyle görünmesi gerekiyor.