API ของฟอร์มใช้ # ด้านหน้าของคุณสมบัติทั้งหมดเพื่อแยกความแตกต่างระหว่างคุณสมบัติและองค์ประกอบลูก ในรหัสต่อไปนี้$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',
);
คุณสมบัติทั้งหมดที่มีการระบุไว้ในการอ้างอิงในแบบฟอร์ม API มีคุณสมบัติมากมาย แต่ทั้งหมดเกี่ยวกับการแสดงผลการตรวจสอบและการส่ง
เหตุผลในการใช้คำนำหน้าสำหรับคุณสมบัติคือสามารถกรองคุณสมบัติออกจากองค์ประกอบย่อยอย่างรวดเร็วซึ่งมีประโยชน์เมื่อจำเป็นต้องสร้างการแสดงผลตัวอย่างเช่น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]);
}
}
หากคุณดูที่element_children ()คุณจะสังเกตเห็นรหัสเพื่อกรองคุณสมบัติต่างๆดังต่อไปนี้
// 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;
}
}
}