FANDOM


表情符號視窗(EmoticonsWindow/zh)會插入一個表情符號列表的視窗。用戶們可以選擇表情符號並將它們添加在下方的輸入欄內。

對於擁有許多表情符號的維基來說,這個插件是非常有用的,這能讓用戶不必牢記所有符號的代碼,也不需要在聊天期間頻繁的使用MediaWiki:Emoticons來查詢表情符號。

安裝方法

請添加以下的程式碼至MediaWiki:Chat.js(維基)或Special:Mypage/chat.js(個人)

importArticles({
    type: 'script',
    articles: [
        // ...
        'u:kocka:MediaWiki:Emoticons/code.js',
        // ...
    ]
});
導入文章 (importArticles) — 在Fandom上安裝JavaScript的最佳實踐
導入文章是被設計來用於一行代碼加入多種HTTP請求的功能,允許載入多重腳本並加快運行。如果安裝了數個不同的腳本的話,JavaScript檔應該會積存了很多不必要的定義聲明。點擊"展開"以獲取如何更有效地載入大量腳本並加快運行速度
如果JavaScript檔內含有多個importScriptimportScriptPageimportArticles代碼的話,其實可以簡化並合併它們。以一行代碼去載入多個腳本可以使JS代碼運算得更快及整潔。以下為一個簡單的例子,左方的是正常載入下的代碼,右方的是簡化後的代碼:
多重載入 — 離亂無章 一次性載入 — 簡單整潔
importScriptPage('AjaxRC/code.js','dev');
 
importScript('MediaWiki:localScript.js');
 
importArticle({
  type: 'script',
  article: 'u:dev:FloatingToc/code.js'
});
 
importScriptPage('page1.js', 'wikiname');
 
importScriptPage('page2.js', 'wikiname');
importArticles({
    type: 'script',
    articles: [
        'u:dev:AjaxRC/code.js',
        'MediaWiki:localScript.js',
        'u:dev:FloatingToc/code.js',
        'u:wikiname:page1.js',
        'u:wikiname:page2.js'
    ]
});
注意:以上需要小心使用各標點符號
一般不太熟悉程式編寫之人(就算熟悉的)所常犯的,通常也是意外地刪除、遺忘或錯誤放置符號(例逗號跟引號)。這些都會引致syntax error (語法錯誤)的情況而導致錯誤運作。請小心閱讀以上的例子並確保跟從轉換方法以使用導入文章
更多有關導入文章的資料,請參閱導入更多JavaScript與CSS.

配置

JS

配置方面需透過window.EmoticonsWindowConfig物件才能完成,目前唯一可使用的配置選項為 chatOptionsIntegration,它允許按鈕能放在聊天選項按鈕的下方,也就是在chat-buttonclass旁邊。

欲開啟它,請使用:

window.EmoticonsWindowConfig = {
    chatOptionsIntegration: true
};

關於出現在腳本裡的文字配置可透過物件window.EmoticonsWindowVocab的配置屬性來實現。在翻譯段落中,每個屬性皆有其各自的翻譯名稱。舉例來說,如果您想要配置出現在模組內的help文本:

window.EmoticonsWindowVocab = {
    help: "Clicking an emoticon will make it appear in your text box. Poof!"
};

以上的程式碼僅作為示例參考之用,並非本腳本運作的必要條件。

CSS

本配置應至個別維基的MediaWiki:Chat.css(維基)或Special:Mypage/chat.css (個人)。

選項 說明 預設值
.EmoticonsWindowIcon 在表情符號視窗中顯示表情符號。
width: 19px;
height: 19px;
border: 1px solid black;
padding: 10px;
border-radius: 5px;
background: #5F2C60;
游標懸停時
background: #823C83;
.EmoticonsWindowButton 添加在標題上的按鈕 N/A
#EmoticonsWindowModal 顯示表情符號的視窗 N/A
#EmoticonsWindowList 表情符號視窗的內容
height: 400px;
overflow-y: auto;
(由らり牛ちゃん編寫該元素的預設CSS)
#EmoticonsWindowClose 「關閉」按鈕 N/A
.EmoticonsWindowHelp Help文本 N/A

配置示例:

#EmoticonsWindowList {
    height: 600px;
}
.EmoticonsWindowIcon {
    background: yellow;
}

翻譯

您可以透過國際化數據頁面(利用正確的JSON標記翻譯)將本腳本翻譯為不同語言(如果您有權限編輯)。然而,若您沒有權限,您可以將翻譯發布在KockaAdmiralac的對話頁上。

這裡有一些字串需要翻譯。每個字串皆有其代碼(說明該字串的用途),因此當翻譯這些字串時,請依照字符的代碼與用法來進行翻譯。

代碼 字串 用法
help 透過點擊來選擇表情符號 在模組內的help文本
emoticons 表情符號 表情符號按鈕的標題
close 關閉 關閉模組按鈕的文本

變更記錄

v1.0
初步修訂
v1.1
Dorumin提供修改建議
當游標懸停在表情符號時,會顯示該表情符號的名稱
當插入一個表情符號時,前面多出了一個空格
Help文本已固定在頂部
Steven Universe維基添加例外的情況
v1.2
緩存模組內容
在CSS元素中將 「kockaEmoticons」變更為「EmoticonsWindow
v1.3
更新腳本的一般界面
更新國際化系統
本腳本現在使用與FANDOM相同的方法來解析表情符號
全面支援聊天選項的腳本
v1.4
再度更新國際化系統
v1.5
重新針對代碼進行格式化
完全移除「kockaEmoticons
將實際按鈕元素的按鈕變更為帶有wikia-button class的鏈結

Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.