details ve summary ne işe yarar?
details, kullanıcının açıp kapatabildiği bir bilgi alanı oluşturur. summary ise kapalı durumda da görünen açıklayıcı başlığı sağlar. MDN details başvurusu, yerleşik açılır bilgi davranışını tanımlar.
Sık sorulan sorular, isteğe bağlı açıklamalar veya teknik ayrıntılar için bu yapı uygun olabilir. Başlık, açılacak içeriği anlamlı biçimde anlatmalıdır. Sayfanın temel görevini tamamlamak için mutlaka görülmesi gereken bir uyarıyı gizlemek ise ayrı bir tasarım kararıdır; yalnızca daha kısa bir sayfa elde etmek için verilmemelidir.
JavaScript olmadan bir akordeon nasıl yazılır?
Aşağıdaki iki alan aynı name değerini paylaşır. Bu gruplamayı destekleyen tarayıcılarda birini açmak diğerini kapatır:
<section class="faq" aria-label="Teslimat soruları">
<details id="shipping" name="shipping-faq">
<summary>Kargo ne zaman çıkar?</summary>
<div class="answer">
<p>Örnek teslimat bilgisi burada yer alır. Gerçek süreyi ürününüzün kurallarına göre yazın.</p>
</div>
</details>
<details id="returns" name="shipping-faq">
<summary>İade süreci nasıl işler?</summary>
<div class="answer">
<p>İade adımlarını açık ve anlaşılır biçimde açıklayın.</p>
</div>
</details>
</section>
<button type="button" id="close-faq" hidden>Tümünü kapat</button>
Buradaki teslimat metinleri bir örnektir, gerçek bir mağazanın taahhüdü değildir. Asıl konu etkileşim yapısıdır. summary öğesini details içindeki ilk öğe olarak kullanın ve başlığın içine ayrı düğme veya bağlantı yerleştirmeyin. summary başvurusu, davranış ve erişilebilirlik sınırlarını açıklar.
name özelliği neyi değiştirir?
Ortak name, birbiriyle ilişkili details alanlarının tek açık öğeli bir grup oluşturmasını sağlar. Gruptaki bütün alanların kapalı olması mümkündür; mutlaka birinin açık kalacağı varsayılmamalıdır. Farklı sayfa bölümlerinin yanlışlıkla aynı gruba girmemesi için isimleri bilinçli seçin.
name desteği bulunmayan bir ortamda alanlar bağımsız olarak açılıp kapanabilir. Bu durumda da içerik ulaşılabilir kalmalıdır. Hedef tarayıcılarınızın desteğini denetleyin; gruplama davranışını bütün istemciler için test etmeden garanti etmeyin.
open neden sıradan bir metin değeri değildir?
open bir boolean HTML niteliğidir. Varlığı açık durumu ifade eder. Bu nedenle open="false" yazmak kapatmaz; niteliğin kaldırılması veya DOM open özelliğinin false yapılması gerekir. HTMLDetailsElement.open belgesi, bu yansıtmayı açıklar.
Örnekteki son düğme için isteğe bağlı küçük bir geliştirme eklenebilir. Bu kodu HTML öğelerinden sonra çalıştırın:
const items = document.querySelectorAll('details[name="shipping-faq"]');
const closeButton = document.querySelector('#close-faq');
closeButton.hidden = false;
closeButton.addEventListener('click', () => {
items.forEach(item => { item.open = false; });
});
Bu yardımcı olmadan da summary üzerinden açma ve kapatma yerleşik davranışla çalışır. Kod düğmeyi görünür yapıp toplu kapatma işini ekler. JavaScript çalışmazsa ek düğme gizli kalır; temel bilgi alanları ona bağımlı değildir.
Açılma işaretini ve odağı nasıl korursunuz?
Yerleşik summary işaretini görünmez yapmadan, açık durumu ve klavye odağını stillendirebilirsiniz:
.faq { max-width: 42rem; }
.faq details {
border: 1px solid #94a3b8;
border-radius: 0.75rem;
margin-block: 0.75rem;
overflow-wrap: anywhere;
}
.faq summary {
padding: 1rem;
cursor: pointer;
font-weight: 700;
}
.faq summary::marker { color: #1d4ed8; }
.faq summary:focus-visible {
outline: 3px solid #2563eb;
outline-offset: 3px;
}
.faq details[open] { border-color: #2563eb; }
.faq .answer { padding: 0 1rem 1rem; }
summary için display değerini rastgele değiştirmek veya işareti kaldırıp hiçbir karşılık sunmamak, etkileşimin anlaşılmasını zorlaştırabilir. Odak göstergesinin kesilmediğini ve uzun başlıkların dar ekranda kırıldığını kontrol edin. web.dev details rehberi, iç içe etkileşimli içerik gibi dikkat isteyen durumları ele alır.
toggle olayı ile hangi durumu okuyabilirsiniz?
toggle olayı açık/kapalı durum değişikliğini gözlemlemek için kullanılabilir. Güncel durum DOM open özelliğinden okunabilir. Ancak hızlı ardışık değişikliklerde olaylar birleştirilebildiği için bunu her ara değişikliğin ayrı bir kaydı olarak düşünmeyin.
Bir açılma olayını doğrudan iş işlemi veya ağ isteğiyle eşleştirmek gerekiyorsa tekrarları ve son durumu ayrıca tasarlayın. Basit bir bilgi alanında ek JavaScript yazmamak, taşınacak durum sayısını da azaltır. summary'nin zaten sağladığı açma/kapama davranışını ikinci bir tıklama işleyicisiyle yeniden uygulamak gereksiz çakışmalara yol açabilir.
Klavyeyle hangi kontroller yapılmalıdır?
Tab ile summary'ye ulaşın; Enter ve Space ile açıp kapatmayı deneyin. İkinci başlığı açınca gruplamanın beklenen davranışını gösterdiğini, kapalı cevabın görünmediğini ve odağın anlaşılır kaldığını doğrulayın. Uzun başlık, büyütülmüş metin ve dar ekranı da aynı örnekte deneyin.
Yerleşik öğeler erişilebilirlik için iyi bir başlangıçtır, fakat tarayıcı ve yardımcı teknoloji kombinasyonlarında değerlendirme gereksinimini kaldırmaz. Erişilebilir form rehberi, adlandırma ve klavye etkileşiminin başka bir uygulamasını gösterir. Modal gerektiren ayrı bir akış için dialog rehberine bakabilirsiniz.
Sık sorulan sorular
open="false" alanı kapatır mı? Hayır. Boolean nitelik hâlâ vardır; kaldırın veya DOM özelliğini false yapın.
Bir grupta her zaman bir alan açık mı kalır? Hayır. name grubu tek açık öğeyi sınırlar, en az birinin açık olmasını zorunlu kılmaz.
summary içine ayrı bir düğme eklemek uygun mu? Bu örnekte eklenmez. İç içe etkileşimli kontrollerin farklı tarayıcılarda sorun çıkarabileceğini dikkate alın.

