• 原生組件說明
  • 使用限制
    • 代碼示例
  • 同層渲染

原生組件說明

概念：原生組件是由客戶端創(chuàng)建的原生組件。

成都創(chuàng)新互聯(lián)公司專注于企業(yè)網(wǎng)絡(luò)營銷推廣、網(wǎng)站重做改版、欒川網(wǎng)站定制設(shè)計、自適應(yīng)品牌網(wǎng)站建設(shè)、HTML5建站、商城網(wǎng)站建設(shè)、集團公司官網(wǎng)建設(shè)、成都外貿(mào)網(wǎng)站建設(shè)公司、高端網(wǎng)站制作、響應(yīng)式網(wǎng)頁設(shè)計等建站業(yè)務(wù)，價格優(yōu)惠性價比高，為欒川等各大城市提供網(wǎng)站開發(fā)制作服務(wù)。

包括：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 起）已支持同層渲染。

為了解決原生組件層級最高的限制。小程序?qū)ｉT提供了 cover-view 和 cover-image 組件，可以覆蓋在部分原生組件上面。這兩個組件也是原生組件，但是使用限制與其他原生組件有所不同。

使用限制

由于原生組件脫離在 web-view 渲染流程外，因此在使用時有以下限制：

• 原生組件的層級是最高的，所以頁面中的其他組件無論設(shè)置 z-index 為多少，都無法蓋在原生組件上。后插入的原生組件可以覆蓋之前的原生組件。
• 原生組件無法在 scroll-view、swiper、picker-view、movable-view 中使用，下面示例為錯誤寫法。

代碼示例

在開發(fā)者工具中打開

在開發(fā)者工具中打開

在 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 樣式無法應(yīng)用于原生組件，例如：
無法對原生組件設(shè)置 CSS 動畫；
不能在父級節(jié)點使用overflow: hidden來裁剪原生組件的顯示區(qū)域。
• 在 iOS 下，video 組件暫時不支持觸摸相關(guān)事件。
• 原生組件會遮擋 sConsole 彈出的調(diào)試面板。

在工具上，原生組件是用 web 組件模擬的，因此很多情況并不能很好的還原真機的表現(xiàn)，建議開發(fā)者在使用到原生組件時盡量在真機上進行調(diào)試。

同層渲染

同層渲染是為了解決原生組件的層級問題，在支持同層渲染后，原生組件與其它組件可以隨意疊加，有關(guān)層級的限制將不再存在。當前 video、input、textarea、live-player 組件已支持同層渲染。

在同層渲染模式下：

• 無需使用 cover-view、cover-image 組件來覆蓋同層渲染組件。

• 可在滾動組件，如 scroll-view、swiper、movable-view 等組件中使用同層渲染組件。

• 可直接通過 z-index 屬性對同層渲染組件進行層級控制。

• 同層渲染組件不會遮擋 sConsole 彈出的調(diào)試面板。