라우트 매개변수를 사용한 네비게이션 가이드
애플리케이션 상태를 지원하는 과정에서 App Builder의 변수 사용은 이제 특별한 종류의 변수, 즉 라우트 매개변수를 통해 애플리케이션 내의 네비게이션을 용이하게 합니다.
라우트 매개변수 이해
라우트 매개변수는 변수로 기능하며, 사용자가 값을 생성하고 저장하고 할당하고 애플리케이션의 다른 속성에 바인딩할 수 있게 합니다. 그러나 이러한 라우트 매개변수는 특정한 주요 용도를 가지고 있습니다. 앱 내에서 네비게이션을 구축할 수 있도록 하는 것입니다(네비게이션 참조). 네비게이션 경로에 매개변수 바인딩이 필요할 때 사용자는 라우트 매개변수를 바인딩하여 이 프로세스를 용이하게 할 수 있습니다.
App 변수와 라우트 매개변수 간의 주요 차이점:
- 라우트 매개변수는 자식 보기에서만 생성할 수 있으며, 여기서 자식 보기는 특정 네비게이션 경로의 랜딩 페이지 역할을 할 수 있습니다.
- 라우트 매개변수는
string,numeric또는boolean유형만 가능합니다. 다른 유형에 대한 지원은 향후 버전에서 도입될 예정입니다. - 라우트 매개변수는 초기값을 지원하며,
boolean라우트 매개변수는FALSE초기값만 지원합니다. - 라우트 매개변수는 Set Variable 동작의 대상 변수가 아닙니다.
변수 소개
라우트 매개변수 생성
사용자는 두 가지 방법으로 라우트 매개변수를 생성할 수 있습니다:
- 변수 섹션의 New Variable > Route param 흐름을 통해.
- 속성 패널의 일부인 Route Params 섹션의 + 추가 버튼을 사용합니다.
매개변수 이름은 변수와 동일한 유효성 검사를 거칩니다.
라우트 매개변수 생성
라우트 매개변수 사용
-
자식 보기에 라우트 매개변수가 하나만 있는 경우, 이는 애플리케이션 라우팅을 위한 경로 매개변수로 처리됩니다. 이를 통해 pathParameter에 대한 특정 값을 전달하면서
/child-view/pathParameter로 네비게이션할 수 있습니다. -
보기에 대해 둘 이상의 라우트 매개변수가 생성된 경우, 이러한 매개변수는 네비게이션에서 쿼리 매개변수로 처리됩니다:
/child-view/pathParameter=value1&pathParameter2=value2. 보기의 유일한 라우트 매개변수가 boolean 유형인 경우, 쿼리 매개변수로 처리됩니다.
선택적 및 필수 라우트 매개변수
라우트 매개변수에 초기값이 있는 경우, 네비게이션에서 선택적 매개변수로 처리됩니다. 선택적 라우트 매개변수를 생성하면 애플리케이션에는 두 가지 유효한 경로가 있습니다:
/app/customerDetails/customerIDapp/customerDetails
옵션 2에서 customerID 매개변수의 값이 설정되지 않은 경우, customerID 속성의 처리는 대상 프레임워크에 따라 다를 수 있습니다. Angular 및 WebComponents 프레임워크는 기본적으로 undefined 값을 할당하지만, 이 값은 App Builder에서 속성에 대해 설정된 초기값으로 재정의됩니다.
라우트 매개변수를 사용하여 자식 페이지로 네비게이션
-
디자인 서피스에 구성 요소(예: 버튼)를 추가하고 드롭다운에서 자식 보기를 선택하여
Navigate to상호 작용을 첨부합니다. -
선택한 자식 보기에 라우트 매개변수가 있는 경우, 사용자는 라우트 매개변수에 값을 제공하거나 값에 바인딩할 수 있는 대화 상자를 열 수 있는 옵션을 받습니다:
엔드포인트에서 데이터 초기화
