Skip to main content Skip to docs navigation

التسميات العائمة (Floating labels)

أنشئ تسميات نماذج بسيطة وجميلة تطفو فوق حقول الإدخال الخاصة بك.

مثال

قم بتغليف زوج من العناصر <input class="form-control"> و <label> داخل .form-floating لتمكين التسميات العائمة مع حقول النماذج النصية في الـ Bootstrap.

مطلوب وجود سمة placeholder غير فارغة في كل عنصر <input> لأن تنفيذ التسميات العائمة المعتمد على الـ CSS فقط يعتمد على العنصر الزائف :placeholder-shown للكشف عما إذا كان الإدخال فارغاً. نص عنصر النائب (placeholder) نفسه غير مرئي؛ فقط <label> هو الذي يظهر للمستخدمين.

لاحظ أيضاً أن <input> يجب أن يأتي أولاً حتى نتمكن من استخدام محدد الشقيق (أي ~).

html
<div class="form-floating mb-3">
  <input type="email" class="form-control" id="floatingInput" placeholder="name@example.com">
  <label for="floatingInput">Email address</label>
</div>
<div class="form-floating">
  <input type="password" class="form-control" id="floatingPassword" placeholder="Password">
  <label for="floatingPassword">Password</label>
</div>

عندما تكون هناك قيمة value محددة مسبقاً، ستتعدل <label>s تلقائياً إلى موضعها العائم.

html
<form class="form-floating">
  <input type="email" class="form-control" id="floatingInputValue" placeholder="name@example.com" value="test@example.com">
  <label for="floatingInputValue">Input with value</label>
</form>

كما تعمل أنماط التحقق من صحة النموذج كما هو متوقع.

html
<form class="form-floating">
  <input type="email" class="form-control is-invalid" id="floatingInputInvalid" placeholder="name@example.com" value="test@example.com">
  <label for="floatingInputInvalid">Invalid input</label>
</form>

مناطق النصوص (Textareas)

بشكل افتراضي، ستكون <textarea>s التي تستخدم .form-control بنفس ارتفاع <input>s.

html
<div class="form-floating">
  <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea"></textarea>
  <label for="floatingTextarea">Comments</label>
</div>

لتعيين ارتفاع مخصص لـ <textarea>، لا تستخدم سمة rows. بدلاً من ذلك، قم بتعيين height صريح (إما بشكل مباشر inline أو عبر الـ CSS المخصص).

html
<div class="form-floating">
  <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea2" style="height: 100px"></textarea>
  <label for="floatingTextarea2">Comments</label>
</div>

قوائم التحديد (Selects)

بخلاف .form-control، تتوفر التسميات العائمة فقط على .form-select. وهي تعمل بنفس الطريقة، ولكن على عكس <input>، ستظهر <label> دائماً في حالتها العائمة. قوائم التحديد (Selects) التي تحتوي على size و multiple غير مدعومة.

html
<div class="form-floating">
  <select class="form-select" id="floatingSelect" aria-label="Floating label select example">
    <option selected>Open this select menu</option>
    <option value="1">One</option>
    <option value="2">Two</option>
    <option value="3">Three</option>
  </select>
  <label for="floatingSelect">Works with selects</label>
</div>

تعطيل

أضف سمة disabled المنطقية (boolean) على الإدخال، أو منطقة النصوص، أو القائمة المنسدلة لإعطائها مظهراً رمادياً، وإزالة أحداث المؤشر، ومنع التركيز.

html
<div class="form-floating mb-3">
  <input type="email" class="form-control" id="floatingInputDisabled" placeholder="name@example.com" disabled>
  <label for="floatingInputDisabled">Email address</label>
</div>
<div class="form-floating mb-3">
  <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextareaDisabled" disabled></textarea>
  <label for="floatingTextareaDisabled">Comments</label>
</div>
<div class="form-floating mb-3">
  <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea2Disabled" style="height: 100px" disabled>Disabled textarea with some text inside</textarea>
  <label for="floatingTextarea2Disabled">Comments</label>
</div>
<div class="form-floating">
  <select class="form-select" id="floatingSelectDisabled" aria-label="Floating label disabled select example" disabled>
    <option selected>Open this select menu</option>
    <option value="1">One</option>
    <option value="2">Two</option>
    <option value="3">Three</option>
  </select>
  <label for="floatingSelectDisabled">Works with selects</label>
</div>

النص العادي للقراءة فقط (Readonly plaintext)

تدعم التسميات العائمة أيضاً .form-control-plaintext، والتي يمكن أن تكون مفيدة للتبديل من <input> قابل للتعديل إلى قيمة نصية عادية دون التأثير على تخطيط الصفحة.

html
<div class="form-floating mb-3">
  <input type="email" readonly class="form-control-plaintext" id="floatingEmptyPlaintextInput" placeholder="name@example.com">
  <label for="floatingEmptyPlaintextInput">Empty input</label>
</div>
<div class="form-floating mb-3">
  <input type="email" readonly class="form-control-plaintext" id="floatingPlaintextInput" placeholder="name@example.com" value="name@example.com">
  <label for="floatingPlaintextInput">Input with value</label>
</div>

مجموعات الإدخال (Input groups)

تدعم التسميات العائمة أيضاً .input-group.

@
html
<div class="input-group mb-3">
  <span class="input-group-text">@</span>
  <div class="form-floating">
    <input type="text" class="form-control" id="floatingInputGroup1" placeholder="Username">
    <label for="floatingInputGroup1">Username</label>
  </div>
</div>

عند استخدام .input-group و .form-floating جنباً إلى جنب مع التحقق من صحة النموذج، يجب وضع -feedback خارج .form-floating، ولكن داخل .input-group. وهذا يعني أن التغذية الراجعة ستحتاج إلى أن يتم عرضها باستخدام الـ JavaScript.

@
Please choose a username.
html
<div class="input-group has-validation">
  <span class="input-group-text">@</span>
  <div class="form-floating is-invalid">
    <input type="text" class="form-control is-invalid" id="floatingInputGroup2" placeholder="Username" required>
    <label for="floatingInputGroup2">Username</label>
  </div>
  <div class="invalid-feedback">
    Please choose a username.
  </div>
</div>

التخطيط

عند العمل مع نظام الشبكة (grid system) في الـ Bootstrap، تأكد من وضع عناصر النموذج داخل فئات الأعمدة (column classes).

html
<div class="row g-2">
  <div class="col-md">
    <div class="form-floating">
      <input type="email" class="form-control" id="floatingInputGrid" placeholder="name@example.com" value="mdo@example.com">
      <label for="floatingInputGrid">Email address</label>
    </div>
  </div>
  <div class="col-md">
    <div class="form-floating">
      <select class="form-select" id="floatingSelectGrid">
        <option selected>Open this select menu</option>
        <option value="1">One</option>
        <option value="2">Two</option>
        <option value="3">Three</option>
      </select>
      <label for="floatingSelectGrid">Works with selects</label>
    </div>
  </div>
</div>

الـ (CSS)

متغيرات الـ (Sass)

$form-floating-height:                  add(3.5rem, $input-height-border);
$form-floating-line-height:             1.25;
$form-floating-padding-x:               $input-padding-x;
$form-floating-padding-y:               1rem;
$form-floating-input-padding-t:         1.625rem;
$form-floating-input-padding-b:         .625rem;
$form-floating-label-height:            1.5em;
$form-floating-label-opacity:           .65;
$form-floating-label-transform:         scale(.85) translateY(-.5rem) translateX(.15rem);
$form-floating-label-disabled-color:    $gray-600;
$form-floating-transition:              opacity .1s ease-in-out, transform .1s ease-in-out;