বৈশিষ্ট্য এবং শিশু উপাদানগুলির মধ্যে পার্থক্য তৈরি করতে ফর্ম এপিআই সমস্ত বৈশিষ্ট্যের সামনে একটি # ব্যবহার করে। নিম্নলিখিত $form['choice_wrapper']['choice']কোডটিতে একটি শিশু উপাদান, যখন $form['choice_wrapper']['#tree']সম্পত্তি।
// Add a wrapper for the choices and more button.
$form['choice_wrapper'] = array(
'#tree' => FALSE,
'#weight' => -4,
'#prefix' => '<div class="clearfix" id="poll-choice-wrapper">',
'#suffix' => '</div>',
);
// Container for just the poll choices.
$form['choice_wrapper']['choice'] = array(
'#prefix' => '<div id="poll-choices">',
'#suffix' => '</div>',
'#theme' => 'poll_choices',
);
এই সমস্ত সম্পত্তি ফর্ম এপিআই রেফারেন্সে তালিকাভুক্ত । এখানে অনেকগুলি সম্পত্তি রয়েছে তবে তারা সমস্ত রেন্ডারিং, বৈধতা এবং জমা দেওয়ার বিষয়ে।
বৈশিষ্ট্যগুলির জন্য একটি উপসর্গ ব্যবহার করার কারণ হ'ল শিশু উপাদানগুলির থেকে বৈশিষ্ট্যগুলি দ্রুত ফিল্টার করা সক্ষম হয়, যা যখন তাদের রেন্ডার করা প্রয়োজন তখন দরকারী, উদাহরণস্বরূপ drupal_render () সহ , যা নিম্নলিখিত কোডটি ধারণ করে।
// Get the children of the element, sorted by weight.
$children = element_children($elements, TRUE);
// Initialize this element's #children, unless a #pre_render callback already
// preset #children.
if (!isset($elements['#children'])) {
$elements['#children'] = '';
}
// Call the element's #theme function if it is set. Then any children of the
// element have to be rendered there.
if (isset($elements['#theme'])) {
$elements['#children'] = theme($elements['#theme'], $elements);
}
// If #theme was not set and the element has children, render them now.
// This is the same process as drupal_render_children() but is inlined
// for speed.
if ($elements['#children'] == '') {
foreach ($children as $key) {
$elements['#children'] .= drupal_render($elements[$key]);
}
}
আপনি যদি এলিমেন্ট_চিল্ডেন () দেখুন , আপনি নীচের বৈশিষ্ট্যগুলি ফিল্টার আউট করার জন্য কোডটি লক্ষ্য করবেন।
// Filter out properties from the element, leaving only children.
$children = array();
$sortable = FALSE;
foreach ($elements as $key => $value) {
if ($key === '' || $key[0] !== '#') {
$children[$key] = $value;
if (is_array($value) && isset($value['#weight'])) {
$sortable = TRUE;
}
}
}