Skip to content

Commit bfe5410

Browse files
lacolacolacolaco
committed
fix(docs): retranslate updated API section in guide/aria/combobox
1 parent f8c4fe2 commit bfe5410

2 files changed

Lines changed: 20 additions & 98 deletions

File tree

‎adev-ja/src/content/guide/aria/combobox.en.md‎

Lines changed: 10 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -235,62 +235,23 @@ describe('MyComboboxComponent', () => {
235235
});
236236
```
237237

238-
## APIs
238+
## API reference
239239

240-
### Combobox Directive
240+
For detailed API documentation, inspect the following API references:
241241

242-
Coordinates an interactive trigger element (such as a text input, button, or div) with a popup container.
243-
244-
#### Inputs / Model
245-
246-
| Property | Type | Default | Description |
247-
| ------------------ | ---------------------- | ------- | ------------------------------------------------------------------- |
248-
| `value` | `ModelSignal<string>` | `''` | Two-way bindable text value of the combobox |
249-
| `expanded` | `ModelSignal<boolean>` | `false` | Two-way bindable open/closed expanded state of the popup |
250-
| `disabled` | `boolean` | `false` | Disables the combobox trigger element |
251-
| `softDisabled` | `boolean` | `true` | Disables interaction while keeping the element keyboard focusable |
252-
| `alwaysExpanded` | `boolean` | `false` | Forces the popup to always remain open |
253-
| `inlineSuggestion` | `string \| undefined` | - | Sets an inline suggestion to be highlighted at the end of the input |
254-
| `tabIndex` | `number \| undefined` | - | Tabindex of the combobox element (aliased to `tabindex`) |
255-
256-
All keyboard events, focus coordination, and ARIA state properties (including `role="combobox"`, `aria-autocomplete`, and `aria-expanded`) are handled automatically on the host element.
257-
258-
---
259-
260-
### ComboboxPopup Directive
261-
262-
Marks an `<ng-template>` as the popup container for the combobox.
263-
264-
#### Inputs
265-
266-
| Property | Type | Default | Description |
267-
| ----------- | ------------------------------------------- | ----------- | ---------------------------------------------- |
268-
| `combobox` | `Combobox` | (Required) | Reference to the parent `Combobox` directive |
269-
| `popupType` | `'listbox' \| 'tree' \| 'grid' \| 'dialog'` | `'listbox'` | Specifies the layout/role profile of the popup |
270-
271-
---
272-
273-
### ComboboxWidget Directive
274-
275-
Connects the popup contents (such as a listbox or grid) with the parent combobox trigger.
276-
277-
#### Inputs
278-
279-
| Property | Type | Description |
280-
| ------------------ | --------------------- | ----------------------------------------------------------------------------------- |
281-
| `activeDescendant` | `string \| undefined` | The ID of the currently active option (bound to the active option ID in the widget) |
282-
283-
---
242+
- [`Combobox`](/api/aria/combobox/Combobox)
243+
- [`ComboboxPopup`](/api/aria/combobox/ComboboxPopup)
244+
- [`ComboboxWidget`](/api/aria/combobox/ComboboxWidget)
284245

285246
### Related patterns and directives
286247

287248
Combobox is the primitive directive for these documented patterns:
288249

289-
- **[Autocomplete](guide/aria/autocomplete)** - Filtering and suggestions pattern (coordinates input typing with options list)
290-
- **[Select](guide/aria/select)** - Single selection dropdown pattern (applied directly on non-editable button triggers)
291-
- **[Multiselect](guide/aria/multiselect)** - Multiple selection pattern (applied on non-editable triggers with multi-enabled Listbox)
250+
- [Autocomplete](guide/aria/autocomplete) - Filtering and suggestions pattern (coordinates input typing with options list)
251+
- [Select](guide/aria/select) - Single selection dropdown pattern (applied directly on non-editable button triggers)
252+
- [Multiselect](guide/aria/multiselect) - Multiple selection pattern (applied on non-editable triggers with multi-enabled Listbox)
292253

293254
Combobox typically combines with:
294255

295-
- **[Listbox](guide/aria/listbox)** - Most common popup content
296-
- **[Tree](guide/aria/tree)** - Hierarchical popup content (see Tree guide for examples)
256+
- [Listbox](guide/aria/listbox) - Most common popup content
257+
- [Tree](guide/aria/tree) - Hierarchical popup content (see Tree guide for examples)

‎adev-ja/src/content/guide/aria/combobox.md‎

Lines changed: 10 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -235,62 +235,23 @@ describe('MyComboboxComponent', () => {
235235
});
236236
```
237237

238-
## API {#apis}
238+
## API reference {#api-reference}
239239

240-
### Comboboxディレクティブ {#combobox-directive}
240+
詳細なAPIドキュメントについては、以下のAPIリファレンスを参照してください。
241241

242-
インタラクティブなトリガー要素（テキスト入力、ボタン、divなど）とポップアップコンテナを連携させます。
243-
244-
#### 入力 / モデル {#inputs--model}
245-
246-
| プロパティ | 型 | デフォルト | 説明 |
247-
| ------------------ | ---------------------- | ------- | ------------------------------------------------------------------- |
248-
| `value` | `ModelSignal<string>` | `''` | コンボボックスの双方向バインディング可能なテキスト値 |
249-
| `expanded` | `ModelSignal<boolean>` | `false` | ポップアップの開閉状態を双方向バインディングできる値 |
250-
| `disabled` | `boolean` | `false` | コンボボックスのトリガー要素を無効にします |
251-
| `softDisabled` | `boolean` | `true` | 要素をキーボードフォーカス可能に保ちながら、インタラクションを無効にします |
252-
| `alwaysExpanded` | `boolean` | `false` | ポップアップを常に開いたままにします |
253-
| `inlineSuggestion` | `string \| undefined` | - | 入力の末尾でハイライト表示するインライン補完候補を設定します |
254-
| `tabIndex` | `number \| undefined` | - | コンボボックス要素のtabindex（`tabindex`のエイリアス） |
255-
256-
すべてのキーボードイベント、フォーカス連携、ARIA状態プロパティ（`role="combobox"`、`aria-autocomplete`、`aria-expanded`を含む）は、ホスト要素で自動的に処理されます。
257-
258-
---
259-
260-
### ComboboxPopupディレクティブ {#comboboxpopup-directive}
261-
262-
`<ng-template>`をコンボボックスのポップアップコンテナとしてマークします。
263-
264-
#### 入力 {#comboboxpopup-inputs}
265-
266-
| プロパティ | 型 | デフォルト | 説明 |
267-
| ----------- | ------------------------------------------- | ----------- | ---------------------------------------------- |
268-
| `combobox` | `Combobox` | (必須) | 親`Combobox`ディレクティブへの参照 |
269-
| `popupType` | `'listbox' \| 'tree' \| 'grid' \| 'dialog'` | `'listbox'` | ポップアップのレイアウト/ロールプロファイルを指定します |
270-
271-
---
272-
273-
### ComboboxWidgetディレクティブ {#comboboxwidget-directive}
274-
275-
ポップアップコンテンツ（リストボックスやグリッドなど）を親コンボボックストリガーに接続します。
276-
277-
#### 入力 {#comboboxwidget-inputs}
278-
279-
| プロパティ | 型 | 説明 |
280-
| ------------------ | --------------------- | ----------------------------------------------------------------------------------- |
281-
| `activeDescendant` | `string \| undefined` | 現在アクティブなオプションのID（ウィジェット内のアクティブなオプションIDにバインド） |
282-
283-
---
242+
- [`Combobox`](/api/aria/combobox/Combobox)
243+
- [`ComboboxPopup`](/api/aria/combobox/ComboboxPopup)
244+
- [`ComboboxWidget`](/api/aria/combobox/ComboboxWidget)
284245

285246
### 関連するパターンとディレクティブ {#related-patterns-and-directives}
286247

287248
Comboboxは、これらのドキュメント化されたパターンのためのプリミティブディレクティブです:
288249

289-
- **[オートコンプリート](guide/aria/autocomplete)** - フィルタリングと提案のパターン（入力タイピングとオプションリストを連携）
290-
- **[セレクト](guide/aria/select)** - 単一選択のドロップダウンパターン（編集不可のボタントリガーに直接適用）
291-
- **[マルチセレクト](guide/aria/multiselect)** - 複数選択のパターン（複数選択が有効なListboxを持つ編集不可トリガーに適用）
250+
- [オートコンプリート](guide/aria/autocomplete) - フィルタリングと提案のパターン（入力タイピングとオプションリストを連携）
251+
- [セレクト](guide/aria/select) - 単一選択のドロップダウンパターン（編集不可のボタントリガーに直接適用）
252+
- [マルチセレクト](guide/aria/multiselect) - 複数選択のパターン（複数選択が有効なListboxを持つ編集不可トリガーに適用）
292253

293254
Comboboxは通常、以下と組み合わせて使用されます:
294255

295-
- **[Listbox](guide/aria/listbox)** - 最も一般的なポップアップコンテンツ
296-
- **[Tree](guide/aria/tree)** - 階層的なポップアップコンテンツ（例についてはTreeガイドを参照）
256+
- [Listbox](guide/aria/listbox) - 最も一般的なポップアップコンテンツ
257+
- [Tree](guide/aria/tree) - 階層的なポップアップコンテンツ（例についてはTreeガイドを参照）

0 commit comments

Comments
 (0)