iT邦幫忙

2022 iThome 鐵人賽

DAY 10
1
自我挑戰組

那些年我用 Ant Design 做過的網頁元件系列 第 10

Day10:Ant Design 裡的上傳鈕

  • 分享至 

  • xImage
  •  

上傳鈕比較常見於表單提交的使用範圍內,雖然大家都熟知在 html 裡可以使用 input tag 搭配 type=filesaccept="image/png, image/jpeg" 的屬性就完成一個僅接受圖片副檔名為 png 或 jpeg 的簡單上傳按鈕,但是隨著時代的演變,就算只是個上傳按鈕,你也需要讓它有多變的功能,讓使用者在介面上也能輕鬆操作,然而我覺得ANTD的upload元件正好可以滿足這些需求。

html 裡基本的上傳按鈕:https://ithelp.ithome.com.tw/upload/images/20220925/20140920VihqOpA2Q3.png

<input type="file"
   id="avatar" name="avatar"
   accept="image/png, image/jpeg">

一、ANTD Upload 最基本的使用方式:引用與呼叫它

import { Upload, Button } from 'antd';

const App = () => (
  <div>
    <Upload
        name: 'file',
        onChange
    >
      <Button>上傳檔案</Button>
    </Upload>
  <div/>
);

export default App;  

二、Upload 可添加的參數

參數就如同下方程式碼說明,也可以點此連結去看更多官方 api 文件

屬性名稱 可以使用的值 說明
accept 字串 允許上傳的檔案格式
beforeUpload (file, fileList) => boolean 在上傳過程中先行檢查是否符合你的條件,回傳值是true或false(IE 9 不適用)
listType text 或 picture 或 picture-card 依序在上傳後呈現效果是單純檔名、圖片牆、圖片搭配檔名
multiple true 或 false 預設是false,需要的話可以直接加這個參數或multiple={true}
maxCount 數字 允許上傳的最多數量值
fileList 陣列 存放目前上傳的檔案

三、Upload 的 fileList 詳解

這邊要特別注意,如果你有上傳多個檔案的需求,像是超多照片或PDF檔案,一定要給一個名叫fileList的參數,用來存放使用者上傳的檔案陣列,參數就如同下方程式碼說明,也可以點此連結去看更多官方 api 文件。有幾點是我在開發上曾經不太明白的地方,這邊也用列點的方式分享給大家:

1. fileList一定要是陣列型態。

2. 如果你需要提供給使用者編輯這些上傳清單,那你可以在讀取原本資料(call api回來)時,將對應或需要的值整理到 ANTD 的參數裡,這點很重要千萬別忽略了。

屬性名稱 可以使用的值 說明
uid 字串 如果沒有特別定義,則ANTD會自動幫檔案生成一個獨特的id值
name 字串 檔案名稱
url 字串 檔案下載的網址
status error 或 success 或 done 或 uploading 或 removed 檔案上傳後的狀態值

四、Upload 的 listType 詳解

如同第二點所述,ANTD提供三種檔案預覽模式給我們使用,分別是 text 或 picture 或 picture-card。這邊也就我個人經驗跟大家分享一下使用時機。

屬性名稱與設定值 說明 預覽效果圖(引用自ANTD官方文件)
listType="text" 如果你的需求在檔案限制非照片格式或檔名很重要的情形下,推薦這款! https://ithelp.ithome.com.tw/upload/images/20220925/20140920UxWMJevHCL.png
listType="picture" 這個效果比較像照片牆,用來顯示純圖片格式的需求時很適合。預覽圖是方形的(104px*104px),想改的話也沒問題。滑鼠滑過去會有放大預覽和刪除的按鈕。 https://ithelp.ithome.com.tw/upload/images/20220925/201409205kla3kmRaZ.png
listType="picture-card" 結合前述兩者需求,你覺得預覽圖和檔名都很重要,必須呈現在頁面上的話,這個屬性值就非常符合唷! https://ithelp.ithome.com.tw/upload/images/20220925/20140920JHT0zDuXSh.png

五、Upload 實際使用範例

看完上面簡單的介紹後,下面提供我的一些簡單範例,若大家有興趣也可以到線上編輯器裡玩玩看唷!

https://ithelp.ithome.com.tw/upload/images/20220925/20140920SIYyQWsjQ2.png
先前專案元件示意圖

參考連結
註1:ANTD Upload 官方介紹


上一篇
Day09:Ant Design 裡的麵包屑(導覽列)
下一篇
Day11:Ant Design 裡的下拉選單 Dropdown
系列文
那些年我用 Ant Design 做過的網頁元件30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

1 則留言

0
kk00915
iT邦新手 4 級 ‧ 2022-10-03 13:43:10

我點了選擇檔案的按鈕發現他其實是一張圖片

Annie iT邦新手 1 級 ‧ 2023-02-19 22:37:15 檢舉

XDDDD 好可愛

我要留言

立即登入留言