[TOC]
* * * * *
## 1 源代码文件
~~~
src\component\index.js
~~~
## 2 接口组织
### 2-1 avalon.component(name,definition)
### 2-2 源代码
~~~
avalon.component = function (name, definition) {
if (typeof name === 'string') {
//这里是定义组件的分支
avalon.components[name] = definition
for (var i = 0, obj; obj = componentQueue[i]; i++) {
if (name === obj.type) {
componentQueue.splice(i, 1)
i--
}
}
//这里没有返回值
} else {
var node = name //node为页面上节点对应的虚拟DOM
var vm = definition
var wid = node.props.wid
var options = node.props['ms-widget']
var tagName = node.type.indexOf('-') > 0 ? node.type : options.$type
//如果组件模板已经定
var placeholder = {
type: '#comment',
directive: 'widget',
props: {'ms-widget': wid},
nodeValue: 'ms-widget placeholder'
}
var docker = resolvedComponents[wid]
if (docker.render) {
//重新渲染自己
return reRender(docker)
} else if (!avalon.components[tagName]) {
componentQueue.push({
type: tagName
})
return placeholder
} else {
//页面上的节点是用于传参的
//通过插件的template字符串生成的节点,是来授参执行的
var type = node.type
if (!rcomponentTag.test(type)) {
avalon.warn(type + '不合适做组件的标签')
}
if (type === 'xmp' || type === 'template' || node.children.length === 0) {
node.children = avalon.lexer(docker.template)
}
definition = avalon.components[tagName]
if (!avalon.modern && !definition.fixTag) {
avalon.document.createElement(tagName)
definition.fixTag = 1
}
var vtree = avalon.lexer(definition.template.trim())
if (vtree.length > 1) {
avalon.error('组件必须用一个元素包起来')
}
var widgetNode = vtree[0]
if (widgetNode.type !== tagName) {
avalon.warn('模板容器标签最好为' + tagName)
}
for (var i in docker.props) {
if (!skip[i]) {
widgetNode.props[i] = docker.props[i]
}
}
if (!node.isVoidTag) {
//如果不是半闭合标签,那么里面可能存在插槽元素,抽取出来与主模板合并
insertSlots(vtree, node)
}
delete options.$type
delete options.$define
var diff = options
delete options.$diff
var define = options.$define || avalon.directives.widget.define
var $id = options.$id || avalon.makeHashCode(tagName.replace(/-/g, '_'))
var vmodel = define(vm, definition.defaults, options)
vmodel.$id = $id
avalon.vmodels[$id] = vmodel
//生成组件的render
var render = avalon.render(vtree)
vmodel.$render = render
vmodel.$fire('onInit', vmodel)
avalon.mix(docker, {
render: render,
vmodel: vmodel,
diff: diff,
placeholder: placeholder
})
return reRender(docker)
}
}
}
~~~
## 3 其他操作
## 4 总结
- 概述
- 框架目录
- 组件目录(components\)
- 生成目录(dist\)
- 测试目录(karma\)
- 示例目录(perf\)
- 主体目录(src)
- 其他文件
- 框架流程
- 前:章节说明
- 主:模板扫描(avalon.scan())
- 主:VM创建(avalon.define())
- 主:同步刷新(avalon.batch())
- 附:节点解析(avalon.lexer())
- 附:虚拟DOM(avalon.vdomAdaptor())
- 附:渲染函数(avalon.render())
- 附:VM生成(avalon.masterFactory())
- 附:节点diff(avalon.diff())
- 主:界面事件(test)
- 框架工具
- 另:全局函数
- 另:全局正则
- 另:事件接口
- 另:组件接口
- 另:DOMApi
- 框架驱动
- D : 指令实现
- D:兼容处理
- 使用范例
- 基础原理
- js模块
- js对象
- js函数
- js数组
- js字符串
- dom接口
- 框架心得
- 心:总体思路