【更新說(shuō)明】本次更新主要引入了多語(yǔ)言解決方案,我們?yōu)榇藢?xiě)了全網(wǎng)最詳細(xì)的教程,讓您多語(yǔ)言切換從入門(mén)到精通
【文檔地址】http://uviewui.com/guide/i18n.html
【使用方法】右上角下載/導(dǎo)入【示例項(xiàng)目】,解壓根目錄的【i18n.zip】運(yùn)行即可
uView于4月12號(hào)發(fā)布,文檔和源碼全部開(kāi)源免費(fèi)。uView為uniapp生態(tài)最優(yōu)秀的UI框架。uView文檔詳盡,經(jīng)得起推敲,受得住考驗(yàn)。美好,近在咫尺,觸手可及。
歷時(shí)數(shù)月開(kāi)發(fā),uView終于迎來(lái)了要和大家第一次見(jiàn)面的重要時(shí)刻。uView文檔和源碼完全開(kāi)源免費(fèi),為uniapp生態(tài)優(yōu)秀、成熟的UI框架,擁有大量的組件和JS工具庫(kù),每一個(gè)組件都經(jīng)過(guò)精心打磨和推敲,外觀驚艷,性能優(yōu)異。
uView文檔異常詳細(xì),為您想好每一處細(xì)節(jié),提供大量示例和說(shuō)明,讓您輕松上手,無(wú)坑可踩。
uni-app2018年初發(fā)布以來(lái),一直蓬勃發(fā)展,一派欣欣向榮,社區(qū)也是人聲鼎沸,眾望所歸。
因此,uView應(yīng)運(yùn)而生,uView的目標(biāo)是成為uni-app生態(tài)最優(yōu)秀的UI框架。
關(guān)于uView的取名來(lái)由,首字母u
來(lái)自于uni-app首字母uni-app是基于Vue.js,Vue和View(延伸為UI、視圖之意)同音,同時(shí)view組件uni-app中 最基礎(chǔ),最重要的組件,故取名uView
,表達(dá)源于uni-appVue之意,同時(shí)在此也對(duì)它們表示感謝。
uView是uni-app生態(tài)專用的UI框架,uni-app 是一個(gè)使用 Vue.js 開(kāi)發(fā)所有前端應(yīng)用的框架,開(kāi)發(fā)者編寫(xiě)一套代碼, 可發(fā)布到iOS、Android、H5、以及各種小程序(微信/支付寶/百度/頭條/QQ/釘釘)等多個(gè)平臺(tái)(引言自u(píng)ni-app網(wǎng))。
說(shuō)明,由于uni-app前暫未支持編譯到PC端,所以u(píng)View目前也不適用于PC端,如uni-app兼容了PC端,uView也會(huì)第一時(shí)間跟進(jìn)適配。
uView遵循碼云(Gitee),在此對(duì)碼云表示衷心感謝。我們會(huì)向著風(fēng),擁抱彩虹,勇敢的向前走,透過(guò)黎明的那道光,越過(guò)黑暗,打破一切恐懼,我能找到答案,哪怕要逆著光,也要驅(qū)散黑暗。
網(wǎng)址: https://www.uviewui.com
請(qǐng)用微信掃碼,即可體驗(yàn)最新版演示
網(wǎng)址: https://www.uviewui.com
uView的每一個(gè)組件和JS工具,模板等,都有詳細(xì)的文檔說(shuō)明,并且文檔完美適配移動(dòng)端,讓您隨時(shí)隨地,無(wú)憂無(wú)慮的查詢文檔。uView的文檔有眾多的示例和說(shuō)明,每一處可能會(huì)踩坑的地方,都有特別說(shuō)明,讓您上手簡(jiǎn)單,使用無(wú)憂。
uView為您考慮到了開(kāi)發(fā)的整個(gè)生命周期,眾多組件覆蓋開(kāi)發(fā)過(guò)程的各個(gè)需求,組件功能豐富,多端兼容。讓您快速集成,開(kāi)箱即用:
【Color 色彩】
uView經(jīng)過(guò)大量調(diào)試和研究,得出一套專有的調(diào)色板,在各個(gè)組件內(nèi)部,使用統(tǒng)一的配色,為您的產(chǎn)品帶來(lái)統(tǒng)一又鮮明的視覺(jué)效果。
【Icon 圖標(biāo)】
基于字體的圖標(biāo)集,包含了大多數(shù)常見(jiàn)場(chǎng)景的圖標(biāo)。
【Button 按鈕】
該組件內(nèi)部實(shí)現(xiàn)以u(píng)ni-appbutton組件為基礎(chǔ),進(jìn)行二次封裝,主要區(qū)別在于:1.按鈕type值有更多的主題顏色2.有可選的按鈕點(diǎn)擊水波紋效果3.按鈕size值有更多的尺寸可選
【Layout 布局】
通過(guò)基礎(chǔ)的 12 分欄,迅速簡(jiǎn)便地創(chuàng)建布局
【Cell 單元格】
cell單元格一般用于一組列表的情況,比如個(gè)人中心頁(yè),設(shè)置頁(yè)等。
【Badge 徽標(biāo)數(shù)】
該組件一般用于圖標(biāo)右上角顯示未讀的消息數(shù)量,提示用戶點(diǎn)擊,有圓點(diǎn)和圓包含文字兩種形式。
【Tag 標(biāo)簽】
該組件一般用于標(biāo)記和選擇,有如下特點(diǎn):mode參數(shù)可以設(shè)置3種模式,dark(深色背景)、light(淺色背景)、plain(白色背景)shape參數(shù)可以設(shè)置多種形狀,circle(兩邊半圓形), square(方形,帶圓角),circleLeft(左邊半圓),circleRight(右邊半圓)type參數(shù)可以設(shè)置5種主題,primary,success,warning,error,info
【Keyboard 鍵盤(pán)】
此為uViw自定義的鍵盤(pán)面板,內(nèi)含了數(shù)字鍵盤(pán),車(chē)牌號(hào)鍵,身份證號(hào)鍵盤(pán)3中模式,都有可以打亂按鍵順序的選項(xiàng)。
【Picker 選擇器】
此選擇器有兩種彈出模式:一是時(shí)間模式,可以配置年,日,月,時(shí),分,秒?yún)?shù)二是地區(qū)模式,可以配置省,市,區(qū)參數(shù)
【Rate 評(píng)分】
該組件一般用于滿意度調(diào)查,星型評(píng)分的場(chǎng)景。
【Search 搜索】
搜索組件,集成了常見(jiàn)搜索框所需功能,用戶可以一鍵引入,開(kāi)箱即用。
【NumberBox 步進(jìn)器】
該組件一般用于商城購(gòu)物選擇物品數(shù)量的場(chǎng)景
【Upload 上傳】
該組件用于上傳圖片場(chǎng)景
【VerificationCode 驗(yàn)證碼倒計(jì)時(shí)】
考慮到用戶實(shí)際發(fā)送驗(yàn)證碼的場(chǎng)景,可能是一個(gè)按鈕,也可能是一段文字,提示語(yǔ)各有不同,所以本組件 不提供界面顯示,只提供提示語(yǔ),由用戶將提示語(yǔ)嵌入到具體的場(chǎng)景
【Field 輸入框】
借助此組件,可以實(shí)現(xiàn)表單的輸入, 有'text'和'textarea'類型的,此外,借助uView的picker和actionSheet組件可以快速實(shí)現(xiàn)上拉菜單,時(shí)間,地區(qū)選擇等, 為表單解決方案的利器。
【Checkbox 復(fù)選框】
復(fù)選框組件一般用于需要多個(gè)選擇的場(chǎng)景,該組件功能完整,使用方便
【Radio 單選框】
單選框用于有一個(gè)選擇,用戶只能選擇其中一個(gè)的場(chǎng)景。
【Switch 開(kāi)關(guān)選擇器】
選擇開(kāi)關(guān)一般用于只有兩個(gè)選擇,且只能選其一的場(chǎng)景。
【Slider 滑動(dòng)選擇器】
該組件一般用于表單中,手動(dòng)選擇一個(gè)區(qū)間范圍的場(chǎng)景。
【CircleProgress 圓形進(jìn)度條】
展示操作或任務(wù)的當(dāng)前進(jìn)度,比如上傳文件,是一個(gè)圓形的進(jìn)度條。
【LineProgress 線形進(jìn)度條】
展示操作或任務(wù)的當(dāng)前進(jìn)度,比如上傳文件,是一個(gè)線形的進(jìn)度條。
【Table 表格】
表格組件一般用于展示大量結(jié)構(gòu)化數(shù)據(jù)的場(chǎng)景
【CountDown 倒計(jì)時(shí)】
該組件一般使用于某個(gè)活動(dòng)的截止時(shí)間上,通過(guò)數(shù)字的變化,給用戶明確的時(shí)間感受,提示用戶進(jìn)行某一個(gè)行為操作。
【CountTo 數(shù)字滾動(dòng)】
該組件一般用于需要滾動(dòng)數(shù)字到某一個(gè)值的場(chǎng)景,目標(biāo)要求是一個(gè)遞增的值。
【ActionSheet 操作菜單】
本組件用于從底部彈出一個(gè)操作菜單,供用戶選擇并返回結(jié)果。本組件功能類似于uni的uni.showActionSheetAPI,配置更加靈活,所有平臺(tái)都表現(xiàn)一致。
【AlertTips 警告提示】
警告提示,展現(xiàn)需要關(guān)注的信息。
【Toast 消息提示】
此組件表現(xiàn)形式類似uni的uni.showToastAPI,但也有不同的地方,具體表現(xiàn)在:uView的toast有5中主題可選可以配置toast結(jié)束后,跳轉(zhuǎn)相應(yīng)URL目前沒(méi)有加載中的狀態(tài),請(qǐng)用uni的uni.showLoading,這個(gè)需求uni已經(jīng)做得很好
【NoticeBar 滾動(dòng)通知】
該組件用于滾動(dòng)通告場(chǎng)景,有多種模式可供選擇
【TopTips 頂部提示】
該組件一般用于頁(yè)面頂部向下滑出一個(gè)提示,爾后自動(dòng)收起的場(chǎng)景。
【Collapse 折疊面板】
通過(guò)折疊面板收納內(nèi)容區(qū)域
【Popup 彈出層】
彈出層容器,用于展示彈窗、信息提示等內(nèi)容,支持上、下、左、右和中部彈出。組件只提供容器,內(nèi)部?jī)?nèi)容由用戶自定義
【SwipeAction 滑動(dòng)操作】
該組件一般用于左滑喚出操作菜單的場(chǎng)景,用的最多的是左滑刪除操作。
【Modal 模態(tài)框】
彈出模態(tài)框,常用于消息提示、消息確認(rèn)、在當(dāng)前頁(yè)面內(nèi)完成特定的交互操作。
【fullScreen 壓窗屏】
所謂壓窗屏,是指遮罩能蓋住原生導(dǎo)航欄和底部tabbar欄的彈窗,一般用于在APP端彈出升級(jí)應(yīng)用彈框,或者其他需要增強(qiáng)型彈窗的場(chǎng)景。
【Mask 遮罩層】
創(chuàng)建一個(gè)遮罩層,用于強(qiáng)調(diào)特定的頁(yè)面元素,并阻止用戶對(duì)遮罩下層的內(nèi)容進(jìn)行操作,一般用于彈窗場(chǎng)景
【NoNetwork 無(wú)網(wǎng)絡(luò)提示】
該組件無(wú)需任何配置,引入即可,內(nèi)部自動(dòng)處理所有功能和事件,有如下特點(diǎn):如果沒(méi)有網(wǎng)絡(luò),改組件會(huì)以fixed定位,并且以很大的z-index值覆蓋原來(lái)的內(nèi)容。一旦有網(wǎng)絡(luò)了,會(huì)自動(dòng)隱藏該組件,實(shí)現(xiàn)自動(dòng)化在APP上,嵌入了5+接口,可以直接打開(kāi)手機(jī)的設(shè)置頁(yè)面,方便用戶進(jìn)行網(wǎng)絡(luò)相關(guān)的設(shè)置
【Grid 宮格布局】
宮格組件一般用于同時(shí)展示多個(gè)同類項(xiàng)目的場(chǎng)景,可以給宮格的項(xiàng)目設(shè)置徽標(biāo)組件(badge),或者圖標(biāo)等,也可以擴(kuò)展為左右滑動(dòng)的輪播形式。
【Swiper 輪播圖】
該組件一般用于導(dǎo)航輪播,廣告展示等場(chǎng)景,可開(kāi)箱即用,具有如下特點(diǎn):內(nèi)置多種指示器模式,可配置指示器位置3D輪播圖效果可配置是否顯示標(biāo)題
【TimeLine 時(shí)間軸】
時(shí)間軸組件一般用于物流信息展示,各種跟時(shí)間相關(guān)的記錄等場(chǎng)景。
【Skeleton 骨架屏】
骨架屏一般用于頁(yè)面在請(qǐng)求遠(yuǎn)程數(shù)據(jù)尚未完成時(shí),頁(yè)面用灰色塊預(yù)顯示本來(lái)的頁(yè)面結(jié)構(gòu),給用戶更好的體驗(yàn)。
【Sticky 吸頂】
該組件與CSS中position: sticky屬性實(shí)現(xiàn)的效果一致,當(dāng)組件達(dá)到預(yù)設(shè)的到頂部距離時(shí), 就會(huì)固定在指定位置,組件位置大于預(yù)設(shè)的頂部距離時(shí),會(huì)重新按照正常的布局排列。
【W(wǎng)aterfall 瀑布流】
這是一個(gè)瀑布流形式的組件,內(nèi)容分為左右兩列,結(jié)合uView的懶加載組件效果更佳。相較于某些只是奇偶數(shù)左右分別,或者沒(méi)有利用vue作用域插槽的做法,uView的瀑布流實(shí)現(xiàn)了真正的 組件化,搭配LazyLoad 懶加載和loadMore 加載更多組件,讓您開(kāi)箱即用,眼前一亮。
【Divider 分割線】
區(qū)隔內(nèi)容的分割線,一般用于頁(yè)面底部'沒(méi)有更多'的提示。
【Navbar 自定義導(dǎo)航欄】
此組件一般用于在特殊情況下,需要自定義導(dǎo)航欄的時(shí)候用到,一般建議使用uni-app帶的導(dǎo)航欄。
【tabs 標(biāo)簽】
該組件,是一個(gè)tabs標(biāo)簽組件,在標(biāo)簽多的時(shí)候,可以配置為左右滑動(dòng),標(biāo)簽少的時(shí)候,可以禁止滑動(dòng)。 該組件的一個(gè)特點(diǎn)是配置為滾動(dòng)模式時(shí),激活的tab會(huì)自動(dòng)移動(dòng)到組件的中間位置。
【tabsSwiper 全屏選項(xiàng)卡】
該組件內(nèi)部實(shí)現(xiàn)主要依托于uni-appscroll-view和swiper組件,主要特色是切換過(guò)程中,tabsSwiper文字的顏色可以漸變,底部滑塊可以 跟隨式滑動(dòng),活動(dòng)tab滾動(dòng)居中等。應(yīng)用場(chǎng)景可以用于需要左右切換頁(yè)面,比如商城的訂單中心(待收貨-待付款-待評(píng)價(jià)-已退貨)等應(yīng)用場(chǎng)景。
【Subsection 分段器】
該分段器一般用于用戶從幾個(gè)選項(xiàng)中選擇某一個(gè)的場(chǎng)景
【IndexList 索引列表域】
通過(guò)折疊面板收納內(nèi)容區(qū)域
【Steps 步驟條】
該組件一般用于完成一個(gè)任務(wù)要分幾個(gè)步驟,標(biāo)識(shí)目前處于第幾步的場(chǎng)景。
【Empty 內(nèi)容為空】
該組件用于需要加載內(nèi)容,但是加載的第一頁(yè)數(shù)據(jù)就為空,提示一個(gè)'沒(méi)有內(nèi)容'的場(chǎng)景, 我們精心挑選了十幾個(gè)場(chǎng)景的圖標(biāo),方便您使用。
【Link 超鏈接】
該組件為超鏈接組件,在不同平臺(tái)有不同表現(xiàn)形式:在APP平臺(tái)會(huì)通過(guò)plus環(huán)境打開(kāi)內(nèi)置瀏覽器在小程序中把鏈接復(fù)制到粘貼板,同時(shí)提示信息在H5中通過(guò)window.open打開(kāi)鏈接
【Section 查看更多】
該組件一般用于分類信息有很多,但是限于篇幅只能列出一部分,讓用戶通過(guò)'查看更多'獲得更多信息的場(chǎng)景,實(shí)際效果見(jiàn)演示。
【MessageInput 驗(yàn)證碼輸入】
該組件一般用于驗(yàn)證用戶短信驗(yàn)證碼的場(chǎng)景,也可以結(jié)合uView的鍵盤(pán)組件使用
【AvatarCropper 頭像裁剪】
該組件一般的圖片裁剪需求場(chǎng)景,尤其適合于頭像裁剪方面。
【loadMore 加載更多】
此組件一般用于標(biāo)識(shí)頁(yè)面底部加載數(shù)據(jù)時(shí)的狀態(tài),共有三種狀態(tài):加載前,顯示'加載更多',加入點(diǎn)擊可選,是因?yàn)閿?shù)據(jù)不夠一頁(yè)時(shí),無(wú)法觸發(fā)頁(yè)面的onReachBottom生命周期加載中,顯示'正在加載...',2種動(dòng)畫(huà)可選加載后,如果還有數(shù)據(jù),回到'加載前'狀態(tài),否則加載結(jié)束,顯示'沒(méi)有更多了'
【ReadMore 展開(kāi)閱讀更多】
該組件一般用于內(nèi)容較長(zhǎng),預(yù)先收起一部分,點(diǎn)擊展開(kāi)全部?jī)?nèi)容的場(chǎng)景。
【LazyLoad 懶加載】
懶加載使用的場(chǎng)景為:頁(yè)面有很多圖片時(shí),APP會(huì)同時(shí)加載所有的圖片,導(dǎo)致頁(yè)面卡頓,各個(gè)位置的圖片出現(xiàn)前后不一致等本組件高度封裝和集成,創(chuàng)新性地使用uni.createIntersectionObserver 接口,保證高性能的同時(shí),還有其他友好的可配置參數(shù),比如預(yù)加載占位圖,加載錯(cuò)誤占位圖,加載位置參數(shù)(threshold),各種事件等。
【Gap 間隔槽】
該組件一般用于內(nèi)容塊之間的用一個(gè)灰色塊隔開(kāi)的場(chǎng)景,方便用戶風(fēng)格統(tǒng)一,減少工作量
【Avatar 頭像】
本組件一般用于展示頭像的地方,如個(gè)人中心,或者評(píng)論列表頁(yè)的用戶頭像展示等場(chǎng)所。
【Loading 加載動(dòng)畫(huà)】
此組件為一個(gè)小動(dòng)畫(huà),目前用在uView的loadmore加載更多和switch開(kāi)關(guān)等組件的正在加載狀態(tài)場(chǎng)景。
uView有眾多的貼心小工具,是您開(kāi)發(fā)過(guò)程中召之即來(lái)的利器,讓您飛鏢在手,百步穿楊:
【Http請(qǐng)求】
該插件適用于一般的請(qǐng)求場(chǎng)景,只支持post、get、put和delete請(qǐng)求,目前不適用于其他的請(qǐng)求形式,比如上傳,下載等。插件定位為 小而美,而不是大而全,目標(biāo)是切合實(shí)際,開(kāi)箱即用。
【API集中管理】
這里說(shuō)的集中管理,是指把各個(gè)請(qǐng)求,統(tǒng)一放到一個(gè)文件中進(jìn)行管理,這樣的好處是不用每次調(diào)用this.$u.get時(shí)都需要傳入url參數(shù),一些固定的 請(qǐng)求參數(shù)也可以不用顯式的傳入.
【time 時(shí)間格式】
timeFormat | date(timestamp, format = 'yyyy-mm-dd')
【route 路由跳轉(zhuǎn)】
此為一個(gè)路由跳轉(zhuǎn)方法,內(nèi)部是對(duì)uni多個(gè)路由跳轉(zhuǎn)api的封裝,更方便使用
【randomArray 數(shù)組亂序】
打亂數(shù)組
【guid 全局唯一標(biāo)識(shí)符】
產(chǎn)生唯一標(biāo)識(shí)符
【colorSwitch 顏色轉(zhuǎn)換】
該函數(shù)可以將一個(gè)RGB顏色值轉(zhuǎn)換成一個(gè)Hex的十六進(jìn)制顏色值
【color 顏色值】
此功能為uView內(nèi)部通過(guò)js提供的一些顏色值,可以用于通過(guò)js修改元素字體,背景顏色等一些場(chǎng)景,常用于uView的各個(gè)組件中。這些顏色值,掛載在$u對(duì)象下的color數(shù)組中,關(guān)于這些顏色值的具體描述,詳見(jiàn)Color 色彩使用方法:如使用primary顏色值,方法為:$u.color['primary']
【queryParams 對(duì)象轉(zhuǎn)URL參數(shù)】
該方法,可以將一個(gè)對(duì)象形式參數(shù)轉(zhuǎn)換成get傳參所需參數(shù)形式,如把{name: 'lisa', age: 20}轉(zhuǎn)換成?name=lisa&age=20用途:可以用于uni.navigateTo接口傳參等場(chǎng)景,無(wú)需自己手動(dòng)拼接URL參數(shù)
【test 規(guī)則校驗(yàn)】
uView內(nèi)置了一些校驗(yàn)規(guī)則,如是否手機(jī)號(hào),郵箱號(hào),URL等這些規(guī)則方法,掛載在$u.test下面,如驗(yàn)證是否手機(jī)號(hào):$u.test.mobile('13888889999'),如果驗(yàn)證通過(guò),返回true,否則返回false
【md5 加密】
該md5加密方法,需要手動(dòng)import庫(kù)函數(shù),調(diào)用md5方法即可使用,可以對(duì)字符串加密為32位的字符串結(jié)果,如需進(jìn)一步了解, 詳見(jiàn)MD5百度百科
【random 隨機(jī)數(shù)值】
該方法可以返回在'min'和'max'之間的數(shù)值,要求'min'和'max'都為數(shù)值,且'max'大于或等于'min',否則返回0.
【trim 去除空格】
該方法可以去除空格,分別可以去除所有空格,兩端空格,左邊空格,右邊空格,默認(rèn)為去除兩端空
【getRect 節(jié)點(diǎn)布局信息】
此方法封裝自u(píng)ni的nodesRef.boundingClientRect,它極大簡(jiǎn)化了 使用復(fù)雜度,內(nèi)部使用Promise,可以讓用戶同步獲取節(jié)點(diǎn)信息。
【mpShare 小程序分享】
此功能,是對(duì)uni的onShareAppMessage 生命周期的封裝。
uView目前已有數(shù)量眾多的優(yōu)秀模板,眾多的模板正在陸續(xù)加入中……
uView采用MIT許可證,您可以免費(fèi)自由使用,文檔和源碼開(kāi)源免費(fèi),不收任何費(fèi)用!
聯(lián)系客服