2019年11月20日

[WebAPIs] Web Share API 的使用 - navigator.share

keywords: WebAPIs, mobile, navigator.share

TL;DR

// 判斷瀏覽器是否支援 Web Share API
if (navigator.share) {
  // navigator.share 會回傳 Promise
  navigator.share({
    title: 'Web Fundamentals',
    text: 'Check out Web Fundamentals — it rocks!',
    url: 'https://developers.google.com/web',
  })
  .then(() => console.log('Successful share'))
  .catch((error) => console.log('Error sharing', error));
}

Web Share API 的說明

用手機瀏覽網頁的時候,不知道你有沒有注意過,當你按下分享按鈕時它會跳出一個選單,讓你可以選擇要分享到哪個 App 的選單,像是這樣:
Web Share API
這個功能過去需要透過點擊手機瀏覽器上的「分享」後才會出現:
Web Share API
但現在透過 Web Share 這個 API 也可以輕鬆達到這個功能,讓使用者在點擊網頁上的按鈕後就跳出這個「分享選單」,如此就有機會省去使用那種帶有一堆 Facebook、Line、Twitter、Pinterest 按鈕的第三方套件,進一步減少頁面載入時間。
現在就來看看怎麼使用吧!

Web Share API - navigator.share

適用瀏覽器

Web Share API 的使用方式很簡單,但要注意的是這主要是適用在手機上的功能,畢竟電腦上沒有這種分享選單(目前除了 Mac 的 Safari 可用),不過即使電腦不支援此 API 的使用,還是可以很容易做出替代方案(fallback)。
看到下圖瀏覽器支援性的一大片紅字感覺很恐怖,但目前(2019-11-20)其實主要的手機瀏覽器(Chrome, Safari)都適用,Mac 上的 Safari 亦可:
Web Share API
目前實測在三星內建的瀏覽器上可以使用,但分享成功後的回傳訊息不太正確。

使用方式

使用方式很簡單:
// navigator.share 會回傳一個 Promise

// 下面的欄位可以不用全部填寫,可以只分享網址,也可以只分享文字
const sharePromise = navigator.share({
  url: 'https://pjchender.blogspot.com',    // 要分享的 URL
  title: 'PJCHENder 那些沒告訴你的小細節',      // 要分享的標題
  text: '好多眉眉角角啊'             // 要分享的文字內容
});
navigator.share() 會回傳一個 Promise (代表你可以搭配 async...await 使用),這個 Promise 會在使用者完成點擊某個 App 分享後被完成(fulfilled);若使用者取消分享或帶入的參數有錯誤時,則會被拒絕(reject)。
使用時有幾點需留意一下:
  1. Web Share API 只能使用在有 HTTPS 的網站或者是測試時的 localhost,若想玩玩看這個 API 就可以到帶有 HTTPS 的 CodePen 上試試看。
  2. 需要透過使用者主動的行爲(user activation)才能觸發,例如,點擊事件。

範例程式碼

來看一下範例程式碼吧,也可以直接看 CodePen。
See the Pen Web Share API by PJCHEN (@PJCHENder) on CodePen.

HTML

先建立最基本的一個按鈕:
<div class="center-center">
  <button>Share<i class="fas fa-share-alt"></i></button>
  <p class="result"></p>
</div>

JavaScript

  1. 透過 document.querySelector() 選擇和 DOM 有關的元素
  2. 建立使用者點擊分享時要帶入的資訊,不用每一項都填寫,也可以只分享文字或網址
  3. Web Share API 需要使用者主動的行為才能觸發, 所以透過 addEventListener 監聽使用者點擊 click 事件
  4. 透過 navigator.share 來使用 Web Share API
  5. 當使用者拒絕分享或發生錯誤時要顯示的訊息
// STEP 1:選擇和 DOM 有關的元素
const btn = document.querySelector('button');
const result = document.querySelector('.result');

// STEP 2:建立使用者點擊分享時要帶入的資訊
const shareData = {
  url: 'https://pjchender.blogspot.com', // 要分享的 URL
  title: 'PJCHENder 那些沒告訴你的小細節', // 要分享的標題
  text: '好多眉眉角角啊', // 要分享的文字內容
};

// STEP 3:當使用者點擊按鈕時
btn.addEventListener('click', async () => {
  try {
    // STEP 4:使用 Web Share API
    await navigator.share(shareData);
    result.textContent = '感謝你的的分享';
  } catch (err) {
    // STEP 5:使用者拒絕分享或發生錯誤
    const { name, message } = err;
    if (name === 'AbortError') {
      result.textContent = '您已取消分享此訊息';
    } else {
      result.textContent = err;
      console.log('發生錯誤', err);
    }
  }
});
如此就完成這個簡單的範例了。
這個範例的按鈕樣式是修改自 Ayooluwa 的 CodePen。
來看一下實作的結果:
Web Share API
以 Line 為例,傳送出去的訊息內容如下:
Web Share API
See the Pen Web Share API by PJCHEN (@PJCHENder) on CodePen.

替代處理與其他(fallback)

對於不支援 Web Share API 的瀏覽器則可以透過判斷 navigator.share 是否存在來進行替代方案:
if (navigator.share) {
  // 使用 Web Share API
} else {
  // 替代方案寫在這...
}
舉例來說,在 CSS Tricks 的 How to Use the Web Share API 文章中提供了非常精緻的替代處理畫面:
Imgur
可以參考這個作者的 CodePen 範例。
如果不想這麼複雜的話,替代方案也可以是點擊按鈕後複製網址(Copy Link)給使用者自行分享即可。複製到剪貼簿的方式同樣有對應的 WebAPIs 可以支援,有需要可以參考先前整理的筆記 [WebAPIs] Copy to clipboard 複製到剪貼簿。

範例程式碼:當瀏覽器不支援時讓按鈕變成複製功能

這裡提供實際的範例可以作為參考:
// 選擇和 DOM 有關的元素
const btn = document.querySelector('button');
const result = document.querySelector('.result');

// 當使用者點擊分享時要帶入的資訊
const shareData = {
  url: 'https://pjchender.blogspot.com', // 要分享的 URL
  title: 'PJCHENder 那些沒告訴你的小細節', // 要分享的標題
  text: '好多眉眉角角啊', // 要分享的文字內容
};

btn.addEventListener('click', () => {
  // 判斷瀏覽器是否支援 Web Share API
  if (navigator.share) {
    handleNavigatorShare();
  } else {
    handleNotSupportNavigatorShare();
  }
});

// 當瀏覽器支援 Web Share API 時
async function handleNavigatorShare() {
  try {
    await navigator.share(shareData);
    result.textContent = '感謝你的的分享';
  } catch (err) {
    // 使用者拒絕分享或發生錯誤
    const { name } = err;
    if (name === 'AbortError') {
      result.textContent = '您已取消分享此訊息';
    } else {
      result.textContent = err;
      console.log('發生錯誤', err);
    }
  }
}

// 當瀏覽器不支援 Web Share API 時,點下去變成複製
function handleNotSupportNavigatorShare() {
  const contentToCopy = document.querySelector('#content-to-copy');
  contentToCopy.value = shareData.url;
  contentToCopy.setAttribute('type', 'text'); // 不是 hidden 才能複製
  contentToCopy.select();

  try {
    const successful = document.execCommand('copy');
    const msg = successful ? '成功' : '失敗';
    alert(`${shareData.url} - 複製${msg}`);
  } catch (err) {
    alert('Oops, unable to copy');
  }

  /* unselect the range */
  contentToCopy.setAttribute('type', 'hidden');
  window.getSelection().removeAllRanges();
}

參考文章

2019年11月16日

[Samsung] 沒辦法看訊息通知?讓 Bixby Routines 朗讀通知給你聽

平常在開車或是工作時,並不是非常方便看手機,這種時候若收到 Line 或者簡訊通知時,常常都只聽得到通知卻不知道也不方便點開來看內容,這時候就會很希望手機的語音助理能夠把通知直接念出來讓我知道,至少可以知道是不是有急著需要處理的事情。
其實這個功能已經內建在三星這個看似毫無作用的 Bixby Routine 中了,這篇文章中就來看看可以怎麼樣使用。如果懶得看文字的話可以直接參考這個影片:

進入 Bixby Routine

要進入 Bixby Routine 可以從「設定」-->「進階功能」-->「Bixby Routines」中找到:
Bixby 朗讀通知功能
接著點擊上方的新增,可以為這個 routine 取個名稱,例如這裡我叫「唸給我聽」:
Bixby 朗讀通知功能
接著就可以設定「如果⋯則⋯」,這裡我先設定手動啟動(即,已輕觸開始按鈕),平常我也會設成一旦連接到藍芽耳機就啟動:
Bixby 朗讀通知功能
按下完成儲存後,像是這種需要手動開啟的 routine,會詢問你要不要新增到桌面上,點選是支後桌面上就會多了啟動和關閉這個 Routine 的按鈕:
Bixby 朗讀通知功能

當你希望手機擁有朗讀通知的功能時,例如開車、工作時,只要點選這個按鈕,一旦有收到推播通知,手機就會念出來給你聽。

Bixby Routines 的更多功能

這裡雖然是透過 Bixby Routines 來達到朗讀通知的功能,但實際上 Bixby Routines 可以做到更多的功能,它可以設定「當你到公司時則⋯」、「當你回家時則⋯」,可以是開啟 WIFI、開啟某個應用程式等等,功能還蠻多樣的話,善用它的話覺得會是個相當方便好用的功能。
若還不清楚怎麼操作的話,一樣可以回頭參考示範影片:

2019年9月3日

[Mac] 如何透過 iMovie 輸出高畫質影片(4k, 1080p)

iMovie 的專案會依據「第一部」匯入到時間軸中的媒體,以此決定這個影片最後可以輸出成多高的解析度,因此若你最後想輸出成 4K 的影片,只需要:
  1. 先到網路上下載一部 4k 的影片(參考影片下載連結)
  2. 新增一個全新的專案(專案一定要是全新的,因為是以第一個匯入時間軸的媒體來決定最後輸出的解析度)
  3. 將 4k 影片匯入媒體後,拖曳到時間軸內,成功的話,在右邊齒輪(設定)的地方點一下,會看到解析度出現 4k 選項:
iMovie
  1. 接著,如果原本已經有編輯好的內容,可以複製貼在時間軸後面
  2. 把第一個放入時間軸的 4k 影片移除
  3. 選擇匯出成 4k 影片:
iMovie
專案一定要是全新的,因為是以第一個匯入時間軸的媒體來決定最後輸出的解析度

示範操作影片

參考資料

2019年8月31日

[多圖] 三星 Samsung S10+ Plus 與 Note 10 選擇困難?相機拍照、螢幕與效能比較心得

keywords: samsung, camera, s10+, s10plus, note10, performance, screen
imgur
最近剛好有機會同時入手三星(Samsung)的 S10+ Plus 和 Note 10(不是 Note 10+),可以分享一下這兩隻使用上的心得。
直接說結論:相較於 Note10,S10+ 的螢幕真的無可挑惕,色彩的呈現和解析度都非常棒;而 Note10 則是在 App 的安裝速度上有較明顯的提升。兩隻在主鏡頭的拍攝略有差異,主要體現在 Note 10 的成像有更明顯的對比,因此天空會更藍一些,較為吸睛,但有時對比太重會有色偏或修圖感較重的情況(覺得和這幾年 iPhone 成像對比也變強有些相似);S10+ 則中規中矩,在顏色的呈現上和原本的色彩比較接近。
台灣上市的 S10+ CPU 使用的是三星自家的 exynos 9820;Note 10 則是使用 高通 Qualcomm 855。

螢幕(screen)

以前對於螢幕都沒有特別的感覺(不論是小米、三星、LG、HTC),至少不會讓我馬上感覺到「怪怪的」,但這次用了 Note10 之後,第一次感覺到螢幕真的有差異(差異的大小每個人感受不同),特別是和 S10+ 相比,可能眼睛有點被 S10+ 的螢幕給慣壞了。
這兩隻螢幕在色溫上的差異蠻明顯的。打開白屏的情況下就可以很明顯看得出來。將同一張照片放到這兩隻手機上時,可以看到很明顯的顯色不同。這也導致有時候在 Note 10 上看的相片在拿到 S10+ 或上傳到 MAC 後卻又是另一種感覺,也就是說同一張照片在手機上和電腦上色彩看起來會不太一樣。
若想看螢幕的色溫差異可以參考 ptt 的這篇文章:[問題] 請問Note10+螢幕是預設偏黃嗎。
對我個人來說 Note10 上的白色會給我沒那麼乾淨的感覺,並有些許偏黃,然後成像解析度也沒那麼清晰的感覺,和之前同樣是 1080p 的手機相比,之前的手機反倒不會給我這種感覺。
有網友表示可以在顯示的地方,把「背景效果」調成「鮮豔」,並到「進階設定」的地方將綠色拉到底,紅色降兩格會比較接近原本的白色,有需要的朋友可以試試看:
s10+ vs note10
因為每個人的感受和每台手機差異可能不同,建議如果在意的人可以到現場看實機感受一下。
不論 Note 10 或 Note 10+ 似乎都有人反映這樣的情況,但每個人感受和每台手機的差異不同,可以看在 Mobile 01, ptt 或 fb 社團內都有不止一篇以上的討論
Note10 在螢幕的表現上偏黃,但因為每個人的感受和每台手機差異可能不同,如果在意的人可以到現場看實機感受一下。

效能(performance)

不看任何跑分軟體或數字的話,從主觀使用感受上對我來說沒有什麼差異,日常使用都不會有什麼卡頓的情況,遊戲順暢度給我的感覺也差不多。
硬要比較的話,下載並安裝同一款 App 時 Note 10 花費的時間比較少,且在玩遊戲時 Note10 會再更流暢一些;但當我在用影片編輯軟體操作時,S10 + 的輸出速度則明顯較快。
簡單的說,我覺得高通在多工任務時處理得比較好,因此在 App 的切換上或同時運作多個 App 時比較流暢;而獵戶座在單槍匹馬的執行上速度更快,讓他不要分心乖乖一次做一件事他會做得更好。發熱程度的話,兩者在玩遊戲時都會有明顯發熱的感受。
日常使用都不會有什麼卡頓的情況,遊戲順暢度給我的感覺也差不多

相機拍照(camera)

主鏡頭

雖然 S10+ 和 Note 10 用的是相近相機模組,但兩者成像上仍有所差異,但我覺得沒有孰優孰劣,端看自己喜歡怎麼樣的風格。
這兩隻手機拍出來的照片可以用成像的對比度簡單地區分出來。相較於以往三星手機飽和度相對較高的情況來說,這次 Note 10 的相片則是對比度較高,具體來說,會使得天空更藍一些、文字則會有加粗的效果,整體來說相片是更吸睛的,但有些時候對比度過高時會有色偏的情況,原本的紅色變得更深,或者是給人較強的修圖感。
S10+ 的相片則比較中規中矩,相較之下顏色比較準確,白色和文字的呈現上會比較乾淨一些,但也使得直接輸出的相片和 Note 10 相比沒那麼吸睛。
從下面這一系列的照片中可以蠻清楚看到上面的結論,可以先看一下你比較喜歡哪一邊的色彩,最後會在公布左邊和右邊各式哪台手機所拍:
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
s10+ vs note10
答案揭曉,左邊的照片都是使用 S10+ 所拍攝,右邊的照片則是使用 Note 10 進行拍攝,不知道你比較喜歡哪一個呢?
若想要看完整的圖片可以到此 Google 相簿
兩者用的雖然是相似的鏡頭模組,但成像上仍有所差異,S10 + 中規中矩、顏色較準確;Note 10 對比度高、照片較吸睛、但有時修圖感較強。我覺得沒有孰優孰劣,端看自己喜歡怎麼樣的風格。

前鏡頭(自拍鏡頭)

在前鏡頭方面 S10+ 和 Note 10 的成像方式可以說和主鏡頭是完全反過來。
S10+ 對比較強烈,在光線充足的情況下色彩較豐富,但有時會對比拉得太高,讓相片本身很不自然,這種情況在開啟廣角時更佳明顯。Note 10 在顏色上則比較自然舒服些,但相對的色彩表現上比較沒那麼豐富。完全取決於個人喜好和感受。
這裡避免傷眼就不附上自拍的照片,有興趣可以再去 Youtube 找相關的影片。

延伸閱讀

2019年8月11日

三星全面屏手勢操作,一個滑動手勢快速動作(關閉螢幕、返回上一頁)- One Hand Operation +

imgur
keywords: swipe gesture, samsung, one hand operation, lock screen, back
最近把手機換到三星,一開始一直有個地方很不習慣,之前在小米的 MIUI 上有提供了非常簡單易用的全面屏手勢,簡單來說就是把安卓傳統下方的三個功能鍵隱藏之外,只要透過「手勢」就可以做出回上一頁(從左右其中一側的螢幕向內撥)、回到主頁面、顯示應用程式清單頁的功能。
但是一開始換到三星手機時找不到這個功能,雖然一樣有全面屏的設定,但其實只是把下方三個功能鍵的區塊變成「一條線」,使用方式和傳統的操作方式幾乎一樣。對於大螢幕的手機來說,每此回到上一頁還需要把手指放到最下方真的很不方便,要嘛就變成需要雙手操作。
另一點不習慣的是電源鍵位置實在有點高,每次要關閉螢幕常要勾很久,而先前用的手機可以放置「關閉螢幕」的按鈕在桌面上,等於可以不用使用到電源鍵就可以做到關閉螢幕的功能。
這兩個功能讓我在一開始切換過來時很不適應,直到我發現三星有推出自己的手勢功能 App - One Hand Operation + 後覺得實在是太好用了,這個官方推出的 App 比先前 MIUI 上的還強大,因為它可以自行設定多種手勢對應到多種功能,而這個 App 也等於一次解決了兩個主要讓我不習慣的問題。
現在看看完成後可以怎麼操作,我設定只要從螢幕兩側往內下方滑動就會「關閉螢幕」、往內水平滑動就會「回到上一頁」、往內上方滑動則分別進行「調整螢幕亮度」和「螢幕截圖」的功能,實際操作起來會像這樣:


可以留意影片中左右側會出現一個「箭頭符號」,表示正在進行全面屏的手勢操作:
imgur

安裝 One Hand Operation +

imgur
首先就是要安裝官方提供的 One Hand Operation+,下載下來後就可以設定你想要哪個手勢對應到哪個工作就可以了。
下載三星官方 One Hand Operation+ @ Play Store

設定滑動手勢

設定的部分可以分成三個部分:
  • 滑動手勢對應功能:在對應功能裡可以設定不同的滑動手勢想要對應到什麼樣的功能,其中包括關閉螢幕、回到上一頁、螢幕截圖、調整音量、調整螢幕量度等等,可以說能夠調整非常多的東西。在後面會在做一些說明。
  • 滑動手勢可感應的區域:在這裡你可以選擇一般的情況下要不要看到手勢可感應區
    • 「透明度」設成「最高」表示看不到,設成「最低」則會看到曲面螢幕兩邊出現白線。
    • 「大小」表示可感應區的「高度」,基本我設成到幾乎整個曲面螢幕除了不要蓋到「側螢幕面板」的控制區。
    • 「位置」則是感應區的高低,一樣是看個人習慣,我習慣設到最低是因為我都是握手機底部。
    • 「寬度」表示可感應區的寬度大小,當感應區太大,有些人會覺得容易誤觸滑動手勢,感應區太小則可能會不容易感應到,這個部分端看自己的習慣。
  • 其他:這裡可以設定觸發手勢操作時要不要發出震動(震動級數),還有就是當感應到滑動手勢時需要拖曳拖長的距離才算數(滑動距離)
💡提示:側螢幕面板若想移動該位置區域,可以按住 0.5 秒後即可對其進行拖曳。
swipe gestrue

滑動手勢對應功能

在滑動手勢的對應功能中,可以設定非常多的手勢和對應的功能,像是可以除了向內上滑、向內水平滑、向內下滑外,還可以設定左右對應到不同的功能(左控點、右控點)、滑動後停一下(滑動並按住)要做什麼事,但自己實際使用後,建議還是可以設定幾個比較「直觀」且「常用」的就好,而且最好左右的手勢功能是對稱的,例如,向內水平滑動都是「上一頁」。不然如果每次操作時都還要先想一下這個動作應該要用什麼手勢的話,覺得這個功能對你的方便性就沒這麼高了。
💡提示:建議還是可以設定幾個比較「直觀」且「常用」的就好,而且最好左右的手勢功能是對稱的,才不會變得太會複雜而失去原本方便的目的。
one hand operation

快速工具

其中「快速工具」中甚至可以設定像是工具箱的內容:

one hand operation

滑動並按住

如果行有餘力的話,還可以設定滑動並按住對應的功能,但我自己設了幾天之後就關掉了,因為發現記不了這麼多XD:

one hand operation

心得

設定好之後你就可以用這些手勢快速的操作,這裡我也來分享一下自己的設定,左右兩側基本上是對稱的,除了「關閉螢幕」、「上一頁」、「螢幕截圖」等常用到的基本操作外,還可以在「快速工具」中加入自己常用的功能,像是調控聲音、旋轉螢幕、切換到單手模式使用等等:
設定好之後你就可以用這些手勢快速的操作,我自已是設定「關閉螢幕」、「上一頁」、「螢幕截圖」和「調整亮度」這幾個我非常常用到的功能,算是整個補足了換機過來後不習慣的地方,如果你原本就是三星的用戶,但還沒使用這個全面屏手勢的功能的話,可以下載這個 One Hand Operation + 來試試看!

2019年7月3日

[筆記] 使用 react-intl 在 React 實作多語系功能 i18n, internationalization

Photo by Aaron Burden on Unsplash

keywords: i18n, Internationalization, intl, format
這篇文章主要說明如何透過 React Intl 來實作網頁上的 i18n,先備知識必須要已經基本會使用 React。
⚠️ 文章使用的是 react-intl @ 2.9,部分功能在 3.0 後不再支援(文章最下方會說明)。

開始使用 react-intl

我們直接用 create-react-app 的頁面來做練習:
create-react-app

建立 React 專案

直接透過 create-react-app 建立 React 專案:
$ create-react-app react-intl-sandbox
$ cd react-intl-sandbox

安裝 react-intl

$ npm install react-intl
接著就可以透過 npm run start 啟動專案。

使用 IntlProvider

IntlProvider @ react-intl components
將 <IntlProvider> 包在最外層,讓所有內部 component 都可以存取到它提供的屬性與方法。這裡方便操作,把它多包成一個名為 Root 的 functional component:
imgur

取得使用者語系並帶入 IntlProvider

接著:
  • 透過 navigator.language 取得使用者在瀏覽器上所使用的語系,並且將它代入 IntlProvider 的 local 屬性中
  • 為了讓語系變動後可以重新渲染 React 組件,因此也將取得的語系帶入 key 屬性中(參考:dynamic language selection)
  • 若有需要可以定義 defaultLocale 屬性
react-intl
這時候打開瀏覽器會看到錯誤訊息:
react-intl
表示它載不到預設的地區資料。

載入需要的語系資料

在 react-intl 中已經定義好許多地區的語系資料,這些資料會定義某個語系是否有其父子語系的關係,例如 zh-TW 是在 zh-Hant 底下,而 zh-Hant 又在 zh 底下這種關係。除此之外,裡面還定義了關於「時間」、「複數型態」時要怎麼呈現的資訊。
關於各地區的語系,最標準的可以參考 BCP 47 所定義的 locale code 規格文件。
react-intl 所定義好的語系檔都在安裝好的套件內,路徑為 node_modules/react-intl/locale-data/,裡面列出了各語系的定義:
react-intl
例如說這裡我們可以載入英文、中文和日文的語系資料,並且透過 addLocaleData 將語系檔載入:
react-intl
⚠️ 在 react-intl 3 之後不在支援 addLocaleData 的方法,而是直接使用原生的 Intl API,關於使用方式可以參考 Migrate to using native Intl APIs。

定義多語系字典檔

做好上述設定後,就可以來定義多語系用的字典檔。假設我們要做 i18n 的內容是範例頁面中的「Learn React」這個部分:
create-react-app
這時候就可以先定義這個字典檔。首先在 ./src 資料夾內再新增一個 i18n 的資料夾,裡面分別放入 en.js, zh.js, ja.js:
react-intl
接著分別定義每支字典檔的內容,這裡的 app.learn 可以視為 id,之後的使用 react-intl 提供的方法或組件時,他會根據你提供的這個 id 來帶入不同的內容,而 { } 刮起來的 name 表示它是動態的變數:
// ./src/i18n/en.js
const en = { 'app.learn': 'Learn {name}' };
export default en;
// ./src/i18n/zh.js
const zh_TW = { 'app.learn': '學習 {name}' };
export default zh_TW;
// ./src/i18n/ja.js
const ja_JP = { 'app.learn': '学び {name}' };
export default ja_JP;

撰寫切換語言的功能

因為一開始使用的是 functional component,想要添加狀態(state)的話,可以匯入 useState 近來用:
// ./src/index.js
import React, { useState } from 'react';

// ...
const Root = () => {
  // 使用 useState 定義 locale 這個 state
  const [locale, setLocale] = useState(navigator.language);

  return (
    <IntlProvider
      locale={locale}
      key={locale}
      defaultLocale="en"
    >
      <!-- 將 setLocale 的方法傳到 App 內 -->
      <App setLocale={setLocale} />
    </IntlProvider>
  );
};
在 App.js 的地方,撰寫三個按鈕可以來切換 locale 的狀態:
// ./src/App.js
import React from 'react';
import logo from './logo.svg';
import './App.css';

// 從 props 取得從 index 傳入的 setLocale 方法
function App({ setLocale }) {
  return (
    <div className="App">
      <header className="App-header">
        <img src={logo} className="App-logo" alt="logo" />
        <p>
          Edit <code>src/App.js</code> and save to reload.
        </p>
        <div>
          <!-- 建立三顆按鈕可以切換 local 的狀態 -->
          <button onClick={() => setLocale('en')}>英文</button>
          <button onClick={() => setLocale('zh-Hant')}>中文</button>
          <button onClick={() => setLocale('ja')}>日文</button>
        </div>
        <a
          className="App-link"
          href="https://reactjs.org"
          target="_blank"
          rel="noopener noreferrer"
        >
          Learn React
        </a>
      </header>
    </div>
  );
}

export default App;
這時候的畫面會像這樣:
react-intl

文字訊息多語系

這裡說明的是最一般用來轉換不同語系字串的作法,react-intl 提供了:

根據不同的語言傳入不同的語系檔

可以切換 locale 的狀態後,最後就可以根據使用者選擇的語言傳入不同的語系檔。
先將剛剛撰寫好的語系檔載入:
// ./src/index.js
// ...
import en from './i18n/en.js';
import zh from './i18n/zh.js';
import ja from './i18n/ja.js';
接著定義 messages 這個變數,透過 if 判斷使用者切換到的語言為何,最後將 messages 傳入 <IntlProvider>:
// ./src/index.js
import React, { useState } from 'react';
// ...

import en from './i18n/en.js';
import zh from './i18n/zh.js';
import ja from './i18n/ja.js';

addLocaleData([...zhLocaleData, ...enLocaleData, ...jaLocaleData]);

const Root = () => {
  const [locale, setLocale] = useState(navigator.language);
  let messages;

  // 根據使用者選擇的語系 locale 切換使用不同的 messages
  if (locale.includes('zh')) {
    messages = zh;
  } else if (locale.includes('ja')) {
    messages = ja;
  } else {
    messages = en;
  }

  return (
    <!-- 將 messages 傳入 IntlProvider -->
    <IntlProvider
      locale={locale}
      key={locale}
      defaultLocale="en"
      messages={messages}
    >
      <App setLocale={setLocale} />
    </IntlProvider>
  );
};

ReactDOM.render(<Root />, document.getElementById('root'));

在組件中使用語系檔

在 index.js 中,使用者在切換語言後,我們會提供不同的語系檔到 <IntlProvider> 的 messages 屬性內。現在,在 App.js 中就可以使用 react-intl 提供的 <FormattedMessage> 方法來顯示。
在 <FormattedMessage /> 中,id 會對應到先前寫在 ./src/i18n/ 資料夾內的語系檔中定義的屬性 app.learn,而 values 是因為在語系檔中有定義
// ./src/App.js
// ...
// 匯入 FormattedMessage 組件
import { FormattedMessage } from 'react-intl';

function App({ setLocale }) {
  return (
    <div className="App">
      <header className="App-header">
        <!-- ... -->
        <a
          className="App-link"
          href="https://reactjs.org"
          target="_blank"
          rel="noopener noreferrer"
        >
          <!-- 使用 FormattedMessage -->
          <FormattedMessage id="app.learn" values={{ name: 'React' }} />
        </a>
      </header>
    </div>
  );
}
這時候就完成了簡單的 i18n 語系替換:
react-intl

時間日期多語系

在 react-intl 中也提供了時間、日期的多語系功能,包含:
import {
  FormattedDate,
  FormattedTime,
} from 'react-intl';

function App({ setLocale }) {
  return (
    <div className="App">
      <header className="App-header">
        <!-- ... -->
        <br />
        <!-- 使用多語系的日期格式 -->
        <FormattedDate
          value={new Date()}
          year="numeric"
          month="long"
          day="numeric"
          weekday="long"
        />
        <!-- 使用多語系的時間格式 -->
        <FormattedTime value={new Date()} />
      </header>
    </div>
  );
}
react-intl
完成的結果如下:
react-intl
如果有需要也可以使用 <FormattedRelativeTime>,這個方法會回傳距今的時間:
// ./src/App.js
// ⚠️ 在 2.x 版時使用的是 FormattedRelative
import {
  FormattedRelative,
} from 'react-intl';

function App({ setLocale }) {
  return (
    <div className="App">
      <header className="App-header">
        <!-- ... -->
        <br />
        <!-- ... -->
        <FormattedRelative value={new Date() - 60 * 10}/>
      </header>
    </div>
  );
}

⚠️ 在 v2.x 前使用的是 <FormattedRelative>。
顯示的結果如下:
react-intl

數值多語系

若有需要針對數值進行多語系的切換,react-intl 則提供了:

更新到最新 3.x beta 版

務必參考 Upgrade Guide @ react-intl
安裝當前最新版本(非穩定版):
# 撰寫本文時最新的版本為 v3.0.0-beta-11
$ npm install react-intl@next
注意事項:
  • <FormattedRelative> 改為 <FormattedRelativeTime>,且 value 的使用方式不同,改成是用「差距(delta)」,參考 FormattedRelativeTime。
  • 改用瀏覽器原生的語系資料,移除 addLocaleData 的方法,參考 Migrate to using native Intl APIs
因此,我們不需要在 addLocaleData:
react-intl