Workshop Routing으로 화면 상태 공유

Routing은 모듈의 페이지와 선택한 변수값을 URL에 기록하여 현재 화면 상태를 링크로 공유하는 기능입니다.

현재 화면 상태를 URL로 표현하도록 구성한 Workshop 모듈

Routing 켜기

Settings의 Pages에서 Enable routing을 켭니다.

모듈의 Enable routing 설정

Pages에는 Routing에 사용하는 페이지 개요와 변수 목록이 표시됩니다.

Routing에 포함된 페이지와 변수를 보여 주는 개요

Routing을 켜면 현재 페이지의 ID를 URL에 기록합니다. Page ID가 없는 페이지는 ID를 기록하지 않으므로 그 상태의 링크를 다시 열면 모듈의 기본 페이지로 돌아갑니다.

URL에서 페이지를 구분할 Page ID 설정

변수 기반 페이지 선택을 함께 쓸 때는 페이지 선택 변수의 기본값을 비워 둡니다. 기본값을 설정하면 URL의 페이지보다 우선하여, 링크의 페이지가 잠깐 보인 뒤 기본값의 페이지로 이동할 수 있습니다.

모듈 interface에 공개한 변수의 Routing URL update behavior를 구성합니다. Routing을 켠 상태에서 해당 변수의 현재값을 query parameter로 기록합니다.

선택	URL에 기록하는 조건
In URL when used by visible widget or layout	값이 기본값과 다르고 현재 화면의 보이는 위젯 또는 레이아웃에서 사용하는 경우입니다.
Always in URL	값이 기본값과 다르면 현재 화면의 사용 여부와 관계없이 기록합니다.
Never in URL	해당 변수의 Routing URL 갱신을 비활성화하여 값을 기록하지 않습니다.

Module interface 변수의 URL 기록 방식을 선택하는 설정

URL에 값을 기록할지와 URL에서 초기값을 받을지는 별개입니다. Query parameter 이름이 module interface의 external ID와 일치하면 URL 포함 방식과 관계없이 그 값을 초기값으로 사용합니다.

Workshop Routing의 URL 상태 표현에는 다음 제한이 있습니다.

조건값을 별도 String 같은 Routing 변수에 저장하고 그 값을 객체 집합 필터의 기본 조건으로 참조하면 간접적으로 해당 상태를 구성할 수 있습니다. 필터 값 추출과 연결하여 사용자의 선택값을 전달할 수도 있습니다.

Carbon의 모듈 탭 매개변수로 값을 전달하는 규격은 모듈 interface의 별도 지원 범위를 따릅니다.

자식 모듈을 삽입해도 그 모듈의 Routing 설정은 이어받지 않습니다. 자식의 필요한 변수를 module interface에 공개하고 부모가 Routing을 설정한 변수를 매핑합니다. 모듈 삽입의 공유 변수 규칙에 따라 상태를 연결합니다.