圭臬年份轉換器0.3

Response code is 404

簡介

有朋友詢問我如何將WordPress的年份改為民國年,其實這只是個小小JavaScript,並沒有動到佈景或後端,並且,這個小腳本理論上可以應用在任何能以jQuery選擇符挑出日期的網頁上,如Joomla、Discuz、phpBB、Drupal等常見程式,或支援腳本的線上網誌空間。

此腳本會搜尋指定對象內的HTML內容,以「連續四個數字」為條件作過濾,並將其換算為民國年,因此,有效範圍僅從西元1000年至西元9999年,在此之前或之後就沒辦法了。

由於最初版本我認定「只是小東西」,所以是沒有使用jQuery的,後來因為貪圖選擇符便利性而使用了jQuery,但核心內容並未完全改寫,因此有些累贅,不過想想一個1kb多一點點的東西,再怎麼累贅好像也還好,因此就擺著了。

使用

安裝

你可以引用「http://guinie.org/js/GnYears0.3m.js」,但我不確定自己將來是否會更改路徑,或者因過大的流量而被迫禁止外連,因此還是建議下載到你自己的伺服器比較妥當。

引用

在網頁任意處插入後列代碼(建議在「<head>」與「</head>」之間):

  • 如果你使用的內容管理系統已經引用了jQuery,則可以省略第一行。
  • 如果你已經將檔案放上自己的伺服器,需將第二行「http://guinie.org/js/GnYears0.3m.js」修改為你的檔案路徑。

函式與參數

函式:GnYears_ADtoROC(甲,乙,丙,丁)

  • 參數甲:選擇符,定義欲取代的對象,可使用最簡單的CSS選擇符。
  • 參數乙:註解標籤,如使用「GnYears_ADtoROC(“#”,”span”)」則會在取代年份時插入一個「<span>」,並設其「title」屬性的值為「西元XXXX年」,如此將游標移上去即顯示西元年提示。(如本網誌目前設定)
  • 參數丙:在年份前插入的文字,如「GnYears_ADtoROC(“#”,null,“中華民國”,”年”)」即輸出「中華民國XXX年」。
  • 參數丁:在年份後插入的文字,如「GnYears_ADtoROC(“#”,null,”中華民國”,“年”)」即輸出「中華民國XXX年​」。

函式:GnYears_useROC(甲)​

  • 參數甲:是否啟用轉換,「0」為不使用,「1」為使用。

轉換範例

無論是否在「<head>……</head>」內,「轉換代碼」都應該放在「引用代碼」之後。

在「<head>……</head>」內

在「<head>……</head>」內,你需要先使用一個jQuery匿名函式,使其在網頁載入後執行。

在「<body>……</body>」內

在「<body>……</body>」內,則不需要定義觸發機制,直接使用即可,瀏覽器在載入到這些代碼時,即會進行轉換動作。

發表迴響