iT邦幫忙

2023 iThome 鐵人賽

DAY 22
1
Modern Web

從零開始學習 Astro, 打造個人Blog (部落格)系列 第 22

實作 Astro 組件:格式化日期(FormattedDate) 與 卡片(Card)

  • 分享至 

  • xImage
  •  

在前幾天的文章中,我們已經學會了如何建立文章列表和實現分頁功能。
然而,目前的文章列表頁面看起來相當簡單,而日期格式也不符合我想要的需求。
所以今天要實做兩個組件。分別是 日期格式化顯示、與卡片樣式

以下是完成後的畫面
https://ithelp.ithome.com.tw/upload/images/20230923/20093270dDDsIkanjl.jpg

建立 FormattedDate 組件

src/components 裡建立一個 FormattedDate.astro 的組件

這個組件將用於格式化日期的顯示,以便按照 YYYY/MM/DD 的格式呈現日期。

---
interface Props {
  date: Date;
}

const { date } = Astro.props;
---

<time datetime={date.toISOString()}>
  {date.getFullYear()}/{(date.getMonth() + 1).toString().padStart(2, '0')}/{
    date.getDate().toString().padStart(2, '0')
  }
</time>
  1. 這裡定義了一個 Props 類型,其中包含了一個名為 date 的屬性,該屬性的類型是 Date。這是一個通用的方式,用來告訴程式碼後續將使用 Props 物件中的 date 屬性。

  2. 我們將 Astro.props 中的 date 屬性解構賦值給一個叫做 date 的變數。

  3. 使用 JavaScript 的日期方法來格式化日期。

  • date.getFullYear() 返回年份。
  • date.getMonth() 返回月份(0 表示一月,11 表示十二月),我們使用 (date.getMonth() + 1) 來得到實際的月份。
  • date.getDate() 返回日期。
  • toString().padStart(2, '0') 用於確保月份和日期都是兩位數,例如將 9 轉換為 09。

最後,將這些值插入到 <time> 標籤的內容中,形成一個完整的日期顯示。


建立 Card 組件

src/components 裡建立一個 Card.astro 的組件

一樣在 Tailwind Components Card 這裡選一個我們喜歡的卡片樣式,且稍作調整。

Card.astro

---
import FormattedDate from './FormattedDate.astro';
import Tags from './Tags.astro';
const { post } = Astro.props;
---

<div
  class="mb-4 p-4 items-center justify-center w-full rounded-xl group sm:flex space-x-6 bg-white bg-opacity-50 shadow-xl hover:rounded-2xl"
>
  <img
    class="mx-auto block sm:w-4/12 w-full rounded-lg"
    alt="art cover"
    src={post.data.heroImage}
  />
  <div class="sm:w-8/12 pl-0 p-5">
    <div class="space-y-2">
      <div class="space-y-4">
        <a
          class="text-md font-semibold text-justify"
          href={`/blog/${post.slug}/`}
        >
          <h4 class="text-cyan-900">{post.data.title}</h4>
        </a>
      </div>
      <FormattedDate date={post.data.pubDate} />

      <p>{post.data.description}</p>
      <div class="flex items-center space-x-4 justify-between">
        <div>
          <Tags tags={post.data.tags} />
        </div>
        <div
          class="bg-sky-500 shadow-lg shadow- shadow-sky-600 text-white cursor-pointer px-3 text-center justify-center items-center py-1 rounded-xl flex space-x-2 flex-row"
        >
          <a
            class="text-white hover:text-neutral-50"
            href={`/blog/${post.slug}/`}
          >
            more...
          </a>
        </div>
      </div>
    </div>
  </div>
</div>
  • 引用了剛剛實做的 FormattedDate 組件 與昨天做的 Tags 組件

引用到文章列表

接著將昨天建立好的 card 引用到原本的文章列表

src/page/[page].astro

修改 section 區塊如下

---
import Card from '../../../components/Card.astro';
---
<!-- ...略 -->
<section>
  <ul>
    {
      data.map((post) => {
        return <Card {post} />;
      })
    }
  </ul>
</section>
<!-- ...略 -->

總結

今天,我們學到了:

  • 學習如何建立自訂組件(FormattedDate 和 Card)來改善部落格的內容呈現。
  • 熟悉了 Astro 專案中組件的引用和使用方式。

範例連結:https://stackblitz.com/edit/withastro-astro-e2tb8i


上一篇
實作 Astro 功能:文章標籤 (Tags)
下一篇
實作 Astro 組件:文章目錄 (Toc)
系列文
從零開始學習 Astro, 打造個人Blog (部落格)30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言