---
title: "Flow Builder'da girişler ve formlar"
description: "Metin alanları ve onay kutuları gibi etkileşimli form öğeleri ekleyin."
---

Kullanıcılardan ad, e-posta adresi veya doğum tarihi gibi yazılı veri toplamak için girişleri kullanın. Yanıtları saklayın ve sonraki ekranlarda kullanıcıya adıyla hitap etmek gibi amaçlarla flow'un farklı yerlerinde bunlara başvurun.
## Bir girdi ekle \{#add-an-input\}

1. Sol üstteki **+** simgesine tıklayın.
2. **Input** seçeneğini seçin.
3. Girdi türünü belirleyin:
   - **Text:** Kısa metin girişleri için.
   - **Email:** E-posta adresleri; isteğe bağlı format doğrulaması ile.
   - **Password:** Güvenli metin girişi; yapılandırılabilir gereksinimler ile.
   - **Number:** Sayısal değerler; yapılandırılabilir format ile.
   - **Phone number:** Telefon numaraları.
   - **Date:** Tarih seçici açar.
   - **Time:** Saat seçici açar.
   - **Date and time:** Birleşik bir seçici açar.
## Girdi yapılandırma \{#configure-an-input\}

:::link
Görsel ayarlar — düzen, stil ve görünürlük — hakkında daha fazla bilgi için [Stiller ve görünüm](builder-styling) bölümüne bakın.
:::

Tüm girdi türleri için **Design** sekmesinde şunları yapılandırabilirsiniz:
- **Type:** Giriş türünü değiştirin (Text, Email, Password, Number, Phone number, Date, Time veya Date and time).
- **Element ID:** Giriş değerini flow içinde başka yerlerde referans almak için kullanılan tanımlayıcı. Aşağıdaki [Giriş değerlerini kullanma](#use-input-values) bölümüne bakın.
- **Placeholder:** Boş alanda görüntülenen ipucu metni.
- **State:** Girişin farklı durumlarda nasıl göründüğünü tanımlayın. **Default**, **Active**, **Invalid** ve **Disabled** arasında geçiş yaparak her birine farklı görsel uygulayın.
- **Typography:** Alanda görüntülenen değerin metin stili.
- **Leading and trailing icons:** Giriş alanının içine simge ekleyin.

Bazı ayarlar yalnızca belirli girdi türlerine özgüdür:
| Ayar | Giriş türleri |
|---|---|
| Temizle düğmesi | Metin, E-posta |
| E-posta formatını doğrula | E-posta |
| Şifre göster simgesi | Şifre |
| Şifre gereksinimlerini düzenle | Şifre |
| Sayı formatı | Sayı |
| Tarih/saat formatı | Tarih, Saat, Tarih ve saat |
| Min ve maks tarih | Tarih, Tarih ve saat |

## Girdi değerlerini kullanma \{#use-input-values\}

Her girdi, otomatik olarak bir değişken olarak kullanılabilir — herhangi bir kurulum ya da **On Submit** eylemi gerekmez. Değer, **Input Settings** bölümünde belirlediğiniz **Element ID** üzerinden referans alınır.

Bir girdi değerini flow'un başka bir yerinde kullanmak için (örneğin, metni kişiselleştirmek, başka bir alanı doldurmak veya koşullu gezinmeyi yönlendirmek amacıyla) bir değişken ekleyin ve şunu seçin:

**Element > Screen > `<elementId>.value`**
:::link
İlgili kılavuzları inceleyerek kaydedilen giriş değerlerini nasıl kullanacağınızı öğrenin:
- [Koşullu navigasyon](onboarding-navigation-branching)
- [Değişkenler](onboarding-variables)
:::
## Girdi doğrulama \{#input-validation\}

Doğrulama davranışı girdi türüne göre değişir. Her girdi, girilen değerin doğrulama kurallarını karşılayıp karşılamadığını gösteren salt okunur bir Boolean değişkeni olan `<elementId>.isValid`'i kullanıma sunar. Bunu koşullu eylemlerde veya koşullu görünürlükte kullanabilirsiniz — örneğin, bir e-posta formatı geçerli olana kadar İleri düğmesini gizlemek için.

:::note
- `isValid` değişkeni salt okunurdur — bu değişkeni siz ayarlayamazsınız.
- Boş bir girdi her zaman geçerli kabul edilir.
- Metin girdilerinin doğrulama kuralı yoktur. `textInput.isValid` her zaman `True` döndürür.
:::
| Girdi türü | Doğrulama davranışı |
|---|---|
| Metin | Yerleşik doğrulama kuralı yoktur. |
| E-posta | İsteğe bağlı. Girilen değeri e-posta formatına göre kontrol etmek için **Design** panelinde **Validate email format** seçeneğini etkinleştirin. |
| Telefon numarası | Yerleşik telefon numarası format kontrolü. Builder'da yapılandırılamaz — kural çalışma zamanında değerlendirilir. |
| Şifre | Yapılandırılabilir. Aşağıdaki [Şifre gereksinimleri](#password-requirements) bölümüne bakın. |
| Sayı | Format tabanlı. Girilen değer, seçilen sayı formatıyla eşleşmelidir. Aşağıdaki [Sayı formatı](#number-format) bölümüne bakın. |
| Tarih, Saat, Tarih ve saat | Yerleşik. Seçici yalnızca geçerli tarih veya saat değerlerini kabul eder. |
**Geçersiz** [görsel durum](builder-styling#input-states), kullanıcı formu gönderdiğinde — örneğin klavyeden Enter veya Done tuşuna bastığında — etkinleşir. O ana kadar input, **Aktif** veya **Varsayılan** durumu gösterir.
### Şifre gereksinimleri \{#password-requirements\}

Şifre girişleri, yapılandırılabilir doğrulama kurallarını destekler. Kural düzenleyicisini açmak için **Design** panelindeki **Edit password requirements** seçeneğine tıklayın. Etkinleştirilen kurallar, girişin altında canlı bir kontrol listesi olarak görüntülenir; her kural karşılanır karşılanmaz yanında bir onay işareti belirir.

Kullanılabilir kurallar:
- **Min length** — minimum karakter sayısı. Varsayılan: 8.
- **Max length** — maksimum karakter sayısı. Varsayılan: 32.
- **Uppercase letter** — en az bir A–Z karakteri.
- **Lowercase letter** — en az bir a–z karakteri.
- **Number** — en az bir rakam.
- **Special character** — en az bir alfanümerik olmayan karakter (örneğin, `!@#$%`).

Şifre yalnızca etkinleştirilen tüm kurallar sağlandığında geçerli sayılır.
### Sayı biçimi \{#number-format\}

**Number** giriş ayarlarındaki **Format** açılır menüsü, girilen değerin nasıl ayrıştırılacağını belirler:

- **Integer** — yalnızca tam sayılar (örneğin, `4`).
- **Decimal (Point)** — ayraç olarak nokta kullanan ondalıklı sayılar (örneğin, `4.89`).
- **Decimal (Comma)** — ayraç olarak virgül kullanan ondalıklı sayılar (örneğin, `4,89`).

Seçilen biçimle eşleşmeyen değerler geçersiz sayılır.
## Girdi olaylarında eylemleri tetikleme \{#trigger-actions-on-input-events\}

:::link
Ana makale: [Eylemler](onboarding-actions)
:::

**Interactions** paneli aracılığıyla kullanıcının girdisine tepki olarak eylemler çalıştırabilirsiniz:

- **On changed** — kullanıcı girdinin değerini değiştirdiğinde tetiklenir. Tüm girdi türlerinde kullanılabilir.
- **On submit** — kullanıcı klavyedeki Enter veya Done tuşuna basarak bir metin girdisini gönderdiğinde tetiklenir. Tarih ve saat seçicilerinde bu tetikleyici bulunmaz.