cabrillo.viewLayout - 클라이언트

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기8분
  • 카브리요 JS 기능을 사용하여 버튼 및 스피너와 같은 네이티브 UI 요소에 대한 액세스를 제공합니다.

    cabrillo.viewLayout - getTitle()

    현재 네이티브 뷰의 제목을 가져옵니다.

    표 1. 매개변수
    이름 유형 설명
    없음
    표 2. 반환
    유형 설명
    약속 성공하면 제목 텍스트로 해결되고, 그렇지 않으면 오류가 해결됩니다.
    cabrillo.viewLayout.getTitle()
    .then(function(title) {
       console.log(title);
    }, function(error) {
       console.log(error);
    });

    cabrillo.viewLayout - hideBackButton()

    클라이언트 인터페이스에서 뒤로 버튼을 숨깁니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    없음
    cabrillo.viewLayout.hideBackButton();

    cabrillo.viewLayout - hideSpinner()

    현재 인터페이스에서 네이티브 스피너를 숨깁니다.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    void
    cabrillo.viewLayout.hideSpinner();

    cabrillo.viewLayout - setBottomButtons(배열 버튼, 함수 실행)

    현재 인터페이스 하단에 버튼을 설정합니다.

    하단 버튼에서는 이미지와 배지가 지원되지 않습니다.

    표 7. 매개변수
    이름 유형 설명
    단추 Cabrillo.Button 객체의 배열 설정할 단추에 대해 설명합니다. 현재 최대 1개의 버튼이 지원됩니다.
    실행 기능 단추를 누를 때 호출할 함수입니다. 이 함수에는 반환 값이 없으며 선택한 단추 인덱스를 유일한 매개 변수로 사용합니다. 함수에는 Number라는 단일 매개 변수가 있어야 합니다.
    표 8. 반환
    유형 설명
    약속 성공하면 해결되지 않은 객체이고, 그렇지 않으면 오류입니다.

    하단 버튼을 설정합니다.

    var buttons = [
        {
            title: 'Add to Cart',
            buttonId: 'btnAddCart',
            enabled: true,
            backgroundColor: '#3091F9',
            textColor: '#FFFFFF'
        }
    ];
    
    cabrillo.viewLayout.setBottomButtons(buttons, (buttonIndex) => {
        console.log('Success. Received an event from the button.');
    }).catch((err) => {
        console.log('Failed to register buttons.');
        console.error(err);
    });

    하단 버튼을 지웁니다.

    cabrillo.viewLayout.setBottomButtons();

    cabrillo.viewLayout - setNavigationBarButtons(배열 버튼, 함수 실행)

    현재 인터페이스의 탐색 모음에서 버튼을 설정합니다.

    오버플로우 버튼 메뉴에 나타나는 버튼의 이미지와 배지는 생략됩니다. 이러한 이유로 탐색 모음에서 이미지 버튼을 설정할 때 제목과 이미지 이름을 제공하는 것이 가장 좋습니다.

    표 9. 매개변수
    이름 유형 설명
    단추 Cabrillo.Button 개체의 배열입니다. 설정할 단추에 대해 설명합니다. 버튼은 필요에 따라 추가 메뉴로 오버플로우될 수 있습니다.
    실행 기능 단추를 누를 때 호출할 함수입니다. 이 함수에는 반환 값이 없으며 선택한 단추 인덱스를 유일한 매개 변수로 사용합니다. 함수에는 Number라는 단일 매개 변수가 있어야 합니다.
    표 10. 반환
    유형 설명
    약속 성공하면 해결되지 않은 객체이고, 그렇지 않으면 오류입니다.

    탐색 모음 버튼을 설정합니다.

    var buttons = [
       {
          title: "Save",
          enabled: true,
          buttonId: "btnSave",
       },
    ];
    
    cabrillo.viewLayout
       .setBottomButtons(buttons, (buttonIndex) => {
          console.log("Success. Received an event from the button.");
       })
       .catch((err) => {
          console.log("Failed to register buttons.");
          console.error(err);
       });

    여러 버튼을 처리합니다.

    var buttons = [
       {
          title: "Save",
          enabled: true,
          buttonId: "btnSave",
       },
       {
          title: "Delete",
          enabled: true,
          buttonId: "btnDelete",
       },
    ];
    
    cabrillo.viewLayout
       .setNavigationBarButtons(buttons, (buttonIndex) => {
          switch (buttonIndex) {
             case 0:
                console.log("Received an event from the Save button.");
                break;
             case 1:
                console.log("Received an event from the Delete button.");
                break;
          }
       })
       .catch((err) => {
          console.log("Failed to register buttons.");
          console.error(err);
       });

    탐색 모음에 배치된 버튼은 이미지로 나타낼 수 있습니다.

    var buttons = [
       {
          title: "Compose",
          buttonId: "btnCompose",
          imageName: "compose",
          enabled: true,
       },
    ];
    
    cabrillo.viewLayout
       .setNavigationBarButtons(buttons, (buttonIndex) => {
          console.log("Success. Received an event from the button.");
       })
       .catch((err) => {
          console.log("Failed to register buttons.");
          console.error(err);
       });

    네이티브 뒤로 단추는 기본적으로 네이티브 앱에 표시되지만 단추의 buttonStyle 속성을 설정하여 뒤로 단추를 Cabrillo 단추로 바꿀 수 있습니다.

    var buttons = [
       {
          title: "Cancel",
          buttonId: "btnCancel",
          imageName: "close",
          buttonStyle: cabrillo.viewLayout.REPLACE_BACK_BUTTON_STYLE,
          enabled: true,
       },
       {
          title: "Done",
          enabled: true,
       },
    ];
    
    cabrillo.viewLayout
       .setNavigationBarButtons(buttons, (buttonIndex) => {
          switch (buttonIndex) {
             case 0:
                c.log("Cancel button was clicked.");
                break;
             case 1:
                c.log("Done button was clicked.");
                break;
          }
       })
       .catch((err) => {
          c.log("Failed to register buttons.");
          c.error(err);
       });

    버튼은 필요에 따라 오버플로우 버튼 메뉴에 배치됩니다. 단추를 오버플로 단추 메뉴에 강제로 넣으려면 단추의 buttonStyle 속성을 설정합니다.

    var buttons = [
       {
          title: "Save",
          buttonId: "btnSave",
          buttonStyle: cabrillo.viewLayout.MORE_MENU_BUTTON_STYLE,
          enabled: true,
       },
    ];
    
    cabrillo.viewLayout
       .setNavigationBarButtons(buttons, (buttonIndex) => {
          console.log("Success. Received an event from the button.");
       })
       .catch((err) => {
          console.log("Failed to register buttons.");
          console.error(err);
       });

    버튼이 탐색 모음에 배치되면 배지가 생길 수 있습니다. 이 예시에서는 쇼핑 카트 아이콘이 있고 배지 개수가 3인 단추를 설정합니다. 배지의 배경은 파란색이고 텍스트는 흰색입니다.

    var buttons = [
       {
          title: "Cart",
          buttonId: "btnCart",
          imageName: "cart",
          badgeCount: 3,
          backgroundColor: "#3091F9",
          textColor: "#FFFFFF",
          enabled: true,
       },
    ];
    
    cabrillo.viewLayout
       .setNavigationBarButtons(buttons, (buttonIndex) => {
          console.log("Success. Received an event from the button.");
       })
       .catch((err) => {
          console.log("Failed to register buttons.");
          console.error(err);
       });

    탐색 모음 버튼의 선택을 취소합니다.

    cabrillo.viewLayout.setNavigationBarButtons();

    cabrillo.viewLayout - setTitle(title 문자열)

    현재 네이티브 뷰의 제목을 설정합니다.

    표 11. 매개변수
    이름 유형 설명
    제목 문자열 인터페이스의 제목입니다.
    표 12. 반환
    유형 설명
    void
    cabrillo.viewLayout.setTitle('My Title');

    cabrillo.viewLayout - showBackButton()

    클라이언트 인터페이스에 뒤로 버튼을 표시합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    없음
    cabrillo.viewLayout.showBackButton();

    cabrillo.viewLayout - showSpinner(객체 옵션)

    현재 인터페이스에 네이티브 스피너를 표시합니다.

    표 15. 매개변수
    이름 유형 설명
    옵션 객체 옵션입니다. 스피너의 모양을 수정하기 위한 추가 설정입니다.
    {
      "mask": Boolean,
      "maskColor": "String"
    }
    옵션.마스크 부울 옵션입니다. 스피너 뒤에 마스크를 표시할지 여부를 결정합니다.
    유효한 값은 다음과 같습니다.
    • true: 스피너 뒤에 마스크를 표시합니다.
    • false: 스피너 뒤에 마스크를 표시하지 않습니다.

    기본값: false

    options.maskColor 문자열 마스크의 색상입니다(활성화된 경우).
    표 16. 반환
    유형 설명
    없음
    var options = { mask: true, maskColor: '#ffffff' };
    cabrillo.viewLayout.showSpinner(options);