## dom 对于那些不依赖 UI 交互的原生功能，nvue将其封装成模块，这是一种通过 javascript 调用原生能力的方法。 - uni-app默认内置集成原生模块，如：BindingX，animation， DOM.addRule等。通过```uni.requireNativePlugin```引入 App 原生插件 ```js //使用方式 const PluginName = uni.requireNativePlugin(PluginName); // PluginName 为原生插件名称 ``` - 支持项目nativeplugins目录下和插件市场原生云打包的第三方原生插件。你可以将已有原生模块移植到nvue平台也很方便。使用方式：在manifest.json->App原生插件配置->选择本地插件或者云端插件->打自定义基座才能使用。[详见](/plugin/native-plugin) - nvue还支持uni-app的js API接口，若无特殊说明，则表示vue文件和nvue文件均支持。[详见](/api/README)。 - nvue 里不支持的 uni-app API，[详见](#nvue-里不支持的-uni-app-api) ### addRule Weex 提供 DOM.addRule 以**加载自定义字体**。开发者可以通过指定 font-family加载 iconfont 和 custom font。开发者可以使用下面的代码加载自定义字体： ``` html ```

**addRule(type, contentObject)** - @fontFace 协议名称，不可修改。 - @fontFamily ```font-family```的名称。 - @src 字体地址，url('') 是保留字段，其参数如下: - http. 从HTTP请求加载, e.g. ```url('http://at.alicdn.com/t/font_1469606063_76593.ttf')``` - https. 从HTTPS请求加载, e.g. ```url('https://at.alicdn.com/t/font_1469606063_76593.ttf')``` - local, Android ONLY. 从assets目录读取, e.g. url('local://foo.ttf'), foo.ttf 是文件名在你的assets目录中. - file. 从本地文件读取, e.g. ```url('file://storage/emulated/0/Android/data/com.alibaba.weex/cache/http:__at.alicdn.com_t_font_1469606063_76593.ttf')``` - data. 从base64读取, e.g. ```url('data:font/truetype;charset=utf-8;base64,AAEAAAALAIAAAwAwR1NVQrD+....')```, 上述data字段不全。 **注意** > addRule 方法里的 fontFamily 可以随意取。这个名字不是字体真正的名字。字体真正的名字（font-family），也就是注册到系统中的名字是保存在字体二进制文件中的。你需要确保你使用的字体的真正名字（font-family）足够特殊，否则在向系统注册时可能发生冲突，导致注册失败，你的字符被显示为‘?’。 > 如果你使用 http://www.iconfont.cn/ 来构建你的 iconfont。确保在项目设置中，设置一个特殊的 font-family 名字。默认是 “iconfont”，但极大可能发生冲突。 > 调用addRule 在 beforeCreate 中是被推荐的。 ### scrollToElement

让页面滚动到 ref 对应的组件，这个 API 只能用于可滚动组件的子节点，例如 ``````，``````, `````` 等可滚动组件中。 **scrollToElement(ref, options)** - @ref，要滚动到的那个节点。 - @options - offset，一个到其可见位置的偏移距离，默认是 0。 - animated，是否需要附带滚动动画，默认是 true。 ``` html ```

### getComponentRect 获取某个元素 View 的外框。 **getComponentRect(ref, callback)** - @ref，要获取外框的那个节点。 - @callback，异步方法，通过回调返回信息。回调方法中的数据样例： ```html { result: true, size: { bottom: 60, height: 15, left: 0, right: 353, top: 45, width: 353 } } ``` > 此方法需要在节点渲染后调用才能获取正确的信息，可在 mounted 或更新数据后 updated 中调用 > > 如果想要获取到 Weex 视口容器的布局信息，可以指定 ref 为字符串 'viewport'，即 getComponentRect('viewport', callback). ## animation ```animation```模块可以用来在组件上执行动画。JS-Animation可以对组件执行一系列简单的变换 (位置、大小、旋转角度、背景颜色和不透明度)。举个例子，如果有一个```image```组件，通过动画你可以对其进行移动、旋转、拉伸或收缩等动作。 ```html ```

## nvue 和 vue 相互通讯@communication 在 uni-app 中，nvue 和 vue 页面可以混搭使用。推荐使用 ```uni.$on``` , ```uni.$emit``` 的方式进行页面通讯，旧的通讯方式（uni.postMessage及plus.webview.postMessageToUniNView）不再推荐使用。 ##### 通讯实现方式 ```javascript // 接收信息的页面 // $on(eventName, callback) uni.$on('page-popup', (data) => { console.log('标题：' + data.title) console.log('内容：' + data.content) }) // 发送信息的页面 // $emit(eventName, data) uni.$emit('page-popup', { title: '我是title', content: '我是content' }); ``` **使用此页面通讯时注意事项：要在页面卸载前，使用 uni.$off 移除事件监听器。**[参考](https://uniapp.dcloud.io/tutorial/page.html#off) ### nvue 向 vue 通讯（已过期，推荐使用上面的uni.$on、uni.$emit） ##### 步骤： 1. 在 nvue 使用 uni.postMessage(data) 发送数据通讯，data 为 JSON 格式（键值对的值仅支持String）。 2. 在 App.vue 里使用 onUniNViewMessage 进行监听。 ##### 代码示例: ```html ``` ```html ``` ### vue 向 nvue 通讯（已过期，推荐使用上面的uni.$on、uni.$emit） ##### 步骤： 1. 在 ```vue``` 里使用 ```plus.webview.postMessageToUniNView(data,nvueId)``` 发送消息，```data``` 为 ```JSON``` 格式（键值对的值仅支持String），```nvueId``` 为 ```nvue``` 所在 webview 的 id，webview的 id 获取方式参考：[$getAppWebview()](/tutorial/page.html#getappwebview)。 2. 在 ```nvue``` 里引用 ```globalEvent``` 模块监听 ```plusMessage``` 事件，如下： ```javascript const globalEvent = uni.requireNativePlugin('globalEvent'); globalEvent.addEventListener("plusMessage", e => { console.log(e.data);//得到数据 }); ``` ##### 代码示例: ```html ``` ```html ``` ## vue 和 nvue 共享的变量和数据@sharevar 除了通信事件，vue 和 nvue 页面之间还可以共享变量和存储。 ```uni-app```提供的共享变量和数据的方案如下： 1. **vuex:** 自HBuilderX 2.2.5起，nvue支持```vuex```。这是vue官方的状态管理工具。 > 注意：不支持直接引入```store```使用，可以使用```mapState```、```mapGetters```、```mapMutations```等辅助方法或者使用```this.$store``` 2. **uni.storage:** - vue和nvue页面可以使用相同的```uni.storage```存储。这个存储是持久化的。比如登录状态可以保存在这里。 - App端还支持```plus.sqlite```，也是共享通用的。 3. **globalData:** 小程序有```globalData```机制，这套机制在```uni-app```里也可以使用，全端通用。在App.vue文件里定义```globalData```，如下： ```javascript ``` - js中操作```globalData```的方式如下： ```getApp().globalData.text = 'test'``` - 如果需要把```globalData```的数据绑定到页面上，可在页面的onShow声明周期里进行变量重赋值。 ## nvue 里使用 HTML5Plus API nvue页面可直接使用plus的API，并且不需要等待plus ready。 ## nvue 里不支持的 uni-app API nvue 支持大部分 uni-app API ，下面只列举目前还**不支持的 API** 。 ##### 动画 |API |说明 |解决方案| |-- |-- |-- | |uni.createAnimation() |创建一个动画实例 |[animation](/tutorial/nvue-api?id=animation)| ##### 滚动 |API |说明 |解决方案| |-- |-- |-- | |uni.pageScrollTo() |将页面滚动到目标位置 |[scrollToElement](#scrolltoelement)| ##### 节点布局交互 |API |说明 | |-- |-- | |uni.createIntersectionObserver() |创建并返回一个 IntersectionObserver 对象实例 | ##### 绘画 canvas API使用，[详见canvas文档](https://uniapp.dcloud.net.cn/api/canvas/createCanvasContext)。