Skip to main content
Version: v7

ion-buttons

scoped

Buttonsコンポーネントは、コンテナ要素です。 ツールバー の内部で使用し、標準のボタンメニューボタン戻るボタンを含むいくつかのタイプのボタンを含めることができる。

基本的な使い方

<ion-toolbar>
<ion-buttons slot="start">
<ion-button>Button</ion-button>
</ion-buttons>
<ion-title>Default Buttons</ion-title>
</ion-toolbar>

Buttons Placement

ツールバー内のボタンは、スロットという名前を使って配置することができます。下図は各スロットの説明です。

SlotDescription
startPositions to the left of the content in LTR, and to the right in RTL.
endPositions to the right of the content in LTR, and to the left in RTL.
secondaryPositions element to the left of the content in ios mode, and directly to the right in md mode.
primaryPositions element to the right of the content in ios mode, and to the far right in md mode.
<ion-toolbar>
<ion-buttons slot="start">
<ion-button>Start</ion-button>
</ion-buttons>
<ion-title>Buttons</ion-title>
<ion-buttons slot="end">
<ion-button>End</ion-button>
</ion-buttons>
</ion-toolbar>

<ion-toolbar>
<ion-buttons slot="secondary">
<ion-button>Secondary</ion-button>
</ion-buttons>
<ion-title>Buttons</ion-title>
<ion-buttons slot="primary">
<ion-button>Primary</ion-button>
</ion-buttons>
</ion-toolbar>

Buttonsのタイプ

ツールバーのボタンは、デフォルトでは透明ですが、ボタンの fill プロパティで変更することが可能です。この例で バックボタンメニューボタン に含まれるプロパティは表示目的であり、正しい使用方法はそれぞれのドキュメントをご覧ください。

<ion-toolbar>
<ion-buttons slot="secondary">
<ion-button size="large">
Favorite
</ion-button>
</ion-buttons>
<ion-title>Default Buttons</ion-title>
<ion-buttons slot="primary">
<ion-button>
Delete
</ion-button>
</ion-buttons>
</ion-toolbar>

<ion-toolbar>
<ion-buttons slot="secondary">
<ion-button>
<ion-icon slot="icon-only" name="person-circle"></ion-icon>
</ion-button>
<ion-button>
<ion-icon slot="icon-only" name="search"></ion-icon>
</ion-button>
</ion-buttons>
<ion-buttons slot="primary">
<ion-button>
<ion-icon slot="icon-only" ios="ellipsis-horizontal" md="ellipsis-vertical"></ion-icon>
</ion-button>
</ion-buttons>
<ion-title>Icon Buttons</ion-title>
</ion-toolbar>

<ion-toolbar>
<ion-buttons slot="secondary">
<ion-button fill="solid">
<ion-icon slot="start" name="person-circle"></ion-icon>
Contact
</ion-button>
</ion-buttons>
<ion-buttons slot="primary">
<ion-button fill="solid">
Help
<ion-icon slot="end" name="help-circle"></ion-icon>
</ion-button>
</ion-buttons>
<ion-title>Solid Buttons</ion-title>
</ion-toolbar>

<ion-toolbar>
<ion-buttons slot="secondary">
<ion-button fill="outline">
<ion-icon slot="start" name="star"></ion-icon>
Star
</ion-button>
</ion-buttons>
<ion-buttons slot="primary">
<ion-button fill="outline">
Edit
<ion-icon slot="end" name="create"></ion-icon>
</ion-button>
</ion-buttons>
<ion-title>Outline Buttons</ion-title>
</ion-toolbar>

<ion-toolbar>
<ion-buttons slot="start">
<ion-back-button default-href="#"></ion-back-button>
</ion-buttons>
<ion-title>Back Button</ion-title>
</ion-toolbar>

<ion-toolbar>
<ion-buttons slot="start">
<ion-menu-button auto-hide="false"></ion-menu-button>
</ion-buttons>
<ion-title>Menu Button</ion-title>
</ion-toolbar>

Collapsible Buttons

ボタンに collapse プロパティを設定すると、ヘッダーが折りたたまれたときにボタンが折りたたまれます。これは通常、collapsible large titles と共に使用します。

info

この機能はiOS modeでのみ有効です。

<ion-header [translucent]="true">
<ion-toolbar>
<ion-title>Title</ion-title>
<ion-buttons [collapse]="true" slot="end">
<ion-button>Button</ion-button>
</ion-buttons>
</ion-toolbar>
</ion-header>
<ion-content [fullscreen]="true">
<ion-header collapse="condense">
<ion-toolbar>
<ion-title size="large">Title</ion-title>
<ion-buttons [collapse]="true" slot="end">
<ion-button>Button</ion-button>
</ion-buttons>
</ion-toolbar>
</ion-header>

<div class="ion-padding">Scroll the list to see the title & buttons collapse.</div>

<ion-list>
<ion-item>Item 1</ion-item>
<ion-item>Item 2</ion-item>
<ion-item>Item 3</ion-item>
<ion-item>Item 4</ion-item>
<ion-item>Item 5</ion-item>
<ion-item>Item 6</ion-item>
<ion-item>Item 7</ion-item>
<ion-item>Item 8</ion-item>
<ion-item>Item 9</ion-item>
<ion-item>Item 10</ion-item>
<ion-item>Item 11</ion-item>
<ion-item>Item 12</ion-item>
<ion-item>Item 13</ion-item>
<ion-item>Item 14</ion-item>
<ion-item>Item 15</ion-item>
<ion-item>Item 16</ion-item>
<ion-item>Item 17</ion-item>
<ion-item>Item 18</ion-item>
<ion-item>Item 19</ion-item>
<ion-item>Item 20</ion-item>
</ion-list>
</ion-content>

プロパティ

collapse

DescriptionIf true, buttons will disappear when its parent toolbar has fully collapsed if the toolbar is not the first toolbar. If the toolbar is the first toolbar, the buttons will be hidden and will only be shown once all toolbars have fully collapsed.

Only applies in ios mode with collapse set to true on ion-header.

Typically used for Collapsible Large Titles
Attributecollapse
Typeboolean
Defaultfalse

イベント

No events available for this component.

メソッド

No public methods available for this component.

CSS Shadow Parts

No CSS shadow parts available for this component.

CSSカスタムプロパティ

No CSS custom properties available for this component.

Slots

No slots available for this component.