"Add custom document browser actions, activities, and bar items."
커스텀 문서 브라우저 액션, 활동, 바 아이템을 추가합니다.
Overview
문서 브라우저에 커스텀 액션을 추가하는 세 가지 방법이 있습니다.
- 네비게이션 바 혹은 편집 메뉴에 문서 브라우저 액션을 추가합니다.
- 활동 뷰에 활동을 추가합니다.
- 네비게이션 바에 바 아이템을 추가합니다.
Add Document Browser Actions
기본값으로 시스템은 몇 가지 표준 액션(복사, 이동, 이름 변경, 삭제, 공유)을 제공합니다. 커스텀 액션을 추가하려면, 브라우저의 customActions 속성에 UIDocumentBrowserAction 객체의 배열을 할당해야 합니다.
문서 브라우저 액션은 두 가지 방법으로 접근될 수 있습니다.
- Navigation bar 액션은 사용자가 선택 모드에 브라우저를 위치시킬 때 네비게이션 바에 나타납니다.
- Edit Menu 액션은 사용자가 문서 혹은 폴더를 길게 누를 때 나타납니다.
이 액션이 실행되면 이러한 액션들은 현재 선택된 아이템의 URL로 전달됩니다.
Add Activities
브라우저는 사용자가 공유 버튼을 탭할 때 호라동 뷰를 표시합니다(예를 들어 사용자가 문서 혹은 폴더를 길게 누르고 편집 메뉴로부터 공유를 선택하는 경우).
활동 뷰에 커스텀 활동을 추가하려면 UIDocumentBrowserViewControllerDelegate 객체의 documentBrowser(_:applicationActivitiesForDocumentURLs:) 메소드를 구현하고, 커스텀 UIActivity 객체의 배열을 반환해야 합니다.
딜리게이트 객체는 현재 선택된 아이템에 대한 URL의 배열을 전달받습니다. UIActivity 서브클래스에서 이러한 URL을 저장하거나 사용할 수 있습니다.
더 많은 정보는 Sharing and Actions를 살펴보시기 바랍니다.
Sharing and Actions
https://developer.apple.com/design/human-interface-guidelines/ios/extensions/sharing-and-actions/
Add Bar Button Items
네비게이션 바에 버튼을 추가하려면 additionalLeadingNavigationBarButtonItems 및 additionalTrailingNavigationBarButtonItems 메소드를 사용하시기 바랍니다.
이 버튼에 의해 실행된 액션은 브라우저의 컨텐트 혹은 선택된 아이템의 URL에 접근권한을 갖지 않습니다. 글로벌 액션만을 위해 바 버튼 아이템을 사용하시기 바랍니다(특정 문서 혹은 폴더에 영향을 미치지 않는 액션)
See Also
Customization
Customizing the Browser
문서 브라우저의 모양 및 동작을 커스터마이징합니다.
https://developer.apple.com/documentation/uikit/view_controllers/adding_a_document_browser_to_your_app/customizing_the_browser
https://velog.io/@panther222128/Customizing-the-Browser
