Skip to content

Commit

Permalink
Merge branch 'main' of github.com:ionic-team/ionic-docs
Browse files Browse the repository at this point in the history
# Conflicts:
#	docs/api/datetime.md
#	docs/api/fab.md
#	docs/api/title.md
  • Loading branch information
rdlabo committed May 6, 2024
2 parents 9b6487c + 71ae5e6 commit 41e0a06
Show file tree
Hide file tree
Showing 24 changed files with 876 additions and 463 deletions.
2 changes: 2 additions & 0 deletions docs/api/content.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,8 @@ import Fullscreen from '@site/static/usage/v8/content/fullscreen/index.md';

スクロール可能な領域の外側に要素を配置するには、`fixed`スロットに割り当てます。そうすることで、その要素はコンテンツの左上に[絶対位置](https://developer.mozilla.org/en-US/docs/Web/CSS/position#absolute_positioning)されます。要素の位置を変えるには、CSSの[top, right, bottom, left](https://developer.mozilla.org/en-US/docs/Web/CSS/position)プロパティを使ってスタイルを設定することができます。

The `fixedSlotPlacement` property is used to determine if content in the `fixed` slot is placed before or after the main content in the DOM. When set to `before`, fixed slot content will be placed before the main content and will therefore receive keyboard focus before the main content receives keyboard focus. This can be useful when the main content contains an infinitely-scrolling list, preventing a [FAB](./fab) or other fixed content from being reachable by pressing the tab key.

import Fixed from '@site/static/usage/v8/content/fixed/index.md';

<Fixed />
Expand Down
9 changes: 1 addition & 8 deletions docs/api/datetime.md
Original file line number Diff line number Diff line change
Expand Up @@ -443,14 +443,7 @@ JavaScriptで日付を扱うために [date-fns](https://date-fns.org) を使う

#### 時刻、月、年のホイール

タイムホイールピッカーを使用する場合、列がフォーカスされているときに、数字キーで時、分の値を選択することができます。

| Key | Function |
| ------------------ | ------------------------------------------------------------ |
| `ArrowUp` | Scroll to the previous item. |
| `ArrowDown` | Scroll to the next item. |
| `Home` | Scroll to the first item. |
| `End` | Scroll to the last item. |
Datetimeのホイールピッカーは、内部的に [Picker](./picker) を使用しています。ホイールピッカーのアクセシビリティ機能の詳細については、 [ピッカー アクセシビリティ](./picker#accessibility) を参照してください。

## Interfaces

Expand Down
10 changes: 10 additions & 0 deletions docs/api/fab.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,16 @@ import SafeArea from '@site/static/usage/v8/fab/safe-area/index.md';

<SafeArea />

### 無限リストとの相対関係

無限にスクロールするリストなど、ビューに多くのインタラクティブ要素が含まれるシナリオでは、フローティングアクションボタン(FAB)がDOM内のすべてのアイテムの下に配置されていると、ユーザーがフローティングアクションボタンに移動するのが難しい場合があります。

[Content](./content)`fixedSlotPlacement` プロパティを `before` に設定することで、FABはDOM内のメインコンテンツの前に配置されます。これにより、他のインタラクティブ要素がフォーカスを受ける前にFABがキーボードフォーカスを受けるようになり、ユーザがFABにアクセスしやすくなります。

import BeforeContent from '@site/static/usage/v8/fab/before-content/index.md';

<BeforeContent />

## ボタンサイズ

メインファブボタンの `size` プロパティを `"small"` に設定すると、ミニサイズで描画されます。なお、このプロパティは内側のファブボタンで使用した場合は効果がありません。
Expand Down
31 changes: 31 additions & 0 deletions docs/api/picker.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,37 @@ import CSSProps from '@site/static/usage/v8/picker/theming/css-properties/index.
import ModalExample from '@site/static/usage/v8/picker/modal/index.md';

<ModalExample />

## Accessibility

### Screen Readers

Picker supports navigation using a screen reader by implementing the [`slider` role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/slider_role) on each [Picker Column](./picker-column). The following gestures can be used to navigate the Picker.

| Gesture | Function |
| - | - |
| Swipe Left | Move focus to the previous Picker Column. |
| Swipe Right | Move focus to the next Picker Column. |
| Swipe Up | Select the next option in the Picker Column. |
| Swipe Down | Select the previous option in the Picker Column. |
| Double Tap and Slide Up/Down | Adjust the selected option in the Picker Column. Can be used as an alternative to swiping up and down. |

:::caution
The Swipe Up and Swipe Down gestures rely on the correct key events being synthesized as noted on the [`slider` documentation](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/slider_role). [Chromium-based browsers do not synthesize keyboard events correctly](https://issues.chromium.org/issues/40816094), but the "Double Tap and Slide Up/Down" gesture can be used as an alternative until this has been implemented in Chromium-based browsers.
:::

### Keyboard Navigation

Each [Picker Column](./picker-column) can be navigated using the keyboard when focused.

| Key | Function |
| ------------------ | ------------------------------------------------------------ |
| `ArrowUp` | Scroll to the previous option. |
| `ArrowDown` | Scroll to the next option. |
| `PageUp` | Scroll up by more than one option. |
| `PageDown` | Scroll down by more than one option. |
| `Home` | Scroll to the first option. |
| `End` | Scroll to the last option. |

## プロパティ
<Props />
Expand Down
11 changes: 7 additions & 4 deletions docs/api/title.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,10 +53,13 @@ import CollapsibleLargeTitleButtons from '@site/static/usage/v8/title/collapsibl

### 見出し

見出しを作成する場合、一般的には [セマンティック見出し要素(h1-h6)](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements) を使うことをお勧めします。しかし、支援技術によって特定の見出しとして扱われるようにTitleを更新する必要がある場合があります。例えば、ビューの一番上にTitleがある場合、これをレベル1の見出しと見なしたいかもしれません。
これを実現するために、開発者はTitleで [`heading` role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/heading_role) を使用する必要があります。これにより、Titleが見出しの一種であることを支援技術に示すことができます。そこから、開発者は [`aria-level`属性](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-level) を使用して見出しレベルを設定する必要があります。
例えば、Titleを`h1`要素のように動作させたい場合、Titleに`role="heading"``aria-level="1"`を設定します。
複数のTitle要素をセマンティック見出し要素と組み合わせてビュー上で使用することができるため、Ionicは自動的にTitleの`role``aria-level`を設定しません。これを処理するのは開発者の責任です。
見出しを作成する場合、一般的には[セマンティック見出し要素(h1-h6)](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)を使うことをお勧めします。しかし、支援技術によって特定の見出しとして扱われるようにTitleを更新する必要がある場合があります。例えば、ビューの一番上にTitleがある場合、これをレベル1の見出しと見なしたいかもしれません。

これを実現するために、開発者はTitleで[`heading` role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/heading_role)を使用する必要があります。これにより、Titleが見出しの一種であることを支援技術に示すことができます。そこから、開発者は[`aria-level`属性](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-level)を使用して見出しレベルを設定する必要があります。

例えば、Titleを`h1`要素のように動作させたい場合、Titleに`role="heading"``aria-level="1"`を設定します。これは[Focus Manager](../developing/managing-focus#assistive-technology-focus-management)を使用するときに必要です。

複数のTitle要素をセマンティック見出し要素と組み合わせてビューで使用することができるため、Ionicは自動的にTitleの`role``aria-level`を設定しません。これを処理するのは開発者の責任です。

## Theming

Expand Down
Loading

0 comments on commit 41e0a06

Please sign in to comment.