开发者日益需要制作网站内容支持多种语言和地区。Zend_Form 把这样的任务变得简单并利用 Zend_Translate 和 Zend_Validate 来完成。
缺省地,Zend_Form
不支持国际化(I18n)。要打开在 Zend_Form
中的 I18n 功能,需要带适当的适配器实例化一个 Zend_Translate
对象,并把它附加到 Zend_Form
和/或 Zend_Validate
中。参见 Zend_Translate 文档 有更多关于生成翻译对象和翻译文件的信息。
可以对每个元素关闭翻译 | |
---|---|
你可以通过调用 |
要在表单中初始化 I18n,你需要或者 Zend_Translate
对象或者 Zend_Translate_Adapter
对象,详细请见 Zend_Translate
文档。一旦你有一个翻译对象,你将有若干选项:
Easiest: 添加它到注册表。Zend Framework 中所有 I18n 相关的组件将自动发现一个翻译对象(这个对象在注册表中在 'Zend_Translate' 键之下)并用它翻译和/或本地化:
<?php // use the 'Zend_Translate' key; $translate is a Zend_Translate object: Zend_Registry::set('Zend_Translate', $translate); ?>
这将由 Zend_Form
、Zend_Validate
和 Zend_View_Helper_Translate
来获得。
如果你所担心的是翻译校验错误消息,可以用 Zend_Validate_Abstract
来注册翻译对象:
<?php // Tell all validation classes to use a specific translate adapter: Zend_Validate_Abstract::setDefaultTranslator($translate); ?>
另外,你可以(把它)附加到 Zend_Form
对象作为全局翻译器。这个也有翻译校验错误消息的副作用:
<?php // Tell all form classes to use a specific translate adapter, as well as use // this adapter to translate validation error messages: Zend_Form::setDefaultTranslator($translate); ?>
最后,你可以用 setTranslator()
方法附加一个翻译器到一个特定的表单实例或特定的元素:
<?php // Tell *this* form instance to use a specific translate adapter; it will also // be used to translate validation error messages for all elements: $form->setTranslator($translate); // Tell *this* element to use a specific translate adapter; it will also be used // to translate validation error messages for this particular element: $element->setTranslator($translate); ?>
既然你已经附加了翻译对象,那么到底什么是缺省翻译?
Validation error messages. 校验错误消息可以被翻译。使用从 Zend_Validate
校验类来的各种错误代码常数作为消息的 IDs。更多关于这些代码的信息,参见 Zend_Validate 文档。
另外,到 1.6.0 版,你可使用实际的错误消息作为消息识别符来提供翻译。我们倾向在 1.6.0 版及以上使用这个办法,因为我们在将来的版本中废除消息键翻译。
Labels. 如果翻译存在,元素标签 (labels)将被翻译。
Fieldset Legends. 显示组和子表单缺省地在字段中解析。字段装饰器在解析字段钱尝试翻译 legend。
Form and Element Descriptions. 所有表单类型(元素、表单、显示组、子表单)允许指定一个可选的条目描述。描述装饰器可用来解析它,缺省地它将尝试翻译它。
Multi-option Values. 对于各种从 Zend_Form_Element_Multi
继承的条目(包括 MultiCheckbox、 Multiselect 和 Radio 元素),如果翻译可用,选项值(不是键)将被翻译。这意味着显示给用户的选项标签将被翻译。
Submit and Button Labels. 各种提交和按钮元素(按钮,提交和重置)将翻译显示给用户的标签。