Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
merge from yiidoc
- Loading branch information
qiang.xue
committed
May 10, 2009
1 parent
aa67830
commit 1bff887
Showing
57 changed files
with
6,560 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
Neue Features | ||
============= | ||
|
||
Diese Seite fasst die wesentlichen neuen Features jeder Yii-Version zusammen. | ||
|
||
Version 1.0.5 | ||
------------- | ||
|
||
* ActiveRecord wurden um benannte Bereiche erweitert. Siehe: | ||
- [Benannte Bereiche](/doc/guide/database.ar#named-scopes) | ||
- [Relationale Abfragen mit benannten Bereichen](/doc/guide/database.arr#relational-query-with-named-scopes) | ||
|
||
|
||
* ActiveRecord unterstützt nun lazy loading mit dynamischen Abfrageoptionen. Siehe: | ||
- [Dynamische Optionen für relationale Abfragen](/doc/guide/database.arr#dynamic-relational-query-options) | ||
|
||
<div class="revision">$Id: changes.txt 956 2009-04-21 15:16:03Z qiang.xue@gmail.com $</div> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,149 @@ | ||
Vista (View) | ||
============ | ||
|
||
Una vista es un script PHP que consiste basicamente en elementos de la interfaz | ||
de usuario (user interface - UI). La misma puede contener expresiones PHP, pero | ||
es recomendable que estas expresiones no modifiquen los datos del modelo y se | ||
mantengan relativamente simples. Para el mantener la separación de la lógica y | ||
la presentación se recomienda que la gran parte de la lógica se encuentre | ||
en el modelo y no en la vista. | ||
|
||
Una vista tiene el mismo nombre que es utilizada para identificar un archivo | ||
script de vista cuando se presenta. El nombre de la vista es el mismo que el nombre | ||
del archivo de la vista. Por ejemplo, la vista `edit`se refiere a el archivo | ||
script de vista llamado `edit.php`. Para presentar una vista llame a | ||
[CController::render()] con el nombre de la vista. Este método buscara la vista | ||
dentro del directorio `protected/views/ControllerID`. | ||
|
||
Dentro del script de vista podemos acceder al controlador utilizando `$this`. | ||
De esta forma podemos pasmar cualquier propiedad del controlador en la vista | ||
evaluando `$this->propertyName`. | ||
|
||
También podemos utilizar la siguiente forma de llamado a la función render del | ||
controlador para pasar datos a la vista. | ||
|
||
~~~ | ||
[php] | ||
$this->render('edit', array( | ||
'var1'=>$value1, | ||
'var2'=>$value2, | ||
)); | ||
~~~ | ||
|
||
En el ejemplo anterior, el método [render()|CController::render] extraera el segundo parametro array | ||
en el script de vista para que lo podamos acceder como variables locales `$var1` y `$var2`. | ||
|
||
Esquema (Layout) | ||
---------------- | ||
|
||
El esquema o layout es un tipo de vista especial que es utilizado para decorar vistas. | ||
El mismo contiene usualmente porciones de la interfaz de usuario que son comunes a travez de | ||
muchas vistas. Por ejemplo, el esquema o layout puede contener la porción de header y footer | ||
y embeber dentro el contenido de la vista, | ||
|
||
~~~ | ||
[php] | ||
......header here...... | ||
<?php echo $content; ?> | ||
......footer here...... | ||
~~~ | ||
|
||
en donde `$content` contiene el resultado de la presentación de la vista contenida. | ||
|
||
El esquema o layout es aplicado implicitamente cuando se llama a la funcion | ||
[render()|CController::render]. Por predeterminado, el script de la vista | ||
`protected/views/layouts/main.php` es utilizado como el esquema. Esto puede ser | ||
personalizado modificando [CWebApplication::layout] o [CController::layout]. | ||
Para presentar una vista sin aplicarle ningún esquema, llame a la funcion | ||
[renderPartial()|CController::renderPartial] en vez de la función `render()`. | ||
|
||
Widget | ||
------ | ||
|
||
Un widget es una instancia de [CWidget] o una clase que lo hereda. Es un componente | ||
con proposito presentacional principalmente. Los widgets son usualmente embebidos | ||
en los scripts de vista para generar interfaces de usuarios complejas y contenidas | ||
en los mismos widgets. Por ejemplo, un widget calendario puede ser utilizado para | ||
presentar una interfaz de usuario compleja de calendario. Los widgets nos ayudan a | ||
tener mayor reusabilidad de la interfaz de usuario. | ||
|
||
Para utilizar un widget realize lo siguiente en un script de vista: | ||
|
||
~~~ | ||
[php] | ||
<?php $this->beginWidget('path.to.WidgetClass'); ?> | ||
...body content that may be captured by the widget... | ||
<?php $this->endWidget(); ?> | ||
~~~ | ||
|
||
o | ||
|
||
~~~ | ||
[php] | ||
<?php $this->widget('path.to.WidgetClass'); ?> | ||
~~~ | ||
|
||
El segundo se utiliza cuando el widget no necesita ninguno contenido es su cuerpo. | ||
|
||
Los widgets pueden ser configurados para customizarse según su comportamiento. | ||
Esto es realizado mediante la configuración de sus valores de propiedades iniciales | ||
cuando se llama al método [CBaseController::beginWidget] o al método | ||
[CBaseController::widget]. Por ejemplo, cuando se utiliza el widget [CMaskedTextField], | ||
se puede identificar que máscara se desea utilizar. Podemos hacerlo pasandole | ||
un array con los valores de las propiedades incialmente de la siguiente forma, donde | ||
las claves del array son los nombres de las propiedades y los valores del array los | ||
vlores iniciales de las correspondientes propiedades del widget: | ||
|
||
~~~ | ||
[php] | ||
<?php | ||
$this->widget('CMaskedTextField',array( | ||
'mask'=>'99/99/9999' | ||
)); | ||
?> | ||
~~~ | ||
|
||
Para definir un nuevo widget extienda [CWidget] y sobrecarge los métodos | ||
[init()|CWidget::init] y [run()|CWidget::run]: | ||
|
||
~~~ | ||
[php] | ||
class MyWidget extends CWidget | ||
{ | ||
public function init() | ||
{ | ||
// this method is called by CController::beginWidget() | ||
} | ||
|
||
public function run() | ||
{ | ||
// this method is called by CController::endWidget() | ||
} | ||
} | ||
~~~ | ||
|
||
Como un controlador el widget también puede tener sus propias vistas. Por predeterminado, | ||
los archivos de vista de un widget se encuentran dentro del subdirectorio `views` del | ||
directorio que contiene el archivo de clase widget. Estas vistas pueden ser presentadas | ||
llamando al método [CWidget::render()], similarmente a como se realiza en un controlador. | ||
La única diferencia es que no se le aplicará ningún esquema o layout a la vista de un widget. | ||
|
||
Vistas de sistema | ||
----------------- | ||
|
||
Las vistas de sistema es la forma de referirse a las vistas utilizadas por Yii | ||
para mostrar los errores y la informaccion del logueo. Por ejemplo, cuando | ||
un se realiza un pedido de un controlador o una accion inexistente, Yii lanzará una | ||
excepción explicando el error. Yii mostrará el error utilizando la vista del sistema | ||
especifica para el mismo. | ||
|
||
Los nombres de las vistas del sistema siguen ciertas reglas. Nombres como | ||
`errorXXX` refieren a vistas que muestran las CHttpException con código de error | ||
`XXX`. Por ejemplo, si [CHttpException] es lanzada con el código de error 404, | ||
la vista `error404` será la que se mostrará. | ||
|
||
Yii provee un conjunto de vistas de sistema predeterminados que se pueden localizar en | ||
`framework/views`. Las mismas pueden ser personalizadas creando las vistas con el mismo | ||
nombre de archivo dentro de `protected/views/system`. | ||
|
||
<div class="revision">$Id: basics.view.txt 416 2008-12-28 05:28:11Z sebathi $</div> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
Fitur Baru | ||
========== | ||
|
||
Halaman ini meringkas fitur-fitur utama baru yang diperkenalkan dalam setiap rilis Yii. | ||
|
||
Versi 1.0.5 | ||
------------- | ||
|
||
* Rekaman aktif ditingkatkan dengan mendukung lingkup penamaan. Lihat: | ||
- [Lingkup Bernama](/doc/guide/database.ar#named-scopes) | ||
- [Query Relasional dengan Lingkup Bernama](/doc/guide/database.arr#relational-query-with-named-scopes) | ||
|
||
|
||
* Rekaman aktif ditingkatkan dengan mendukung pemanggilan lazy dengan opsi query dinamis. Lihat: | ||
- [Opsi Query Relasional Dinamis](/doc/guide/database.arr#dynamic-relational-query-options) | ||
|
||
<div class="revision">$Id: changes.txt 956 2009-04-21 15:16:03Z qiang.xue@gmail.com $</div> |
Oops, something went wrong.