☰

Furaffinity-Message-Box

Library to hold MessageBox functions for Furaffinity

此脚本不应直接安装。它是供其他脚本使用的外部库，要使用该库请加入元指令 // @require https://update.cn-greasyfork.org/scripts/528997/1549467/Furaffinity-Message-Box.js

作者
Midori Tsume
版本
1.0.1
创建于
2025-03-06
更新于
2025-03-07
大小
28.0 KB
许可证
MIT

Furaffinity Message Box

Helper Library to show a MessageBox for your custom Furaffinitiy Script. Also see docs on Furaffinity-Message-Box

Features

  • Display custom styled message boxes that appear in front of the current page
  • Support for different message box icons (Error, Warning, Information, Question)
  • Support for different button combinations (OK, OK/Cancel, Yes/No, etc.)
  • Promise-based API for easy integration with async/await
  • Use of Furaffinity Themes

How to use

  • @require this script

  • Create a new MessageBox:

    await FAMessageBox.show('Hello, world!');
const result = await FAMessageBox.show('This is a confirmation.', 'Confirmation', FAMessageBoxButtons.YesNo, FAMessageBoxIcon.Question);
if (result === FADialogResult.Yes) //...

    See MessageBox for more info

Feature Roadmap

Feature Status
Have MassageBox ✅ Completed
Support different Types ✅ Completed
⠀⠀⠀⠀Information ✅ Completed
⠀⠀⠀⠀Question ✅ Completed
⠀⠀⠀⠀Warning ✅ Completed
⠀⠀⠀⠀Error ✅ Completed
Support Furaffinity Color Themes⠀⠀⠀⠀⠀⠀⠀⠀ ✅ Completed
Support non async MessageBox ⬜ Planned

Documentation

MessageBox

The main class for displaying message boxes. It contains following static functions:

  • static async show(text, caption, buttons, icon) - Shows a message box with the specified text, caption, buttons, and icon returning DialogResult.
    • text: The text to display in the message box.
    • caption: The text to display in the title bar of the message box.
    • buttons: One of the MessageBoxButtons values that specifies which buttons to display in the message box.
    • icon: One of the MessageBoxIcon values that specifies which icon to display in the message box.

MessageBoxButtons

Enum that specifies the buttons that are displayed on a message box.

  • OK: The message box contains an OK button.
  • OKCancel: The message box contains OK and Cancel buttons.
  • AbortRetryIgnore: The message box contains Abort, Retry, and Ignore buttons.
  • YesNoCancel: The message box contains Yes, No, and Cancel buttons.
  • YesNo: The message box contains Yes and No buttons.
  • RetryCancel: The message box contains Retry and Cancel buttons.

MessageBoxIcon

Enum that specifies the icon that is displayed on a message box.

  • None: No icon is displayed.
  • Error: An error icon is displayed on the message box.
  • Warning: A warning icon is displayed on the message box.
  • Information: An information icon is displayed on the message box.
  • Question: A question mark icon is displayed on the message box.

DialogResult

Enum that specifies identifiers to indicate the return value of a dialog box.

  • None: Nothing is returned from the dialog box.
  • OK: The dialog box return value is OK.
  • Cancel: The dialog box return value is Cancel.
  • Abort: The dialog box return value is Abort.
  • Retry: The dialog box return value is Retry.
  • Ignore: The dialog box return value is Ignore.
  • Yes: The dialog box return value is Yes.
  • No: The dialog box return value is No.