すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:フィードバック

最終更新日:Jan 17, 2025

my.alert

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

アラートボックス。アラートボックスのタイトル、コンテンツ、およびボタンテキストを設定できます。画像などのスタイルの設定は現在サポートされていません。

パラメーター

名前

タイプ

必須

説明

title

文字列

いいえ

アラートボックスのタイトル。

content

文字列

いいえ

アラートボックスのコンテンツ。

buttonText

文字列

いいえ

ボタンテキスト。デフォルトは OK です。

success

関数

いいえ

呼び出しが成功したことを示すコールバック関数。

fail

関数

いいえ

呼び出しが失敗したことを示すコールバック関数。

complete

関数

いいえ

呼び出しが完了したことを示すコールバック関数(呼び出しの成功または失敗に関係なく実行されます)。

サンプルコード

// API-DEMO page/API/alert/alert.json
{
  "defaultTitle": "アラート"
}
<!-- API-DEMO page/API/alert/alert.axml-->
<view class="page">
  <view class="page-description">アラートボックス API</view>
  <view class="page-section">
    <view class="page-section-title">my.alert</view>
    <view class="page-section-demo">
      <button type="primary" onTap="alert">アラートボックスを表示する</button>
    </view>
  </view>
</view>
// API-DEMO page/API/alert/alert.js
Page({
  alert() {
    my.alert({
      title: 'お客様各位',
      content: '月次請求書が作成されました',
      buttonText: '了解',
      success: () => {
        my.alert({
          title: 'ユーザーが「了解」をクリックしました',
        });
      }
    });
  },
})

my.confirm

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

確認ボックス。現在の操作を確認するようにユーザーに促すための確認ボックス。確認ボックスのタイトル、コンテンツ、および確認ボタンまたはキャンセルボタンのテキストを設定できます。

パラメーター

名前

タイプ

必須

説明

title

文字列

いいえ

確認ボックスのタイトル。

content

文字列

いいえ

確認ボックスのコンテンツ。

confirmButtonText

文字列

いいえ

確認ボタンのテキスト。デフォルトは OK です。

cancelButtonText

文字列

いいえ

キャンセルボタンのテキスト。デフォルトは キャンセル です。

success

関数

いいえ

呼び出しが成功したことを示すコールバック関数。

fail

関数

いいえ

呼び出しが失敗したことを示すコールバック関数。

complete

関数

いいえ

操作が終了したことを示すコールバック関数。このコールバック関数は、呼び出しが成功した場合と失敗した場合の両方で実行されます。

success の戻り値

名前

タイプ

説明

confirm

ブール値

OK をクリックすると true が返され、キャンセル をクリックすると false が返されます。

サンプルコード

// API-DEMO page/API/confirm/confirm.json
{
    "defaultTitle": "確認"
}
<!-- API-DEMO page/API/confirm/confirm.axml-->
<view class="page">
  <view class="page-description">確認ボックス API</view>
  <view class="page-section">
    <view class="page-section-title">my.confirm</view>
    <view class="page-section-demo">
      <button type="primary" onTap="comfirm">確認ボックスを表示する</button>
    </view>
  </view>
</view>
// API-DEMO page/API/confirm/confirm.js
Page({
  comfirm() {
    my.confirm({
      title: 'リマインダー',
      content: '追跡番号:\n1234567890 の荷物照会を実行しますか?',
      confirmButtonText: '今すぐ照会',
      cancelButtonText: '今はしない',
      success: (result) => {
        my.alert({
          title: `${result.confirm}`,
        });
      },
    });
  },
});

my.prompt

説明

このインターフェイスは、ベースライブラリ V1.7.2 (119285) 以降のバージョンと mPaaS 10.1.32 以降のバージョンでのみサポートされています。

このインターフェイスを使用すると、ユーザーがダイアログボックスにテキストを入力するためのダイアログボックスを表示できます。

パラメーター

名前

タイプ

必須

説明

title

文字列

いいえ

プロンプトボックスのタイトル。

message

文字列

いいえ

プロンプトボックスのテキスト。デフォルトは コンテンツを入力してください です。

placeholder

文字列

いいえ

入力ボックスのプロンプトテキスト。

align

文字列

いいえ

メッセージの配置方法。列挙型の left、center、および right の値を指定できます。たとえば、iOS 'center', android 'left' は、iOS クライアントでは中央揃え、Android クライアントでは左揃えを示します。

okButtonText

文字列

いいえ

確認ボタンのテキスト。デフォルトは OK です。

cancelButtonText

文字列

いいえ

確認ボタンのテキスト。デフォルトは キャンセル です。

success

関数

いいえ

呼び出しが成功したことを示すコールバック関数。

fail

関数

いいえ

呼び出しが失敗したことを示すコールバック関数。

complete

関数

いいえ

呼び出しが完了したことを示すコールバック関数(呼び出しの成功または失敗に関係なく実行されます)。

success の戻り値

名前

タイプ

説明

ok

ブール値

OK をクリックすると true が返され、キャンセル をクリックすると false が返されます。

inputValue

文字列

ok が true に設定されている場合、ユーザー入力値が返されます。

サンプルコード

my.prompt({
  title: '単一行タイトル',
  message: '現在の状況を説明し、ユーザーに解決策を提示します。できれば2行以内にしてください',
  placeholder: '友達にメッセージを残す',
  okButtonText: 'OK',
  cancelButtonText: 'キャンセル',
  success: (result) => {
    my.alert({
      title: JSON.stringify(result),
    });
  },
});

my.showToast

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

このインターフェイスを使用すると、トーストを表示できます。トーストの表示時間を設定できます。

パラメーター

名前

タイプ

必須

説明

content

文字列

いいえ

テキストコンテンツ。

type

文字列

いいえ

対応するアイコンで表されるトーストタイプ。デフォルトは none です。使用可能な値は、successfailexception、および none です。これらのうち、exception タイプにはテキスト情報が必要です。

duration

数値

いいえ

ミリ秒単位の表示時間。デフォルトは 2,000 です。

success

関数

いいえ

呼び出しが成功したことを示すコールバック関数。

fail

関数

いいえ

呼び出しが失敗したことを示すコールバック関数。

complete

関数

いいえ

呼び出しが完了したことを示すコールバック関数(呼び出しの成功または失敗に関係なく実行されます)。

サンプルコード

// API-DEMO page/API/toast/toast.json
{
    "defaultTitle": "トースト"
}
<!-- API-DEMO page/API/toast/toast.axml-->
<view class="page">
  <view class="page-description">トースト API</view>
  <view class="page-section">
    <view class="page-section-title">my.showToast</view>
    <view class="page-section-btns">
      <view type="primary" onTap="showToastSuccess">成功プロンプトテキストを表示する</view>
      <view type="primary" onTap="showToastFail">失敗プロンプトテキストを表示する</view>
    </view>
    <view class="page-section-btns">
      <view type="primary" onTap="showToastException">例外プロンプトテキストを表示する</view>
      <view type="primary" onTap="showToastNone">「なし」トーストを表示する。</view>
    </view>
  </view>

  <view class="page-section">
    <view class="page-section-title">my.hideToast</view>
    <view class="page-section-btns">
      <view onTap="hideToast">トーストを非表示にする。</view>
    </view>
  </view>
</view>
// API-DEMO page/API/toast/toast.js
Page({
  showToastSuccess() {
    my.showToast({
      type: 'success',
      content: '操作成功',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  showToastFail() {
    my.showToast({
      type: 'fail',
      content: '操作失敗',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  showToastException() {
    my.showToast({
      type: 'exception',
      content: 'ネットワーク例外',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  showToastNone() {
    my.showToast({
      type: 'none',
      content: '少々お待ちください',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  hideToast() {
    my.hideToast()
  },
})

my.hideToast

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

このインターフェイスを使用すると、トーストを非表示にできます。

パラメーター

名前

タイプ

必須

説明

success

関数

いいえ

操作が成功したことを示すコールバック関数。

fail

関数

いいえ

操作が失敗したことを示すコールバック関数。

complete

関数

いいえ

操作が完了したことを示すコールバック関数。この関数は、操作の成功または失敗に関係なく実行されます。

サンプルコード

// API-DEMO page/API/toast/toast.json
{
    "defaultTitle": "トースト"
}
<!-- API-DEMO page/API/toast/toast.axml-->
<view class="page">
  <view class="page-description">トースト API</view>
  <view class="page-section">
    <view class="page-section-title">my.showToast</view>
    <view class="page-section-btns">
      <view type="primary" onTap="showToastSuccess">成功プロンプトテキストを表示する</view>
      <view type="primary" onTap="showToastFail">失敗プロンプトテキストを表示する</view>
    </view>
    <view class="page-section-btns">
      <view type="primary" onTap="showToastException">例外プロンプトテキストを表示する</view>
      <view type="primary" onTap="showToastNone">「なし」トーストを表示する。</view>
    </view>
  </view>

  <view class="page-section">
    <view class="page-section-title">my.hideToast</view>
    <view class="page-section-btns">
      <view onTap="hideToast">トーストを非表示にする。</view>
    </view>
  </view>
</view>
// API-DEMO page/API/toast/toast.js
Page({
  showToastSuccess() {
    my.showToast({
      type: 'success',
      content: '操作成功',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  showToastFail() {
    my.showToast({
      type: 'fail',
      content: '操作失敗',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  showToastException() {
    my.showToast({
      type: 'exception',
      content: 'ネットワーク例外',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  showToastNone() {
    my.showToast({
      type: 'none',
      content: '少々お待ちください',
      duration: 3000,
      success: () => {
        my.alert({
          title: 'トーストが消えました',
        });
      },
    });
  },
  hideToast() {
    my.hideToast()
  },
})

my.showLoading

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

このインターフェイスを使用すると、読み込みプロンプト付きのトランジション効果を表示できます。このインターフェイスは、my.hideLoading 操作と一緒に使用できます。

パラメーター

名前

タイプ

必須

説明

content

文字列

いいえ

読み込みプロンプト。

delay

数値

いいえ

表示するまでの遅延。単位:ミリ秒。デフォルト値:0。指定された時間より前に my.hideLoading 操作が実行された場合、読み込みプロセスは表示されません。

success

関数

いいえ

呼び出しが成功したことを示すコールバック関数。

fail

関数

いいえ

呼び出しが失敗したことを示すコールバック関数。

complete

関数

いいえ

呼び出しが完了したことを示すコールバック関数(呼び出しの成功または失敗に関係なく実行されます)。

サンプルコード

// API-DEMO page/API/loading/loading.json
{
    "defaultTitle": "読み込みプロンプト"
}
<!-- API-DEMO page/API/loading/loading.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-title">
      読み込みプロセス中は、HTML5 ページ全体が覆われ、インタラクティブではなくなります。
    </view>
    <view class="page-section-btns">
      <view onTap="showLoading">読み込みプロンプトを表示する。</view>
    </view>
  </view>
</view>
// API-DEMO page/API/loading/loading.js
Page({
  showLoading() {
    my.showLoading({
      content: '読み込み中...',
      delay: 1000,
    });
    setTimeout(() => {
      my.hideLoading();
    }, 5000);
  },
});
/* API-DEMO page/API/loading/loading.acss */
.tips{
  margin-left: 10px;
  margin-top: 20px;
  color: red;
  font-size: 12px;
}
.tips .item {
  margin: 5px 0;
  color: #888888;
  line-height: 14px;
}

my.hideLoading

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

このインターフェイスを使用すると、読み込みプロセスを表示するために指定されたトランジション効果を非表示にできます。このインターフェイスは、my.showLoading 操作と一緒に使用できます。

パラメーター

名前

タイプ

必須

説明

page

オブジェクト

いいえ

my.hideLoading 操作を実行するページインスタンス。

サンプルコード

Page({
  onLoad() {
    my.showLoading();
    const that = this;
    setTimeout(() => {
      my.hideLoading({
        page: that, // page パラメーターを指定して、必要に応じて特定のページで my.hideLoading 操作が実行されるようにします。
      });
    }, 4000);
  }
})

my.showActionSheet

説明

このインターフェイスは、mPaaS 10.1.32 以降のバージョンでのみサポートされています。

このインターフェイスを使用すると、アクションシートを表示できます。

パラメーター

名前

タイプ

必須

説明

最小ベースライブラリバージョン

title

文字列

いいえ

アクションシートのタイトル。

-

items

文字列配列

必須

アクションシートのボタンに表示されるテキストの文字列配列。

-

cancelButtonText

文字列

いいえ

キャンセルボタンに表示されるテキスト。デフォルト値:「キャンセル」。

重要

Android では、このパラメーターはサポートされておらず、キャンセルボタンは表示されません。

-

destructiveBtnIndex

数値

いいえ

特定のボタンのインデックス番号。最小値は 0 です。このパラメーターは iOS でのみサポートされています。

適用可能なシナリオ:この操作では、データを削除またはクリアできます。デフォルトでは、インデックス番号は赤で表示されます。

-

badges

オブジェクト配列

いいえ

強調表示する必要があるオブジェクトの配列。次の表に、配列内の各オブジェクトに指定する必要があるパラメーターを示します。

1.9.0

success

関数

いいえ

呼び出しが成功したことを示すコールバック関数。

-

fail

関数

いいえ

呼び出しが失敗したことを示すコールバック関数。

-

complete

関数

いいえ

呼び出しが完了したことを示すコールバック関数(呼び出しの成功または失敗に関係なく実行されます)。

-

badges パラメーターの各オブジェクトに指定するパラメーター

名前

タイプ

説明

index

数値

強調表示する必要があるオブジェクトのインデックス番号。最小値は 0 です。

type

文字列

ハイライトスタイル。有効な値:none、point、num、textなど。

  • このパラメーターを none に設定すると、オブジェクトが強調表示されても赤い点は表示されません。

  • このパラメーターを point に設定すると、オブジェクトが強調表示されたときにテキストのない赤い点が表示されます。

  • このパラメーターを text に設定すると、オブジェクトが強調表示されたときにテキストを含む赤い円が表示されます。

  • このパラメーターを more に設定すると、必要に応じてスタイルをさらに構成する必要があります。

text

文字列

オブジェクトが強調表示されたときに表示されるカスタムテキスト。

  • type パラメーターを none、point、または more に設定した場合は、このパラメーターを設定する必要はありません。

  • type パラメーターを num に設定した場合、または指定したテキストが 10 進数または 0 以下の数値の場合、オブジェクトが強調表示されてもテキストは表示されません。指定したテキストが 100 より大きい数値の場合、テキストは ... として表示されます。

サンプルコード

// API-DEMO page/API/action-sheet/action-sheet.json
{
    "defaultTitle": "アクションシート"
}
<!-- API-DEMO page/API/action-sheet/action-sheet.axml-->
<view class="page">
  <view class="page-description">アクションシートを表示するための API 操作</view>
  <view class="page-section">
    <view class="page-section-title">my.showActionSheet</view>
    <view class="page-section-demo">
      <button type="primary" onTap="showActionSheet">アクションシートを表示する。</button>
    </view>
  </view>
</view>
// API-DEMO page/API/action-sheet/action-sheet.js
Page({
  showActionSheet() {
    my.showActionSheet({
      title: 'Alipay-アクションシート',
      items: ['メニュー 1', 'メニュー 2', 'メニュー 3'],
      cancelButtonText: 'キャンセル',
      success: (res) => {
        const btn = res.index === -1 ? 'キャンセル' : 'No.' + res.index;
        my.alert({
          title: `選択したのは ${btn} です`,
        });
      },
    });
  },
});