• 原生组件说明
  • 使用限制
    • 代码示例
  • 同层渲染

原生组件说明

概念：原生组件是由客户端创建的原生组件。

成都创新互联公司专注于企业网络营销推广、网站重做改版、栾川网站定制设计、自适应品牌网站建设、HTML5建站、商城网站建设、集团公司官网建设、成都外贸网站建设公司、高端网站制作、响应式网页设计等建站业务，价格优惠性价比高，为栾川等各大城市提供网站开发制作服务。

包括：canvas、map、animation-view、textarea、cover-view、cover-image、camera、video、live-player、input 。

其中，video 组件（v3.70.0 起）、input 组件（v3.105.0 起）、textarea（v3.140.1 起支持）和 live-player（v3.140.1 起）已支持同层渲染。

为了解决原生组件层级最高的限制。小程序专门提供了 cover-view 和 cover-image 组件，可以覆盖在部分原生组件上面。这两个组件也是原生组件，但是使用限制与其他原生组件有所不同。

使用限制

由于原生组件脱离在 web-view 渲染流程外，因此在使用时有以下限制：

• 原生组件的层级是最高的，所以页面中的其他组件无论设置 z-index 为多少，都无法盖在原生组件上。后插入的原生组件可以覆盖之前的原生组件。
• 原生组件无法在 scroll-view、swiper、picker-view、movable-view 中使用，下面示例为错误写法。

代码示例

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

• SWAN

 
 
 
  
  
  
  
  
  
 横向滚动
  
  
  
 
  
  
  
 scroll-x
  
  
  
 class="scroll-view"
  
  
  
 bind:scrolltoupper="toLeft"
  
  
  
 bind:scrolltolower="toRight"
  
  
  
 scroll-left="{= scrollLeft =}"
  
  
  
 upper-threshold="1"
  
  
  
 lower-threshold="1"
  
  
  
 bind:scroll="scroll"
  
  
  
 >
  
  
  
 
  
  
  
 
  
  
  
 
 

• 部分 CSS 样式无法应用于原生组件，例如：
无法对原生组件设置 CSS 动画；
不能在父级节点使用overflow: hidden来裁剪原生组件的显示区域。
• 在 iOS 下，video 组件暂时不支持触摸相关事件。
• 原生组件会遮挡 sConsole 弹出的调试面板。

在工具上，原生组件是用 web 组件模拟的，因此很多情况并不能很好的还原真机的表现，建议开发者在使用到原生组件时尽量在真机上进行调试。

同层渲染

同层渲染是为了解决原生组件的层级问题，在支持同层渲染后，原生组件与其它组件可以随意叠加，有关层级的限制将不再存在。当前 video、input、textarea、live-player 组件已支持同层渲染。

在同层渲染模式下：

• 无需使用 cover-view、cover-image 组件来覆盖同层渲染组件。

• 可在滚动组件，如 scroll-view、swiper、movable-view 等组件中使用同层渲染组件。

• 可直接通过 z-index 属性对同层渲染组件进行层级控制。

• 同层渲染组件不会遮挡 sConsole 弹出的调试面板。