check_circle
code
Dökümanlar / Başlangıç

Kurulum

HowwydSheet'i projenize dahil ederek hemen kullanmaya başlayın. Modern ve reaktif bir deneyim için AlpineJS ile güçlendirilmiştir.

HTML
<!-- Stiller -->
<link rel="stylesheet" href="https://cdn.howwyd.com/sheet/v2/index.css">

<!-- Scriptler -->
<script defer src="https://cdn.jsdelivr.net/npm/[email protected]/dist/cdn.min.js"></script>
<script src="https://cdn.howwyd.com/sheet/v2/index.js"></script>

Kullanım

Bir sayfayı başlatmak için x-data="howwydSheet()" direktifini kullanın. Görünürlüğü kontrol etmek için standart AlpineJS direktiflerini kullanabilirsiniz.

HTML
<!-- Tetikleyici Buton -->
<button @click="$dispatch('open-sheet')">Sayfayı Aç</button>

<!-- Sayfa Bileşeni -->
<div x-data="howwydSheet({ initialSize: '50%' })" 
     @open-sheet.window="show()" 
     class="sheet" 
     x-show="isVisible" 
     x-cloak>
    
    <!-- Arka Plan Örtüsü -->
    <div class="overlay" @click="hide()"></div>
    
    <!-- İçerik Alanı -->
    <div class="contents" :style="sheetStyle">
        <header class="controls" 
                @mousedown="startDrag" @touchstart="startDrag"
                @mousemove.window="onDrag" @touchmove.window="onDrag"
                @mouseup.window="endDrag" @touchend.window="endDrag">
            <div class="draggable-area">
                <div class="draggable-thumb"></div>
            </div>
        </header>
        <main class="body">
            <h2>Merhaba Dünya</h2>
        </main>
    </div>
</div>

Boyutlandırma

Sayfanın başlangıç yüksekliğini initialSize parametresi ile ayarlayabilirsiniz. Yüzde (%) veya piksel (px) değerleri kabul edilir.

initialSize: '50%'

Ekranın yarısı kadar açılır.

initialSize: '300px'

300 piksel yükseklikte açılır.

Kilitleme (Locking)

Kullanıcının sayfayı yanlışlıkla kapatmasını önlemek için lockable: true özelliğini kullanın. Bu modda arka plan örtüsüne tıklamak sayfayı kapatmaz.

İpucu: Kilitli modda sayfayı kapatmak için hide(true) metodunu çağıran bir buton eklemeyi unutmayın.

Yapılandırma

howwydSheet() fonksiyonuna bir yapılandırma nesnesi geçirerek davranışı özelleştirin.

Seçenek Tip Varsayılan Açıklama
initialSize string '50%' Sayfanın başlangıç yüksekliği.
lockable boolean false True ise, dışarı tıklamak kapatmaz.
fullscreenOnInit boolean false Başlangıçta tam ekran açılır.

Metotlar

Bileşen içinde kullanabileceğiniz metotlar.

Metot Parametreler Açıklama
show() - Sayfayı açar.
hide(force) force: boolean Sayfayı kapatır. force=true ise kilitli olsa bile kapatır.
toggle() - Görünürlük durumunu değiştirir.

Sıkça Sorulan Sorular

React veya Vue ile çalışır mı?

Evet, HowwydSheet framework bağımsızdır ancak AlpineJS üzerine kuruludur. React veya Vue bileşenleriniz içinde rahatlıkla kullanabilirsiniz.

Mobil cihazlarda performans nasıl?

Son derece yüksek. CSS transform ve requestAnimationFrame kullanarak 60fps akıcılık hedeflenmiştir.

Ücretli mi?

Hayır, HowwydSheet tamamen açık kaynaklı ve ücretsizdir.