メインコンテンツまでスキップ

getFoldableState

Description​

フォルダブル端末の現在の折りたたみ状態の名前を文字列で返します。

isUnfolded()やisFoldedよりも詳細な状態情報が必要なときに使用します。

Parameters​

なし

Returns​

型値説明
String"folded"端末が折りたたまれている状態
String"unfolded"端末が開かれている状態
String"unknown"状態を検出できない場合（一般的な端末を含む）

Notes​

  • フォルダブルAndroid端末専用の機能です。
  • ⚠️ 注意：一般的な端末（デスクトップを含む）では"unknown"ではなく**"folded"**を返します。これは内部実装上、displayFeaturesがない場合にfoldedへフォールバックする動作で、既知の問題です。
  • 単純なtrue/falseの判定だけが必要な場合はisUnfolded()を使用してください。

Example​

// 現在の折りたたみ状態の文字列を確認
var state = $app.getFoldableState();
console.log("폴드 상태:", state); // "folded", "unfolded", "unknown"

// 状態ごとの分岐処理
switch (state) {
    case "unfolded":
        console.log("펼쳐진 상태 - 와이드 레이아웃");
        break;
    case "folded":
        console.log("접힌 상태 - 컴팩트 레이아웃");
        break;
    default:
        console.log("일반 기기 또는 상태 미감지");
}
  • $app.isUnfolded() — 開かれた状態かどうかをboolで返します
  • $vm.onFoldableStateChanged(state, isFolded, isUnfolded) — 折りたたみ状態の変更イベント