aotoo

aotoo是一个react的封装库，将react组件js实例化

在一些小型的项目，不需要引入redux等状态库，使用ao2封装原生react组件(自定义)生成JS对象，通过定义内部的属性和方法，来更新状态

INSTALL

yarn add @aotoo/aotoo
#
npm install @aotoo/aotoo

USAGE 1 计数器

下例是一个简单的计数器组件，为react原生组件添加了属性和api方法，其中api暴露给外部使用，如下例中的button按钮通过暴露的increase方法设置组件计数

Demo: codesandbox.io/s/aotoo6jis…

import createComponent from '@aotoo/aotoo'

class Count extends React.Component {
  render() {
    return (
      <div className="container" onClick={this.env.increase}>
        {this.state.count || 0}
      </div>
    );
  }
}

const countInstance = createComponent(Count, {
  data: {  // 将转化成react组件的state
    count: 0,
  },
  increase(e) {
    let count = this.getData().count;
    count++;
    this.setData({ count });
  }
});

function Container() {
  return (
    <>
      <countInstance.UI />
      <button onClick={countInstance.increase}>计数器</button>
    </>
  );
}

ReactDOM.render(<Container />, document.getElementById('root'))

USAGE 2 配置化计数器组件

参考微信小程序组件的设计，使用配置化生成react组件，并对外曝露相关api方法

Demo: codesandbox.io/s/aotoo6jis…

import createComponent from '@aotoo/aotoo'

const countTemplate = function (state, props) {
  return <div className={"container"}>{state.count}</div>;
};

const countConfig = {
  data: {
    count: 0
  },
  increase() {
    let count = this.getData().count;
    count++;
    this.setData({ count });
  }
};

let count = createComponent(countConfig, countTemplate);

function Container() {
  return (
    <>
      <count.UI />
      <button onClick={count.increase}>计数器</button>
    </>
  );
}

ReactDOM.render(<Container/>, document.getElementById('root'))

生命周期

组件的生命周期，指的是组件自身的一些函数，这些函数在特殊的时间点或遇到一些特殊的框架事件时被自动触发。其中，最重要的生命周期是 created attached detached ，包含一个组件实例生命流程的最主要时间点。生命周期的设计参考微信小程序

import createComponent, {$$} from '@aotoo/aotoo';
createComponent({
  created: function(){
    // 在组件实例刚刚被创建时执行
  },
  attached: function() {
    // 在组件实例进入页面节点树时执行
  },
  ready: function(){
    // 在组件在视图层布局完成后执行
  },
  didUpdate: function(){
    // 在组件挂载后，每一次更新后会调用
  },
  detached: function() {
    // 在组件实例被从页面节点树移除时执行
  },
}, 
template
)

通用属性

属性	类型	说明
$$id	String	类似于$('#id')的id
created	Function	生命周期，同小程序组件
attached	Function	生命周期，同小程序组件
ready	Function	生命周期，同小程序组件
didUpdate	Function	每次更新后触发

通用API

方法	类型	说明
parent	(p)	查找父级
getData	()	获取元素数据
show	()	显示该组件
hide	()	隐藏该组件
destory	()	销毁该组件
render	(p)	渲染组件，与直接写jsx一致
attr	(p1, p2)	设置/获取data-*属性

内置组件

item

引入@aotoo/aotoo后，会生成全局变量ui_item和全局方法组件UI_item, item组件将会生成一个div的html结构

ui_item

配置化生成item组件

import '@aotoo/aotoo'

const itemConfig = {
  title: '标题',
  onClick: 'changeTitle?title=新的标题',
  changeTitle(e, param, inst){
    inst.update({
	  title: param.title
	})
  }
}

const item = ui_item(itemConfig)

ReactDOM.render(<item.UI />, document.getElementById('root'))

UI_item

通过React方法组件

import '@aotoo/aotoo'

function changeTitle(e){
  this.update({
    title: '新的标题'
  })
}

const JSX = <UI_item title='标题' onClick={changeTitle}/>

item属性

属性	类型	说明
$$id	String	类似于$('#id')的id
title	String/Object/Array	item结构
img	String/Object/Array	item结构
attr	Object	data-*属性
body	Array	item结构，子集均为item
footer	Array	item结构
dot	Array	item结构
itemClass	String	自定义样式
itemStyle	String	自定义样式
methods	Object	自定义方法
onXXXX	String/Function	all events
created	Function	生命周期，同小程序组件
attached	Function	生命周期，同小程序组件
ready	Function	生命周期，同小程序组件

item API 方法

方法	参数	说明
reset	(p)	恢复初始数据
update	(p, callback)	更新数据
setData	(p, callback)	与update相同
attr	(p1, p2)	设置/获取data-*属性
addClass	(p, callback)	新增样式类
removeClass	(p, callback)	移除样式类名
hasClass	(p)	检测样式类名
css	(p)	自定义样式
toggleClass	(p, callback)	切换样式类名
siblings	(p)	查找兄弟元素
parent	(p)	查找父级
getData	()	获取元素数据
show	()	显示该组件
hide	()	隐藏该组件
destory	()	销毁该组件
render	(p)	渲染组件，与直接写jsx一致

list

引入@aotoo/aotoo后，会生成全局变量ui_list和全局方法组件UI_list, list组件将会生成一组div的html结构(基于item组件)

ui_list

配置生成list组件

const listConfig = {
  data: [
    {title: 'JACK', onClick: 'onItemClick?user=jack'},
    {title: 'ROSE', onClick: 'onItemClick?user=rose'}
  ],
  listClass: 'list-class',
  onItemClick(e, param, inst){
    if (param.user === 'jack') {
      this.update({
        'data[0].title': 'JACK LOVE ROSE'
      })
    }
  }
}

const list = ui_list(listConfig)  

ReactDOM.render(<list.UI />, document.getElementById('root'))

UI_list