کنترل‌های المان (Element Controls)

کنترل‌های المان به کاربر اجازه می‌دهند محتوا و ظاهر یک المان را تغییر دهند. می‌توانید کنترل‌های یک المان را با متد set_controls() در کلاس PHP المان تعریف کنید.

کلاس المان نمونه با پارامترهای کنترلی برای کنترل testColor:

class Prefix_Element_Test extends \Bricks\Element {
  public function set_controls() {
    $this->controls['testColor'] = [
      'tab' => 'content',
      'group' => 'settings',
      'label' => esc_html__( 'Text color', 'bricks' ),
      'type' => 'color',
      'inline' => true,
      'small' => true,
      'css' => [
        [
          'property' => 'color',
          'selector' => '.content',
          'important' => true, // Optional
        ],
      ],
      'default' => [
        'rgb' => 'rgba(158, 158, 158, .8)',
        'hex' => '#9e9e9e',
      ],
      'pasteStyles' => false,
      'description' => esc_html__( 'Define the content color.', 'bricks' ),
      'required' => ['showText', '!=', ''],
    ];
  }
}

پارامترهای کنترلی زیر برای همه انواع کنترل در دسترس است. برای بررسی عمیق‌تر آرگومان‌های یک نوع کنترل خاص، کنترل را از لیست پایین انتخاب کنید.

آرگومان‌های کنترل سراسری

نام	نوع	پیش‌فرض	توضیحات
tab	string	content	برگه‌ای که کنترل زیر آن نشان داده می‌شود. مقادیر قابل قبول: content یا style.
group	string		گروهی که کنترل زیر آن نشان داده می‌شود. به‌طور پیش‌فرض، کنترل بدون گروه‌بندی زیر تب content نمایش داده می‌شود.
label	string		برچسب کنترل. مثال: esc_html__( 'Color', 'bricks' )
type	string		نوع کنترل را تنظیم کنید (برای لیستی از انواع کنترل‌های موجود به جدول زیر مراجعه کنید).
inline	bool	false	برای نمایش برچسب کنترل و ورودی در همان خط روی true تنظیم کنید.
small	bool	false	برای نمایش ورودی کنترل با عرض ۶۰ پیکسل روی true تنظیم کنید. به‌طور پیش‌فرض برچسب inline و ورودی هر کدام عرض ۵۰٪ دارند.
css	array		آرایه‌ای از تعاریف قوانین CSS. هر قانون CSS یک آرایه جداگانه است و به پارامترهای property و selector نیاز دارد.
default	string/array		مقدار پیش‌فرض کنترل؛ یک رشته یا آرایه (بسته به نوع کنترل، به فهرست کنترل زیر مراجعه کنید).
pasteStyles	bool	true	روی false تنظیم کنید تا این کنترل از «Paste Styles» در منوی راست‌کلیک سازنده حذف شود. برای کنترل‌هایی که محتوای HTML خروجی می‌دهند (نه CSS) توصیه می‌شود.
description	string		توضیح اختیاری برای کنترل‌هایی که نیاز به توضیح بیشتر دارند یا به منبعی لینک می‌شوند.
required	array		کنترل را مشروط به تنظیم کنترل دیگری نشان می‌دهد. پارامتر اول: شناسه کنترل پارامتر دوم: عملگر مقایسه: =, !=, >, <, >=, <= مثال: نمایش کنترل اگر کنترل layout برابر با list یا grid باشد.

انواع کنترل

نوع کنترل	خروجی (Content/CSS)
Apply	—
Align Items	CSS
Audio	Content
Background	CSS
Border	CSS
Box Shadow	CSS
Checkbox	Conditional
Code	Content
Color	CSS
Datepicker	Content
Dimensions	CSS
Direction	CSS
Editor	Content
Filters	CSS
Gradient	CSS
Icon	Content
Image	Content/CSS
Image Gallery	Content
Info	Builder panel only
Justify Content	CSS
Link	Content
Number	Content/CSS
Posts	Content
Repeater	Content
Select	Content/CSS
Slider	Content
SVG	Content
Text	Content
Textarea	Content
Text Align	CSS
Text Decoration	CSS
Text Shadow	CSS
Text Transform	CSS
Typography	CSS