From 84a6c667801d46c4cb6f831c9e40043b308f96d8 Mon Sep 17 00:00:00 2001 From: xue <> Date: Sun, 5 Feb 2006 23:38:21 +0000 Subject: Added two examples showing creating new controls by composition. --- .../protected/pages/Controls/NewControl.page | 90 +++++++++++++++++++++- .../Controls/Samples/LabeledTextBox1/Home.page | 11 +++ .../Controls/Samples/LabeledTextBox1/Home.php | 13 ++++ .../Samples/LabeledTextBox1/LabeledTextBox.php | 18 +++++ .../Samples/LabeledTextBox1/LabeledTextBox.tpl | 2 + .../Controls/Samples/LabeledTextBox2/Home.page | 11 +++ .../Controls/Samples/LabeledTextBox2/Home.php | 13 ++++ .../Samples/LabeledTextBox2/LabeledTextBox.php | 32 ++++++++ .../protected/pages/GettingStarted/AboutPrado.page | 29 +++++-- 9 files changed, 212 insertions(+), 7 deletions(-) create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.page create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.php create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.php create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.tpl create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.page create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.php create mode 100644 demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/LabeledTextBox.php (limited to 'demos/quickstart/protected/pages') diff --git a/demos/quickstart/protected/pages/Controls/NewControl.page b/demos/quickstart/protected/pages/Controls/NewControl.page index f4ded5a4..8e2a21cf 100644 --- a/demos/quickstart/protected/pages/Controls/NewControl.page +++ b/demos/quickstart/protected/pages/Controls/NewControl.page @@ -1,15 +1,101 @@

Writing New Controls

+

+Writing new controls is often desired by advanced programmers, because they want to reuse the code that they write for dealing with complex presentation and user interactions. +

+

+In general, there are two ways of writing new controls: composition of existing controls and extending existing controls. They all require that the new control inherit from TControl or its child classes. +

Composition of Existing Controls

+

+Composition is the easiest way of creating new controls. It mainly involves instantiating existing controls, configuring them and making them the constituent components. The properties of the constituent components are exposed through subproperties. +

+

+One can compose a new control in two ways. One is to override the TControl::createChildControls() method. The other is to extend TTemplateControl (or its child classes) and write a control template. The latter is easier to use and can organize the layout constituent compoents more intuitively, while the former is more efficient because it does not require parsing of the template. +

+

+As an example, we show how to create a labeled textbox called LabeledTextBox using the above two approaches. A labeled textbox displays a label besides a textbox. We want reuse the PRADO provided TLabel and TTextBox to accomplish this task. +

-

+

Composition by Writing Templates

+

+We need two files: a control class file named LabeledTextBox.php and a control template file named LabeledTextBox.tpl. Both must reside under the same directory. +

+

+Like creating a PRADO page, we can easily write down the content in the control template file. +

+ +<com:TLabel ID="Label" ForControl="TextBox" /> +<com:TTextBox ID="TextBox" /> + +

+The above template specifies a TLabel control named Label and a TTextBox control named TextBox. We would to expose these two controls. This can be done by defining a property for each control in the LabeledTextBox class file. For example, we can define a Label property as follows, +

+ +class LabeledTextBox extends TTemplateControl { + public function getLabel() { + $this->ensureChildControls(); + return $this->getRegisteredObject('Label'); + } +} + +

+In the above, the method call to ensureChildControls() ensures that both the label and the textbox controls are created (from template) when the Label property is accessed. The TextBox property can be implemented similarly. +

+ + +

Composition by Overriding createChildControls()

+

+For a composite control as simple as LabeledTextBox, it is better to create it by extending TControl and overriding the createChildControls() method, because it does not use templates and thus saves template parsing time. +

+

+Complete code for LabeledTextBox is shown as follows, +

+ +class LabeledTextBox extends TControl { + private $_label; + private $_textbox; + protected function createChildControls() { + $this->_label=new TLabel; + $this->_label->setID('Label'); + // add the label as a child of LabeledTextBox + $this->getControls()->add($label); + $this->_textbox=new TTextBox; + $this->_textbox->setID('TextBox'); + // add the textbox as a child of LabeledTextBox + $this->getControls()->add($textbox); + } + public function getLabel() { + $this->ensureChildControls(); + return $this->_label; + } + public function getTextBox() { + $this->ensureChildControls(); + return $this->_textbox; + } +} + + + +

Using LabeledTextBox

+

+To use LabeledTextBox control, first we need to include the corresponding class file. Then in a page template, we can write lines like the following, +

+ +<com:LabeledTextBox ID="Input" Label.Text="Username" /> + +

+In the above, Label.Text is a subproperty of LabeledTextBox, which refers to the Text property of the Label property. For other details of using LabeledTextBox, see the above online examples. +

Extending Existing Controls

Extending TControl

Extending TWebControl

- +PostBackHandler +PostBackEvnetHandler +DataBoundControl
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.page b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.page new file mode 100644 index 00000000..ed05bfdf --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.page @@ -0,0 +1,11 @@ + + + + + \ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.php b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.php new file mode 100644 index 00000000..2b18972d --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/Home.php @@ -0,0 +1,13 @@ +Text=$this->Input->TextBox->Text; + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.php b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.php new file mode 100644 index 00000000..999639d7 --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.php @@ -0,0 +1,18 @@ +ensureChildControls(); + return $this->getRegisteredObject('Label'); + } + + public function getTextBox() + { + $this->ensureChildControls(); + return $this->getRegisteredObject('TextBox'); + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.tpl b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.tpl new file mode 100644 index 00000000..8b3c1406 --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox1/LabeledTextBox.tpl @@ -0,0 +1,2 @@ + + \ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.page b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.page new file mode 100644 index 00000000..ed05bfdf --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.page @@ -0,0 +1,11 @@ + + + + + \ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.php b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.php new file mode 100644 index 00000000..2309bd88 --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/Home.php @@ -0,0 +1,13 @@ +Text=$this->Input->TextBox->Text; + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/LabeledTextBox.php b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/LabeledTextBox.php new file mode 100644 index 00000000..f4148148 --- /dev/null +++ b/demos/quickstart/protected/pages/Controls/Samples/LabeledTextBox2/LabeledTextBox.php @@ -0,0 +1,32 @@ +_label=new TLabel; + $this->_label->setID('Label'); + $this->getControls()->add($this->_label); + $this->getControls()->add(' '); + $this->_textbox=new TTextBox; + $this->_textbox->setID('TextBox'); + $this->getControls()->add($this->_textbox); + } + + public function getLabel() + { + $this->ensureChildControls(); + return $this->_label; + } + + public function getTextBox() + { + $this->ensureChildControls(); + return $this->_textbox; + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/AboutPrado.page index 03d9afe8..0d031f9f 100644 --- a/demos/quickstart/protected/pages/GettingStarted/AboutPrado.page +++ b/demos/quickstart/protected/pages/GettingStarted/AboutPrado.page @@ -1,19 +1,38 @@

What is PRADO?

-PRADO stands for PHP Rapid Application Development -Object-oriented. +PRADO is a component-based and event-driven programming framework for developing Web applications in PHP 5. PRADO stands for PHP Rapid Application Development Object-oriented.

-PRADO is a component-based and event-driven programming framework for developing Web applications in PHP 5. +PRADO stipulates a protocol of writing and using components to construct Web applications. A component is a software unit that is self-contained and can be reused with trivial customization.

-PRADO stipulates a protocol of writing and using components to construct Web applications. A component is a software unit that is self-contained and can be reused with trivial customization. New components can be developed by either inheriting or composing from existing ones. Component-based programming brings great freedom in teamwork anf offers the ultimate extensibility and maintenability to the code. PRADO implements a set of elementary components that represent commonly used Web elements, such as input field, checkbox, dropdown list, etc. +PRADO implements an event-driven programming paradigm that allows delegation of extensible behavior to components. End-user activities, such as clicking on a submit button, are captured as server events. Methods or functions may be attached to these events so that when the events happen, they are invoked automatically to respond to the events. Compared with the traditional Web programming in which developers have to deal with the raw POST or GET variables, event-driven programming helps developers better focus on the necessary logic and reduces significantly the low-level repetitive coding.

+ +

Why PRADO?

-PRADO implements an event-driven programming scheme that allows delegation of extensible behavior to components. End-user activities, such as clicking on a submit button, changing the content in an input field, are captured as server events. Methods or functions may be attached to these events so that when the events happen, they are invoked automatically to respond to the events. Compared with the traditional Web programming in which developers have to deal with the raw POST or GET variables, event-driven programming helps developers better focus on the necessary logic and reduces significantly the low-level repetitive coding. +A primary goal of PRADO is to enable maximum reusability in Web programming. By reusability, we mean not only reusing one's own code, but also reusing other people's code in an easy way. The latter is more important as it saves the effort of reinventing the wheels and may cut off development time dramatically. The introduction of the concept of component is for this purpose. +

+

+Reusing existing components is very easy. It merely involves getting and setting component properties, and sometimes responding to component events. PRADO provides a complete set of components that deal with common Web programming tasks, such as collecting and validating user inputs through generic HTML elements, manipulating tabular data, etc. These components can be rapidly glued together and form Web pages that are highly user interactive. For example, using the datagrid component, one only needs to write a few lines of PHP code (mainly to populate the data into the datagrid), and he can create a page presenting a data table which allows paging, sorting, editting, and deleting rows of data. +

+

+Developing new components can also be very easy. A new component class can be created by composing together several existing components in a template which specifies the layout of the constituent components. The page that you are reading now is such an example. It is the presentation of a component without a single line of PHP code.

Developing a PRADO Web application mainly involves instantiating prebuilt component types, configuring them by setting their properties, responding to their events by writing handler functions, and composing them into pages for the application. It is very similar to RAD toolkits, such as Borland Delphi and Microsoft Visual Basic, that are used to develop desktop GUI applications.

+ +

What Is PRADO Best For?

+

+PRADO is best suitable for creating Web front-ends that are highly user-interactive and require small to medium traffic. It can be used to develop systems as simple as a blog system to systems as complex as a content management system (CMS) or a complete e-commerce solution. PRADO can help you cut your development time significantly. +

+

+PRADO does not exclude other back-end solutions such as most DB abstraction layers. In fact, they can be used like what you usually do with traditional PHP programming. +

+

+Without server caching techniques, PRADO may not be suitable for developing extremely high-traffic Web applications, such as popular portals, forums, etc. In these applications, every niche of potential performance gain must be exploited and server caching (e.g. Zend optimizer) is almost a must. +

+
\ No newline at end of file -- cgit v1.2.3