mirror of
https://github.com/frappe/books.git
synced 2024-12-22 10:58:59 +00:00
docs
This commit is contained in:
parent
0fa2c70133
commit
3ce79d2027
@ -1,4 +1,4 @@
|
||||
# Frappe.JS
|
||||
# Frappe.js
|
||||
|
||||
Frappe.js is a meta-data driven framework that enables rapid application development of Node.js and Electron based applications.
|
||||
|
||||
@ -12,7 +12,7 @@ Frappe.js is a meta-data driven framework that enables rapid application develop
|
||||
|
||||
## Documentation
|
||||
|
||||
[Read the full docs](docs/README.md)
|
||||
[Read the full docs](frappe/docs/README.md)
|
||||
|
||||
## License
|
||||
|
||||
|
@ -12,7 +12,7 @@ Frappe.js is a meta-data driven framework that enables rapid application develop
|
||||
- [Server](server.md)
|
||||
- [REST API](rest.md)
|
||||
- [Client](client.md)
|
||||
- [Routing](routing.md)
|
||||
- [Routing](router.md)
|
||||
- [Page](page.md)
|
||||
- [Lists](lists.md)
|
||||
- [Forms](forms.md)
|
||||
|
@ -1,21 +1,43 @@
|
||||
# Controllers
|
||||
|
||||
In Frappe.js you can extend the metadata class as well as the document class for a particular DocType. The `meta` class contains actions that are done on a group of objects and a document represents a single object. So properties and actions related to the group will be part of the `meta` class
|
||||
In Frappe.js you can extend the metadata class as well as the document class for a particular DocType.
|
||||
|
||||
You can write event handlers in controllers, by declaring a `.js` file in the `models/doctype/` folder along with the model file.
|
||||
|
||||
### Naming
|
||||
## Naming
|
||||
|
||||
1. The name of the controller class must be the slugged name of the DocType (example `todo`)
|
||||
2. The name of the `meta` class must be the name of the controller class prefixed by `meta_` (example `meta_todo`)
|
||||
|
||||
To add a standard handler, you must bind all handlers in `setup` method.
|
||||
|
||||
### Example
|
||||
## Document Controller
|
||||
|
||||
You can bind events to the controller that will be called when an action is completed on a document or its property.
|
||||
|
||||
The document controller represents a single record and is subclassed from the `frappe.document.Document` class
|
||||
|
||||
```js
|
||||
const frappe = require('frappe-core');
|
||||
|
||||
// extend the document and add event handlers
|
||||
class todo extends frappe.document.Document {
|
||||
setup() {
|
||||
this.add_handler('validate');
|
||||
}
|
||||
validate() {
|
||||
if (!this.status) {
|
||||
this.status = 'Open';
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Metadata Controller
|
||||
|
||||
The `meta` class contains actions that are done on a group of objects and a document represents a single object. So properties and actions related to the group will be part of the `meta` class.
|
||||
|
||||
```js
|
||||
// extend the meta class
|
||||
class todo_meta extends frappe.meta.Meta {
|
||||
setup_meta() {
|
||||
@ -29,25 +51,9 @@ class todo_meta extends frappe.meta.Meta {
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
// extend the document and add event handlers
|
||||
class todo extends frappe.document.Document {
|
||||
setup() {
|
||||
this.add_handler('validate');
|
||||
}
|
||||
validate() {
|
||||
if (!this.status) {
|
||||
this.status = 'Open';
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
todo: todo,
|
||||
todo_meta: todo_meta
|
||||
};
|
||||
```
|
||||
|
||||
|
||||
### Controller Events
|
||||
|
||||
Standard events on which you can bind handlers are
|
||||
|
Loading…
Reference in New Issue
Block a user