用正确的方式渲染Drupal Field(字段)

Submitted by admin on Sun, 12/14/2014 - 09:56
$node->field_name['und'][0]['safe_value']

对于大多数人来说,一般会使用上面的方式来打印一个字段的值。

这是普遍的做法,但是不通用。

上面的做法,会有如下问题:

1: 'und'的使用容易导致多语言方面的问题。

2:上面的方式,打印的是field的原始的值;不是正常的field的渲染方式。

3:[0]['safe_value'],这种方式只会渲染第一个值。如果是一个多值字段,会有数据不会被渲染出来。

4:对于有些字段,比如entityreference类型的字段,是没有['safe_value']这个东西的,这种方式很容易出现语法错误。


下面推荐的是一种Drupal原生的方式渲染字段:

即field_view_field

常规用法如下:

$output = field_view_field('node', $node, 'field_name');
print render($output);

这种方式,可以兼容上面提到的几种容易产生问题的地方。同时,你可以更灵活的渲染你的字段。

比如对于图片字段,默认的label隐藏,使用medium的imagestyle来显示图片,则可以使用如下的代码:

  $node = node_load(NID);
  $display = array(
    'label' => 'hidden',
    'settings' => array(
      'image_style' => 'food_pairing',
    )
  );
  $field = field_view_field('node', $node, 'field_image', $display);

  对于body字段,打印起trim的值:

  $display = array(
    'label'=>'hidden', 
    'type' => 'text_summary_or_trimmed', 
    'settings'=>array('trim_length' => 150),
  );
  $output = field_view_field('node', $node, 'body', $display);
  print render($output);

额外补充:

如果只想获得field的值,则可以使用field_get_items,并结合field_view_value,可以实现打印指定的$delta的值;比如第一个。代码示例如下:

$node = node_load($nid);
$field = field_get_items('node', $node, 'field_name');
$output = field_view_value('node', $node, 'field_name', $field[$delta]);