html form

نموذج HTML

فئات PHP خفيفة الوزن لإنشاء عناصر html.

لا تحتوي هذه الحزمة على أي تبعية غير php-5.4

• الترخيص: معهد ماساتشوستس للتكنولوجيا

متطلبات

• PHP 5.4.0 أو أعلى

تثبيت

الملحن

Composer هو مدير تبعية يستخدم على نطاق واسع لحزم PHP. يتوفر نموذج Html هذا على Packagist كـ user-meta/html ويمكن تثبيته عن طريق تشغيل الأمر composer require . لتمكين Composer لمشروعك، راجع وثائق بدء المشروع.

لإضافة هذه التبعية باستخدام الأمر، قم بتشغيل ما يلي من داخل دليل المشروع الخاص بك:

 composer require user-meta/html

ابدأ

مثال سريع لإنشاء إدخال نص باستخدام نموذج Html باستخدام الملحن:

 <?php
require __DIR__ . ' /vendor/autoload.php ' ;
use UserMeta  Html  Html ;
echo Html:: text ( ' example ' );

الإخراج:

 < input type =" text " value =" example " />

يمكن استخدام جميع أنواع عناصر html تقريبًا. (على سبيل المثال: زر، بريد إلكتروني، div، p، إلخ)

 echo Html:: button ( ' Submit Me ' );
echo Html:: email ( ' example email ' );
echo Html:: div ( ' example text ' );
echo Html:: p ( ' example text ' );

الإخراج:

 < input type =" button " value =" Submit Me " />
< input type =" email " value =" example email " />
< div > example text </ div >
< p > example text </ p > 

الاستخدام

الاستخدام الأساسي

الحجج المقبولة

تقبل معظم العناصر وسيطتين:

• $default : القيمة الافتراضية
• $attributes : مجموعة من السمات
• echo Html::text($default, attributes);

بالنسبة لعنصر الخيارات مثل التحديد والراديو، فإنه يقبل الوسيطة الثالثة $options

• $options : مجموعة من الخيارات. يمكن أن يحتوي المصفوفة على زوج من القيمة الرئيسية أو القيم فقط
• echo Html::select($default, attributes, $options);

باستخدام الاسم والمعرف والفئة

لتعيين اسم أو معرف أو فئة أو أي سمات أخرى، استخدم الوسيطات الثانية ( $attributes )

حقل نصي يحتوي على القيمة الافتراضية والاسم والمعرف وسمات الفئة:

 echo Html:: text ( ' Example_Value ' , [ ' name ' => ' Example_Name ' , ' id ' => ' Example_ID ' , ' class ' => ' Example_Class ' ]);

الإخراج:

 < input type =" text " name =" Example_Name " value =" Example_Value " id =" Example_ID " class =" Example_Class " /> 

إضافة سمات إلى العنصر

يمكنك أيضًا إضافة أي سمات إلى أي عنصر:

 echo Html:: text ( ' Example_Value ' , [ ' name ' => ' Example_Name ' , ' data-example ' => ' Example_Data ' ]);

الإخراج:

 < input type =" text " name =" Example_Name " value =" Example_Value " data-example =" Example_Data " /> 

باستخدام المطلوبة، للقراءة فقط والمعوقين

 echo Html:: email ( null , [ ' name ' => ' Email ' , ' required ' ]);
echo Html:: email ( null , [ ' name ' => ' Email ' , ' readonly ' ]);
echo Html:: email ( null , [ ' name ' => ' Email ' , ' disabled ' ]);

الإخراج:

 < input type =" email " name =" Email " required =" required " />
< input type =" email " name =" Email " readonly =" readonly " />
< input type =" email " name =" Email " disabled =" disabled " /> 

باستخدام التسمية

 echo Html:: email ( null , [
    ' name ' => ' Example_Name ' ,
    ' label ' => ' Email '
]);

 echo Html:: email ( null , [
    ' name ' => ' Example_Name ' ,
    ' label ' => [
        ' Example ' ,
        ' class ' => ' Class '
    ]
]);

الإخراج:

 < label > Email </ label >
< input type =" email " name =" Example_Name " /> 

 < label class =" Class " > Example </ label >
< input type =" email " name =" Example_Name " /> 

div مع سمات المعرف والفئة:

 echo Html:: div ( ' example text ' , [ ' id ' => ' Example_ID ' , ' class ' => ' Example_Class ' ]);

الإخراج:

 < div id =" Example_ID " class =" Example_Class " > example text </ div > 

lebel مع نص التسمية والمعرف والفئة والسمات

 echo Html:: label ( ' Some text ' , [ ' id ' => ' ID ' , ' class ' => ' Class ' , ' for ' => ' For ' ]);

الإخراج:

 < label id =" ID " class =" Class " for =" For " > Some text </ label >

باستخدام خانة الاختيار

مربع اختيار بسيط مع تحديده بشكل افتراضي

 echo Html:: checkbox ( true , [ ' name ' => ' Name ' ]);
echo Html:: checkbox ( true , [ ' name ' => ' Name ' , ' value ' => ' Value ' ]);

الإخراج:

 < input type =" checkbox " name =" Name " value =" 1 " checked =" checked " />
< input type =" checkbox " name =" Name " value =" Value " checked =" checked " />

قم بتمرير الوسيطة الأولى كخطأ لإلغاء التحديد الافتراضي. echo Html::checkbox(false)

قائمة خانة الاختيار

أنشئ قائمة بمربعات الاختيار ذات القيم الافتراضية

 echo Html:: checkbox ( ' cat ' , [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);
echo Html:: checkbox ([ ' cat ' ], [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);

الإخراج

 < label > < input type =" checkbox " value =" dog " name =" Name " id =" ID_1 " /> Dog </ label >
< label > < input type =" checkbox " value =" cat " name =" Name " id =" ID_2 " checked =" checked " /> Cat </ label >

للحصول على مجموعة من القيم بطريقة POST أو GET

 echo Html:: checkbox ([ ' cat ' ], [ ' name ' => ' Name[] ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);

الإخراج

 < label > < input type =" checkbox " value =" dog " name =" Name[] " id =" ID_1 " /> Dog </ label >
< label > < input type =" checkbox " value =" cat " name =" Name[] " id =" ID_2 " checked =" checked " /> Cat </ label >

باستخدام تحديد / الراديو

قم بإنشاء تحديد باستخدام سمات القيمة والاسم والمعرف الافتراضية

 echo Html:: select ([ ' cat ' ], [ ' name ' => ' Name ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);
echo Html:: select ([ ' cat ' ], [ ' name ' => ' Name ' ], [ ' dog ' , ' cat ' ]);

الإخراج

 < select name =" Name " >
    < option value =" dog " > Dog </ option >
    < option value =" cat " selected =" selected " > Cat </ option >
</ select >

< select name =" Name " >
    < option value =" dog " > dog </ option >
    < option value =" cat " selected =" selected " > cat </ option >
</ select > 

إنشاء قائمة الراديو

 echo Html:: radio ([ ' cat ' ], [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' , ' cat ' ]);

الإخراج

 < label > < input type =" radio " value =" dog " name =" Name " id =" ID_1 " /> dog </ label >
< label > < input type =" radio " value =" cat " name =" Name " id =" ID_2 " checked =" checked " /> cat </ label >

باستخدام جمع

يمكن تجميع عدة عناصر معًا كمجموعة

 $ div = new Html ( ' div ' );
$ div -> p ( ' Hello World ' );
$ div -> text ( ' example ' );
$ div -> add ( ' Some plain text ' );
echo $ div -> render ();

الإخراج:

 < div >
    < p > Hello World </ p >
    < input type =" text " value =" example " />
    Some plain text
</ div >

تستخدم المجموعة مُنشئ Html وتقبل معلمتين.

• $type (اختياري): اسم العلامة. (على سبيل المثال النموذج، div)
• $attributes (اختياري): مجموعة من السمات

مثال النموذج

إنشاء نموذج باستخدام المجموعات:

 $ form = new Html ( ' form ' , [ ' method ' => ' POST ' ]);
$ form -> div ( ' Enter your email and password for login ' );
$ form -> email ( '' , [ ' name ' => ' email ' , ' label ' => ' Email ' ]);
$ form -> password ( '' , [ ' name ' => ' password ' , ' label ' => ' Password ' ]);
$ form -> submit ( ' login ' );
echo $ form -> render ();

الإخراج:

 < form method =" POST " >
    < div > Enter your email and password for login </ div >
    < label > Email </ label >
    < input type =" email " name =" email " />
    < label > Password </ label >
    < input type =" password " name =" password " />
    < input type =" submit " value =" login " />
</ form > 

مجموعات متداخلة

إنشاء قالب HTML باستخدام المجموعات المتداخلة:

 $ html = new Html ( ' html ' );
$ head = $ html -> import ( ' head ' );
$ head -> title ( ' Example Title ' );
$ body = $ html -> import ( ' body ' );
$ body -> p ( ' Hello World ' );
echo $ html -> render ();

 < html >
    < head >
        < title > Example Title </ title >
    </ head >
    < body >
        < p > Hello World </ p >
    </ body >
</ html > 

باستخدام كمولد XML

 $ book = new Html ( ' book ' );
$ book -> title ( ' The Da Vinci Code ' );
$ author = $ book -> import ( ' author ' );
$ author -> name ( ' Dan Brown ' );
$ author -> nationality ( ' American ' );
echo $ book -> render ();

الإخراج

< book >
    < title >The Da Vinci Code</ title >
    < author >
        < name >Dan Brown</ name >
        < nationality >American</ nationality >
    </ author >
</ book >

متقدم

من الممكن إنشاء أي عنصر html عن طريق استدعاء اسمه.

 echo Html:: email ( ' [email protected] ' );
echo Html:: h1 ( ' Example Heading ' );

تحت الغطاء، نستخدم Html::input() لعنصر الإدخال و Html::tag() لعلامة html

إنشاء إدخال بريد إلكتروني باستخدام طريقة input :

 echo Html:: input ( ' email ' , ' [email protected] ' );

قم بإنشاء h1 باستخدام طريقة tag :

 echo Html:: tag ( ' h1 ' , ' Example Heading ' );

أضف HTML إلى العناصر قبل وبعد

 echo Html:: email ( '' , [ ' _before ' => ' Before ' , ' _after ' => ' After ' ]);

الإخراج

Before < input type =" email " /> After

أرفق مع عنصر آخر.

 echo Html:: email ( '' , [ ' _enclose ' => ' div ' ]);
echo Html:: email ( '' , [ ' _enclose ' => [ ' div ' , ' class ' => ' Class ' ]]);

الإخراج

 < div >
    < input type =" email " />
</ div >
< div class =" Class " >
    < input type =" email " />
</ div >

عدة طرق لتعيين خيارات التحديد / التحديد المتعدد / الراديو / مربع الاختيار

 // Same value and label
echo Html:: select ( null , [], [ ' audi ' , ' bmw ' ]);

// Different value and label
echo Html:: select ( null , [], [ ' audi ' => ' Audi ' , ' bmw ' => ' BMW ' ]);

// Option with extra attributes
echo Html:: select ( null , [], [ ' ferrari ' => [ ' Ferrari ' , ' data-origin ' => ' Italy ' ]]);
echo Html:: select ( null , [], [[ ' value ' => ' ferrari ' , ' label ' => ' Ferrari ' , ' data-origin ' => ' Italy ' ]]);

الإخراج

 < select > < option value =" audi " > audi </ option > < option value =" bmw " > bmw </ option > </ select >
< select > < option value =" audi " > Audi </ option > < option value =" bmw " > BMW </ option > </ select >
< select > < option value =" ferrari " data-origin =" Italy " > Ferrari </ option > </ select >
< select > < option value =" ferrari " data-origin =" Italy " > Ferrari </ option > </ select >

خلط عدة طرق مع مجموعة خيارات واحدة

 echo Html:: select ( null , [], [
    ' audi ' ,
    ' bmw ' => ' BMW ' ,
    ' honda ' => [
        ' Honda ' ,
        ' data-origin ' => ' Japan '
    ],
    [
        ' value ' => ' ferrari ' ,
        ' label ' => ' Ferrari ' ,
        ' data-origin ' => ' Italy '
    ]
]);

الإخراج

 < select >
    < option value =" audi " > audi </ option >
    < option value =" bmw " > BMW </ option >
    < option value =" honda " data-origin =" Japan " > Honda </ option >
    < option value =" ferrari " data-origin =" Italy " > Ferrari </ option >
</ select >

باستخدام القيمة الرقمية

 echo Html:: select ( null , [], [ 2 => ' Two ' , 4 => ' Four ' ]);

الإخراج

 < select >
    < option value =" 2 " > Two </ option >
    < option value =" 4 " > Four </ option >
</ select > 

حماية

الهروب من الإخراج

الهروب يعني إزالة البيانات غير المرغوب فيها، مثل علامات HTML أو علامات البرنامج النصي المشوهة.

تطبق المكتبة esc_attr على سمة القيمة. esc_url إلى سمات href و src .