المكونات
الحقل
يجمع عنصر تحكم واحدًا مع تسميته ووصفه ورسالة الخطأ.
الاستخدام
أساسي
We only use this for receipts.
HTML
<bs:bsui-field>
<bs:bsui-field-label text="Email address" />
<bs:bsui-input type="email" placeholder="you@example.com" />
<bs:bsui-field-description text="We only use this for receipts." />
</bs:bsui-field>حالة غير صالحة
يؤدي وضع علامة على الحقل بأنه غير صالح إلى تغيير لون عنصر التحكم وإظهار الرسالة أسفله.
Enter an address with a domain, like ada@example.com.
HTML
<bs:bsui-field invalid="true">
<bs:bsui-field-label text="Work email" />
<bs:bsui-input type="email" defaultValue="ada@example" />
<bs:bsui-field-error text="Enter an address with a domain, like ada@example.com." />
</bs:bsui-field>مطلوب
يوضح نص المساعدة المتطلبات، لذا تبقى التسمية قصيرة.
Required. This name appears on every invoice.
HTML
<bs:bsui-field>
<bs:bsui-field-label text="Workspace name" />
<bs:bsui-input placeholder="Acme Production" required="true" />
<bs:bsui-field-description text="Required. This name appears on every invoice." />
</bs:bsui-field>معطل
عطّل الحقل وعنصر التحكم بداخله، ليظهر الصف بأكمله مقفلًا.
The URL is fixed once the workspace is created.
HTML
<bs:bsui-field disabled="true">
<bs:bsui-field-label text="Workspace URL" />
<bs:bsui-input defaultValue="acme.blockstudio.dev" disabled="true" />
<bs:bsui-field-description text="The URL is fixed once the workspace is created." />
</bs:bsui-field>حقل خيارات
يضم الحقل عناصر التحكم المجمّعة بالطريقة نفسها التي يضم بها حقل إدخال واحدًا.
HTML
<bs:bsui-field invalid="true">
<bs:bsui-field-label text="Deploy target" />
<bs:bsui-radio-group orientation="horizontal">
<bs:bsui-radio value="staging" label="Staging" />
<bs:bsui-radio value="production" label="Production" />
</bs:bsui-radio-group>
<bs:bsui-field-error text="Pick a target before deploying." />
</bs:bsui-field>البنية
يتكوّن الحقل من الكتل أدناه. كل كتلة منها مستقلة ولا تُعرض إلا داخل العنصر الأب.
bsui/fieldbsui/field-descriptionbsui/field-errorbsui/field-label
السمات
| السمة | النوع | افتراضي |
|---|---|---|
name | text | — |
invalid | toggle | false |
disabled | toggle | false |
bsui/field-description
| السمة | النوع | افتراضي |
|---|---|---|
text | richtext | — |
bsui/field-error
| السمة | النوع | افتراضي |
|---|---|---|
text | richtext | — |
bsui/field-label
| السمة | النوع | افتراضي |
|---|---|---|
text | richtext | — |