第一章 OWL应用
概述
一个OWL应用有一个根元素,若干模版,环境变量和设置组成。App类是一个代表了这些元素的简单类。下面是一个例子:
const {Component, App } = owl;
class MyComponent extends Component { ... }
const app = new App(MyComponent, { props: {...}, templates: "..."});
app.mount(document.body)
创建一个OWL应用的流程是:
- 创建一个APP
- 创建一个组件
- 使用创建的组件和其他必要的设置,模版等实例化该App
- 将app挂载到DOM中。
API
构造函数
constructor(Root[,config]): 第一个参数是一个组件的类,第二个是参数是配置对象。
挂载
mount(target, options): 第一个参数为挂载的位置,第二个参数可选,可选值为first-child or last-child。该参数决定挂载的位置是第一个还是最后一个子节点。
销毁
destroy(): 销毁该应用
配置
在应用中,可以配置的参数如下:
- env: 环境变量,可以在组件间进行共享的数据结构。
- props: root组件的属性对象。
- dev: 布尔值,是否是开发者模式,默认为false。
- test: 布尔值,与dev模式一样,只是不在日志中提示为开发者模式。
- translatableAttributes:字符串列表,应该翻译的属性列表。
- translateFn:owl翻译模版时被调用的方法
- templates:模版名称或XML代码,被组件用来渲染的模版
- warnIfNoStaticProps:布尔值,当一个组件没有静态描述属性时,是否在日志进行提示。